AI-Chat
Docsbook AI-Chat ist ein Chat-Widget auf Ihrer Dokumentationsseite, das aus dem Inhalt dieser Dokumentation antwortet, nicht aus dem Gedächtnis des Modells. Ein Leser stellt eine Frage, der Assistent durchsucht Ihre Seiten, öffnet die relevanten und streamt eine Antwort zurück, die die verwendeten Seiten zitiert.
Wie beantwortet Docsbook AI Chat eine Frage?#
Docsbook AI Chat antwortet mit einem retrieval-augmented generation (RAG) Fluss, der auf Toolaufrufen basiert. Das Modell entscheidet, wann es jedes Tool aufruft, und das Widget zeigt die Live-Verfolgung jedes Schrittes, sodass der Leser sehen kann, von welcher Seite die Antwort stammt.
- Suche — der Assistent durchsucht Ihre Dokumentation nach relevanten Abschnitten.
- Lesen — er öffnet spezifische Seiten und zitiert den benötigten Text.
- Antwort — er formuliert die Antwort und streamt sie an den Leser über
streamdown.
Jeder Aufruf wird protokolliert, sodass Sie später überprüfen können, was gefragt wurde, was abgerufen wurde und ob der Leser die Antwort nützlich fand. Da der Assistent aus Ihren indizierten Seiten antwortet, erhält ein Leser, der sonst ein Support-Ticket eröffnet hätte, die Antwort auf der Seite — und eine Frage, die der Assistent nicht beantworten konnte, wird als dokumentierte Lücke angezeigt, anstatt als E-Mail.
Was kostet es, Docsbook AI Chat zu betreiben?#
Jede Antwort, die Docsbook AI Chat streamt, basiert auf dem Guthaben des Projekts, für das sie gegeben wurde. Nichts anderes im Chat wird gemessen: das Hosting des Widgets, das Bereitstellen der Seite und die Suche des Lesers werden nicht erfasst.
Drei Dinge im Chat verbrauchen das Guthaben, und das sind die drei, die ein Modell aufrufen:
- Eine Antwort an einen Leser.
- Erstellung oder Neubau des semantischen Index.
- Ein Agentenlauf, der aus dem Chat gestartet wurde.
Die aktuellen Preise und was ein Plan beinhaltet, finden Sie auf der Docsbook-Preisseite — sie wird aus den aktuellen Abrechnungswerten bei jeder Anfrage generiert, sodass sie die einzige Zahl ist, die es wert ist, zitiert zu werden. Wenn das Guthaben eines Projekts aufgebraucht ist, pausiert der AI-Chat, anstatt Ihnen weitere Kosten zu berechnen, und das Widget zeigt dies an.
Semantische Suche#
Die semantische Suche ersetzt die Schlüsselwortsuche in Schritt 1 durch bedeutungsbasierte Abrufe: Jeder Abschnitt Ihrer Dokumentation wird einmal eingebettet, und Docsbook AI Chat findet dann den richtigen Abschnitt, selbst wenn die Formulierung des Lesers nicht mit der Formulierung auf der Seite übereinstimmt. Ein Leser, der fragt: "Warum ist meine Seite nach einem Push leer", gelangt zur Seite über den Build-Fehler, die niemals das Wort "leer" verwendet.
Aktivieren Sie es im Float Widget → AI Chat Tab → Semantische Suche. Die Karte ist der Ort, an dem Sie es bedienen:
- Der Schalter — aktivieren oder deaktivieren Sie den bedeutungsbasierten Abruf für den Chat.
- Echtzeit-Synchronisierung — sobald der Index existiert, wird er bei jedem Commit Ihrer Dokumente neu synchronisiert, sodass Sie nicht daran denken müssen, ihn neu zu erstellen.
- Zuletzt aktualisiert — ob der Index Ihren aktuellen Inhalt widerspiegelt.
- Erstellen / Neu erstellen — zeigt eine Kostenschätzung an, bevor es ausgeführt wird, den Live-Fortschritt, den Sie abbrechen können, und die Tokens und Kosten nach einem Durchlauf.
Der Aufbau des Index ruft ein Einbettungsmodell über Ihr gesamtes Korpus auf, weshalb die Schätzung vor dem Durchlauf und nicht danach angezeigt wird. Sie können die Ausgaben pro Quelle begrenzen — siehe das Semantische Index Limit in Premium-Plänen.
Anpassung#
Sie steuern, wie der Chatbot sich verhält, ohne Backend-Code zu schreiben:
- Vorgeschlagene Fragen — füllen Sie den leeren Zustand mit 3–5 Startaufforderungen. Dies sind die wirkungsvollsten Texte im Widget: Sie sagen dem Leser, wofür der Assistent gedacht ist.
- Systemaufforderung — ersetzen Sie das standardmäßige Set an Anweisungen durch Ihre eigene Stimme und Regeln.
- Pre/Post-LLM-Hooks — transformieren Sie die Aufforderung, bevor das Modell sie sieht, und verarbeiten Sie die Antwort, bevor der Leser sie sieht. Siehe Chat Hooks.
Welches Modell führt den Chat aus?#
Docsbook führt den Chat standardmäßig über OpenRouter aus, auf openai/gpt-4o-mini, und Sie wählen ein anderes Modell in den Arbeitseinstellungen. Der Anbieter kann einer der folgenden sein:
providers:
- openrouter
- openai
- gemini
- anthropicEs gibt zwei Modelleinstellungen unter Einstellungen ▸ Chat, da zwei verschiedene Modelle im Einsatz sind:
- AI Visitors Chat Modell — was Ihren Lesern im Docs-Chat antwortet.
- Admin & AI Agent Modell — was den Assistenten in Ihrem Dashboard steuert: derjenige, der Ihre Analysen liest, Tools aufruft und Ihre Dokumente bearbeitet.
Jede Einstellung listet ihre eigenen Modelle mit dem Preis pro 1M Tokens daneben auf, sodass ein günstiger Leser-Chat und ein stärkerer Admin-Assistent — oder umgekehrt — jeweils eine Wahl ist. Ein günstigeres Modell lässt das gleiche Budget weiter reichen. Übersetzungen haben eine eigene Modelleinstellung unter Einstellungen ▸ Übersetzungen.
Sie können auch Ihren eigenen Anbieter-API-Schlüssel aus den Arbeitseinstellungen mitbringen. Die Nutzung erfolgt dann zu Ihrem Schlüssel zum eigenen Preis des Anbieters und wird nicht von Ihrem Docsbook-Guthaben abgezogen.
Multiplayer-Chat#
Drücken Sie Einladen in der Symbolleiste des Chats, um einen Teamkollegen in dieselbe Live-Sitzung zu bringen. Dokumentationsfragen sind selten Einzelarbeit: Jemand fragt, jemand anderes kennt die halbe Antwort, und das Ergebnis wird in Slack eingefügt, wo es niemand wiederfindet.
- Sehen Sie, wer hier ist. Der Button zeigt, wer von Ihrem Team derzeit in diesem Chat ist.
- Einladung per E-Mail. Die Einladung funktioniert, unabhängig davon, ob der Empfänger bereits ein Docsbook-Konto hat – der Link führt ihn durch die Anmeldung direkt ins Projekt.
- Eine gemeinsame Antwort. Ihr fragt beide, und ihr seht beide, wie die gleiche Antwort hereinkommt, sodass sie gleichzeitig bei allen ankommt, anstatt dass sie indirekt weitergegeben wird.
Sitzungen sind nur live. Nichts über einen gemeinsamen Chat wird gespeichert, nachdem alle gegangen sind.
Was ein Leser sieht, wenn kein Chat verbunden ist#
Wenn ein Leser das Chat-Widget auf einer Dokumentationsseite öffnet, auf der kein KI-Chat verbunden ist, sieht er eine einfache Erklärung anstelle eines Fehlers, die ihn auffordert, den Eigentümer der Seite zu kontaktieren, um es einzurichten. Das Widget schlägt niemals still und zeigt niemals einen Stack-Trace einem Leser an.
Verwandt#
- Chat Hooks — den Prompt und die Antwort abfangen.
- Quellen — was der Assistent liest, bevor er antwortet.
- MCP-Server — Chat-Einstellungen von Claude Code verwalten.
- Preise — worauf eine Antwort basiert.