Docsbook
Übersicht

Agent-fähige Inhalte

Eine ausschließlich für Menschen erstellte Dokumentationswebsite ist für alles andere eine Wand aus HTML. Ein darauf zugreifender Agent muss erraten, welche Seite relevant ist, Fließtext nach Fakten durchsuchen und hat keine Möglichkeit, auf Grundlage des Gelesenen zu handeln. Docsbook veröffentlicht dieselbe Dokumentation über vier Oberflächen, die eine Maschine direkt nutzen kann – damit ein Agent die Methode finden, den Korpus lesen, seine Struktur navigieren und ihn ändern kann.

Die vier sind keine Alternativen. Sie beantworten vier verschiedene Fragen, die ein Agent der Reihe nach stellt: wie wird diese Aufgabe erledigt, was kann ich aufrufen, wo befindet sich das und was gibt es überhaupt.

Was jede Oberfläche bietet#

Oberfläche Die Frage des Agenten Was sie bietet Was sie kostet
SKILL.md-Katalog „Wie wird diese Aufgabe ordnungsgemäß erledigt?“ Ein Workflow mit Leitplanken, geordneten Schritten und Akzeptanzkriterien, abgerufen von GitHub Nichts — der Katalog ist öffentlich und find_skill wird nie abgerechnet
MCP-Server „Was kann ich für welches Projekt aufrufen?“ 310 Tools, ein instructions-Block beim Verbindungsaufbau, strukturierte Fehler, die den nächsten Schritt nennen Pro Aufruf über das Guthaben des Projekts abgerechnet; Discovery-Aufrufe sind kostenlos
Dokumentgraph „Wo befindet sich dieses Konzept, und was verweist darauf?“ Seiten und Überschriften als separate Knotennamensräume, vier Arten von Kanten, fehlerhafte Links und Ankerkollisionen In jedem Tarif kostenlos — er wird aus deinem eigenen Markdown erstellt
llms.txt „Was gibt es überhaupt auf dieser Website?“ Ein flacher, abrufbarer Index jeder veröffentlichten Seite, ohne Authentifizierung Kostenlos und ohne Docsbook-Konto lesbar

Wie die Oberflächen ineinandergreifen#

Die Übergaben sind das Design, kein Zufall.

  • Ein Skill benennt einen Bedarf, der MCP-Server beantwortet ihn. Die Skills von Docsbook geben an, welche Belege ein Schritt erfordert („die Zahlen lesen, bevor eine Seite gelesen wird“), und lassen das Modell das Werkzeug auswählen. Das ist beabsichtigt: Ein Skill, der Werkzeugnamen fest einprogrammiert, funktioniert in dem Moment nicht mehr, in dem ein Werkzeug umbenannt wird, und der Fehler bleibt unbemerkt — der Agent wählt etwas Ähnliches aus und improvisiert eine andere Methode hinter einem Bericht, der identisch aussieht.
  • Der MCP-Server kann den Skill für Sie ausführen. run_docs_analyze, run_docs_create, run_docs_manage und run_docs_automate führen einen der vier Orchestrator-Skills auf den Rechnern von Docsbook für Ihren Arbeitsbereich aus und geben statt eines Ergebnisses eine Lauf-ID zurück.
  • Der Graph ist das, was die Inhaltswerkzeuge lesen. search_docs, read_doc und get_doc_outline durchsuchen keine Dateien mit grep; sie fragen einen RichDocGraph ab, der aus dem Markdown Ihres Repositorys erstellt und serverseitig zwischengespeichert wird.
  • llms.txt ist der Fallback für einen Agenten, der keines von beidem hat. Kein Token, kein Checkout, kein MCP-Client — nur ein HTTP-GET über die veröffentlichte Website.

Warum dies der richtige Weg ist (Belege)#

Regel Warum dies auf der Maschine funktioniert, die es verarbeitet Quelle
Veröffentlichen Sie die Methode als Datei, die der Agent bei Bedarf lädt, nicht als Prosa in einem System-Prompt Das Agent-Skills-Design von Anthropic lädt einen Skill stufenweise – „bis ein Skill ausgelöst wird, belegen nur sein Name und seine Beschreibung Kontext“ Übersicht zu Agent Skills
Halten Sie die Tool-Oberfläche typisiert und benannt, statt einen einzigen Endpunkt „Dokumentation ausführen“ bereitzustellen MCP-Tools sind „dafür konzipiert, modellgesteuert zu sein“, und werden vom Modell aus tools/list entdeckt und aufgerufen MCP-Spezifikation 2026-07-28, Tools
Laden Sie nicht alles auf einmal in das Kontextfenster „Kontext muss daher als endliche Ressource mit abnehmendem Grenznutzen behandelt werden“ Effektives Kontext-Engineering
Geben Sie einem Modell für eine große Katalogstruktur eine durchsuchbare Struktur statt einer flachen Liste Anthropic misst, dass „Claudes Fähigkeit, das richtige Tool auszuwählen, abnimmt, sobald mehr als 30–50 verfügbare Tools vorhanden sind“ Tool-Suchfunktion
Geben Sie der Suche einen Graphen statt einer Ansammlung von Seiten Der Abruf in langen Kontexten verschlechtert sich in der Mitte: Die Leistung „verschlechtert sich deutlich, wenn Modelle relevante Informationen in der Mitte langer Kontexte abrufen müssen“ (Liu et al., TACL 2024) In der Mitte verloren

Zwei davon verdienen ihre gemessene Form statt eines Schlagworts. Der Abruf über eine große Tool-Registry wurde unabhängig benchmarkgetestet: RAG-MCP (arXiv-Preprint 2505.03275, Gan und Sun, Mai 2025) berichtet eine Genauigkeit bei der Tool-Auswahl von „43,13 % gegenüber 13,62 % im Baseline-Szenario“, wenn Tools abgerufen werden, anstatt alle aufzulisten, und reduziert die Prompt-Token „um über 50 %“. Ein Preprint aus dem Jahr 2026, der Registries „mit 20 bis 3.251 Tools“ benchmarktestet, berichtet bei der adaptiven Vorauswahl eine Auswahlgenauigkeit von 93,1 % gegenüber 87,1 % für eine feste Vorauswahl von fünf Tools (arXiv 2605.24660). Beide sind nicht begutachtete Preprints; betrachten Sie die Richtung als gut belegt und die genauen Zahlen als Messung eines einzelnen Teams.

Grenzen und offene Fragen#

  • Die vier Oberflächen kosten nicht alle gleich viel. Der Skills-Katalog, der Graph und llms.txt sind in jedem Tarif kostenlos. MCP-Tool-Aufrufe werden pro Aufruf gegen das Guthaben des Projekts abgerechnet, und die beiden Funktionen, die das Modellbudget von Docsbook beanspruchen — Agent-Ausführungen (run_docs_*, agent_*) und der leserorientierte KI-Chat — beginnen mit Pro. Die aktuellen Beträge finden Sie auf der Preisseite; in dieser Dokumentation werden bewusst keine Beträge genannt, da ein in eine Seite kopierter Preis unbemerkt veraltet.
  • „Agent-ready“ ist eine Formaussage, keine Ranglistenaussage. Docsbook kann Ihnen zeigen, dass eine Seite abrufbar ist, dass ihre Abschnitte eigenständig bestehen und dass ihre Anker aufgelöst werden können. Ob ein bestimmter Assistent sie anschließend zitiert, misst dieses Produkt nicht für Sie, und keine öffentliche Quelle belegt eine allgemeine Rate. Informationen darüber, was messbar ist, finden Sie unter GEO.
  • Die Anzahl der Tools ändert sich. 310 ist die Anzahl der Toolnamen, die dieser Build registriert. Die maßgebliche Anzahl ist das, was tools/list für Ihr Token zurückgibt; der MCP-Bereich Ihres Admin-Panels liest diesen Wert live aus, statt eine niedergeschriebene Kopie zu verwenden.
  • Die MCP-Spezifikation hat sich weiterentwickelt. Revision 2026-07-28 machte MCP zustandslos und entfernte den initialize-Handshake vollständig — „Es gibt keinen Aushandlungs-Handshake“ (Versionierung und Kompatibilität). Der Server von Docsbook wird über einen zustandslosen HTTP-Transport bereitgestellt, spricht aber weiterhin die initialisierungsbasierten Revisionen, die sein SDK unterstützt — aktuell 2025-11-25 — und führt seinen Orientierungstext in initialize, was eine Platzierung vor 2026-07-28 darstellt. Ein Client, der ausschließlich 2026-07-28 spricht, wird keine Verbindung herstellen. Die übrige Liste der Lücken finden Sie unter Sicherheit des MCP-Servers.
  • Keine der hier beschriebenen Oberflächen ist ein Ersatz dafür, dass die Dokumentation korrekt ist. Ein Agent, der einen Korpus perfekt navigieren kann, gibt weiterhin das wieder, was im Korpus steht.
  • GEO — von einem Assistenten zitiert werden, der niemals eine Verbindung zu irgendetwas herstellt
  • llms.txt — die vierte Oberfläche, dokumentiert zusammen mit der SEO- und GEO-Familie
  • Referenz der MCP-Tools — jedes Tool mit seinen Parametern und seiner Abrechnungsklasse
  • Webhooks — die Push-Hälfte: benachrichtigt werden, wenn etwas passiert ist, statt danach zu fragen
  • KI-Chat — der Assistent, mit dem Ihre Leser sprechen und der denselben Graphen liest

Updated

War diese Seite hilfreich?