Übersicht

Für Agenten geeignete Inhalte

Eine Dokumentationswebsite, die ausschließlich für Menschen erstellt wurde, 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 passende Methode findet, den Dokumentbestand liest, darin navigiert und ihn verändert.

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

Was jede Schnittstelle bietet#

Schnittstelle Die Frage des Agenten Was sie bietet Was sie kostet
SKILL.md-Katalog "Wie wird diese Aufgabe richtig erledigt?" Ein Workflow mit Leitplanken, geordneten Schritten und Abnahmekriterien, abgerufen von GitHub Nichts — der Katalog ist öffentlich und find_skill wird nie abgerechnet
MCP-Server "Was kann ich für welches Projekt aufrufen?" 140 Tools hinter einem docsbook_expert-Agenten, ein instructions-Block beim Verbindungsaufbau sowie strukturierte Fehler, die den nächsten Schritt nennen Pro Aufruf zulasten des Projektguthabens abgerechnet; Erkundungsaufrufe sind kostenlos
Dokumentgraph "Wo befindet sich dieses Konzept, und worauf verweist es?" 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 aneinander übergeben#

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 Tool auswählen. Das ist Absicht: Ein Skill, der Toolnamen fest kodiert, ist in dem Moment kaputt, in dem ein Tool umbenannt wird, und der Fehler bleibt unbemerkt — der Agent wählt etwas Ähnliches aus und improvisiert eine andere Methode hinter einem identisch aussehenden Bericht.
  • Der MCP-Server teilt deinem Agenten mit, wie der Skill ausgeführt wird. Vier Tools wurden verwendet, um einen Skill auf den Rechnern von Docsbook auszuführen und eine Lauf-ID (run_docs_*) zurückzugeben; sie wurden am 12.09.2026 entfernt. docsbook_expert antwortet stattdessen mit der Methode, den Schritten und dem jeweiligen Tool, und dein eigener Agent — der das Repository bereits besitzt — führt sie aus.
  • Der Graph ist das, was die Inhaltstools lesen. search_docs, read_doc und get_doc_outline durchsuchen keine Dateien per grep; sie fragen einen RichDocGraph ab, der aus dem Markdown deines Repositorys erstellt und serverseitig zwischengespeichert wird.
  • llms.txt ist der Fallback für einen Agenten, der keines von beiden 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 sie auf der Maschine funktioniert, die sie verarbeitet Quelle
Veröffentlichen Sie die Methode als Datei, die der Agent bei Bedarf lädt, nicht als Fließtext in einer Systemaufforderung 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 über Agent Skills
Halten Sie die Tool-Oberfläche typisiert und benannt, nicht als einzelnen Endpunkt „Dokumentation erledigen“ MCP-Tools sind „so konzipiert, dass sie modellgesteuert sind“, 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 einen großen Katalog eine durchsuchbare Struktur statt einer flachen Liste Anthropic misst, dass „Claudes Fähigkeit, das richtige Tool auszuwählen, nachlässt, sobald Sie mehr als 30–50 verfügbare Tools überschreiten“ Tool-Suchwerkzeug
Geben Sie der Suche einen Graphen statt einer Ansammlung von Seiten Die Suche in langen Kontexten nimmt in der Mitte ab: Die Leistung „nimmt deutlich ab, 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 Slogans. Die Suche ü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 % als Baseline“, wenn Tools abgerufen werden, statt sie alle aufzulisten, wodurch die Prompt-Token „um über 50 %“ reduziert werden. Ein Preprint aus dem Jahr 2026, der Registries „mit 20 bis 3.251 Tools“ benchmarktestet, berichtet für die adaptive Vorauswahl eine Auswahlgenauigkeit von 93,1 % gegenüber 87,1 % bei einer festen 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 vom Guthaben des Projekts abgerechnet, und der leserorientierte KI-Chat, der das Modellbudget von Docsbook verbraucht, beginnt ab 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 Aussage über die Form, keine Rangordnung. Docsbook kann Ihnen zeigen, dass eine Seite abrufbar ist, dass ihre Abschnitte für sich stehen und dass ihre Anker aufgelöst werden. Ob ein bestimmter Assistent sie anschließend zitiert, misst dieses Produkt nicht für Sie, und keine öffentliche Quelle legt eine allgemeine Rate fest. Informationen darüber, was messbar ist, finden Sie unter GEO.
  • Die Anzahl der Tools verändert sich. 140 ist die Anzahl der Toolnamen, die dieser Build registriert. Maßgeblich ist die Anzahl, die tools/list für Ihr Token zurückgibt; der MCP-Bereich Ihres Administrationspanels liest diesen Wert live und nicht aus einer schriftlich festgehaltenen Kopie.
  • Die MCP-Spezifikation hat sich unterdessen 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 enthält 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 genannten Oberflächen ersetzt korrekte Dokumentation. Ein Agent, der einen Korpus perfekt durchsuchen kann, gibt weiterhin das wieder, was im Korpus steht.
  • GEO — von einem Assistenten zitiert werden, der sich mit nichts verbindet
  • llms.txt — die vierte Oberfläche, dokumentiert zusammen mit der SEO- und GEO-Familie
  • MCP-Tools-Referenz — jedes Tool mit seinen Parametern und seiner Abrechnungsklasse
  • Webhooks — die Push-Hälfte: benachrichtigt werden, wenn etwas passiert ist, anstatt danach zu fragen
  • KI-Chat — der Assistent, mit dem Ihre Leser sprechen und der denselben Graphen liest

Updated

War diese Seite hilfreich?