The Papers

Guide

Comment donner à votre bot de support et à vos agents IA une source de vérité unique pour la documentation produit

Choisissez un document canonique par type d’information produit — caractéristiques, limites, offres, politiques —, publiez-le à un lien permanent dans un format texte que les outils d’IA lisent bien, et orientez votre bot de support, vos agents internes et les robots d’indexation IA publics vers ce lien plutôt que vers des copies. Gardez-le versionné et mettez-le à jour sur place, afin que chaque bot réponde à partir du même contenu à jour et à fidélité contrôlée.

Pourquoi les bots donnent des réponses différentes

Un bot de support répond à partir de ce qu’on lui a fourni : un export du centre d’aide, une ancienne fiche technique en PDF, une page wiki copiée l’an dernier. Les assistants publics répondent à partir de ce qu’ils ont trouvé sur le web. Quand la même information existe à cinq endroits, chaque bot en choisit un différent.

Résultat : un bot qui cite une limite supprimée, un prix de l’an dernier ou une fonctionnalité qui n’existe que dans une offre — et un client qui lui fait confiance.

Décider quelle est la source de vérité

Toutes les autres copies — présentations, e-mails d’onboarding, supports commerciaux — doivent renvoyer au document canonique plutôt que le reformuler.

Type d’informationDocument canoniqueResponsable
Caractéristiques et limitesFiche technique par produitProduit
Offres et tarifsDocument des offresMarketing produit / finance
Politiques (remboursements, SLA, données)Document de politiqueJuridique / support
Guides pratiques et dépannageArticles du centre d’aideSupport / documentation
Évolutions des versionsJournal des modificationsProduit

Rédiger une documentation à partir de laquelle les bots répondent correctement

  • Une information, un endroit, une formulation. Ne reformulez pas les limites dans trois articles.
  • Écrivez limites et chiffres avec leurs unités et leur périmètre : « Jusqu’à 10 Go par espace de travail avec l’offre Team ».
  • Précisez à quelle offre, version ou région s’applique une affirmation.
  • Datez les informations qui évoluent, et signalez clairement les fonctionnalités obsolètes.
  • Utilisez de vrais titres et tableaux ; évitez les captures d’écran de paramètres ou de tableaux.
  • Donnez à chaque document un court résumé en tête qui répond à la question la plus fréquente.

Relier les bots à la source

  • Pointez la source de connaissances de votre bot de support vers les documents canoniques, idéalement en Markdown ou en JSON plutôt qu’en PDF.
  • Publiez un index de Data Room (llms.txt) qui liste vos documents canoniques, pour que les outils d’IA externes puissent les découvrir.
  • Resynchronisez le bot à chaque modification d’un document canonique, ou faites-lui lire le lien en direct.
  • Passez en revue les transcriptions du bot pour repérer les réponses qui ne remontent à aucun document canonique.

La place de The Papers

The Papers publie chaque document canonique sous forme de version IA à une URL permanente : une page pour les humains, du Markdown avec front matter (URL canonique, version, statut, score de lisibilité IA) et du JSON avec blocs, indicateurs et provenance par page. Un index de Data Room à /{room}/llms.txt et /{room}/index.md liste chaque document.

Avant publication, chaque nombre, date et période doit correspondre à la source, et les réserves comme « jusqu’à » restent attachées. Mettre à jour un document conserve son URL et son historique des versions : le bot et les assistants publics lisent donc toujours la version en vigueur. Les statistiques montrent quels agents IA, robots d’indexation et outils lisent chaque document, et dans quel format.

Les documents publics peuvent être répertoriés et indexables, et un domaine personnalisé comme ai.yourcompany.com garde la Data Room à votre propre adresse. Le service convient à vos documents de référence clés ; il n’est pas conçu pour convertir en masse toute une archive sans contrôle de fidélité document par document.

FAQ

Le centre d’aide doit-il lui-même être la source de vérité ?
Pour les guides pratiques, souvent oui. Pour les informations factuelles comme les limites, les offres et les politiques, un document canonique unique vers lequel renvoient les articles d’aide est plus facile à maintenir exact.
Quel format un bot de support doit-il lire ?
Les formats texte comme Markdown ou JSON se prêtent mieux à la recherche et génèrent moins d’erreurs que les PDF. The Papers publie les deux pour chaque document.
Comment les assistants IA publics trouvent-ils nos documents ?
Rendez les documents canoniques publics et indexables, et listez-les dans un index llms.txt pour que les outils d’IA et les robots d’indexation puissent les découvrir.
Que deviennent les liens lorsqu’un document change ?
Avec The Papers, l’URL reste la même et l’historique des versions est conservé : aucun lien qui y renvoie ne se casse.

Donnez à chaque bot et à chaque agent les mêmes informations produit à jour, à un lien permanent.

Guides associés