O ChattyBox pode recolher conteúdo de um site Docusaurus?
Sim. O ChattyBox pode recolher conteúdo de páginas públicas de documentação Docusaurus ou usar o URL de um sitemap para descobrir conteúdo da documentação.
Um chatbot de IA para Docusaurus destinado a redatores técnicos, DevRel e equipas de suporte. O ChattyBox recolhe conteúdo da sua documentação Docusaurus e pode incluir nas respostas ligações para as páginas obtidas. Verifique a exatidão das respostas e citações. Sem RAG personalizado e sem migração.
Algumas ferramentas de suporte com IA exigem que marque uma demonstração antes sequer de testar o produto. O ChattyBox é de utilização autónoma: adicione o seu site, recolha o conteúdo da documentação, teste o chatbot e incorpore-o quando estiver pronto.
Ferramentas tradicionais de suporte de IA
Configuração de autoatendimento
O ChattyBox recolhe o conteúdo do seu site, documentação, centro de ajuda, CMS ou base de conhecimento existentes. O conteúdo recuperado pode orientar as respostas do chatbot; verifique a precisão das respostas e das citações.
Escolha o sitemap de produção do Docusaurus ou um conjunto intencional de rotas atuais, versionadas e localizadas da documentação.
Recolha o conteúdo das rotas selecionadas e depois teste as perguntas na versão e no idioma exatos usados pelos visitantes.
Instale um único carregador persistente em src/theme/Root.tsx e permita as origens do script e da API na sua Content Security Policy.
Navegue entre as páginas da documentação sem recarregar e verifique se existe uma única instância do widget, se as citações funcionam e se não há erros na consola ou de CSP.
Lançamento em três etapas
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.
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.
| Questão do Docusaurus | Decisão de implementação | Verificação |
|---|---|---|
Questão do Docusaurus Root e navegação no cliente | Decisão de implementação 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. | Verificação Abra dois links internos da documentação e confirme que document.querySelectorAll("#chattybox-widget").length é 1. |
Questão do Docusaurus Política de Segurança de Conteúdo | Decisão de implementação 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. | Verificação Recarregue com o DevTools aberto e confirme que não há solicitações de script, style, font, fetch ou WebSocket bloqueadas. |
Questão do Docusaurus Versões, localidades e escopo do sitemap | Decisão de implementação Inspecione o sitemap publicado antes da recolha. Inclua apenas caminhos de versões e idiomas suportados. Para âmbitos de versão separados, use projetos separados com apenas as páginas pretendidas em cada um e teste se existem respostas de outras versões. | Verificação Faça a mesma pergunta específica da versão em cada idioma indexado e verifique se todas as citações mantêm o prefixo de rota esperado. |
Questão do Docusaurus Widget ausente ou duplicado | Decisão de implementação 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. | Verificação 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. |
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.
Lista prática de avaliação de chatbots de IA para documentaçãoCrie um componente Root do tema Docusaurus, adicione o script do widget depois de recolher o conteúdo da documentação e publique o site. Os visitantes podem então fazer perguntas em qualquer página da documentação.
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}</>;
}Sim. O ChattyBox pode recolher conteúdo de páginas públicas de documentação Docusaurus ou usar o URL de um sitemap para descobrir conteúdo da documentação.
Não. O ChattyBox é incorporado com uma etiqueta de script, pelo que funciona com o tema e a implementação Docusaurus existentes.
As respostas podem incluir ligações para as páginas de documentação obtidas, mas as respostas de recurso podem não ter fontes. Verifique a exatidão das respostas e citações.
Sim. Pode testar o conteúdo recolhido no painel antes de copiar o snippet do widget para o seu site Docusaurus.