Může ChattyBox procházet web Docusaurus?
Ano. ChattyBox může procházet veřejné stránky dokumentace Docusaurus nebo používat adresu URL souboru Sitemap k objevování obsahu dokumentů.
AI chatbot Docusaurus pro technické autory, DevRel a týmy podpory. ChattyBox prochází vaši dokumentaci Docusaurus, odpovídá na otázky jako „Jak nakonfiguruji verzování?“ přímo z těchto stránek a cituje zdroj, který použil. Žádné vlastní RAG a žádná migrace.
Některé podpůrné nástroje AI vás nutí zarezervovat si demo ještě předtím, než budete moci produkt otestovat. ChattyBox je samoobslužný: přidejte svůj web, procházejte své dokumenty, otestujte chatbota a vložte jej, až budete připraveni.
Tradiční nástroje podpory AI
Samoobslužné nastavení
ChattyBox prochází váš stávající web, dokumentaci, centrum nápovědy, CMS nebo znalostní bázi a poté vloží chatbota, který odpovídá na základě vašeho publikovaného obsahu, nikoli obecné paměti modelu.
Vyberte produkční mapu webu Docusaurus nebo záměrnou sadu aktuálních, verzovaných a lokalizovaných tras dokumentů.
Projděte vybrané trasy a poté otestujte otázky pro přesnou verzi a jazyk, které vaši návštěvníci používají.
Nainstalujte jeden trvalý zavaděč do src/theme/Root.tsx a povolte původ jeho skriptu a API v zásadách zabezpečení obsahu.
Procházejte mezi stránkami dokumentů bez opětovného načítání a ověřte jednu instanci widgetu, fungující citace a žádné chyby konzole nebo CSP.
Spuštění ve třech krocích
Docusaurus při změnách tras na straně klienta zachovává aplikaci React. Otestovaný obal Root proto vytvoří jediný zavaděč, pozdější připojení rozpozná podle ID a ponechá zavaděč na místě, aby při opakovaném připojení ve vývoji neodstranil stále aktivní widget.
Po zásadním upgradu Docusaurus nebo změně koncového bodu widgetu znovu zkontrolujte životní cyklus Root, výstup mapy webu a původ CSP.
| Oblast Docusaurus | Prováděcí rozhodnutí | Ověření |
|---|---|---|
Oblast Docusaurus Root a klientská navigace | Prováděcí rozhodnutí Vytvořte asynchronní skript jednou pomocí stabilního ID. Nevracejte vyčištění z efektu, protože Root a widget mají přetrvávat napříč trasami. | Ověření Otevřete dva interní odkazy na dokumenty a potvrďte, že document.querySelectorAll("#chattybox-widget").length je 1. |
Oblast Docusaurus Zásady zabezpečení obsahu | Prováděcí rozhodnutí Povolte chattybox.ai v script-src, nakonfigurovaný původ API v connect-src, fonts.googleapis.com ve style-src a fonts.gstatic.com ve font-src. Současný widget vkládá vlastní CSS komponenty, takže přísné style-src vyžaduje také 'unsafe-inline', dokud nebude k dispozici varianta s nonce nebo externím stylem. | Ověření Načtěte stránku znovu s otevřeným DevTools a potvrďte, že nejsou blokovány žádné požadavky na skript, styl, font, načítání dat ani WebSocket. |
Oblast Docusaurus Verze, národní prostředí a rozsah souboru Sitemap | Prováděcí rozhodnutí Před procházením zkontrolujte nasazenou mapu webu. Zahrňte pouze podporované cesty k vydání a národnímu prostředí nebo použijte samostatné zdroje, pokud publikum nesmí dostávat odpovědi napříč verzemi. | Ověření Položte stejnou otázku specifickou pro vydání v každém indexovaném národním prostředí a zkontrolujte, zda každá citace zachovává očekávanou předponu trasy. |
Oblast Docusaurus Chybějící nebo duplicitní widget | Prováděcí rozhodnutí Zkontrolujte klíč API, ID zavaděče, zprávy konzoly CSP, odezvu skriptu a zda další komponenta motivu také vkládá widget. | Ověření Otestujte produkční sestavení, nejen opětovné načítání za běhu, a po navigaci zkontrolujte panely Elements a Network. |
Užitečný akceptační test se ptá na nastavení, jehož hodnota se může lišit podle vydání, a poté otevře citaci a ověří tvrzení i adresu URL dané verze.
Jak vybrat ten správný obsahový chatbotVytvořte kořenovou komponentu motivu Docusaurus, přidejte skript widgetu poté, co jsou vaše dokumenty seškrábány, a nasaďte. Vaši návštěvníci pak mohou klást otázky z libovolné stránky dokumentů.
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}</>;
}Ano. ChattyBox může procházet veřejné stránky dokumentace Docusaurus nebo používat adresu URL souboru Sitemap k objevování obsahu dokumentů.
Ne. ChattyBox vložíte pomocí značky skriptu, takže funguje společně s vaším stávajícím motivem a nasazením Docusaurus.
Ano. Odpovědi mohou obsahovat citace, které uživatele nasměrují zpět na přesné stránky dokumentace použité pro odpověď.
Ano. Před zkopírováním úryvku widgetu na svůj web Docusaurus můžete otestovat zkopírovaný obsah na řídicím panelu.
Používáme volitelné nástroje pro analytiku a správu tagů, abychom porozuměli používání webu. Zvolte, zda povolíte Ahrefs Web Analytics, PostHog a Google Tag Manager. Vypnutí analytiky tuto stránku znovu načte, aby se změna správně projevila. Základní funkce webu a monitorování chyb nejsou touto volbou ovlivněny. Přečtěte si naše zásady ochrany soukromí.