Contenu prêt pour les agents

Un site de documentation conçu uniquement pour les humains est un mur de HTML pour tout le reste. Un agent qui y arrive doit deviner quelle page est pertinente, parcourir la prose pour en extraire les faits et n'a aucun moyen d'agir sur ce qu'il a lu. Docsbook publie la même documentation à travers quatre interfaces qu'une machine peut consommer directement — afin qu'un agent puisse trouver la méthode, lire le corpus, parcourir sa structure et le modifier.

Ces quatre interfaces ne sont pas des alternatives. Elles répondent à quatre questions différentes qu'un agent pose successivement : comment effectuer cette tâche, quelles fonctions puis-je appeler, où cela se trouve-t-il et qu'est-ce qui existe au juste.

Ce que chaque surface apporte#

Comment les surfaces se transmettent le relais#

Les transmissions sont le fruit de la conception, pas du hasard.

• Une compétence nomme un besoin, le serveur MCP y répond. Les compétences de Docsbook indiquent les éléments de preuve requis par une étape (« lire les chiffres avant de lire une page ») et permettent au modèle de choisir l'outil. C'est intentionnel : une compétence qui code en dur les noms des outils cesse de fonctionner dès qu'un outil est renommé, et l'échec est silencieux — l'agent choisit quelque chose d'approchant et improvise une autre méthode derrière un rapport à l'apparence identique.
• Le serveur MCP peut exécuter la compétence à votre place. run_docs_analyze, run_docs_create, run_docs_manage et run_docs_automate exécutent l'une des quatre compétences d'orchestration sur les machines de Docsbook, à partir de votre espace de travail, et renvoient un identifiant d'exécution plutôt qu'un résultat.
• Le graphe est ce que les outils de contenu lisent. search_docs, read_doc et get_doc_outline ne recherchent pas dans les fichiers ; ils interrogent un RichDocGraph construit à partir du markdown de votre dépôt et mis en cache côté serveur.
• llms.txt est la solution de secours pour un agent qui ne dispose d'aucun des deux. Aucun jeton, aucun clone local, aucun client MCP — simplement une requête HTTP GET sur le site publié.

Pourquoi c’est la bonne méthode (preuves)#

Deux de ces points méritent leur forme mesurée plutôt qu’un slogan. La récupération sur un registre d’outils volumineux a fait l’objet d’une évaluation indépendante : RAG-MCP (prépublication arXiv 2505.03275, Gan et Sun, mai 2025) fait état d’une précision de sélection des outils de « 43,13 % contre 13,62 % pour la référence » lorsque les outils sont récupérés au lieu d’être tous listés, ce qui réduit les tokens du prompt « de plus de 50 % ». Une prépublication de 2026 évaluant des registres « allant de 20 à 3 251 outils » fait état d’une précision de sélection de 93,1 %, contre 87,1 %, pour une présélection adaptative comparée à une présélection fixe de cinq outils (arXiv 2605.24660). Les deux documents sont des prépublications non évaluées par les pairs ; considérez que la tendance est solidement étayée, mais que les chiffres exacts correspondent à la mesure effectuée par une seule équipe.

Limites et questions ouvertes#

• Les quatre surfaces n’ont pas toutes le même coût. Le catalogue de compétences, le graphe et llms.txt sont gratuits avec tous les forfaits. Les appels aux outils MCP sont décomptés à chaque appel du solde du projet, et les deux fonctionnalités qui utilisent le budget de modèles de Docsbook — les exécutions d’agent (run_docs_*, agent_*) et le chat IA destiné aux lecteurs — sont disponibles à partir de l’offre Pro. Les montants actuels figurent sur la page des tarifs ; cette documentation n’en cite délibérément aucun, car un prix copié dans une page devient obsolète sans avertissement.
• « Prêt pour les agents » décrit une structure, pas un classement. Docsbook peut vous montrer qu’une page peut être récupérée, que ses sections sont autonomes et que ses ancres fonctionnent. En revanche, le fait qu’un assistant donné la cite ensuite ne fait pas partie des mesures effectuées par ce produit, et aucune source publique n’établit de taux général. Consultez GEO pour connaître les éléments mesurables.
• Le nombre d’outils évolue. 310 est le nombre de noms d’outils enregistrés par cette version. Le nombre faisant autorité est celui renvoyé par tools/list pour votre jeton ; la section MCP de votre panneau d’administration le lit en temps réel plutôt que depuis une copie consignée par écrit.
• La spécification MCP a évolué sous nos yeux. La révision 2026-07-28 a rendu MCP apatride et supprimé entièrement la négociation initialize — « Il n’y a pas de négociation » (Gestion des versions et compatibilité). Le serveur de Docsbook est fourni via un transport HTTP apatride, mais parle toujours les révisions fondées sur l’initialisation prises en charge par son SDK — la plus récente étant 2025-11-25 — et contient son texte d’orientation dans initialize, qui constitue un emplacement antérieur à 2026-07-28. Un client qui ne parle que 2026-07-28 ne se connectera pas. Consultez Sécurité du serveur MCP pour le reste de la liste des écarts.
• Aucune des surfaces présentées ici ne remplace une documentation exacte. Un agent capable de parcourir parfaitement un corpus rapporte malgré tout ce que dit ce corpus.

Associées#

• GEO — être cité par un assistant qui ne se connecte jamais à quoi que ce soit
• llms.txt — la quatrième surface, documentée avec la famille SEO et GEO
• Référence des outils MCP — chaque outil avec ses paramètres et sa catégorie de facturation
• Webhooks — la moitié push : être informé lorsqu'un événement s'est produit, plutôt que de le demander
• Chat IA — l'assistant avec lequel vos lecteurs discutent, qui lit le même graphe