Évaluation de documentation technique

Évaluez un chatbot avec citations de sources pour votre documentation technique

Explorez des docs publics sélectionnés, testez de vraies questions techniques et ouvrez les pages sources citées avant d'installer un chatbot sur votre site de documentation.

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.

Free permanent : 10 pages, 100 messages/mois, sans carteLes réponses prises en charge peuvent renvoyer vers le contenu source

Choisissez le bon parcours d'évaluation de la documentation

Preuve Free permanente

Utilisez Free pour une petite preuve : un site, jusqu'à 10 pages et 100 messages par mois. L'offre est permanente et ne nécessite pas de carte bancaire.

Évaluation complète d'une petite documentation publique

Au-delà de 10 pages, demandez une exploration et un test manuellement examinés de votre petite documentation publique complète. La disponibilité et le périmètre peuvent changer ; les demandes ne garantissent ni approbation ni durée.

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 strictement fondées sur vos documents
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

Un chatbot de documentation gagne la confiance en répondant aux questions répétitives que votre support et vos canaux communautaires voient déjà – et en citant la page qu'il a utilisée. Ce sont des exemples de handles ChattyBox issus du contenu de documents indexés.

« Comment puis-je démarrer, m'authentifier et faire ma première demande ? »

« Que signifie cette erreur et où le correctif est-il documenté ? »

« Quelles sont les limites du forfait, les limites de tarif et les tarifs de cette fonctionnalité ? »

« 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.

Éléments éditoriaux vérifié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: 9 juillet 2026
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.

Matrice d'évaluation des questions sur les API, SDK, CLI, l'authentification, la pagination, les erreurs, les migrations et la documentation versionnée — Une suite équilibrée teste les réponses factuelles, les étapes de procédure, les limites entre versions, les citations et le comportement de repli prévu.

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

Cadre de gestion des risques liés à l'IA du NISTRéférence pour la mesure, le suivi et la gouvernance.

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 d'évaluation comparative : un cas délimité avant la mise en ligne

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.

Les chiffres ci-dessous illustrent un résultat obtenu avec ce cas de 24 questions ; ils ne constituent ni une moyenne mesurée en production pour ChattyBox ni une promesse de performances futures.

Résultat observé	Interprétation
Résultat observé 22 réponses sur 24 acceptées (91,7 %)	Interprétation Comprend 20 réponses étayées et deux replis corrects.
Résultat observé 20 réponses substantielles sur 22 citaient des pages qui les étayaient directement (90,9 %)	Interprétation En dessous du seuil de mise en ligne de 95 % ; le classement des versions doit être corrigé.
Résultat observé Les 2 replis attendus sur 2 étaient corrects (100 %)	Interprétation Dans ce petit cas de test, aucune question traitable n'a déclenché un repli à tort.
Résultat observé 1 réponse sur 24 contenait un détail non étayé sur la pagination (4,2 %)	Interprétation La mise en ligne reste bloquée 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

Des flux de travail spécialement conçus qui garantissent des réponses précises, traçables et utiles pour les utilisateurs techniques.

Grattage instantané

Entrez simplement l'URL de votre document. Nous explorons, grattons et vectorisons automatiquement chaque page en quelques minutes.

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 sans autorisation de récupération.
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 guide de documentation pour développeurs 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.

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.

Puis-je évaluer plus de 10 pages ?

Pour une petite documentation publique complète, demandez une évaluation examinée manuellement. La disponibilité et le périmètre peuvent changer ; une demande ne garantit ni l'approbation ni une durée d'évaluation précise.

ChattyBox peut-il explorer toute ma documentation publique ?

Vous sélectionnez les sources publiques à explorer. L'exploration complète d'un petit site de documentation publique est étudiée via la demande d'évaluation manuelle, plutôt que garantie par Free.

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 la preuve Free permanente pour des pages publiques sélectionnées, ou demandez une évaluation manuelle de tout le site pour une petite documentation publique complète. Testez les questions techniques et vérifiez les sources avant d'intégrer le widget.