Connaissances

Page Agent IA → Entraîner → Contenu → Sources dans le dashboard (app.thehumind.com).

C'est ici que vous nourrissez votre agent IA. Tout ce que vous ajoutez devient du contexte que l'IA peut consulter pour répondre aux questions de vos visiteurs. Quatre types de contenus, organisables en dossiers et sous-dossiers.

Les quatre types de connaissances

Type	Visibilité	Usage idéal
Article	Public	Contenu long-format publié dans votre centre d'aide. Cité comme source dans les réponses de l'IA.
Fragment	Privé (IA uniquement)	FAQ, indications à l'IA, infos sensibles. Jamais montré aux visiteurs.
Page web	Public	Synchronise une URL externe (ex. votre centre d'aide existant). Re-synchro auto chaque jour.
Document	Public	Fichier PDF (manuel, brochure, conditions).

Sur la page Sources, cliquez « Ajouter du contenu » en haut à droite. Une fenêtre vous présente deux groupes : Créer une nouvelle connaissance (Article, Fragment) et Importer ou synchroniser (Page web, Document).

Articles : public, cité comme source

Un article est un contenu long que l'IA peut à la fois utiliser pour répondre et citer comme source à l'utilisateur. Concrètement, dans la conversation, l'IA affichera un lien vers cet article si elle s'en sert pour formuler sa réponse ; l'utilisateur pourra cliquer dessus pour lire la version complète.

Champs :

• Titre (obligatoire)
• Extrait (optionnel) : court résumé. Génération automatique par IA possible.
• Contenu (obligatoire) : éditeur de texte riche (titres, listes, gras, liens, images, séparateurs).

Statuts :

• Brouillon : sauvegardé mais pas exposé à l'IA. Seul le titre est requis.
• Publié : l'IA peut l'utiliser et le citer. Titre et contenu requis.

Bon à savoir :

• Vous pouvez régénérer l'extrait par IA ou reformater le HTML par IA depuis la barre latérale d'un article.
• L'éditeur affiche le compteur de vues et la date de dernière modification.

Quand utiliser un article

Quand l'information est utile à l'IA et intéressante à montrer publiquement à l'utilisateur final : politiques, guides, articles de fond, FAQ détaillées que vous voulez aussi rendre accessibles depuis votre centre d'aide.

Fragments : privé, indications à l'IA

Un fragment (« snippet » en anglais dans certaines parties de l'interface) est un couple titre + contenu qui sert d'indication interne à l'IA. Jamais cité, jamais affiché au visiteur.

Champs :

• Titre (obligatoire) : sert à identifier le fragment dans votre liste, et donne aussi un indice à l'IA sur le contexte.
• Contenu (obligatoire) : l'information ou la directive proprement dite.

Bon à savoir :

• Toujours actif (pas de statut brouillon/publié).
• Idéal pour : FAQ courte (« Quelle est ma politique de retour ? »), précisions internes (« Notre marque est positionnée premium, ne suggérez pas d'alternatives low-cost »), informations confidentielles que l'IA doit connaître mais ne doit pas révéler comme citation.
• Ciblage (optionnel) : par défaut un fragment est général, récupéré dans toute la boutique. Vous pouvez aussi le rattacher à des produits ou des collections précis pour qu'il ne s'applique que là. Voir Snippets partagés.

Quand utiliser un fragment

Quand vous voulez que l'IA dispose de l'information mais sans que cela apparaisse comme une source officielle. Si vous voulez que ce soit public, utilisez un article à la place.

Fragments vs. Règles d'instruction

C'est la distinction la plus importante de la section Agent IA, et elle est facile à confondre :

	Fragments (cette page)	Règles d'instruction (page Instructions)
Localisation	Connaissances → Sources	Instructions → Instructions personnalisées
Mode d'activation	Récupérés quand pertinents par rapport à la question	Toujours actifs dans toutes les réponses
Cas typique	FAQ, infos contextuelles	Règles de comportement non-négociables
Exemple	« Politique de retour : 30 jours, frais de retour offerts si commande > 50 € »	« Ne jamais mentionner les concurrents par leur nom »

En résumé : un fragment c'est une information à laquelle l'IA peut accéder si elle en a besoin. Une règle d'instruction c'est une consigne que l'IA doit suivre à chaque réponse, peu importe la question. Ne mettez pas une FAQ en règle d'instruction : vous saturez le contexte de l'IA pour des informations qui ne sont pertinentes que dans 1 % des conversations. À l'inverse, ne mettez pas une règle de comportement dans un fragment : il pourrait ne pas être récupéré quand il faudrait.

Pages web : synchronisation externe

Importez le contenu d'une page web publique. Humind crawle l'URL fournie et toutes les sous-pages rattachées au même domaine.

Champs :

• URL(s) : une ou plusieurs URLs. Bouton « Add Another URL » pour en ajouter.
• Période d'activité (optionnelle) : date de début et/ou date de fin.

Conseils donnés dans le formulaire :

« Pour de meilleurs résultats, entrez le domaine de niveau supérieur plutôt qu'une page spécifique (ex. https://help.yourcompany.com). »

Re-synchronisation automatique :

• Chaque page web est re-crawlée automatiquement, tous les jours à minuit (heure serveur).
• L'indicateur « Dernière synchro » dans la barre latérale d'une page web vous montre la date du dernier crawl.
• Bouton « Force Sync » disponible pour forcer une synchronisation immédiate.

Statuts d'une page web :

• queued : en attente de traitement
• processing : en cours de crawl
• published : synchronisée et disponible pour l'IA
• failed : échec (le tooltip affiche le détail de l'erreur)

Documents : PDF

Importez un ou plusieurs fichiers PDF (mode liste avec drag-and-drop ou sélecteur de fichiers).

Uniquement des PDF

Bien que la zone d'upload semble accepter d'autres formats, seuls les fichiers PDF sont réellement traités. Les autres formats sont rejetés avec une erreur.

Bon à savoir :

• Multi-upload supporté.
• Période d'activité (active_from / active_until) optionnelle, comme pour les pages web.
• En cas d'upload partiel (certains PDF acceptés, d'autres rejetés), un message de notification détaille les succès et échecs.

Dossiers et sous-dossiers

Vous pouvez organiser vos connaissances dans une arborescence de dossiers, sans limite de profondeur.

Créer un dossier :

• Bouton « Nouveau dossier » en haut de la liste, ou depuis le menu contextuel.
• Champs : nom (obligatoire) et icône (emoji, optionnel).
• Si vous cliquez sur « Nouveau dossier » alors que vous êtes déjà dans un dossier, le nouveau sera créé comme sous-dossier de celui-ci.

Déplacer un élément :

• Glisser-déposer sur n'importe quel dossier de la liste, ou sur n'importe quel segment du fil d'Ariane (y compris la racine).
• Sélection multiple : cochez la case d'en-tête ou les cases individuelles, puis glissez-déposez en bloc.

Renommer ou supprimer un dossier :

• Menu contextuel (clic droit ou icône à trois points sur la ligne du dossier).
• Options : Renommer et Supprimer. Pour déplacer un dossier, utilisez le glisser-déposer.

Recherche, filtres, planification

• Recherche : barre en haut de la liste. Cherche dans les titres, retourne jusqu'à 10 résultats.
• Filtres par tags : icône d'entonnoir. Les tags sont remontés automatiquement par l'IA et listés dans le menu de filtre.
• Planification d'activité : chaque connaissance (article, fragment, page web, document) peut avoir une date de début et/ou date de fin d'activité. La connaissance n'est utilisée par l'IA qu'à l'intérieur de cet intervalle. La liste affiche un badge « Programmé » (orange) avant la date de début et « Expiré » après la date de fin.

Synchronisation Shopify automatique

Si votre compte est connecté à Shopify (intégration installée depuis l'App Store Shopify), Humind synchronise automatiquement deux types de contenus dans vos connaissances :

• Pages Shopify (les pages statiques que vous avez créées dans Shopify : « À propos », « Contact », « FAQ », etc.)
• Articles de blog Shopify (tous les articles de tous vos blogs)

Comment ça marche :

1. À la fin de l'installation de l'app Shopify, une première synchronisation est lancée automatiquement.
2. Un dossier racine « Shopify » est créé dans vos connaissances, avec deux sous-dossiers « Pages » et « Blog ».
3. Toutes les pages et tous les articles sont importés comme des pages web (type webpage) dans ces dossiers.
4. Une synchronisation horaire vérifie automatiquement les nouveautés et mises à jour. Pas besoin de webhooks à configurer, tout est géré côté Humind.
5. Vous pouvez déplacer les éléments synchronisés vers d'autres dossiers ; ils ne seront pas remis à la racine lors des synchros suivantes.
6. Vous pouvez aussi renommer ou supprimer le dossier « Shopify » ; la prochaine synchro le recréera si nécessaire.

Synchronisation manuelle Shopify

En haut de la page Sources, un bouton « Sync Shopify » apparaît si votre intégration Shopify est active. Il déclenche une synchronisation immédiate sans attendre la prochaine fenêtre horaire. Si une synchro est déjà en cours, vous verrez le message « A Shopify sync is already in progress. ».

Pages produit Shopify

Les pages produit Shopify ne sont pas synchronisées en tant que connaissances : vos produits sont gérés séparément dans Agent IA → Entraîner → Contenu → Catalogue. Pour ajouter du savoir spécifique à un produit (instructions d'entretien, conseils de taille…), utilisez les Fragments produit.

Public vs. privé : récapitulatif

Type	Visible par l'IA	Cité dans les réponses	Visible publiquement
Article publié	✅	✅	✅ (centre d'aide)
Article brouillon	❌	❌	❌
Fragment	✅	❌	❌
Page web	✅	✅ (lien vers la page d'origine)	✅ (sa propre URL)
Document PDF	✅	✅	✅