Passer au contenu principal
Support docs Docusaurus

Ajoutez un chatbot IA avec des citations de sources à votre documentation Docusaurus

Transformez vos docs Docusaurus en assistant de support IA qui cite les pages exactes utilisées. Gardez votre stack de docs et ajoutez un widget intégrable.

Analyse les pages de documents publiéesRéponses citées par la sourceS'intègre avec un seul scriptAucune migration de documents requiseAucune carte de crédit requiseVotre contenu reste à vous
Inscrivez-vous pour tester notre offre Free

Vous évaluez ChattyBox pour une organisation ? Contactez le support pour discuter de l'essai d'un forfait supérieur.

Demander à ChattyBox
x
Par où commencer si j’ai besoin d’une réponse fiable depuis ce site ?
Commencez par ajouter l’URL de votre site web à ChattyBox. Il explore votre contenu, répond à partir des pages trouvées et montre aux visiteurs les sources derrière chaque réponse.
iSources citées3^
Docusaurus Guide
chattybox.ai
Statistiques
chattybox.ai
Accueil
chattybox.ai
Posez une question...
Propulsé par ChattyBox
Configuration en libre-service

Aucun appel commercial requis

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

  • Réservez une démo
  • Tarification cachée ou axée sur les ventes
  • Axé sur l'entreprise
  • Conversation commerciale en premier

Configuration en libre-service

ChattyBox

  • Commencez tout de suite
  • Tarification publique
  • Conçu pour les sites de documentation, les petites équipes, les logiciels libres et les SaaS
  • Testez-le vous-même d'abord
Conçu pour les équipes Docusaurus

Lancez un chatbot avec citations de sources sans reconstruire votre pile de site

ChattyBox explore votre site existant, votre documentation, votre centre d'aide, votre CMS ou votre base de connaissances, puis intègre un chatbot qui répond à partir de votre propre contenu publié plutôt qu'à partir de la mémoire générique d'un modèle.

Un wrapper Root de Docusaurus 3 charge le widget une seule fois pendant toute la durée de vie de l'application cliente.
Le périmètre d'exploration peut suivre les routes de documentation actuelles, versionnées, localisées ou délibérément filtrées.
Les citations renvoient les lecteurs à la page Docusaurus correspondante et conservent le chemin de sa version et de sa langue.
L'exemple reproductible couvre la prévention des doublons, la navigation côté client, la CSP et la vérification au niveau des routes.
1Étape du workflow

Choisissez le plan de site Docusaurus de production ou un ensemble délibéré de routes de documentation actuelles, versionnées et localisées.

2Étape du workflow

Explorez les routes sélectionnées, puis testez les questions avec la version et la langue exactes qu'utilisent vos visiteurs.

3Étape du workflow

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.

4Étape du workflow

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

Collez votre URL Docusaurus, testez les réponses citées, puis installez le widget.

Éléments éditoriaux vérifiés

Une intégration Docusaurus 3 testée, et non un script propre à une route

Docusaurus affiche une application React persistante autour des changements de route côté client. Le wrapper Root testé crée donc un chargeur unique, reconnaît les montages ultérieurs grâce à leur ID et laisse le chargeur en place au lieu de supprimer un widget encore actif lors des remontages en développement.

Auteur technique
Équipe de documentation ChattyBox
Réviseur technique
Équipe d'ingénierie ChattyBox
Dernière mise à jour
Informations vérifiées
Docusaurus 3.10 et widget ChattyBox actuel

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.

Composant Root de Docusaurus empêchant la duplication du script ChattyBox après une navigation côté client
Référence d'installation originale : le chargeur possède un ID stable, se charge de manière asynchrone et reste présent lorsque Docusaurus change de route.
Décisions d'installation de Docusaurus 3 et vérifications de bout en bout correspondantes.
Point d'attention pour DocusaurusDécision d'implémentationVé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, ou utilisez des sources distinctes lorsque les publics ne doivent pas recevoir de réponses provenant 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.
Vérification d'une réponse avec citations

Tester une réponse pour laquelle le chemin de version importe

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.

Interroger la documentation Docusaurus
x
Comment ouvrir par défaut la dernière version stable de la documentation ?
Dans la configuration de l'extension de documentation, définissez lastVersion sur la version que les visiteurs doivent ouvrir et utilisez onlyIncludeVersions si vous devez limiter les versions publiées. Ne conservez la route de la documentation actuelle que si vous souhaitez donner accès à une documentation non publiée.
Posez une question...
Propulsé par ChattyBox
Réponse de ChattyBox sur la version Docusaurus par défaut, avec citation du guide de gestion des versions
Référence du résultat original : la réponse nomme les paramètres de version pertinents et présente le guide officiel de gestion des versions comme élément probant.
Parcours d’installation

Comment ajouter ChattyBox à Docusaurus

Cré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.

  1. 1Créez un projet ChattyBox et entrez l'URL de votre document Docusaurus ou votre plan de site.
  2. 2Testez de vraies questions Docusaurus dans le tableau de bord et confirmez que les citations pointent vers les bonnes pages.
  3. 3Ajoutez le script du widget dans src/theme/Root.tsx pour qu'il se charge sur votre site de documentation.
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}</>;
}
Questions fréquentes

Questions fréquentes

1

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.

2

Dois-je modifier mon thème Docusaurus ?

Non. Vous intégrez ChattyBox avec une balise script, il fonctionne donc avec votre thème et votre déploiement Docusaurus existants.

3

Les réponses renverront-elles vers les pages Docusaurus ?

Oui. Les réponses peuvent inclure des citations qui renvoient les utilisateurs vers les pages exactes de documentation utilisées pour la réponse.

4

Puis-je tester le bot avant de l’installer ?

Oui. Vous pouvez tester le contenu scrapé dans le tableau de bord avant de copier l’extrait du widget sur votre site Docusaurus.

Inscrivez-vous pour tester notre offre Free

Vous évaluez ChattyBox pour une organisation ? Contactez le support pour discuter de l'essai d'un forfait supérieur.

We use optional analytics and tag-management tools to understand site use. Choose whether to allow Ahrefs Web Analytics, PostHog, and Google Tag Manager. Turning analytics off reloads this page so the change takes effect cleanly. Essential site functionality and error monitoring are not controlled by this choice. Read our privacy policy.