Docusaurus Suporte para documentos

Adicione um chatbot de IA ao seu Documentação Docusaurus em minutos

Um chatbot de IA para Docusaurus para redatores técnicos, DevRel e equipes de suporte. O ChattyBox rastreia sua documentação Docusaurus, responde a perguntas como "Como faço para configurar versionamento?" a partir dessas páginas e cita a fonte usada. Sem RAG personalizado e sem migração.

Rastreia páginas de documentos publicados

Respostas citadas pela fonte

Incorpora com um script

Não é necessária migração de documentos

Crie seu chatbot Ver preços

Não é necessário cartão de créditoO seu conteúdo continua a ser seu

Pergunte ao ChattyBox

Por onde devo começar se preciso de uma resposta confiável deste site?

Comece adicionando o URL do seu site ao ChattyBox. Ele rastreia seu conteúdo, responde a partir das páginas que encontra e mostra aos visitantes as fontes por trás de cada resposta.

iFontes3^

Docusaurus guia

chattybox.ai

Análises

chattybox.ai

Início

chattybox.ai

Faça uma pergunta...

Distribuído por ChattyBox

Configuração de autoatendimento

Nenhuma chamada de vendas necessária

Algumas ferramentas de suporte de IA fazem com que você reserve uma demonstração antes mesmo de testar o produto. ChattyBox é de autoatendimento: adicione seu site, rastreie seus documentos, teste o chatbot e incorpore-o quando estiver pronto.

Ferramentas tradicionais de suporte de IA

ChattyBox

Ferramentas tradicionais de suporte de IAAgende uma demonstração

ChattyBoxComece imediatamente

Ferramentas tradicionais de suporte de IAPreços ocultos ou baseados em vendas

ChattyBoxPreços públicos

Ferramentas tradicionais de suporte de IAFocado na empresa

ChattyBoxCriado para sites de documentos, pequenas equipes, OSS e SaaS

Ferramentas tradicionais de suporte de IAConversa de vendas primeiro

ChattyBoxTeste você mesmo primeiro

Construído para Equipes Docusaurus

Inicie um chatbot citado pela fonte sem reconstruir sua pilha de documentos

ChattyBox rastreia sua documentação existente, indexa o conteúdo para recuperação e incorpora um chatbot que responde usando seus documentos em vez da memória genérica do modelo.

Um wrapper Root do Docusaurus 3 carrega o widget uma única vez durante todo o ciclo de vida da aplicação cliente.

O escopo do rastreamento pode seguir rotas de documentação atuais, versionadas, localizadas ou filtradas intencionalmente.

As citações levam os leitores de volta à página de apoio do Docusaurus e preservam o caminho da versão e da localidade.

O exemplo reproduzível abrange prevenção de duplicatas, navegação no cliente, CSP e verificação por rota.

Etapa do fluxo de trabalho

Escolha o sitemap de produção do Docusaurus ou um conjunto intencional de rotas atuais, versionadas e localizadas da documentação.

Etapa do fluxo de trabalho

Rastreie as rotas selecionadas e depois teste as perguntas na versão e na localidade exatas usadas pelos visitantes.

Etapa do fluxo de trabalho

Instale um único carregador persistente em src/theme/Root.tsx e permita as origens do script e da API na sua Content Security Policy.

Etapa do fluxo de trabalho

Navegue entre as páginas da documentação sem recarregar e verifique se há uma única instância do widget, citações funcionais e nenhum erro no console ou de CSP.

Lançamento em três etapas

Cole seu URL Docusaurus, teste as respostas citadas e instale o widget.

Crie seu chatbot

Evidências editoriais testadas

Uma integração testada com o Docusaurus 3, não um script por rota

O Docusaurus renderiza uma aplicação React persistente durante as mudanças de rota no cliente. Por isso, o wrapper Root testado cria um único carregador, reconhece montagens posteriores pelo ID e mantém o carregador no lugar, em vez de remover um widget ainda ativo durante remontagens no desenvolvimento.

Autor técnico: Equipe de documentação da ChattyBox
Revisor técnico: Engenharia da ChattyBox
Última atualização: 2026-07-09
Informações verificadas: Docusaurus 3.10 e widget atual da ChattyBox

Verifique novamente o ciclo de vida do Root, a saída do sitemap e as origens de CSP após uma atualização principal do Docusaurus ou uma mudança no endpoint do widget.

Componente Root do Docusaurus impedindo a duplicação do script da ChattyBox após a navegação no cliente — Referência original de instalação: o carregador tem um ID estável, carrega de forma assíncrona e permanece presente enquanto o Docusaurus muda de rota.

Decisões de instalação do Docusaurus 3 e suas verificações de ponta a ponta.
Questão do Docusaurus	Decisão de implementação	Verificação
Root e navegação no cliente	Crie o script assíncrono uma única vez com um ID estável. Não retorne uma limpeza do efeito, pois o Root e o widget devem persistir entre as rotas.	Abra dois links internos da documentação e confirme que document.querySelectorAll("#chattybox-widget").length é 1.
Política de Segurança de Conteúdo	Permita chattybox.ai em script-src, a origem configurada da API em connect-src, fonts.googleapis.com em style-src e fonts.gstatic.com em font-src. O widget atual injeta o CSS de seu componente, então um style-src estrito também precisa de 'unsafe-inline' até que haja um build com nonce ou stylesheet externo.	Recarregue com o DevTools aberto e confirme que não há solicitações de script, style, font, fetch ou WebSocket bloqueadas.
Versões, localidades e escopo do sitemap	Inspecione o sitemap implantado antes do rastreamento. Inclua somente caminhos de versões e localidades compatíveis ou use fontes separadas quando os públicos não puderem receber respostas de outras versões.	Faça a mesma pergunta específica da versão em cada localidade indexada e verifique se todas as citações mantêm o prefixo de rota esperado.
Widget ausente ou duplicado	Verifique a chave da API, o ID do carregador, as mensagens de CSP no console, a resposta do script e se outro componente do tema também injeta o widget.	Teste um build de produção, não apenas o hot reload, e inspecione os painéis Elements e Network após a navegação.

Verificação de resposta com citação

Teste uma resposta em que o caminho da versão é importante

Um teste de aceitação útil pergunta sobre uma configuração cuja resposta pode variar conforme a versão e depois abre a citação para verificar tanto a afirmação quanto a URL versionada.

Pergunte à documentação do Docusaurus

Como faço para abrir por padrão a documentação estável mais recente?

Na configuração do plugin de documentação, defina lastVersion como a versão que os visitantes devem abrir e use onlyIncludeVersions quando precisar limitar as versões publicadas. Mantenha a rota da documentação atual somente se quiser que os usuários acessem documentação ainda não lançada.

iFontes1^

Versionamento da documentação: configuração

docusaurus.io/docs/versioning

Faça uma pergunta...

Distribuído por ChattyBox

Referência do resultado original: a resposta informa as configurações de versão relevantes e apresenta o guia oficial de versionamento como evidência.

Fontes primárias e evidências reproduzíveis

Componente Root do tema do DocusaurusOrientação oficial para o componente de nível superior que não é desmontado durante a navegação.Versionamento da documentação do DocusaurusComportamento oficial para documentação atual, versões salvas, caminhos de versão e seleção de versão.Internacionalização do DocusaurusOrientação oficial para builds de localidades e URLs localizadas.Plugin de sitemap do DocusaurusOpções oficiais de geração, filtragem e frequência de alteração do sitemap.Exemplo reproduzível do Docusaurus 3Implementação mínima de Root.tsx e um comando para verificar carregadores duplicados.

Caminho de instalação

Como adicionar ChattyBox ao Docusaurus

Crie um componente Root do tema Docusaurus, adicione o script do widget depois que seus documentos forem rastreados e implante. Seus visitantes podem então fazer perguntas em qualquer página de documentos.

1Crie um projeto ChattyBox e insira o URL dos documentos do Docusaurus ou mapa do site.
2Teste perguntas reais do Docusaurus no painel e confirme se as citações apontam para as páginas certas.
3Adicione o script do widget em src/theme/Root.tsx para que ele seja carregado em seu site de documentação.

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

Explore a seguir

Mais formas de usar ChattyBox

Explore todas as soluções

Chatbot de IA para documentação

Veja como as respostas citadas na fonte funcionam em sites e plataformas de documentação técnica.

Abrir

Chatbot de documentos do desenvolvedor

Ajude os desenvolvedores a resolver questões de configuração, SDK, API e erros de seus guias com mais rapidez.

Abrir

Chatbot de IA MkDocs

Compare o mesmo fluxo de trabalho citado na fonte para sites MkDocs e Material for MkDocs.

Abrir

Navegue por todos os guias da plataforma

Encontre guias de configuração para VitePress, Starlight, Nextra, Mintlify, ReadMe, Hugo e mais plataformas de documentos.

Abrir

Perguntas frequentes

Perguntas comuns

ChattyBox pode rastrear um site Docusaurus?

Sim. ChattyBox pode rastrear páginas de documentação públicas Docusaurus ou usar um URL de mapa do site para descobrir o conteúdo dos documentos.

Preciso mudar meu tema Docusaurus?

Não. Você incorpora ChattyBox com uma tag de script, para que funcione junto com seu tema e implantação Docusaurus existentes.

As respostas direcionarão para as páginas Docusaurus?

Sim. As respostas podem incluir citações que direcionam os usuários às páginas de documentação exatas usadas para a resposta.

Posso testar o bot antes de instalá-lo?

Sim. Você pode testar o conteúdo rastreado no painel antes de copiar o snippet do widget para seu site Docusaurus.

Comece gratuitamente

Não é necessário cartão de crédito. O seu conteúdo não é usado para treinar modelos.

Crie chatbot grátis

Plano Free. Sem cartão.