Kann ChattyBox eine Docusaurus-Website crawlen?
Ja. ChattyBox kann öffentliche Docusaurus-Dokumentationsseiten crawlen oder eine Sitemap-URL nutzen, um Docs-Inhalte zu finden.
Ein Docusaurus-KI-Chatbot für technische Autoren, DevRel und Support-Teams. ChattyBox crawlt Ihre Docusaurus-Dokumentation, beantwortet Fragen wie „Wie konfiguriere ich Versionierung?“ aus diesen Seiten und zitiert die verwendete Quelle. Kein benutzerdefiniertes RAG und keine Migration.
Bei einigen KI-Support-Tools müssen Sie eine Demo buchen, bevor Sie das Produkt überhaupt testen können. ChattyBox ist eine Selbstbedienungslösung: Fügen Sie Ihre Website hinzu, crawlen Sie Ihre Dokumente, testen Sie den Chatbot und betten Sie ihn ein, wenn Sie bereit sind.
ChattyBox crawlt Ihre bestehende Dokumentation, indexiert die Inhalte für den Abruf und bettet einen Chatbot ein, der mit Ihren Docs antwortet statt mit generischem Modellgedächtnis.
Wählen Sie die produktive Docusaurus-Sitemap oder eine gezielt zusammengestellte Menge aktueller, versionierter und lokalisierter Dokumentationsrouten.
Crawlen Sie die ausgewählten Routen und testen Sie Fragen anschließend mit genau der Version und Sprache, die Ihre Besuchenden verwenden.
Installieren Sie einen dauerhaften Loader in src/theme/Root.tsx und erlauben Sie dessen Skript- und API-Ursprünge in Ihrer Content Security Policy.
Navigieren Sie ohne Neuladen zwischen Dokumentationsseiten und prüfen Sie, dass genau eine Widget-Instanz vorhanden ist, Quellenangaben funktionieren und keine Konsolen- oder CSP-Fehler auftreten.
Dreistufiger Start
Docusaurus rendert eine dauerhafte React-Anwendung um clientseitige Routenwechsel. Der getestete Root-Wrapper erstellt daher genau einen Loader, erkennt spätere Einbindungen anhand der ID und belässt den Loader an Ort und Stelle, statt bei erneuten Einbindungen während der Entwicklung ein noch aktives Widget zu entfernen.
Prüfen Sie nach einem Hauptversionsupgrade von Docusaurus oder einer Änderung des Widget-Endpunkts den Root-Lebenszyklus, die Sitemap-Ausgabe und die CSP-Ursprünge erneut.
| Docusaurus-Aspekt | Implementierungsentscheidung | Überprüfung |
|---|---|---|
| Root und Clientnavigation | Erstellen Sie das asynchrone Skript anhand einer stabilen ID genau einmal. Geben Sie aus dem Effekt keine Bereinigungsfunktion zurück, da Root und Widget über Routen hinweg bestehen bleiben sollen. | Öffnen Sie zwei interne Dokumentationslinks und bestätigen Sie, dass document.querySelectorAll("#chattybox-widget").length den Wert 1 hat. |
| Content Security Policy | Erlauben Sie chattybox.ai in script-src, den konfigurierten API-Ursprung in connect-src, fonts.googleapis.com in style-src und fonts.gstatic.com in font-src. Das aktuelle Widget fügt sein Komponenten-CSS ein, daher benötigt eine strenge style-src-Richtlinie zusätzlich 'unsafe-inline', bis ein Nonce-basierter oder externer Stylesheet-Build verfügbar ist. | Laden Sie mit geöffneten DevTools neu und bestätigen Sie, dass keine Skript-, Stil-, Schrift-, Fetch- oder WebSocket-Anfragen blockiert werden. |
| Versionen, Sprachen und Sitemap-Umfang | Prüfen Sie vor dem Crawlen die bereitgestellte Sitemap. Nehmen Sie nur unterstützte Versions- und Sprachpfade auf oder verwenden Sie getrennte Quellen, wenn Zielgruppen keine versionsübergreifenden Antworten erhalten dürfen. | Stellen Sie in jeder indizierten Sprache dieselbe versionsspezifische Frage und prüfen Sie, dass jede Quellenangabe das erwartete Routenpräfix beibehält. |
| Fehlendes oder doppeltes Widget | Prüfen Sie API-Schlüssel, Loader-ID, CSP-Konsolenmeldungen, Skriptantwort und ob eine andere Theme-Komponente das Widget ebenfalls einfügt. | Testen Sie einen Produktionsbuild und nicht nur Hot Reload und prüfen Sie nach der Navigation die Bereiche Elements und Network. |
Ein nützlicher Akzeptanztest fragt nach einer Einstellung, deren Antwort je nach Version abweichen kann, und öffnet anschließend die Quellenangabe, um sowohl die Aussage als auch die versionierte URL zu prüfen.
Erstellen Sie eine Root-Komponente für das Docusaurus-Theme, fügen Sie das Widget-Skript hinzu, nachdem Ihre Dokumente gescrapt wurden, und stellen Sie es bereit. Ihre Besucher können dann von jeder Dokumentenseite aus Fragen stellen.
import React, { useEffect, type ReactNode } from 'react';
const WIDGET_ID = 'chattybox-widget';
export default function Root({ children }: { children: ReactNode }) {
useEffect(() => {
if (document.getElementById(WIDGET_ID)) return;
const script = document.createElement('script');
script.id = WIDGET_ID;
script.src = 'https://chattybox.ai/widget.js';
script.async = true;
script.dataset.apiKey = 'YOUR_API_KEY';
script.dataset.apiUrl = 'https://adorable-woodpecker-629.convex.site/chat';
script.dataset.chattyboxWidget = 'true';
document.body.appendChild(script);
}, []);
return <>{children}</>;
}Erfahren Sie, wie Antworten mit Quellenangaben auf technischen Dokumentationssites und Plattformen funktionieren.
Helfen Sie Entwicklern, Setup-, SDK-, API- und Fehlerfragen schneller aus Ihren Guides zu lösen.
Vergleichen Sie denselben Workflow mit Quellenangaben für MkDocs und Material-for-MkDocs-Websites.
Finden Sie Setup-Guides für VitePress, Starlight, Nextra, Mintlify, ReadMe, Hugo und weitere Docs-Plattformen.
Ja. ChattyBox kann öffentliche Docusaurus-Dokumentationsseiten crawlen oder eine Sitemap-URL nutzen, um Docs-Inhalte zu finden.
Nein. Sie betten ChattyBox mit einem Script-Tag ein, sodass es neben Ihrem bestehenden Docusaurus-Theme und Deployment funktioniert.
Ja. Antworten können Zitate enthalten, die Nutzer zurück zu den exakten Dokumentationsseiten führen, die für die Antwort verwendet wurden.
Ja. Sie können gescrapte Inhalte im Dashboard testen, bevor Sie das Widget-Snippet auf Ihre Docusaurus-Website kopieren.
Keine Kreditkarte erforderlich. Ihre Inhalte werden nicht für Modelltraining verwendet.
Kostenloser Tarif. Keine Karte nötig.