Documentation / Connaissances
Ajouter du contenu à une collection
Saisissez-le, téléversez un fichier, ou indiquez une page ou votre site web.
Dernière mise à jour:
Ouvrez Knowledge, cliquez sur une collection, puis sur Add document. Cette boîte de dialogue propose quatre façons de faire entrer du contenu, et toutes aboutissent au même point : un brouillon que vous publiez ensuite. Il existe une cinquième voie, sur son propre onglet, en bas de cette page.
Texte#
Collez ou saisissez le contenu. Idéal pour des réponses courtes, rédigées par vos soins, que vous voulez maîtriser entièrement : horaires d’ouverture, politique de retour, les trois questions que tout le monde pose.
Fichier#
Téléversez un PDF, un document Word, un fichier HTML, du Markdown ou du texte brut. Le texte est extrait en arrière-plan : le document apparaît donc immédiatement et ses passages arrivent un instant plus tard. Surveillez l’onglet Processing s’il s’agit d’un fichier volumineux.
URL#
Donnez un lien et nous récupérons la page et en conservons le texte. Utilisez le champ scope pour indiquer quelle partie du site la récupération a le droit de toucher ; tout ce qui se trouve en dehors est refusé. Vous pouvez aussi demander que la page soit récupérée à nouveau à intervalles réguliers, afin qu’une page que vous mettez régulièrement à jour reste à jour sans que vous ayez quoi que ce soit à faire. Pour cela, activez Vérifier cette page pour détecter les changements et choisissez toutes les quelques heures, jours, semaines ou mois, d’une heure à un an. Seul un document publié est vérifié, une page inchangée ne coûte rien, et la page du document indique quand elle a été vérifiée pour la dernière fois et quand elle le sera de nouveau. Un intervalle sans prochaine vérification à côté signifie que le document n’est pas encore publié.
Votre site web#
Donnez-nous le site, simplement example.com, et nous trouvons comment l’explorer : nous lisons votre robots.txt à la recherche d’une déclaration de sitemap, nous essayons les adresses de sitemap habituelles et, si le site n’en publie aucune, nous suivons ses liens à la place. Vous n’avez pas besoin de savoir où se trouve votre sitemap, et ne cochez I know my sitemap address que si vous le savez.
L’exploration entière devient un seul document composé de nombreuses pages, de sorte qu’une réponse renvoie toujours à la page exacte dont elle provient. C’est la façon la plus rapide d’importer tout un centre d’aide. Les grands sites demandent du temps, et l’onglet Processing indique où en est l’exploration, combien de pages elle a trouvées, et ce qu’elle a ignoré.
Laissez « Most pages to read » vide et nous lisons toutes les pages. Il n’y a pas de limite cachée : n’indiquez un nombre que si vous en voulez une. Si une exploration s’arrête effectivement avant la fin, la tâche le signale et en explique la raison.
Votre propre stockage#
Si les fichiers se trouvent déjà dans un stockage objet qui vous appartient, ne les téléversez pas un par un. Enregistrez le bucket une seule fois dans Your storage, puis importez un dossier entier aussi souvent que vous le souhaitez : une nouvelle importation ne récupère que ce qui a réellement changé. Cela fait l’objet d’un article à part.
Puis publiez#
Tout ce qui précède arrive sous forme de brouillon. Rien n’est consultable par la recherche, et aucun agent ne peut s’en servir, tant que vous n’avez pas publié. Ouvrez le document et cliquez sur Publish.
La publication est aussi ce que vous faites après une modification. Si vous changez le texte d’un document publié, publiez-le à nouveau, faute de quoi l’agent continue de répondre à partir de la version précédente. La vue du document vous indique quand les deux versions ont divergé.
Plusieurs langues#
Un document peut porter des versions dans plusieurs langues. Ajoutez la traduction en tant que version linguistique plutôt que comme second document, et une seule publication les indexe toutes. L’agent trouve alors la version qui correspond à la langue de l’appel, ce qui est exactement ce que vous voulez lorsque la même politique doit être citée en grec et en anglais.
Étiquettes et catégories#
Des libellés facultatifs. Ils deviennent utiles lorsqu’une collection grandit : vous pouvez filtrer dessus lors d’une recherche, et ils accompagnent le document.