Votre documentation est excellente, mais les utilisateurs posent toujours les mêmes questions. ChattyBox transforme vos documents statiques en un agent d'assistance intelligent, disponible 24h/24 et 7j/7, qui répond instantanément.
Les chatbots IA à usage général essaient de converser avec l'utilisateur. Lorsqu'ils ne connaissent pas la réponse, ils l'inventent.
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.
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.
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.
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 |
|---|---|---|
| API | Point de terminaison, champs obligatoires, structure de la réponse et limite de débit. | Utilise la méthode et le chemin documentés ; les valeurs requises et la citation concordent avec la référence. |
| SDK | Installer et initialiser une version prise en charge du SDK. | Le paquet, l'importation, l'initialisation et la syntaxe du code correspondent au langage et à la version concernés. |
| CLI | Installer, s'authentifier, exécuter une commande et interpréter sa sortie. | Les options et leur ordre sont valides ; la réponse n'invente aucune invite interactive. |
| Authentification | Emplacement des identifiants, format de l'en-tête, portées et exemple de flux interdit. | N'expose jamais de secret, distingue les usages côté client et côté serveur, et cite l'exigence de sécurité. |
| Pagination | Première page, continuation, dernière page et taille maximale d'une page. | Utilise le modèle documenté de curseur ou de décalage et ne mentionne que les limites documentées. |
| Erreurs | Code d'erreur connu, cause probable, étape de résolution et code inconnu. | Associe correctement les erreurs connues et adopte un comportement de repli pour les causes non documentées. |
| Migrations | Rupture de compatibilité, prérequis, étapes ordonnées et note de retour arrière. | Respecte l'ordre et les avertissements sans mélanger les anciennes et les nouvelles procédures. |
| Documentation versionnée | Poser la même question de comportement pour la version actuelle, la version précédente et une version non précisée. | Répond pour la version indiquée, demande une précision en cas d'ambiguïté et cite cette version. |
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 |
|---|---|
| Qualité de la réponse | 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. |
| Exactitude des citations | Toute affirmation importante comporte une citation accessible qui l'étaye directement sur la bonne page versionnée. |
| Comportement de repli | 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. |
| Critère de mise en ligne | 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. |
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 |
|---|---|
| 22 réponses sur 24 acceptées (91,7 %) | Comprend 20 réponses étayées et deux replis corrects. |
| 20 réponses substantielles sur 22 citaient des pages qui les étayaient directement (90,9 %) | En dessous du seuil de mise en ligne de 95 % ; le classement des versions doit être corrigé. |
| Les 2 replis attendus sur 2 étaient corrects (100 %) | Dans ce petit cas de test, aucune question traitable n'a déclenché un repli à tort. |
| 1 réponse sur 24 contenait un détail non étayé sur la pagination (4,2 %) | 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. |
Des flux de travail spécialement conçus qui garantissent des réponses précises, traçables et utiles pour les utilisateurs techniques.
Entrez simplement l'URL de votre document. Nous explorons, grattons et vectorisons automatiquement chaque page en quelques minutes.
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.
Les réponses peuvent inclure des liens vers les pages de documentation où se trouve l'information pertinente.
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.
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 |
|---|---|
| Taux de réponse | 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. |
| Questions non résolues | 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. |
| Lacunes dans le contenu | 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. |
| Taux d'étaiement par les citations | Part des affirmations importantes examinées qui disposent d'une citation directe à l'appui. Analysez les baisses par source et par version. |
| Déviation des tickets | 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.
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.
ChattyBox explore vos documents publiés, votre site Web, votre plan de site, votre CMS ou vos pages du centre d'aide, extrait le texte lisible et récupère les passages pertinents lorsqu'un visiteur pose une question.
Oui. Lorsque le matériel source est disponible, ChattyBox peut afficher des liens vers les pages de documentation utilisées pour la réponse afin que les utilisateurs puissent vérifier les détails et continuer à lire.
L'assistant est conçu pour éviter les réclamations non fondées et peut revenir en arrière lorsque le contenu indexé n'inclut pas la réponse. Ces lacunes peuvent éclairer les futures mises à jour de la documentation.
Non. Vous pouvez conserver votre pile de documents actuelle et intégrer le widget ChattyBox après avoir exploré et testé les réponses citées par la source.
Rejoignez des centaines de développeurs qui utilisent ChattyBox pour automatiser la prise en charge de la documentation et réduire les tickets répétitifs.
