Chat IA

Le chat IA de Docsbook est un widget sur votre site de documentation qui répond aux questions des lecteurs à partir du contenu de cette documentation. Un lecteur pose une question, le serveur recherche dans vos pages, récupère celles qui correspondent et renvoie en continu une réponse qui les cite.

Ce qu'il vaut la peine de vérifier concernant tout assistant de documentation, ce n'est pas qu'il réponde — c'est ce qu'il fait lorsqu'il ne le peut pas. Cette page constitue le contrat des deux côtés. Le pipeline lui-même se trouve dans Qualité des réponses.

Ce que vous obtenez#

Une réponse dans la page, pas un ticket. Un lecteur qui formule la question différemment de votre titre accède tout de même à la page qui y répond.
Une trace visible. Le widget affiche Found N results, puis une ligne Reading <page> pour chaque page ouverte. Chaque ligne est un lien : un lecteur sceptique peut donc aller vérifier lui-même la source.
Des citations sous la réponse. Une citation n'est conservée que si le serveur a réellement récupéré cette page pour cette question, ou si la réponse a cité son chemin dans le texte. Un chemin que le modèle n'a ni lu ni cité est supprimé avant que le lecteur ne le voie.
Des questions de suivi. Trois courtes questions suivantes sont générées à partir de la réponse et proposées sous forme de boutons.
Un relevé de ce qui a échoué. Les questions auxquelles l'assistant n'a pas pu répondre deviennent un rapport des questions sans réponse et un webhook chat.no_answer, qui répertorie les pages que vous n'avez pas encore rédigées.

Ce que l’assistant ne fera pas#

Il ne fera pas	Pourquoi
Répondre à partir de ses propres connaissances préentraînées	Le bloc d’instructions interdit de s’appuyer sur des connaissances générales pour définir un terme ou combler une lacune que votre documentation ne couvre pas
Citer une page qu’il n’a ni lue ni citée	Une citation n’est conservée que si le chemin a été cité en ligne dans la réponse ou s’il s’agit d’une page que le serveur a effectivement récupérée. La partie récupérée est étayée par construction ; la partie en ligne ne l’est pas — voir Qualité des réponses
Inventer une procédure de configuration	Pour « comment configurer X », il doit pointer vers une phrase de votre contenu indiquant un chemin de menu, un bouton ou une étape précis. Une simple mention de X ne constitue pas une procédure de configuration, et il lui est demandé de le préciser
Omettre une condition préalable indiquée	Si une page indique un forfait, un rôle, une étape précédente, une version ou un quota requis, la réponse doit le mentionner — y compris lorsque cette exigence n’est indiquée que dans l’introduction de la page
Confondre une fonctionnalité gratuite avec sa mise à niveau payante	Les pages décrivant des éléments connexes mais différents sont volontairement maintenues distinctes
Deviner une ancre	La cible du lien vers un titre cité est calculée par le serveur avec le même générateur de slug que celui qui rend votre page, et n’est jamais fournie par le modèle

Comment une réponse est-elle produite ?#

En bref ; les détails se trouvent dans Qualité des réponses.

Pré-hook facultatif. Si vous en avez enregistré un, votre endpoint reçoit d’abord la question et peut la bloquer ou injecter du contexte. Voir Hooks de chat.
Récupération. La recherche vectorielle et la recherche plein texte de Postgres sont toutes deux exécutées, puis leurs résultats sont fusionnés — avec un maximum de cinq pages au total. Deux solutions de repli lexicales couvrent les corpus dépourvus d’index vectoriel.
Chargement. Chaque page sélectionnée est lue depuis votre dépôt sur sa branche par défaut et limitée à 12 000 caractères, en conservant le début et la fin.
Génération. Les pages, votre invite système et les règles d’ancrage sont envoyées au modèle ; la réponse est renvoyée progressivement au format Markdown, accompagnée d’un tableau de citations.
Filtrage des citations. Les références sont vérifiées par rapport aux pages effectivement lues, et les ancres sont recalculées côté serveur.
Enregistrement. Le nombre de jetons et le coût du fournisseur sont inscrits dans votre registre d’utilisation ; chat.question_asked est déclenché, ainsi que chat.no_answer lorsque la réponse a reconnu qu’elle ne connaissait pas la réponse.

Ce que vous pouvez configurer#

Contrôle	Ce que cela modifie	Emplacement
Prompt système	Remplace l’instruction par défaut par votre ton et vos règles. Il est ajouté en complément des règles d’ancrage, et non à leur place	Paramètres du chat
Questions suggérées	Les prompts de démarrage dans l’état vide — le texte qui a le plus d’impact dans le widget, car il indique au lecteur à quoi sert l’assistant	Paramètres du chat
URL d’appel à l’action	L’assistant répond d’abord à la question, puis renvoie vers ce lien en une phrase — uniquement lorsque le lecteur évalue, compare ou pose des questions sur les limites, les tarifs ou les offres, et jamais plus d’une fois par réponse	Paramètres du chat
Modèle	Le modèle qui répond aux lecteurs. Gratuit avec toutes les offres	Paramètres du chat
Hooks avant / après / de streaming	Vos propres points de terminaison HTTPS autour de chaque réponse	Hooks du chat
Index sémantique	Recherche basée sur le sens en complément de la correspondance par mots-clés	Float Widget → AI Chat → Semantic Search

Un assistant qui termine chaque réponse par un lien vers les tarifs cesse d’être digne de confiance, ce qui coûte plus de conversions que cela n’en génère — c’est pourquoi l’appel à l’action est formulé comme une contrainte sur le moment où le proposer, plutôt que comme une instruction permanente de faire de la publicité.

Quel modèle exécute le chat ?#

Le modèle par défaut géré du chat des lecteurs est openai/gpt-4o-mini via OpenRouter : une fenêtre de contexte de 128 000 jetons et une limite de sortie de 16 384 jetons, selon la référence des modèles d’OpenAI. Vous pouvez plutôt choisir n’importe quel modèle du catalogue de chat, avec n’importe quel forfait, et le sélecteur affiche le prix de chaque modèle par million de jetons à côté de celui-ci.

Deux paramètres de modèle existent, car deux assistants différents sont à l’œuvre, et ils sont mesurés séparément :

Modèle du chat des visiteurs IA — ce qui répond à vos lecteurs.
Modèle de l’administrateur & de l’agent IA — ce qui exécute l’assistant dans votre tableau de bord, lequel appelle des outils et modifie votre documentation.

Ils ne constituent délibérément pas un seul paramètre. Docsbook a autrefois publié une version dans laquelle la boucle d’administration utilisait silencieusement le modèle par défaut du chat des lecteurs, car un paramètre n’avait pas été transmis, et les deux interfaces semblaient identiques de l’extérieur pendant des semaines. Un modèle évalué pour l’appel d’outils n’est pas automatiquement le modèle adapté aux questions-réponses des lecteurs, et inversement ; séparer les constantes permet de vérifier chaque choix.

Seuls les modèles du catalogue publié sont pris en charge avec la clé Docsbook, car les dépenses sont facturées au prix réel du modèle — un modèle non reconnu serait facturé à un tarif qui ne vous a jamais été affiché. Si vous utilisez votre propre clé de fournisseur, vous pouvez nommer n’importe quel modèle proposé par votre fournisseur, et l’utilisation sera imputée à votre clé au tarif de votre fournisseur plutôt qu’à votre solde Docsbook.

Disponibilité et coût#

Le chat IA destiné aux lecteurs est une fonctionnalité Pro. Dans un projet gratuit, la question d’un visiteur est refusée avant qu’un modèle ne soit appelé, quelle que soit la clé détenue par le projet — le blocage dépend du niveau d’abonnement, et non du coût ; utiliser votre propre clé ne le lève donc pas. Les propres questions du propriétaire dans le chat d’administration restent possibles avec tous les forfaits. Les forfaits actuels sont indiqués sur la page des tarifs.

Trois éléments du chat sont décomptés du solde du projet : une réponse destinée à un lecteur, la création ou la reconstruction de l’index sémantique (ainsi que la vectorisation de chaque question entrante), et l’exécution d’un agent démarrée depuis le chat. L’hébergement du widget, la diffusion de la page, la recherche par mots-clés, les retours sur les pages et les appels de hooks ne sont pas décomptés.

Les éléments décomptés et ceux qui appellent un modèle ne constituent pas la même liste, et il est utile de savoir dans quelle catégorie chacun se trouve. Deux appels de modèle sur le parcours du lecteur ne sont pas facturés aujourd’hui : les trois questions de suivi sous une réponse et la boucle de recherche agentique qui ne s’exécute que lorsque tous les récupérateurs renvoient un résultat vide. Un appel de modèle qui ne fait pas partie du parcours du lecteur est facturé : le juge qui remplit la colonne Répondu de votre onglet Chat, facturé comme un travail d’IA côté propriétaire.

Lorsque le solde est épuisé, le chat s’arrête plutôt que de continuer à facturer. La réponse propre du serveur distingue une limite du forfait d’un plafond que vous avez défini vous-même, et seule la première est comptabilisée comme un blocage par paywall — ainsi, une limite de sources que vous avez vous-même imposée n’apparaît jamais dans votre entonnoir comme une demande de mise à niveau. Dans les deux cas, le lecteur est informé que le chat a été mis en pause.

Ce que voit un lecteur lorsqu'un problème survient#

Situation	Ce que reçoit le lecteur
Aucun chat IA connecté pour ce site	Une explication simple lui demandant de contacter le propriétaire du site. Jamais de trace de la pile d'appels
Projet en formule Free	Rien. L'interface de chat n'est pas rendue du tout : il n'y a donc ni bouton ni message — le lecteur voit un site de documentation sans assistant
Solde épuisé	Le chat se met en pause et l'indique
Aucun résultat trouvé lors de la recherche	Une réponse indiquant clairement que la documentation ne couvre pas ce sujet — ainsi qu'une ligne dans votre rapport des questions sans réponse
Votre pré-hook a bloqué la question	Un message d'erreur générique. Consultez la limite ci-dessous
Échec du modèle ou du réseau	"Une erreur s'est produite. Veuillez réessayer.", dans la langue du lecteur

Limites#

Une question bloquée n’affiche pas votre raison au lecteur. La chaîne reason du pré-hook est envoyée dans le flux de réponse, mais le widget du site de documentation affiche à la place le message d’erreur générique. Dans la question, le champ est transmis et un front-end personnalisé peut le lire, mais pas le widget fourni. Considérez reason comme une valeur destinée à vos propres journaux jusqu’à ce que ce problème soit corrigé.
Le chat multijoueur est développé, mais pas activé. L’interface d’invitation, le bouton de présence et les routes d’API existent ; le transport n’existe pas encore. L’activation d’une session partagée renvoie donc « Temporairement indisponible ». Ne planifiez pas de fonctionnalités en vous basant dessus.
Le détecteur d’absence de réponse repose sur une correspondance de motifs en anglais. Un refus rédigé dans une autre langue n’est pas reconnu. Par conséquent, chat.no_answer et le rapport des questions sans réponse sous-estiment les résultats sur les sites non anglophones.
Les retours sur les réponses et les retours sur les pages sont deux séries différentes. Un pouce vers le bas sur une réponse n’est pas le même événement qu’un pouce vers le bas sur une page ; consultez Retours sur les pages pour savoir où chacun est pris en compte.
Aucun chiffre d’exactitude publié. Docsbook ne revendique aucun pourcentage d’exactitude des réponses. La page Qualité des réponses explique plutôt ce qui est mesuré et pourquoi nous ne communiquons pas de chiffre.
Le modèle de lecteur par défaut peut être modifié par le fournisseur. La fenêtre de contexte, le comportement en cas de refus et le prix dépendent de celui-ci ; le mécanisme de récupération et de citation nous appartient.

Qualité des réponses — le pipeline complet de récupération et d’ancrage, avec les sources.
Sources — ce que l’assistant peut consulter au-delà de vos propres pages.
Hooks de chat — bloquer, enrichir ou mettre en miroir chaque réponse.
Recherche — l’index de mots-clés que le chat partage avec votre champ de recherche.
Serveur MCP — gérer les paramètres du chat depuis Claude Code ou Cursor.
Tarifs — sur quoi une réponse s’appuie.

Updated Sep 5, 2026