Un agent de support IA reposant sur le RAG (génération augmentée par récupération) n'invente pas ses réponses — il trouve le passage le plus pertinent de votre documentation et répond à partir de celui-ci. Autrement dit, la qualité maximale de votre support IA est exactement celle de votre documentation.
La bonne nouvelle : une documentation qui fonctionne bien pour la récupération par l'IA fonctionne aussi bien pour les humains pressés. Voici ce qui fait vraiment la différence.
1. Rédigez des titres en forme de réponse
La récupération fonctionne sur le sens, mais elle commence par la structure. Une section intitulée « Facturation » ne correspond à rien de précis. Une section intitulée « Comment résilier mon abonnement ? » correspond exactement aux mots qu'un utilisateur agacé tape à minuit.
Passez vos titres en revue : si vous n'imaginez pas un utilisateur le taper sous forme de question, reformulez-le en question.
2. Un sujet par section
Les documents sont découpés en fragments avant d'être indexés. Une section qui traite d'un seul souffle des remboursements, des changements d'offre et des factures devient un fragment confus qui correspond à moitié à tout et ne répond pleinement à rien.
Gardez des sections courtes et à objectif unique. Si un paragraphe commence par « Par ailleurs », il mérite probablement sa propre section.
3. Employez les mots de vos utilisateurs
Vous dites « espace de travail », vos utilisateurs disent « compte ». Vous dites « identifiants d'authentification », ils disent « mot de passe ». La recherche sémantique comble une partie de cet écart, mais chaque étape de traduction coûte en précision.
Reprenez directement le vocabulaire des vrais e-mails de support — c'est un corpus gratuit de la façon dont vos utilisateurs formulent réellement les choses.
4. Indiquez limites et prix comme des faits, à un seul endroit
Les questions les plus risquées pour un agent IA sont celles qui portent sur des chiffres : prix, quotas, délais. Si vos tarifs apparaissent à quatre endroits avec trois valeurs différentes, l'IA finira par citer la valeur obsolète.
Conservez une section de référence unique pour les prix et les limites, et mettez-la à jour dès que quelque chose change. Partout ailleurs, renvoyez-y par un lien au lieu de la répéter.
5. Ne cachez pas les réponses dans des captures d'écran
Le texte contenu dans une image est invisible pour la récupération. Une capture de votre page de paramètres avec une flèche pointant vers le bouton d'export ne répond à rien — la phrase « Allez dans Paramètres → Données → Exporter pour télécharger vos données au format CSV » y répond pour toujours.
Les captures d'écran sont très bien pour illustrer. Assurez-vous simplement que les mots existent aussi sous forme de texte.
6. Laissez les lacunes vous dire quoi écrire ensuite
Vous ne prévoirez jamais toutes les questions à l'avance — et vous n'en avez pas besoin. Le rapport de lacunes de connaissances de Resply liste les questions auxquelles l'IA n'a pas pu répondre avec assurance, classées par fréquence.
La documentation cesse ainsi d'être un jeu de devinettes pour devenir une boucle de rétroaction : consultez les lacunes chaque semaine, écrivez une fois la réponse manquante et regardez cette question disparaître de votre boîte de réception. Vingt minutes par semaine suffisent à faire grimper continuellement le taux de résolution de l'IA.
Rien de tout cela ne nécessite un rédacteur technique. Des sections courtes, de vraies questions en guise de titres, le vocabulaire de vos utilisateurs et un coup d'œil hebdomadaire aux lacunes — c'est toute la méthode.