Documentation / Connaissances

Connaissances : répondre à partir de vos propres documents

Les collections, les documents et ce que fait réellement la publication.

Dernière mise à jour:

Un agent répond normalement à partir de son system prompt. Knowledge lui permet de répondre aussi à partir de votre propre documentation : votre grille tarifaire, votre politique de retours, vos horaires d'ouverture, vos fiches produits. Pendant un appel, l'agent recherche les passages pertinents et répond à partir d'eux, et la fiche de l'appel indique quels passages il a utilisés.

Ouvrez Knowledge dans le menu de gauche.

Les deux objets que vous manipulez#

Une collection est un ensemble nommé de documents, par exemple FAQ produits ou Politique d'expédition. Une collection appartient à votre projet, pas à un agent : plusieurs agents peuvent répondre à partir de la même collection, et chaque agent peut répondre à partir de plusieurs collections.

Un document est un élément de contenu au sein d'une collection. Ce peut être un texte que vous saisissez, un fichier que vous envoyez, une page ou un site entier que nous récupérons pour vous, ou des fichiers que nous lisons dans un bucket de stockage qui vous appartient.

Brouillon, en relecture, publié, archivé#

C'est la partie qui mérite deux lectures, car elle explique presque toutes les surprises.

  • Brouillon. Le document existe et vous pouvez le modifier, mais rien ne peut le trouver. Un nouveau document commence toujours ici.
  • En relecture. Un brouillon que quelqu'un a marqué comme prêt à être lu. Exactement aussi introuvable qu'un brouillon : la différence tient au libellé et au filtre, pas à ce à partir de quoi un agent peut répondre.
  • Publié. Le texte a été découpé en passages et indexé. Seuls les documents publiés sont accessibles à la recherche : la publication est donc l'étape qui rend un document utilisable par un agent.
  • Archivé. La ligne et son historique restent, les passages sont supprimés. L'agent ne peut plus le citer. Une nouvelle publication le rétablit.

Modifier le texte d'un document publié ne le republie pas pour autant. Tant que vous n'avez pas publié de nouveau, l'agent continue de répondre avec l'ancienne formulation.

Ce que fait l'agent pendant un appel#

Lorsque l'agent a besoin d'une information qu'il n'a pas, il cherche dans les collections qui lui sont rattachées, lit les passages qui correspondent le mieux et répond à partir d'eux. Il ne cherche que dans les documents publiés, et uniquement dans les collections auxquelles cet agent est rattaché.

Pour aller plus loin#

  • Ajouter du contenu : du texte, un fichier, une page ou un sitemap entier.
  • Importer un dossier entier depuis un bucket de stockage qui vous appartient.
  • Envoyer un document en relecture avant que quiconque ne le publie.
  • Permettre à un agent de répondre à partir d'une collection.
  • Quand l'agent ne sait pas quelque chose dont vous savez que cela s'y trouve.

La console

Ces pages sont en lecture seule. L'appel de test, les clés API et la référence de l'API à jour se trouvent dans la console, où votre compte est connecté.

Ouvrir la console