Contenu prêt pour les agents

Un site de documentation conçu uniquement pour les humains n’est qu’un mur de HTML pour tout le reste. Un agent qui y arrive doit deviner quelle page est pertinente, extraire les faits de la prose et n’a aucun moyen d’agir sur ce qu’il a lu. Docsbook publie la même documentation via quatre interfaces qu’une machine peut consommer directement — afin qu’un agent puisse trouver la méthode, lire le corpus, parcourir sa structure et la 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, que puis-je appeler, où cela se trouve-t-il et qu’est-ce qui existe, au juste.

Ce que chaque interface apporte#

Comment les surfaces se passent le relais#

Les relais relèvent 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 probants requis par une étape (« lire les chiffres avant de lire une page ») et permettent au modèle de choisir l'outil. C'est délibéré : une compétence qui encode 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 en apparence identique.
• Le serveur MCP indique à votre agent comment exécuter la compétence. Quatre outils servaient à en exécuter une sur les machines de Docsbook et renvoyaient un identifiant d'exécution (run_docs_*) ; ils ont été supprimés le 12.09.2026. docsbook_expert répond avec la méthode, les étapes et l'outil associé à chacune, tandis que votre propre agent — qui détient déjà le dépôt — les exécute.
• Le graphe est ce que lisent les outils de contenu. search_docs, read_doc et get_doc_outline ne recherchent pas les fichiers avec grep ; ils interrogent un RichDocGraph construit à partir des fichiers Markdown de votre dépôt et mis en cache côté serveur.
• llms.txt est le recours pour un agent qui ne dispose d'aucun des deux. Pas de jeton, pas de checkout, pas de client MCP — juste une requête HTTP GET sur le site publié.

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

Deux de ces règles méritent leur formulation mesurée plutôt qu’un slogan. La récupération sur un registre d’outils volumineux a fait l’objet d’une évaluation comparative 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 plutôt que tous répertoriés, ce qui réduit le nombre de jetons de l’invite 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 par rapport à une liste fixe de cinq outils (arXiv 2605.24660). Les deux travaux sont des prépublications non évaluées par les pairs ; considérez la tendance comme solidement étayée, mais les chiffres exacts comme la mesure d’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 d’outils MCP sont décomptés à l’appel du solde du projet, et le chat IA destiné aux lecteurs, qui consomme le budget de modèles de Docsbook, est disponible à partir de l’offre Pro. Les montants actuels figurent sur la page des tarifs ; cette documentation n’en cite volontairement 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 particulier la cite n’est pas mesuré par ce produit, et aucune source publique n’établit de taux général. Consultez GEO pour savoir ce qui est mesurable.
• Le nombre d’outils évolue. 140 correspond au nombre de noms d’outils enregistrés par cette version. Le nombre faisant autorité est celui que renvoie tools/list pour votre jeton ; la section MCP de votre panneau d’administration le lit en direct plutôt que depuis une copie consignée.
• La spécification MCP a évolué sans nous attendre. La révision 2026-07-28 a rendu MCP apatride et supprimé entièrement la négociation initialize — « There is no negotiation handshake » (Versioning and Compatibility). 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 place son texte d’orientation dans initialize, ce qui correspond à 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 surface présentée ici ne peut remplacer une documentation exacte. Un agent capable de parcourir parfaitement un corpus ne fait toujours que rapporter ce que dit ce corpus.

Connexe#

• 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 classe 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