Docusaurus Supporto documenti

Aggiungi un chatbot AI al tuo Documentazione Docusaurus in pochi minuti

Trasforma i tuoi documenti Docusaurus in un assistente di supporto AI che cita le pagine esatte utilizzate. Mantieni lo stack dei tuoi documenti, aggiungi un widget incorporabile.

Esegue la scansione delle pagine dei documenti pubblicati

Risposte citate dalla fonte

Incorpora con uno script

Non è richiesta la migrazione dei documenti

Crea il tuo chatbot Visualizza i prezzi

Nessuna carta di credito richiestaI tuoi contenuti restano tuoi

Chiedi a ChattyBox

Da dove dovrei iniziare se mi serve una risposta affidabile da questo sito?

Inizia aggiungendo l'URL del tuo sito web a ChattyBox. Scansiona i tuoi contenuti, risponde dalle pagine che trova e mostra ai visitatori le fonti dietro ogni risposta.

iFonti3^

Docusaurus guida

chattybox.ai

Analisi

chattybox.ai

Pagina iniziale

chattybox.ai

Fai una domanda...

Offerto da ChattyBox

Configurazione self-service

Non è richiesta alcuna chiamata di vendita

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

ChattyBox

Strumenti tradizionali di supporto dell'intelligenza artificialePrenota una dimostrazione

ChattyBoxInizia subito

Strumenti tradizionali di supporto dell'intelligenza artificialePrezzi nascosti o guidati dalle vendite

ChattyBoxPrezzi pubblici

Strumenti tradizionali di supporto dell'intelligenza artificialeConcentrato sull'impresa

ChattyBoxCreato per siti di documenti, piccoli team, OSS e SaaS

Strumenti tradizionali di supporto dell'intelligenza artificialePrima la conversazione sulle vendite

ChattyBoxProvalo tu stesso prima

Costruito per Docusaurus squadre

Avvia un chatbot citato alla fonte senza ricostruire lo stack di documenti

ChattyBox esegue la scansione della documentazione esistente, indicizza il contenuto per il recupero e incorpora un chatbot che risponde utilizzando i tuoi documenti anziché la memoria del modello generico.

Un wrapper Root di Docusaurus 3 carica il widget una sola volta per l'intera durata dell'applicazione client.

L'ambito della scansione può seguire percorsi della documentazione correnti, con versioni, localizzati o filtrati intenzionalmente.

Le citazioni riportano i lettori alla pagina Docusaurus di supporto e ne preservano il percorso della versione e della lingua.

L'esempio riproducibile copre la prevenzione dei duplicati, la navigazione client, la CSP e la verifica a livello di percorso.

Passaggio del workflow

Scegli la sitemap Docusaurus di produzione o un insieme intenzionale di percorsi della documentazione correnti, con versioni e localizzati.

Passaggio del workflow

Esegui la scansione dei percorsi selezionati, quindi verifica le domande sulla release e sulla lingua esatte usate dai visitatori.

Passaggio del workflow

Installa un unico loader persistente in src/theme/Root.tsx e consenti le origini del relativo script e dell'API nella Content Security Policy.

Passaggio del workflow

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

Incolla il tuo URL Docusaurus, prova le risposte citate, quindi installa il widget.

Crea il tuo chatbot

Evidenze editoriali verificate

Un'integrazione Docusaurus 3 verificata, non uno script a livello di percorso

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.

Autore tecnico: Team di documentazione ChattyBox
Revisore tecnico: ChattyBox Ingegneria
Ultimo aggiornamento: 2026-07-09
Informazioni verificate: Docusaurus 3.10 e widget ChattyBox corrente

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.

Componente Root di Docusaurus che impedisce la duplicazione dello script ChattyBox dopo la navigazione client — Riferimento originale per l'installazione: il loader ha un ID stabile, viene caricato in modo asincrono e resta presente mentre Docusaurus cambia percorso.

Docusaurus 3 decisioni di installazione e relativi controlli end-to-end.
Preoccupazione Docusaurus	Decisione di attuazione	Verifica
Root e navigazione client	Crea lo script asincrono una volta in base all'ID stabile. Non restituire la pulizia dall'effetto perché Root e il widget sono destinati a persistere attraverso i percorsi.	Apri due collegamenti a documenti interni e conferma che document.querySelectorAll("#chattybox-widget").length è 1.
Content Security Policy	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.	Ricarica con DevTools aperto e conferma che non ci sono richieste di script, stile, font, fetch o WebSocket bloccate.
Versioni, impostazioni locali e ambito della mappa del sito	Ispeziona la mappa del sito distribuita prima della scansione. Includi solo percorsi di versione e impostazioni locali supportati oppure utilizza fonti separate quando il pubblico non deve ricevere risposte a più versioni.	Poni la stessa domanda specifica per la versione in ogni locale indicizzata e controlla che ogni citazione mantenga il prefisso di percorso previsto.
Widget mancante o duplicato	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.	Testa una build di produzione, non solo la ricarica a caldo, e ispeziona i pannelli Elements e Network dopo la navigazione.

Controllo della risposta citata

Testare una risposta in cui è importante il percorso di rilascio

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.

Chiedi ai documenti Docusaurus

Come faccio ad aprire per impostazione predefinita gli ultimi documenti stabili?

Nella configurazione del plug-in dei documenti, imposta lastVersion sulla versione che i visitatori dovrebbero aprire e utilizza onlyIncludeVersions quando è necessario limitare le versioni pubblicate. Mantieni il percorso corrente dei documenti solo se desideri che gli utenti accedano alla documentazione non rilasciata.

iFonti1^

Controllo delle versioni dei documenti: configurazione

docusaurus.io/docs/versioning

Fai una domanda...

Offerto da ChattyBox

Riferimento al risultato originale: la risposta nomina le impostazioni della versione rilevanti ed espone la guida ufficiale al controllo delle versioni come prova.

Fonti primarie ed evidenze riproducibili

Componente Root del tema DocusaurusIndicazioni ufficiali per il componente di primo livello che non viene smontato durante la navigazione.Gestione delle versioni della documentazione DocusaurusComportamento ufficiale per documentazione corrente, versioni salvate, percorsi delle versioni e selezione della versione.Internazionalizzazione di DocusaurusIndicazioni ufficiali per le build delle lingue e gli URL localizzati.Plugin sitemap di DocusaurusOpzioni ufficiali per generazione, filtraggio e frequenza di modifica della sitemap.Esempio riproducibile di Docusaurus 3Implementazione minima di Root.tsx e comando di verifica dei loader duplicati.

Percorso di installazione

Come aggiungere ChattyBox a Docusaurus

Crea un componente root del tema Docusaurus, aggiungi lo script del widget dopo che i tuoi documenti sono stati raschiati e distribuisci. I tuoi visitatori potranno quindi porre domande da qualsiasi pagina di documenti.

1Crea un progetto ChattyBox e inserisci l'URL dei documenti o la mappa del sito di Docusaurus.
2Prova le domande reali di Docusaurus nella dashboard e verifica che le citazioni indirizzino alle pagine giuste.
3Aggiungi lo script del widget in src/theme/Root.tsx in modo che venga caricato nel tuo sito di documentazione.

Crea il tuo chatbot

src/theme/Root.tsx

tsx

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}</>;
}

Esplora ora

Altri modi per usare ChattyBox

Esplora tutte le soluzioni

Chatbot AI per la documentazione

Scopri come funzionano le risposte citate alla fonte nei siti e nelle piattaforme di documentazione tecnica.

Apri

Chatbot per documenti per sviluppatori

Aiuta gli sviluppatori a risolvere più rapidamente le domande su configurazione, SDK, API ed errori dalle tue guide.

Apri

Chatbot AI MkDocs

Confronta lo stesso flusso di lavoro citato nella fonte per i siti MkDocs e Material for MkDocs.

Apri

Sfoglia tutte le guide della piattaforma

Trova guide di configurazione per VitePress, Starlight, Nextra, Mintlify, ReadMe, Hugo e altre piattaforme di documentazione.

Apri

Domande frequenti

Domande comuni

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.

Devo cambiare il mio tema Docusaurus?

No. Incorpori ChattyBox con un tag script, quindi funziona insieme al tema e alla distribuzione Docusaurus esistenti.

Le risposte rimanderanno alle pagine Docusaurus?

Sì. Le risposte possono includere citazioni che rimandano gli utenti alle esatte pagine della documentazione utilizzate per la risposta.

Posso testare il bot prima di installarlo?

Sì. Puoi testare il contenuto prelevato nella dashboard prima di copiare lo snippet del widget sul tuo sito Docusaurus.

Inizia gratis

Nessuna carta di credito richiesta. I tuoi contenuti non vengono usati per addestrare modelli.

Crea chatbot gratuiti

Piano Free. Nessuna carta.