Gérer les sources : aperçu, modification, entraînement
Gérez les connaissances d'un agent intoCHAT : statut, aperçu, modification, réentraînement, suppression, priorité, utilisation, informations contradictoires, groupes par site et dossier, export ZIP et auto-resync.
Tout ce que sait votre agent est listé dans l'onglet Knowledge (connaissances), sous Knowledge sources : une ligne par page, fichier, extrait de texte, paire de questions-réponses, page Notion, fichier Google Drive ou article Intercom. Les tickets helpdesk importés font exception : ils apparaissent sur une seule ligne, avec leur nombre, dans la carte Helpdesk tickets sous la liste (voir Tickets helpdesk et Intercom). Cette page explique ce que vous pouvez faire avec chaque source et quand les modifications s'appliquent.
Statut d'entraînement
Chaque source affiche un statut :
| Statut | Signification |
|---|---|
| Pending | Enregistrée, pas encore entraînée. L'agent ne l'utilise pas. |
| Training | En cours de découpage et d'indexation. |
| Trained | Utilisée pour les réponses. |
| Failed | N'a pas pu être entraînée. Survolez le badge pour voir pourquoi. |
La barre en haut de l'onglet résume la situation, par exemple « 3 sources waiting to be trained », et indique combien de caractères de votre offre l'agent utilise. Cliquez sur Train agent pour entraîner tout ce qui est en attente, ou sur Retry failed quand il ne reste que des sources en échec.
L'entraînement s'exécute sur les serveurs d'intoCHAT. Une fois que vous avez cliqué sur Train agent, vous pouvez changer d'onglet ou fermer la page : l'entraînement continue. À votre retour, l'onglet Knowledge affiche sa progression. Si un entraînement est interrompu, il reprend quand vous ouvrez l'onglet Knowledge, et une vérification quotidienne relance aussi les entraînements interrompus. Les sources terminées restent entraînées. Si l'entraînement s'arrête après des erreurs répétées, cliquez de nouveau sur Train agent.
Seul l'ajout de connaissances demande de garder la page ouverte : attendez que les nouveaux fichiers et pages apparaissent comme ajoutés avant de la quitter.
Trouver des sources
Utilisez Search sources… pour chercher par nom, par adresse ou par les autres formulations d'une paire de questions-réponses, le menu des types (All types, Website, Files, Text, Q&A, ainsi que Notion, Google Drive ou Intercom dès que vous avez de telles sources) et les boutons de statut comme Pending (3) ou Failed (1).
Grouper les sources par site et par dossier
Dans le menu Arrange sources, à côté du menu des types, choisissez Group by site and folder (grouper par site et par dossier). List revient à la liste.
- Les pages web sont groupées par site, puis par dossier de premier niveau du site, comme
/blogou/docs. Les pages à la racine du site figurent sous/. Un site qui n'a qu'un dossier affiche ses pages directement sous le site. - Les autres sources sont groupées par type : Files, Text, Q&A, Notion, Google Drive et articles Intercom.
- Chaque en-tête indique le nombre de sources du groupe et leurs caractères, par exemple « 24 sources · 81.2K chars ». Cliquez sur la flèche pour le replier ou le déplier.
- La recherche, les filtres et Least used s'appliquent aussi à l'intérieur de chaque groupe.
Chaque en-tête de groupe comporte ces commandes :
- Case à cocher : sélectionne toutes les sources du groupe. Elle affiche un état partiellement coché quand seules certaines sont sélectionnées. Utilisez ensuite Export, Re-index ou Delete pour la sélection.
- Nuage (actualiser depuis le site) : groupes de site et de dossier uniquement. Après confirmation avec Refresh pages, chaque page du groupe est relue et celles dont le texte a changé sont réentraînées. Cela consomme une exploration de votre offre, et une exploration lit jusqu'à 600 pages. Un groupe plus grand ne peut pas être actualisé d'un coup : actualisez alors ses dossiers un par un. Une page lue dans l'heure précédente peut provenir d'une copie en cache. L'actualisation s'arrête à votre limite d'explorations ou de caractères, et un message indique combien de pages ont changé, sont restées identiques ou n'ont pas pu être lues.
- Corbeille : supprime toutes les sources du groupe une fois que vous confirmez avec Delete … sources. Cette action est irréversible.
À quelle fréquence une source est utilisée
Chaque ligne indique combien de réponses de l'agent ont utilisé la source au cours des 30 derniers jours :
- « Used in 12 replies (30 days) » : autant de réponses avaient au moins un extrait de cette source parmi les connaissances fournies à l'agent.
- « Not used in 30 days » : aucune réponse de cette période n'avait d'extrait de cette source.
Les paires de questions-réponses sont comptées comme toute autre source. Les chats enregistrés du Playground comptent aussi ; les chats temporaires ne sont pas enregistrés et ne comptent donc pas. Les chiffres partent du moment où intoCHAT a commencé à enregistrer les connaissances utilisées par chaque réponse. Tant que l'agent n'a aucune réponse de ce type, la liste affiche à la place « How often each source is used appears here as new replies are recorded. »
Dès qu'il y a des chiffres, un menu de tri à côté du menu des types propose Default order et Least used. Least used affiche d'abord les sources inutilisées, puis celles utilisées dans le moins de réponses, puis celles utilisées il y a le plus longtemps.
« Utilisée » signifie que le texte de la source a été fourni à l'agent pour cette réponse, pas que la réponse l'a cité. Une source jamais utilisée traite peut-être de sujets que les visiteurs n'abordent pas, ou est difficile à trouver pour la recherche. Ouvrez son aperçu avant de la supprimer, au cas où elle contiendrait des informations encore utiles. Pour voir les questions auxquelles vos connaissances ne répondent pas encore, utilisez Questions to improve ; voir Texte et questions-réponses.
Informations contradictoires
Avec Pro et Enterprise, la carte Conflicts de l'onglet Knowledge liste les faits sur lesquels deux de vos sources ne sont pas d'accord, comme un ancien prix sur une page et un nouveau dans une paire de questions-réponses. Open source A ou Open source B ouvre la source dans cette liste : les extraits de texte et les paires de questions-réponses pour modification, les autres sources dans leur aperçu. Une fois la source corrigée entraînée, le résultat est résolu de lui-même. Voir Conflits.
Ce que vous pouvez faire avec une source
Chaque ligne comporte ces icônes :
- Étoile (Mark as priority) : la source passe avant les autres connaissances pertinentes et l'emporte en cas de contradiction. L'effet est immédiat dès la réponse suivante, sans entraînement. Les paires de questions-réponses n'ont pas d'étoile, car elles passent déjà en premier. Les sources marquées affichent Priority.
- Œil (Preview the text) : affiche exactement le texte que l'agent apprend de la source, Formatted (mis en forme) ou en Plain text (texte brut). Vous pouvez y chercher, le copier avec Copy ou le télécharger avec Download en fichier Markdown (
.md). Pour une page web, Open page ouvre l'original. - Crayon (Edit) : uniquement pour les extraits de texte et les questions-réponses. Modifiez le titre, le contenu, la question, les autres formulations ou la réponse, puis cliquez sur Save. La source repasse en Pending ; entraînez pour appliquer la modification. Une question qu'une autre paire possède déjà est refusée.
- Nuage (Refresh from website) : pages web uniquement. Relit la page et, si son texte a changé, l'enregistre et la réentraîne aussitôt. Cela consomme une exploration du site, comme l'ajout d'une page.
- Flèches (Re-index saved text) : réentraîne la source à partir du texte dont intoCHAT dispose déjà, sans rien récupérer.
- Corbeille (Delete this source) : supprime la source et ses passages.
Les pages Notion et les fichiers Google Drive n'ont ni icône crayon ni icône nuage. Pour en mettre un à jour, importez-le de nouveau ou laissez l'Auto-resync le vérifier ; voir Notion et Google Drive, où Sync now vérifie d'un coup tous les fichiers Drive d'un agent.
Cochez plusieurs lignes pour les exporter avec Export, les réindexer avec Re-index ou les supprimer avec Delete en une fois. Pour ajouter, mettre à jour ou télécharger de nombreuses questions-réponses d'un coup, utilisez l'import et l'export sous Q&A ; voir Texte et questions-réponses. Delete all, en haut, supprime toutes les sources après confirmation avec Delete everything. Cette action est irréversible.
Quand les modifications s'appliquent
| Modification | S'applique |
|---|---|
| Marquer ou retirer la priorité | dès la réponse suivante |
| Supprimer une source | immédiatement |
| Modifier un extrait ou une paire de questions-réponses | après l'entraînement ; d'ici là, l'agent utilise la version précédente |
| Actualiser une page web modifiée | une fois son réentraînement automatique terminé |
| L'Auto-resync trouve une page modifiée | une fois son réentraînement automatique terminé |
| Importer une nouvelle version d'un fichier | après l'entraînement ; d'ici là, l'agent utilise la version précédente |
| Ajouter une source | après l'entraînement |
Supprimer des sources libère aussi des caractères pour de nouvelles.
Mettre à jour des pages web et des fichiers
Re-index saved text ne récupère rien de nouveau, et les pages web et les fichiers ne se modifient pas directement. L'Auto-resync peut vérifier pour vous les pages web, les pages Notion et les fichiers Google Drive selon un calendrier, et les tickets helpdesk et articles Intercom ont leur propre réglage Sync automatically (voir Tickets helpdesk et Intercom). Sinon, quand vos prix ou vos conditions changent, mettez vos sources à jour vous-même :
- Une page web a changé : cliquez sur Refresh from website sur sa source. Une page lue dans l'heure précédente peut provenir d'une copie en cache. Pour mettre à jour de nombreuses pages à la fois, utilisez l'icône nuage d'un groupe dans Group by site and folder, ou ajoutez les pages de nouveau après Find pages, puis entraînez. Voir Exploration du site.
- Une page Notion a changé : importez-la de nouveau. Voir Notion.
- Un fichier Google Drive a changé : cliquez sur Sync now dans l'option Drive, ou choisissez de nouveau le fichier. Voir Google Drive.
- Un fichier a changé : importez la nouvelle version sous le même nom de fichier, puis entraînez. Elle remplace l'ancien texte ; un fichier identique est ignoré. Voir Fichiers.
- Un extrait ou une paire a changé : modifiez-le avec l'icône crayon et entraînez.
Auto-resync
La carte Auto-resync de l'onglet Knowledge relit vos pages web, vos pages Notion et vos fichiers Google Drive selon un calendrier, et ne réentraîne que les pages dont le texte a changé. Elle est désactivée par défaut.
- Activez Check pages automatically (vérifier les pages automatiquement).
- Sous How often (fréquence), choisissez Daily (chaque jour) ou Weekly (chaque semaine). Chaque changement est enregistré aussitôt.
Ce que fait un passage :
- Il relit les sources de type site web, Notion et Google Drive. Les fichiers importés, extraits de texte et questions-réponses ne sont jamais modifiés.
- Un fichier Google Drive n'est relu que s'il a été modifié dans Drive depuis la dernière vérification. Un fichier supprimé, placé dans la corbeille ou qu'intoCHAT n'a peut-être plus le droit d'ouvrir affiche la raison, et son texte enregistré est conservé.
- Il compare chaque page à son texte enregistré. Le texte répété sur tout votre site, comme les menus et les pieds de page, est ignoré dans la comparaison et ne compte donc pas comme un changement.
- Il enregistre le nouveau texte des pages modifiées et les réentraîne de lui-même. Les pages inchangées sont seulement marquées comme vérifiées.
- Il ne supprime jamais de source. Si une page ne peut pas être lue, par exemple parce qu'elle a été retirée de votre site, le texte enregistré est conservé et la source indique la raison.
- Si le nouveau texte d'une page faisait dépasser la limite de caractères de l'agent, la page garde son texte enregistré et affiche « The new text would go over your plan's character limit, so the saved text was kept. »
- Les pages vérifiées il y a le plus longtemps passent en premier. Une page web lue dans l'heure précédente peut provenir d'une copie en cache.
- Les pages web sont lues avec les paramètres d'exploration de l'agent : son pays d'exploration et, en mode lent, 5 pages à la fois, 2 simultanément, avec une pause entre chaque requête. En mode lent, un passage peut lire moins de 30 pages dans le temps imparti ; les autres sont vérifiées au passage suivant.
Explorations du site
- Chaque passage qui lit des pages web consomme 1 exploration de votre offre et couvre jusqu'à 30 pages.
- Un site plus grand est couvert en plusieurs passages, un par jour, qui consomment chacun une exploration. Avec 90 pages, un tour complet demande trois passages et trois explorations.
- Pour 30 pages au plus, la vérification quotidienne consomme environ 30 explorations par mois et la vérification hebdomadaire environ 4 à 5. Les offres Free, Starter et Pro incluent 1, 9 et 20 explorations par mois, partagées avec l'ajout de pages : une vérification quotidienne d'un site épuise donc les explorations de ces offres.
- Sans exploration restante, les pages web ne sont pas lues et attendent que vos explorations repartent à zéro. La carte indique combien de pages n'ont pas été vérifiées, et ces sources affichent « Not checked: Out of website crawls for this period (saved text kept) ».
- Les pages Notion et les fichiers Google Drive ne consomment pas d'exploration. Un passage lit jusqu'à 30 pages Notion et jusqu'à 30 fichiers Drive.
Quand les passages ont lieu
- Les passages ont lieu au plus une fois par jour. La tâche quotidienne démarre vers 05:00 UTC ; la carte affiche cette heure dans votre fuseau horaire. Quand de nombreux agents sont concernés, la tâche continue en plusieurs étapes, si bien qu'un passage peut commencer plus tard les jours chargés.
- Avec Daily, une page est due quand sa dernière vérification date d'environ 20 heures. Avec Weekly, d'environ six jours et demi.
- La carte affiche Last run (dernier passage), Next run (prochain passage, estimé) et Last run found (résultat du dernier passage), par exemple « 12 checked · 2 changed · 0 failed ».
Check now
Check now (vérifier maintenant) lance une vérification immédiate et attend son résultat, ce qui peut prendre jusqu'à une minute. Elle porte sur toutes les pages, pas seulement celles qui sont dues, dans les mêmes limites : jusqu'à 30 pages web, avec 1 exploration consommée s'il y a des pages web, et jusqu'à 30 pages Notion et 30 fichiers Google Drive, celles vérifiées il y a le plus longtemps en premier. Les pages qu'elle n'atteint pas sont vérifiées au passage suivant. Elle fonctionne aussi quand l'Auto-resync est désactivé.
Vous pouvez utiliser Check now une fois toutes les 10 minutes par agent ; d'ici là, la carte affiche « Available again at … ». Après une vérification, le prochain passage planifié attend au moins 20 heures.
Statut de chaque source
Les sources de site web, Notion et Google Drive déjà vérifiées affichent une ligne « Checked … · changed … » : la date de la dernière vérification et celle du dernier changement de texte. Survolez une date pour voir l'heure exacte. Si la dernière vérification a échoué, la ligne indique « Check on … failed: », suivi de la raison et de « (saved text kept) ». Quand la raison laisse penser que le site a refusé le robot, comme une erreur 403 ou une vérification anti-robots, une seconde ligne renvoie vers Sites qui bloquent les robots.
Exporter des sources
Vous pouvez télécharger le texte de vos sources dans un fichier .zip :
- Cliquez sur Export all au-dessus de la liste pour exporter toutes les sources.
- Ou cochez des sources, ou la case d'un groupe, et cliquez sur Export dans la barre qui apparaît.
Le fichier s'appelle par exemple knowledge-sources-2026-10-07.zip. Il contient un fichier par source, dans un dossier par type : website/, files/, text/, qa/, notion/ et google-drive/.
- Chaque fichier contient, en
.txt, le texte enregistré dont l'agent apprend. Pour un fichier importé, il s'agit du texte extrait, pas du document d'origine. - Les paires de questions-réponses sont des fichiers
.mdde la formeQ: …etA: …, avec chaque autre formulation sur sa propre ligneQ:. manifest.csvliste toutes les sources avec les colonnes Name, Type, URL, Characters, Status et File.
Un export contient jusqu'à 50 millions de caractères de texte, soit environ 50 Mo. Au-delà, sélectionnez moins de sources et exportez-les en plusieurs fois.
Quand utiliser Re-index
Utilisez Re-index saved text sur une source en échec, par exemple après une erreur passagère, ou sélectionnez plusieurs sources et cliquez sur Re-index pour relancer leur entraînement. Pour un changement de contenu, actualisez, importez de nouveau ou modifiez la source comme décrit ci-dessus.
Bonnes habitudes
- Consultez l'aperçu des nouvelles sources avant l'entraînement. Une page dont seul le menu a été capturé, ou un tableau PDF mal extrait, s'y repère tout de suite.
- Supprimez les sources obsolètes ou en double au lieu d'espérer que l'agent choisisse la bonne.
- Si l'agent cite sans cesse la mauvaise source, marquez la bonne comme prioritaire ou ajoutez une paire de questions-réponses.