ChattyBox può eseguire la scansione di un sito Docusaurus?
Sì. ChattyBox può eseguire la scansione delle pagine di documentazione pubbliche Docusaurus o utilizzare un URL della mappa del sito per scoprire il contenuto dei documenti.
Un chatbot IA per Docusaurus dedicato a technical writer, team DevRel e assistenza. ChattyBox esegue la scansione della documentazione Docusaurus e può inserire nelle risposte link alle pagine recuperate. Verifica l'accuratezza delle risposte e delle citazioni. Nessun sistema RAG personalizzato e nessuna migrazione.
Alcuni strumenti di supporto AI ti obbligano a prenotare una demo prima ancora di poter testare il prodotto. ChattyBox è self-service: aggiungi il tuo sito, esegui la scansione dei tuoi documenti, testa il chatbot e incorporalo quando sei pronto.
Strumenti tradizionali di supporto dell'intelligenza artificiale
Configurazione self-service
ChattyBox esegue la scansione del tuo sito web esistente, della documentazione, del centro assistenza, del CMS o della knowledge base. I contenuti recuperati possono guidare le risposte del chatbot; verifica l'accuratezza delle risposte e delle citazioni.
Scegli la sitemap Docusaurus di produzione o un insieme intenzionale di percorsi della documentazione correnti, con versioni e localizzati.
Esegui la scansione dei percorsi selezionati, quindi verifica le domande sulla release e sulla lingua esatte usate dai visitatori.
Installa un unico loader persistente in src/theme/Root.tsx e consenti le origini del relativo script e dell'API nella Content Security Policy.
Naviga tra le pagine della documentazione senza ricaricarle e verifica che ci siano una sola istanza del widget, citazioni funzionanti e nessun errore nella console o della CSP.
Lancio in tre fasi
Docusaurus esegue il rendering di un'applicazione React persistente durante i cambi di percorso lato client. Il wrapper Root verificato crea quindi un solo loader, riconosce i montaggi successivi tramite ID e lascia il loader in posizione anziché rimuovere un widget ancora attivo durante i nuovi montaggi in sviluppo.
Ricontrolla il ciclo di vita di Root, l'output della sitemap e le origini CSP dopo un aggiornamento principale di Docusaurus o una modifica dell'endpoint del widget.
| Preoccupazione Docusaurus | Decisione di attuazione | Verifica |
|---|---|---|
Preoccupazione Docusaurus Root e navigazione client | Decisione di attuazione Crea lo script asincrono una sola volta usando un ID stabile. Non restituire una funzione di pulizia dall'effetto, perché Root e il widget sono destinati a persistere tra i percorsi. | Verifica Apri due collegamenti a documenti interni e conferma che document.querySelectorAll("#chattybox-widget").length è 1. |
Preoccupazione Docusaurus Content Security Policy | Decisione di attuazione Consenti chattybox.ai in script-src, l'origine API configurata in connect-src, fonts.googleapis.com in style-src e fonts.gstatic.com in font-src. Il widget attuale inietta il CSS del componente, quindi uno style-src restrittivo richiede anche 'unsafe-inline' finché non sarà disponibile una build con nonce o con un foglio di stile esterno. | Verifica Ricarica con DevTools aperto e conferma che non ci sono richieste di script, stile, font, fetch o WebSocket bloccate. |
Preoccupazione Docusaurus Versioni, impostazioni locali e ambito della mappa del sito | Decisione di attuazione Esamina la sitemap pubblicata prima della scansione. Includi solo i percorsi delle versioni e delle lingue supportate. Per ambiti di versione separati, usa progetti separati contenenti solo le pagine previste per ciascuno e verifica che le risposte non mescolino versioni diverse. | Verifica Poni la stessa domanda specifica per la versione in ogni locale indicizzata e controlla che ogni citazione mantenga il prefisso di percorso previsto. |
Preoccupazione Docusaurus Widget mancante o duplicato | Decisione di attuazione Controlla la chiave API, l'ID del caricatore, i messaggi della console CSP, la risposta dello script e se anche un altro componente del tema inserisce il widget. | Verifica Testa una build di produzione, non solo la ricarica a caldo, e ispeziona i pannelli Elements e Network dopo la navigazione. |
Un utile test di accettazione chiede informazioni su un'impostazione la cui risposta può differire in base alla versione, quindi apre la citazione per verificare sia l'affermazione che l'URL con versione.
Lista di controllo pratica per valutare i chatbot IA per la documentazioneCrea un componente Root del tema Docusaurus, aggiungi lo script del widget dopo la scansione della documentazione e pubblica il sito. I visitatori potranno quindi porre domande da qualsiasi pagina della documentazione.
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}</>;
}Sì. ChattyBox può eseguire la scansione delle pagine di documentazione pubbliche Docusaurus o utilizzare un URL della mappa del sito per scoprire il contenuto dei documenti.
No. Incorpori ChattyBox con un tag script, quindi funziona insieme al tema e alla distribuzione Docusaurus esistenti.
Le risposte possono contenere link alle pagine della documentazione recuperate, ma le risposte di fallback potrebbero non avere fonti. Verifica l'accuratezza delle risposte e delle citazioni.
Sì. Puoi testare il contenuto prelevato nella dashboard prima di copiare lo snippet del widget sul tuo sito Docusaurus.