Base de connaissances IA, bien écrire sa documentation

En bref · l'assistant retrouve des passages de votre documentation, puis rédige sa réponse à partir d'eux. Il lit chaque passage isolé, hors de la page qui l'entoure. Un passage doit donc se comprendre seul. Le reste (une source de vérité unique, des consignes claires, un test sur vingt vraies questions) sert à garder cette qualité dans le temps.

Qu'est-ce qu'une base de connaissances IA ?

C'est l'ensemble des documents (pages d'aide, PDF, fiches, questions-réponses) sur lesquels un assistant s'appuie pour répondre. Le principe s'appelle le RAG, décrit dans notre guide du RAG en français. Les documents sont découpés en passages et indexés. À chaque question, l'assistant retrouve les passages les plus proches et rédige sa réponse à partir d'eux.

Dans cette mécanique, le modèle de langage compte moins que ce qu'il a sous les yeux. Si le passage retrouvé est ambigu, périmé ou incomplet, la réponse le sera aussi.

Pourquoi l'écriture pèse plus que le modèle

Un passage retrouvé arrive sans son contexte. Anthropic donne l'exemple d'un passage qui dit « le chiffre d'affaires de l'entreprise a augmenté de 3 % par rapport au trimestre précédent ». Pris seul, il ne dit ni de quelle entreprise ni de quelle période il s'agit (Anthropic, Contextual Retrieval).

Votre documentation a le même défaut. « Cliquez sur Paramètres puis sur Exporter » ne dit pas dans quel produit, ni dans quelle version. Un humain regarde le fil d'Ariane. L'assistant n'a que le texte.

Ce qui change pour un éditeur SaaS ou un fabricant

Un éditeur a des pages d'aide courtes, souvent modifiées, avec des captures d'écran. Un fabricant a des notices longues, en PDF, avec plusieurs modèles par fichier. Les deux ont le même risque, une bonne réponse pour la mauvaise version. Les règles ci-dessous valent pour les deux cas.

Comment écrire une documentation utilisateur qu'une IA comprend ?

Il faut écrire chaque page pour qu'un extrait de trois ou quatre paragraphes reste juste hors contexte. Le tableau résume les sept règles que nous appliquerions, avec un exemple fictif pour chacune.

Un sujet par page, un titre qui ressemble à la question

Relisez vos tickets. Les clients écrivent « je n'arrive pas à exporter » ou « où trouver ma facture ». Reprenez ces formulations dans les titres, puis répondez dès la première phrase, avant le contexte. C'est aussi la structure d'une bonne FAQ intelligente.

Nommer le produit et la version dans le texte

Dites de quoi vous parlez dans chaque section, même si cela semble redondant pour un lecteur humain. Le nom du produit, le plan concerné, la version ou le modèle doivent figurer dans la phrase qui porte l'information, pas seulement dans le titre du document ou le menu du centre d'aide.

Ne pas laisser l'information dans une image

Heeya lit le texte des PDF, sans reconnaissance de caractères. Une capture d'écran, un schéma ou un tableau collé en image ne sont donc pas lus. Pour vérifier un PDF, lancez une recherche sur un mot visible dans la page. Adobe décrit ce test (Ctrl+F ou Cmd+F). Si le mot n'est pas trouvé, le fichier est une image.

Que faire de votre centre d'aide existant ?

Vous pouvez importer vos pages publiques par leur URL, que votre centre d'aide soit sur GitBook, Intercom, Zendesk, Crisp ou Help Scout. Heeya lit ces pages comme du HTML statique. Ce n'est pas une connexion à ces outils, seulement la lecture de pages publiques.

Deux limites à connaître. Les pages construites par JavaScript, comme une page Notion publique, ne sont pas lues. Certains centres d'aide bloquent la lecture automatique. Dans les deux cas, exportez le contenu en PDF ou en Word puis importez le fichier.

Quand l'information vient d'une page web importée, l'assistant peut donner le lien de cette page. C'est une raison de plus de soigner les titres et de supprimer les pages en double. Pour choisir ou comparer les outils de centre d'aide, consultez notre comparatif des logiciels de centre d'aide. Notre étude sur les centres d'aide d'éditeurs SaaS montre comment ils sont organisés en pratique.

Le volume se mesure en caractères. Une page A4 fait environ 2 000 caractères. Le plan Gratuit (20 000 caractères) couvre donc environ 10 pages, Standard (1 000 000 de caractères, 19 €/mois) environ 500 pages, et Premium (3 000 000 de caractères, 99 €/mois) plus d'un millier de pages. Le détail est sur la page tarifs. Commencez par les 50 pages les plus lues plutôt que par tout le centre d'aide.

Consignes et questions-réponses, ce qui ne se règle pas dans les pages

Les pages disent ce qui est vrai. Les consignes disent ce que l'assistant doit faire de cette information. Vous les rédigez vous-même dans Heeya, et elles complètent la documentation.

Écrire ce que l'assistant ne doit pas faire

Écrivez les interdits noir sur blanc. Pas de prix qui ne figure pas dans la documentation. Pas de promesse de date pour une fonction à venir. Pas de conseil juridique ou médical. Si la réponse n'est pas dans les documents, dire qu'il ne la trouve pas et proposer le contact humain.

Ajoutez une règle de précision. Quand la réponse dépend du produit, du plan ou de la version et que le visiteur ne l'a pas indiqué, l'assistant le demande avant de répondre. Notre guide des consignes d'un chatbot détaille la rédaction, et l'article sur les hallucinations et garde-fous explique pourquoi ces limites comptent.

Des paires questions-réponses pour les questions qui reviennent

Pour dix ou vingt questions qui reviennent tout le temps, ajoutez des paires questions-réponses. Rédigez la question comme le client la pose, et la réponse comme vous voulez qu'elle soit donnée. Cela évite qu'une réponse importante dépende d'un passage noyé dans une longue page.

Ne recopiez pas toute la documentation en paires. Vous auriez deux sources de vérité à tenir à jour, ce que la règle précédente cherche à éviter.

Comment tester une base de connaissances IA avant de la publier ?

Prenez vingt vraies questions de vos clients, copiées telles quelles depuis vos tickets ou vos emails, avec les fautes et les approximations. Posez-les à l'assistant sans les reformuler, puis comparez chaque réponse à la documentation.

1. Notez chaque réponse « correcte », « incomplète » ou « fausse ».
2. Pour chaque erreur, cherchez la cause dans le contenu (information absente, deux pages qui se contredisent, version non précisée, tableau en image).
3. Corrigez la page, la paire question-réponse ou la consigne.
4. Reposez la même question, avec la même formulation.

Corrigez le contenu, jamais la question. Vos clients ne la reformuleront pas pour vous.

Glissez aussi quelques questions volontairement floues, et deux ou trois questions hors sujet. Le bon résultat, dans ce dernier cas, est que l'assistant dise qu'il ne sait pas. Pour l'offre Standard, l'outil inclus (formulaire de contact ou prise de rendez-vous) permet ensuite de transmettre la demande à votre équipe. Notre page chatbot pour documentation produit décrit ce cas d'usage.

Comment maintenir la base dans le temps ?

Une documentation change à chaque version, et l'assistant ne le sait que si vous mettez le contenu à jour. La routine tient en quatre gestes.

• À chaque version. Remplacez les pages ou fichiers modifiés, ne les ajoutez pas à côté. Cette étape fait partie de la sortie d'une version.
• Chaque semaine au début. Relisez l'historique des conversations dans le tableau de bord. Repérez les questions restées sans réponse et les réponses approximatives.
• Avec les avis des visiteurs. Les visiteurs peuvent marquer une réponse utile ou non utile. Les réponses jugées non utiles indiquent les pages à réécrire en premier.
• Chaque mois ensuite. Supprimez les pages obsolètes, fusionnez les doublons, relancez votre liste de vingt questions.

Ce travail dépasse l'assistant. Une question posée dix fois sans bonne réponse montre une page manquante ou mal écrite, donc un problème que vos clients rencontrent aussi sans chatbot. Notre article sur les indicateurs d'un chatbot IA propose des mesures pour suivre l'évolution.

Les données sont hébergées dans l'Union européenne (OVH, France) et ne servent pas à entraîner des modèles.

FAQ

Conclusion

Une base de connaissances IA se gagne par l'écriture. Une page par sujet, des titres qui ressemblent aux questions des clients, le produit et la version nommés dans le texte, rien d'important dans une image, une seule source de vérité. Testez sur vingt vraies questions, corrigez le contenu et gardez une routine de mise à jour. Le temps se passe surtout sur la documentation, pas sur le paramétrage de l'assistant.

Pour aller plus loin

• Base de connaissances, définition et bonnes pratiques
• Notice technique IA, rendre vos PDF interrogeables
• FAQ intelligente, transformer votre FAQ en assistant IA
• Chatbot pour documentation produit
• Comparatif des logiciels de centre d'aide
• Étude sur les centres d'aide d'éditeurs SaaS
• Tarifs Heeya