1. Ajoutez des docs publiques et testez de vraies questions
L'offre Free est permanente : un site, jusqu'à 10 pages et 100 messages par mois, sans carte bancaire. Vérifiez les réponses et les sources, puis intégrez le widget lorsque vous êtes prêt.
Chatbot de documentation technique
Ajoutez un chatbot à votre documentation technique
Commencez par vos docs publiques, testez de vraies questions techniques et vérifiez les sources liées avant d'ajouter le widget à votre site.
Free permanent : 10 pages, 100 messages/mois, sans carteLes réponses prises en charge peuvent renvoyer vers le contenu source
Commencez par un petit test de documentation
Generic AI
Pourquoi les chatbots génériques échouent à vos utilisateurs
Les chatbots IA à usage général essaient de converser avec l'utilisateur. Lorsqu'ils ne connaissent pas la réponse, ils l'inventent.
- Ils peuvent suggérer des fonctionnalités inexistantes
- Ils peuvent donner des exemples de code obsolètes
- Ils peuvent mentionner des produits concurrents
- Ils peuvent frustrer les utilisateurs techniques
ChattyBox
En quoi ChattyBox est différent
Nous utilisons la génération augmentée par récupération sur vos docs publiées et le contenu de votre site, puis nous affichons les liens sources d'où viennent les réponses.
Pour les équipes qui ont besoin de preuves visibles dans chaque réponse, comparez le workflow d’un chatbot IA avec sources citées qui relie le trafic de documentation aux pages de référence.
- Des réponses fondées sur vos documents et vos pages sources
- Liens de citations directes vers les pages sources
- Réponse de secours "Je ne sais pas" si des informations sont manquantes
- Les exemples de code restent liés aux pages sources indexées
Le chatbot de documentation en pratique
Questions auxquelles un chatbot de documentation doit répondre
Utilisez les questions que vos équipes de support et vos canaux communautaires reçoivent déjà. Vérifiez chaque réponse et sa page source liée avant de publier le widget.
01
« Comment puis-je démarrer, m'authentifier et faire ma première demande ? »
02
« Que signifie cette erreur et où le correctif est-il documenté ? »
03
« Quelles sont les limites du forfait, les limites de tarif et les tarifs de cette fonctionnalité ? »
04
« Dois-je migrer ma plate-forme de documents ou celle-ci peut-elle être placée à côté de mon site actuel ? »
Pour un public technique, consultez le chatbot de documentation pour développeurs, ou découvrez comment réduire les tickets d’assistance grâce à l’IA à partir de votre contenu existant.
Choisissez votre stack
Chatbot IA DocusaurusAjoutez un chatbot IA avec citations de sources à votre documentation Docusaurus. Explorez les pages de docs, répondez aux questions des visiteurs et réduisez les tickets de support répétitifs.
Chatbot MkDocs avec sources citéesAjoutez un chatbot IA à la documentation MkDocs ou Material for MkDocs avec des réponses citées depuis vos pages existantes.
La documentation d’API nécessite des limites de sources précises
Utilisez le chatbot pour aider les développeurs à trouver les endpoints, les étapes d’authentification, les paramètres, les méthodes du SDK et les erreurs connues, puis revenez à la référence pour le contexte complet. Un exemple de code plausible ou une citation visible ne prouve pas que le comportement de l’API est correct.
- Vérifiez d’abord le contenu extrait. Le crawler n’exécute pas le JavaScript des pages ; les références interactives peuvent ne pas exposer les détails des endpoints dans le HTML récupéré. La découverte d’une URL seule ne signifie pas que la référence a été entièrement indexée.
- Délimitez volontairement les versions avec des URL sélectionnées ou des projets distincts. Vérifiez la méthode, le chemin, les champs obligatoires, les permissions, la pagination et les limites de débit pour la version visée, sans mélanger d’anciens exemples de SDK ou étapes de migration.
- Testez les endpoints non documentés, les codes d’erreur inconnus, les versions ambiguës et les demandes impliquant des identifiants. Exigez une limite claire ou une prochaine étape plutôt qu’un comportement deviné. Ne placez jamais de secrets dans un ensemble de sources public ou un prompt de test.
Guide d'évaluation, pas de résultats mesurés
Un cadre d'évaluation réutilisable pour la documentation technique
Constituez le jeu de tests à partir de tâches documentaires réelles, associez une source de référence et les faits attendus à chaque question traitable, et incluez des questions auxquelles l'assistant doit refuser de répondre. Évaluez chaque catégorie séparément afin qu'un bon résultat sur les API ne masque pas des consignes insuffisantes sur les migrations ou l'authentification.
- Auteur technique
- Équipe d'ingénierie ChattyBox
- Réviseur technique
- Équipe de révision de la documentation ChattyBox
- Dernière mise à jour
- Informations vérifiées
- 9 juillet 2026
Relancez la suite avant la mise en ligne, après toute modification importante de la documentation ou de la récupération, puis chaque mois sur un échantillon planifié après le lancement.
| Domaine de la question | Cas de test | Condition de réussite |
|---|---|---|
Domaine de la question API | Cas de test Point de terminaison, champs obligatoires, structure de la réponse et limite de débit. | Condition de réussite Utilise la méthode et le chemin documentés ; les valeurs requises et la citation concordent avec la référence. |
Domaine de la question SDK | Cas de test Installer et initialiser une version prise en charge du SDK. | Condition de réussite Le paquet, l'importation, l'initialisation et la syntaxe du code correspondent au langage et à la version concernés. |
Domaine de la question CLI | Cas de test Installer, s'authentifier, exécuter une commande et interpréter sa sortie. | Condition de réussite Les options et leur ordre sont valides ; la réponse n'invente aucune invite interactive. |
Domaine de la question Authentification | Cas de test Emplacement des identifiants, format de l'en-tête, portées et exemple de flux interdit. | Condition de réussite N'expose jamais de secret, distingue les usages côté client et côté serveur, et cite l'exigence de sécurité. |
Domaine de la question Pagination | Cas de test Première page, continuation, dernière page et taille maximale d'une page. | Condition de réussite Utilise le modèle documenté de curseur ou de décalage et ne mentionne que les limites documentées. |
Domaine de la question Erreurs | Cas de test Code d'erreur connu, cause probable, étape de résolution et code inconnu. | Condition de réussite Associe correctement les erreurs connues et adopte un comportement de repli pour les causes non documentées. |
Domaine de la question Migrations | Cas de test Rupture de compatibilité, prérequis, étapes ordonnées et note de retour arrière. | Condition de réussite Respecte l'ordre et les avertissements sans mélanger les anciennes et les nouvelles procédures. |
Domaine de la question Documentation versionnée | Cas de test Poser la même question de comportement pour la version actuelle, la version précédente et une version non précisée. | Condition de réussite Répond pour la version indiquée, demande une précision en cas d'ambiguïté et cite cette version. |
Sources primaires et éléments reproductibles
Règles d'acceptation explicites
Publiez les règles avant les tests. Les réviseurs doivent parvenir au même résultat à partir de la réponse, des faits attendus et de la source citée, sans se laisser influencer par le caractère convaincant de la formulation.
| Dimension | Accepter uniquement si |
|---|---|
Dimension Qualité de la réponse | Accepter uniquement si Tous les faits requis sont exacts, pertinents, non contradictoires et utilisent la version demandée de l'API, du SDK, de la CLI ou de la documentation. |
Dimension Exactitude des citations | Accepter uniquement si Toute affirmation importante comporte une citation accessible qui l'étaye directement sur la bonne page versionnée. |
Dimension Comportement de repli | Accepter uniquement si Des éléments manquants, ambigus, contradictoires ou non autorisés entraînent l'indication claire d'une limite et d'une prochaine étape utile, plutôt qu'une supposition. |
Dimension Critère de mise en ligne | Accepter uniquement si Aucune affirmation critique non étayée sur l'authentification ou les migrations, 100 % de réussite sur les cas critiques, au moins 90 % d'acceptation globale et au moins 95 % d'exactitude des citations. |
Exemple de jeu d'évaluation, pas de résultats mesurés
Méthode : rédigez 24 questions avant d'exécuter l'assistant, soit trois par domaine de la matrice. Pour chaque question, consignez la version visée, la page de référence, les faits requis, les affirmations interdites et le comportement de repli attendu. Deux réviseurs évaluent indépendamment les réponses figées, tranchent leurs désaccords à partir de la source et conservent les invites et les sorties pour les tests de régression.
Chaque chiffre ci-dessous est un exemple hypothétique pour un jeu de 24 questions, et non un résultat mesuré de ChattyBox, une moyenne de production ou une promesse de performances futures.
| Résultat d'exemple, non mesuré | Comment utiliser l'exemple |
|---|---|
Résultat d'exemple, non mesuré Exemple : 22 réponses acceptées sur 24 (91.7%) | Comment utiliser l'exemple Interprétation de l'exemple : 20 réponses étayées et deux replis corrects. |
Résultat d'exemple, non mesuré Exemple : 20 des 22 réponses substantielles citaient directement des pages d'appui (90.9%) | Comment utiliser l'exemple Interprétation de l'exemple : en dessous du seuil de mise en ligne de 95%, le classement des versions doit être corrigé. |
Résultat d'exemple, non mesuré Exemple : les 2 replis attendus sur 2 étaient corrects (100%) | Comment utiliser l'exemple Interprétation de l'exemple : aucun cas auquel il était possible de répondre n'a déclenché un repli incorrect dans ce petit jeu de test. |
Résultat d'exemple, non mesuré Exemple : 1 réponse sur 24 contenait un détail de pagination non étayé (4.2%) | Comment utiliser l'exemple Interprétation de l'exemple : bloquez la mise en ligne jusqu'à la suppression de l'affirmation non étayée et à la réussite du test de régression. |
Capacités de base
Conçu pour les sites de documentation et de support
Des workflows conçus pour maintenir des réponses traçables, fondées sur les sources et utiles pour les utilisateurs techniques.
Scraping instantané
Entrez l’URL de vos docs, de votre site ou de votre sitemap. ChattyBox explore et indexe les pages que vos utilisateurs consultent déjà.
Garde-corps stricts
Le flux de réponse est configuré pour utiliser le contexte récupéré et éviter les affirmations non étayées sur les API, les fonctionnalités, les prix ou les politiques.
Lien vers les sources
Les réponses peuvent inclure des liens vers les pages de documentation où se trouve l'information pertinente.
Liste de contrôle du déploiement d'un chatbot documentaire
Traitez la mise en ligne comme une publication de documentation, avec des responsables, des critères, de l'observabilité et une procédure de retour arrière.
- 1Inventoriez les sources publiques et restreintes ; attribuez à chacune un responsable et un public cible.
- 2Excluez les secrets, les brouillons, les pages en double, les versions non prises en charge et les chemins privés des sources du chatbot public.
- 3Créez des cas de test traitables, insolubles, ambigus, antagonistes et présentant des conflits de versions dans les huit domaines de la matrice.
- 4Exécutez la suite d'acceptation, vérifiez manuellement les citations et bloquez la mise en ligne en cas d'affirmation critique non étayée.
- 5Menez un pilote auprès d'un public restreint ; consignez les retours, les questions non résolues, la latence et le comportement d'escalade.
- 6Publiez le nom d'un responsable, un calendrier de réindexation, une procédure d'incident, une condition de retour arrière et une fréquence récurrente de tests de régression.
Des indicateurs post-lancement qui conduisent à l'action
Segmentez chaque indicateur par sujet, version de documentation, langue et public lorsque la taille de l'échantillon le permet. Les tendances et les échantillons examinés sont plus utiles qu'un score global unique.
| Indicateur | Définition et action |
|---|---|
Indicateur Taux de réponse | Définition et action Part des questions recevant une réponse substantielle. Recherchez les contenus manquants pour les sujets à faible taux ; n'améliorez pas ce chiffre en assouplissant le comportement de repli. |
Indicateur Questions non résolues | Définition et action Questions ayant entraîné un repli, un retour négatif, des reformulations répétées ou une escalade. Examinez-en un échantillon chaque semaine pour détecter les défauts de réponse et de récupération. |
Indicateur Lacunes dans le contenu | Définition et action Groupes non résolus pour lesquels aucune page de référence n'existe. Ajoutez-les au carnet de la documentation avec leur fréquence et leur impact sur les utilisateurs. |
Indicateur Taux d'étaiement par les citations | Définition et action Part des affirmations importantes examinées qui disposent d'une citation directe à l'appui. Analysez les baisses par source et par version. |
Indicateur Déviation des tickets | Définition et action Sessions admissibles résolues sans ticket d'assistance, mesurées sur une période définie et comparées à une référence. Signalez une association, sauf si une expérience établit un lien de causalité. |
Utilisez le guide d'architecture et d'évaluation RAG pour diagnostiquer la récupération, le processus de citation pour examiner les éléments probants, le contrôle de la documentation API pour les cas d'usage propres à l'ingénierie, ainsi que la liste de contrôle technique avant la mise en ligne pour les étapes de déploiement.
FAQ sur les chatbots de documentation
Questions courantes sur les chatbots de documentation IA
Ces réponses résument la façon dont ChattyBox lit le contenu source, cite les pages de documentation, gère les informations manquantes et s'installe avec une pile de documents existante.
Puis-je utiliser un chatbot pour la documentation d’API ?
Oui, lorsque les références d’endpoints, paramètres, guides d’authentification, exemples de SDK et détails d’erreur figurent dans le contenu public indexé. Il n’exécute pas d’appels API et n’inspecte pas les comptes privés. Le contexte récupéré et les citations n’éliminent pas les comportements d’API inventés ; testez les affirmations importantes avec la référence.
Free est-il un essai ?
Non. Free est une preuve permanente à petite échelle : un site, jusqu'à 10 pages et 100 messages par mois, sans carte bancaire.
Quelles pages de documentation dois-je choisir pour commencer ?
Commencez par les pages publiques qui répondent aux questions courantes sur la configuration, le dépannage, les tarifs et le produit. Vous pourrez élargir l'ensemble de sources après avoir vérifié les premières réponses.
Quand dois-je ajouter d'autres documents ?
Ajoutez des pages lorsque le premier jeu de tests est utile et que les sources associées sont à jour. Excluez du chatbot les pages privées, obsolètes et sans rapport.
Puis-je tester les réponses avant d'installer le widget ?
Oui. Explorez les docs publics sélectionnés, posez de vraies questions techniques et ouvrez les pages sources citées pour vérifier les réponses avant d'installer le widget sur votre site de docs.
Que se passe-t-il lorsque les docs ne permettent pas de répondre ?
L'assistant doit indiquer la limite ou proposer une prochaine étape utile plutôt que de deviner. Traitez les réponses non prises en charge comme un cas de test et comme une éventuelle lacune documentaire à examiner.
Prouvez la qualité des réponses avant l'installation
Commencez avec l’offre Free permanente sur quelques pages publiques, testez des questions techniques et examinez les sources avant d’intégrer le widget.
Free permanent : 10 pages et 100 messages/mois