ChattyBox peut-il explorer un site Docusaurus ?
Oui. ChattyBox peut explorer des pages publiques de documentation Docusaurus ou utiliser une URL de sitemap pour découvrir le contenu des docs.
Un chatbot IA Docusaurus pour les rédacteurs techniques, les équipes DevRel et le support. ChattyBox explore votre documentation Docusaurus et peut inclure dans les réponses des liens vers les pages récupérées. Testez l’exactitude des réponses et des citations. Sans RAG personnalisé ni migration.
Certains outils de support d'IA vous obligent à réserver une démo avant même de pouvoir tester le produit. ChattyBox est en libre-service : ajoutez votre site, explorez vos documents, testez le chatbot et intégrez-le lorsque vous êtes prêt.
Outils de support d'IA traditionnels
Configuration en libre-service
ChattyBox explore votre site existant, votre documentation, votre centre d'aide, votre CMS ou votre base de connaissances. Le contenu récupéré peut guider les réponses du chatbot ; vérifiez l'exactitude des réponses et des citations.
Choisissez le plan de site Docusaurus de production ou un ensemble délibéré de routes de documentation actuelles, versionnées et localisées.
Explorez les routes sélectionnées, puis testez les questions avec la version et la langue exactes qu'utilisent vos visiteurs.
Installez un chargeur persistant unique dans src/theme/Root.tsx et autorisez les origines de son script et de son API dans votre Content Security Policy.
Naviguez entre les pages de documentation sans rechargement et vérifiez qu'il n'existe qu'une instance du widget, que les citations fonctionnent et qu'aucune erreur de console ou de CSP ne se produit.
Un lancement en trois étapes
Docusaurus affiche une application React persistante lors des changements de route côté client. Le wrapper Root testé crée donc un chargeur unique, le reconnaît grâce à son ID lors des montages ultérieurs et le laisse en place au lieu de supprimer un widget encore actif lors des remontages en développement.
Vérifiez de nouveau le cycle de vie de Root, la sortie du plan de site et les origines de la CSP après une mise à niveau majeure de Docusaurus ou une modification du point de terminaison du widget.
| Point d'attention pour Docusaurus | Décision d'implémentation | Vérification |
|---|---|---|
Point d'attention pour Docusaurus Root et navigation côté client | Décision d'implémentation Créez le script asynchrone une seule fois à l'aide d'un ID stable. Ne renvoyez pas de fonction de nettoyage depuis l'effet, car Root et le widget doivent persister entre les routes. | Vérification Ouvrez deux liens internes de la documentation et vérifiez que document.querySelectorAll("#chattybox-widget").length vaut 1. |
Point d'attention pour Docusaurus Politique de sécurité du contenu | Décision d'implémentation Autorisez chattybox.ai dans script-src, l'origine de l'API configurée dans connect-src, fonts.googleapis.com dans style-src et fonts.gstatic.com dans font-src. Le widget actuel injectant son propre CSS de composant, un style-src strict nécessite également 'unsafe-inline' jusqu'à ce qu'une gestion par nonce ou une feuille de styles externe soit disponible. | Vérification Rechargez la page avec DevTools ouvert et vérifiez qu'aucune requête de script, de style, de police, fetch ou WebSocket n'est bloquée. |
Point d'attention pour Docusaurus Versions, langues et périmètre du plan de site | Décision d'implémentation Examinez le plan de site déployé avant l’exploration. N’incluez que les chemins des versions et langues prises en charge. Pour séparer les périmètres par version, utilisez des projets distincts ne contenant chacun que les pages voulues et vérifiez si les réponses proviennent d’autres versions. | Vérification Posez la même question propre à une version dans chaque langue indexée et vérifiez que chaque citation conserve le préfixe de route attendu. |
Point d'attention pour Docusaurus Widget absent ou en double | Décision d'implémentation Vérifiez la clé d'API, l'ID du chargeur, les messages de CSP dans la console, la réponse du script et si un autre composant du thème injecte également le widget. | Vérification Testez une version de production, et pas seulement le rechargement à chaud, puis examinez les panneaux Elements et Network après la navigation. |
Un test d'acceptation utile porte sur un paramètre dont la réponse peut varier selon la version, puis ouvre la citation afin de vérifier à la fois l'affirmation et l'URL versionnée.
Liste de contrôle pratique pour évaluer les chatbots IA de documentationCréez un composant racine de thème Docusaurus, ajoutez le script de widget une fois vos documents récupérés et déployez-le. Vos visiteurs peuvent ensuite poser des questions à partir de n'importe quelle page de documentation.
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}</>;
}Oui. ChattyBox peut explorer des pages publiques de documentation Docusaurus ou utiliser une URL de sitemap pour découvrir le contenu des docs.
Non. Vous intégrez ChattyBox avec une balise script, il fonctionne donc avec votre thème et votre déploiement Docusaurus existants.
Les réponses peuvent inclure des liens vers les pages de documentation récupérées, mais les réponses de repli peuvent ne comporter aucune source. Vérifiez l’exactitude des réponses et des citations.
Oui. Vous pouvez tester le contenu scrapé dans le tableau de bord avant de copier l’extrait du widget sur votre site Docusaurus.