> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/ia-et-recherche/llm-ready-docs.md). # Docs prêtes pour les LLM Nous développons des fonctionnalités qui facilitent l’ingestion et l’utilisation de votre contenu de documentation par les grands modèles de langage (LLM). À mesure que les LLM deviennent de plus en plus importants pour la recherche d’information et l’assistance aux connaissances, faire en sorte que votre documentation soit adaptée aux LLM peut améliorer considérablement la manière dont ces modèles comprennent et représentent vos produits ou services. Une documentation optimisée pour les LLM permet à des systèmes d’IA comme ChatGPT, Claude, Cursor et Copilot de récupérer et de fournir des réponses précises et contextuelles sur votre produit ou votre API. ## pages .md Avec GitBook, toutes les pages de votre site de documentation sont automatiquement disponibles sous forme de fichiers markdown. Si vous ajoutez l’ `.md` extension à n’importe quelle page, vous verrez le contenu de cette page rendu en markdown, que vous pouvez transmettre à un LLM pour un traitement plus efficace qu’un fichier HTML. Consultez le fichier .md de cette page ## llms.txt [llms.txt](https://llmstxt.org/) est une norme proposée pour rendre le contenu web disponible dans des formats textuels plus faciles à traiter pour les LLM. Vous pouvez accéder à la `llms.txt` page en ajoutant `/llms.txt` à l’URL racine de votre site de documentation. La `llms.txt` Le fichier sert d’index pour votre site de documentation, fournissant une liste complète de toutes les pages disponibles au format markdown. Avec ce fichier, vous facilitez la découverte et le traitement efficaces de votre contenu de documentation par les LLM. Consultez le /llms.txt pour la documentation GitBook ## llms-full.txt Là où le `llms.txt` fichier contient un index de toutes les URL et de tous les titres des pages de votre site de documentation, le `llms-full.txt` contient le contenu complet de votre site de documentation dans un seul fichier pouvant être transmis aux LLM comme contexte. Les pages masquées sont incluses dans `llms-full.txt`. Masquer une page la supprime uniquement de la table des matières publiée. Consultez le fichier /llms-full.txt pour la documentation GitBook Les LLM peuvent utiliser cet index pour accéder directement aux versions markdown de vos pages, ce qui leur permet d’intégrer votre documentation dans leur contexte sans avoir à analyser le HTML. ## Serveur MCP pour la documentation publiée GitBook expose automatiquement un serveur Model Context Protocol (MCP) pour chaque site publié. MCP offre aux outils d’IA un moyen structuré de découvrir et de récupérer votre documentation sous forme de ressources — sans scraping. Les pages masquées restent accessibles via le serveur MCP du site. Masquer une page la supprime uniquement de la table des matières publiée. Votre serveur MCP peut être atteint en ajoutant `/~gitbook/mcp` à l’URL racine de votre site de documentation. Par exemple, le serveur MCP de la documentation GitBook se trouve à `https://gitbook.com/docs/~gitbook/mcp`. {% hint style="info" %} Ouvrir cette URL dans votre navigateur provoquera une erreur. Vous pouvez plutôt la partager avec des outils capables d’effectuer des requêtes HTTP, comme les LLM ou les IDE. {% endhint %} Pour en savoir plus, consultez [Serveurs MCP pour les docs publiées](/docs/documentation/fr/ia-et-recherche/mcp-servers-for-published-docs.md). ## Conseils pour optimiser votre documentation pour les LLM Maintenant que votre site GitBook génère automatiquement `.md` des pages, `llms.txt`, et `llms-full.txt` des fichiers, ces bonnes pratiques aideront les LLM à comprendre et à exploiter efficacement votre contenu. En utilisant ces optimisations, vous pouvez également améliorer les performances de votre documentation dans les moteurs de recherche alimentés par l’IA et l’optimisation des moteurs génératifs (GEO). Le plus intéressant ? Ces directives rendront généralement aussi votre documentation plus facile à lire pour les personnes. ### Utilisez une structure claire et hiérarchique Aérez votre contenu avec de bons titres (H1, H2, H3) et n’écrivez pas seulement d’énormes blocs de texte. Les listes à puces, les listes numérotées et les paragraphes plus courts rendent tout plus facile à lire. ### Rédigez un contenu concis, sans jargon Restez simple et évitez les termes techniques complexes, sauf si vous en avez vraiment besoin. Les LLM s’en sortent bien mieux quand vous dites ce que vous voulez dire sans ajouter de remplissage. ### Incluez des exemples pratiques Montrez, ne vous contentez pas d’expliquer. Des extraits de code, des exemples d’API et des scénarios réels aident les LLM — et vos utilisateurs — à comprendre comment les choses fonctionnent réellement en pratique. ### Gardez un contenu à jour et exact Personne n’aime la documentation obsolète. Des mises à jour régulières signifient que les LLM ne donneront pas de mauvaises informations sur vos dernières fonctionnalités et nouveautés. ### Testez avec des outils d’IA Essayez réellement de poser des questions sur votre documentation à ChatGPT ou Claude pour voir à quel point ils comprennent bien votre contenu. Vous pourriez être surpris par ce qui fonctionne et ce qui ne fonctionne pas. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/ia-et-recherche/llm-ready-docs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.