Comment rendre votre documentation prête pour l'IA avec ChatGPT et Claude
Ce qui rend réellement un centre d'aide lisible par ChatGPT, Claude, Perplexity et les agents IA : HTML explorables, règles robots.txt adaptées, articles axés sur les réponses, et un regard honnête sur llms.txt et MCP.
Berkay Akpolat15 min de lecture
Mis à jour le 3 novembre 2026
Pour rendre votre documentation prête pour l'IA, commencez par les bases qui ont fait leurs preuves : les robots d'exploration IA doivent pouvoir récupérer vos pages en HTML brut, votre robots.txt doit autoriser les robots de recherche, et chaque article doit répondre clairement à une question, en précisant le plan, le rôle et les limites. Maintenez vos pages à jour, puis ajoutez des copies en Markdown, un llms.txt et un serveur MCP pour les agents IA. Ces ajouts sont peu coûteux, mais leur effet mesuré sur les réponses de l'IA est encore faible.
Ce guide est destiné aux responsables du support dont les clients demandent désormais à ChatGPT, Perplexity ou aux AI Overviews de Google comment utiliser votre produit, ainsi qu'aux équipes dont les développeurs utilisent Claude Code ou Cursor sur votre documentation. Il distingue ce qui est prouvé de ce qui reste une hypothèse.
Que signifie une documentation prête pour l'IA ?
Une documentation prête pour l'IA est une documentation que les systèmes d'IA peuvent récupérer, comprendre et citer correctement : des documents lisibles par l'IA pour les moteurs de réponse, et des documents pour les agents IA qui agissent en fonction de ceux-ci. Deux types de lecteurs comptent :
- Moteurs de réponse (recherche ChatGPT, Perplexity, Claude, Google AI Overviews et AI Mode) répondent aux questions de vos clients et citent des pages comme sources.
- Agents IA (Claude Code, Cursor, Codex, assistants personnalisés) lisent vos documents pour effectuer une tâche, souvent via des fichiers Markdown ou un serveur MCP.
Les deux connaissent une croissance rapide. L'enquête 2025 de Stack Overflow a révélé que 84 % des développeurs utilisent ou prévoient d'utiliser des outils d'IA, et Similarweb a comptabilisé 1,13 milliard de visites référentes provenant de plateformes d'IA en juin 2025, soit une hausse de 357 % par rapport à l'année précédente, dont plus de 80 % envoyées par ChatGPT. Et lorsque Google affiche un résumé généré par IA, les utilisateurs cliquent moins : Pew Research a constaté que les utilisateurs cliquaient sur un lien de résultat dans 8 % des visites avec un résumé IA, contre 15 % sans. Si la réponse est affichée sans clic, elle a intérêt à être correcte, et elle n'est aussi fiable que votre documentation. Plus de chiffres sur les endroits où les clients cherchent de l'aide sont disponibles dans nos statistiques sur le libre-service client.
Les robots d'exploration IA peuvent-ils réellement lire votre centre d'aide ?
Vérifiez ce point en premier, car rien d'autre ne compte si la réponse est non.
Le texte est-il dans le HTML ? L'analyse du trafic des robots d'exploration par Vercel en décembre 2024 a révélé qu'aucun des principaux robots d'exploration IA ne rend le JavaScript, à l'exception du robot Gemini de Google et de celui d'Apple. Un centre d'aide qui charge ses articles avec du JavaScript côté client peut sembler vide pour les robots de ChatGPT et de Claude. Testez-le :
curl -s -A "GPTBot" https://help.example.com/your-article \
| grep "a sentence from the article"Si la phrase n'est pas dans la réponse, le robot d'exploration ne la voit pas non plus. Les pages rendues côté serveur ou pré-rendues corrigent ce problème.
Vos URL fonctionnent-elles ? Dans les mêmes données de Vercel, environ 35 % des requêtes des robots d'exploration de ChatGPT et Claude aboutissent à des pages 404. Conservez les redirections lorsque vous déplacez ou renommez des articles, et maintenez votre sitemap à jour. Si vous changez de plateforme, suivez une checklist de migration de centre d'aide.
La page est-elle publique ? Les moteurs de réponse ne peuvent pas lire les pages derrière une connexion. Si vous avez des documents privés pour vos clients, acceptez que les réponses de l'IA proviendront plutôt de vos pages publiques, forums et sites tiers.
Quels robots IA votre robots.txt doit-il autoriser ?
Chaque entreprise d'IA gère des robots distincts pour l'entraînement et pour la recherche. Bloquer "tous les robots IA" vous exclut également des réponses de l'IA.
| Bot (entreprise) | Ce qu'il fait | Bloquez-le si… |
|---|---|---|
| GPTBot (OpenAI) | Collecte du contenu pour l'entraînement des modèles | Vous souhaitez refuser l'entraînement |
| OAI-SearchBot (OpenAI) | Trouve des pages pour les résultats de recherche ChatGPT | Rarement : le bloquer vous exclut des réponses de recherche ChatGPT |
| ChatGPT-User (OpenAI) | Récupère une page à la demande d'un utilisateur | Peu pratique : les requêtes utilisateur ne respectent pas toujours robots.txt |
| ClaudeBot (Anthropic) | Collecte du contenu pour l'entraînement | Vous souhaitez refuser l'entraînement |
| Claude-SearchBot, Claude-User (Anthropic) | Indexation de recherche et requêtes utilisateur | Uniquement pour quitter les réponses de recherche de Claude |
| PerplexityBot (Perplexity) | Indexe les pages pour citer des sources, pas pour l'entraînement | Uniquement pour quitter les réponses de Perplexity |
| Perplexity-User (Perplexity) | Récupère une page à la demande d'un utilisateur | Peu pratique : Perplexity ignore généralement robots.txt |
| Google-Extended (Google) | Entraînement Gemini et grounding dans les applications Gemini ; pas pour la recherche ou les AI Overviews | Vous souhaitez refuser l'entraînement et le grounding Gemini |
Les détails proviennent de la documentation de chaque entreprise : OpenAI, Anthropic et Perplexity. Un centre d'aide qui souhaite être cité mais pas utilisé pour l'entraînement peut indiquer :
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: *
Allow: /
Sitemap: https://help.example.com/sitemap.xmlUn robot qui possède son propre groupe ignore les règles *, donc répétez toutes les lignes Disallow (telles que /admin) dans chaque groupe nommé. Bloquer Google-Extended empêche également les applications Gemini d'ancrer les réponses dans vos pages ; la recherche Google et les AI Overviews ne sont pas affectées.
Vérifiez également votre CDN ou votre pare-feu. Une option "bloquer les robots IA" peut outrepasser un robots.txt permissif.
Comment rédiger des articles d'aide pour que l'IA réponde correctement ?
Les moteurs de réponse extraient un passage, pas tout votre site. Chaque passage doit se suffire à lui-même.
- Une tâche par article, formulée comme les clients la demandent. « Annuler ou suspendre votre abonnement », et non « Gestion des abonnements ».
- La réponse d'abord. Les deux premières phrases sous chaque titre doivent y répondre directement. Notre modèle d'article pour centre d'aide est conçu ainsi.
- Précisez les conditions. Quel forfait, quel rôle, quelle plateforme. « Seuls les administrateurs peuvent supprimer un espace de travail » est une information fiable ; « vous pouvez supprimer un espace de travail » génère des réponses erronées pour tous les autres.
- Dites ce que le produit ne peut pas faire. On demande souvent aux assistants « puis-je… ? ». Si votre documentation décrit uniquement ce qui existe, le modèle devinera.
- Utilisez un seul nom par élément et définissez-le une fois. Si « espace de travail », « compte » et « organisation » signifient la même chose, choisissez-en un et maintenez un glossaire court définissant les termes de votre produit.
- Donnez à chaque page des métadonnées propres. Un titre précis, une description en une ligne, une date de dernière mise à jour et, le cas échéant, le forfait ou la zone produit. Les moteurs de réponse et votre propre recherche les utilisent pour décider quelle page répond à une question.
- Ne cachez pas les étapes dans des images ou des vidéos. Donnez à chaque capture d'écran un texte alternatif réel et assurez-vous que chaque étape montrée en vidéo existe aussi sous forme de texte.
- Couvrez les bases avant les cas particuliers. Si vous construisez encore votre centre d'aide, commencez par comment créer une base de connaissances avec l'IA.
- Gardez le contenu à jour. Un article obsolète est désormais une réponse obsolète, répétée avec assurance. Notre guide pour maintenir la documentation à jour couvre une routine de publication, et comment mettre à jour automatiquement la documentation à chaque version montre comment automatiser cela dès la sortie de la version.
Google dit la même chose en termes plus simples : pour ses fonctionnalités IA, "il n'y a pas d'exigences supplémentaires" et aucune optimisation spéciale n'est nécessaire au-delà du SEO normal. Son guide indique également qu'il n'y a aucune exigence de diviser votre contenu en petits morceaux pour l'IA, alors ne découpez pas les articles en fragments pour satisfaire un modèle.
Faut-il ajouter llms.txt pour la documentation ?
Cela aide moins que ce que suggèrent les fournisseurs. llms.txt est un fichier Markdown à la racine de votre site qui répertorie vos pages les plus utiles avec de courtes descriptions. Jeremy Howard l'a proposé en septembre 2024 comme une carte pour les modèles de langage.
Les preuves jusqu'à présent :
- Google l'ignore. Le guide de Google indique que vous n'avez pas besoin de nouveaux fichiers lisibles par machine, fichiers texte IA, balisage ou Markdown pour apparaître dans la recherche Google, et que les fichiers llms.txt n'aideront ni ne nuiront car la recherche les ignore. En 2025, John Mueller de Google a comparé llms.txt à la balise meta keywords.
- Peu de robots le demandent. Ahrefs a étudié 137 210 domaines et a constaté que 97 % des fichiers llms.txt ont reçu zéro demande en mai 2026. Les robots de récupération IA ont effectué seulement 1,1 % des demandes reçues (les assistants IA 2,5 % supplémentaires) ; les agents de codage tels que Claude Code figuraient parmi les principaux lecteurs nommés.
Donc : ajoutez un llms.txt si votre plateforme de documentation le permet gratuitement, surtout si les développeurs utilisent vos documents avec des agents de codage, mais ne vous attendez pas à ce que cela change ce que ChatGPT dit de vous. llms-full.txt (toutes les pages dans un seul fichier) est une convention courante, pas une partie de la proposition.
Vos documents doivent-ils être disponibles en Markdown ?
Oui, si cela ne vous coûte rien. Les agents qui parcourent une page fonctionnent mieux avec du Markdown propre qu'avec du HTML rempli de navigation et de scripts, et la proposition llms.txt suggère de servir chaque page à la même URL avec .md ajouté. Trois détails :
- Marquez les copies Markdown avec
noindex(un en-têteX-Robots-Tagfonctionne), afin que les moteurs de recherche ne les traitent pas comme des doublons des pages HTML. - Gardez-les générées à partir de la même source que le HTML, pour qu'elles ne divergent jamais.
- Laissez les agents les trouver : la proposition suggère une balise
<link rel="alternate" type="text/markdown">sur chaque page HTML.
Comment les agents IA utilisent-ils la documentation via MCP ?
Le Model Context Protocol est un standard ouvert qui permet à une application IA d'appeler des outils et de lire des données provenant d'autres systèmes. Un serveur MCP de documentation permet à un agent de rechercher dans vos documents à la demande au lieu de se fier à ce qu'il a appris lors de son entraînement et, avec les bonnes autorisations, de rédiger ou de mettre à jour des pages. Pour une comparaison des serveurs disponibles, consultez Serveurs MCP pour la documentation.
Les mêmes règles s'appliquent si vous créez votre propre assistant sur votre documentation (génération augmentée par récupération, ou RAG) : il ne peut être aussi précis que les passages qu'il récupère. Deux mises en garde : donnez un accès en lecture seule à tout ce qui est destiné aux clients, sauf si une personne révise les écrits, et rappelez-vous que MCP aide les agents que vos utilisateurs connectent eux-mêmes. Cela ne change pas ce que disent les moteurs de réponse publics.
Comment tester ce que les assistants IA disent de votre produit ?
Personne ne peut voir à l'intérieur des modèles, alors testez le résultat. Une fois par mois :
- Notez 20 questions réelles de clients issues de tickets et de recherches infructueuses dans le centre d'aide.
- Posez chacune d'elles dans ChatGPT, Perplexity, Claude et Google (mode IA ou aperçus IA).
- Notez si la réponse est correcte et quelle page elle cite.
| Question (assistant) | Ce qu'il a dit (source citée) | Correctif |
|---|---|---|
| Comment exporter des factures en CSV ? (ChatGPT) | Partiellement correct : un ancien chemin de menu (un post de forum de 2024) | Mettez à jour l'article d'exportation ; placez le nouveau chemin dans son premier paragraphe |
| Puis-je suspendre mon abonnement ? (Perplexity) | Faux : dit que ce n'est pas possible (aucune source) | Ajoutez un article « Suspendre ou annuler » qui précise les limites du forfait |
- Corrigez l'article d'où chaque mauvaise réponse aurait dû provenir, puis reposez la question le mois suivant.
Pour voir le côté trafic, segmentez les visites par référent (chatgpt.com, perplexity.ai, claude.ai) et vérifiez vos logs serveur pour les noms de bots dans le tableau ci-dessus (à l'exception de Google-Extended, qui n'a pas son propre agent utilisateur). Google compte les clics provenant des fonctionnalités IA dans le rapport de performance de la Search Console, sous le type de recherche Web.
Comment rendre la documentation prête pour l'IA : la liste de contrôle
| Priorité | Tâche | Preuve |
|---|---|---|
| 1 | Texte de l'article présent dans le HTML sans JavaScript | Forte : les principaux crawlers IA ne rendent pas le JS |
| 2 | robots.txt et pare-feu autorisent les bots de recherche (bots d'entraînement optionnels) | Forte : documenté par chaque entreprise d'IA |
| 3 | Une tâche par article, réponse en premier, plan et rôle énoncés | Bonne : correspond aux conseils de Google |
| 4 | Contenu mis à jour à chaque version ; pas de 404 | Bonne : les pages obsolètes produisent de mauvaises réponses |
| 5 | Sitemap à jour | Bonne : découverte standard |
| 6 | Copie Markdown de chaque page, noindexed | Modérée : utilisée par les agents de codage |
| 7 | llms.txt | Faible pour l'instant : peu de requêtes, Google l'ignore |
| 8 | Serveur MCP pour les agents | Utile pour les utilisateurs d'agents ; aucun effet sur les réponses publiques |
| Toujours | Test mensuel de 20 questions réelles | Votre propre preuve |
Comment les centres d'aide Clevera sont conçus pour les lecteurs IA
Clevera est une plateforme IA qui transforme un enregistrement d'écran en une vidéo explicative narrée, un article d'aide étape par étape et une page sur votre centre d'aide hébergé, en 74 langues. Ses centres d'aide hébergés gèrent la majeure partie de la moitié technique de la liste de contrôle, sur tous les plans, y compris le plan Gratuit :
- Pages pré-rendues et sitemap, pour que le texte de l'article soit dans le HTML récupéré par les crawlers.
llms.txt,llms-full.txtet une copie.mdde chaque page, sous le paramètre llms.txt et copies Markdown ("Permet aux outils IA de lire vos docs"), qui est activé par défaut. Sur notre propre centre d'aide, les copies Markdown sont servies avecnoindex. Les centres d'aide privés (Pro et plus) gardent tout cela derrière la connexion.- Demandez à l'IA pour vos lecteurs (activez Afficher l'assistant dans Paramètres → Assistant IA ; 300 réponses par mois sur le plan Gratuit). L'assistant intégré répond uniquement à partir de vos pages publiées, lie ses sources, indique quand les documents ne couvrent pas une question et liste ces questions sous Questions sans réponse pour que vous sachiez quoi écrire ensuite (notre guide sur les lacunes de contenu du centre d'aide montre comment les traiter).
- Agents IA et MCP (Pro et plus). Claude Code, Codex, Cursor, Claude ou ChatGPT peuvent rechercher, rédiger et, avec des droits de publication, mettre à jour votre centre d'aide via le serveur MCP et l'API de Clevera. Un jeton Assistant de support ne peut rechercher que les pages publiées et publiques.
Ceci est le haut du llms.txt que notre propre centre d'aide publie (raccourci) :
# Clevera Help Center
> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...
Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.
### Getting started
- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...
La partie rédaction vous appartient toujours, et Clevera aide aussi à ce niveau : les articles générés à partir d'un enregistrement d'écran apparaissent sous forme d'étapes numérotées avec des captures d'écran de ce qui est à l'écran, et l'enregistrement derrière une vidéo peut également produire son article écrit, afin que les étapes ne vivent pas seulement dans une vidéo. Aucune plateforme ne peut promettre que ChatGPT vous citera, et nous non plus.
Commencez gratuitement avec un centre d'aide hébergé, ou importez votre centre actuel depuis Zendesk, Intercom, GitBook et d'autres plateformes. Les paramètres se trouvent dans Contrôler qui peut lire un site de documentation, Configurer l'assistant du site de documentation et Connecter des agents IA à vos sites de documentation. L'aperçu du produit se trouve sur la page logiciel de centre d'aide et dans notre post de lancement des sites de documentation.
FAQ
Le llms.txt vaut-il la peine d'être ajouté à un centre d'aide ?
Ajoutez-le si votre plateforme le génère gratuitement. Cela ne coûte rien et les agents de codage le lisent, mais Google ne l'utilise pas et les études montrent presque aucune requête de la part des bots de recherche IA. Le HTML explorable et des articles clairs et actuels comptent bien plus.
Comment faire en sorte que ChatGPT réponde correctement aux questions sur mon produit ?
Assurez-vous que OAI-SearchBot peut explorer votre centre d'aide public, que le texte de l'article est dans le HTML et que chaque article répond à une question avec les conditions énoncées. Ensuite, testez les questions réelles des clients chaque mois et corrigez les pages derrière les mauvaises réponses. Cela améliore les chances ; personne ne peut forcer ChatGPT à vous citer.
Dois-je bloquer GPTBot et ClaudeBot ?
C'est une décision d'entraînement, pas de visibilité. Bloquer GPTBot et ClaudeBot empêche vos documents d'être utilisés pour l'entraînement des modèles ; cela ne vous supprime pas de la recherche ChatGPT ou Claude, qui utilisent OAI-SearchBot et Claude-SearchBot. Ne les bloquez pas si vous voulez être cité.
Les données structurées aident-elles les aperçus IA ?
Google affirme qu'aucun schéma spécial n'est nécessaire pour les fonctionnalités IA. Utilisez des données structurées là où elles décrivent un contenu visible, comme vous le feriez pour une recherche normale.
Quelle est la différence entre des documents prêts pour l'IA et un chatbot IA sur mon centre d'aide ?
Les documents prêts pour l'IA aident les assistants externes à répondre à partir de vos pages. Un chatbot de centre d'aide, tel que l'assistant IA de Clevera, répond à vos lecteurs sur votre propre site à partir des mêmes pages. Les deux dépendent d'articles clairs et actuels.
