Chat AI

Docsbook Chat AI est un widget de chat sur votre site de documentation qui répond à partir du contenu de cette documentation, et non à partir de la mémoire du modèle. Un lecteur pose une question, l'assistant recherche vos pages, ouvre celles qui sont pertinentes et renvoie une réponse qui cite les pages utilisées.

Comment Docsbook AI Chat répond-il à une question ?#

Docsbook AI Chat répond avec un flux de génération augmentée par récupération (RAG) basé sur des appels d'outils. Le modèle décide quand appeler chaque outil, et le widget montre la trace en direct de chaque étape, afin qu'un lecteur puisse voir de quelle page provient une réponse.

1. Recherche — l'assistant recherche dans votre documentation des sections pertinentes.
2. Lire — il ouvre des pages spécifiques et cite le texte dont il a besoin.
3. Répondre — il compose la réponse et la diffuse au lecteur via streamdown.

Chaque appel est enregistré, vous pouvez donc plus tard inspecter ce qui a été demandé, ce qui a été récupéré et si le lecteur a trouvé la réponse utile. Comme l'assistant répond à partir de vos pages indexées, un lecteur qui aurait autrement ouvert un ticket de support obtient la réponse sur la page — et une question à laquelle l'assistant n'a pas pu répondre apparaît comme un écart documenté plutôt que comme un e-mail.

Quel est le coût d'exécution de Docsbook AI Chat?#

Chaque réponse que Docsbook AI Chat diffuse s'appuie sur le solde du projet pour lequel elle a répondu. Rien d'autre dans le chat n'est mesuré : l'hébergement du widget, le service de la page et la recherche du lecteur ne sont pas comptabilisés.

Trois choses dans le chat dépensent le solde, et ce sont les trois qui appellent un modèle :

• Une réponse à un lecteur.
• La construction ou la reconstruction de l'index sémantique.
• Un agent exécuté à partir du chat.

Les prix actuels et ce qu'un plan inclut se trouvent sur la page de tarification de Docsbook — elle est générée à partir des constantes de facturation en direct à chaque demande, donc c'est le seul chiffre qui vaut la peine d'être cité. Lorsque le solde d'un projet est épuisé, le chat AI se met en pause au lieu de vous facturer davantage, et le widget le signale.

Recherche sémantique#

La recherche sémantique remplace la correspondance par mots-clés à l'étape 1 par une récupération basée sur le sens : chaque section de votre documentation est intégrée une fois, et Docsbook AI Chat trouve ensuite le bon passage même lorsque les mots du lecteur ne se chevauchent pas avec ceux de la page. Un lecteur qui demande "pourquoi mon site est-il vide après un push" atteint la page d'échec de construction qui n'utilise jamais le mot "vide".

Activez-le dans Float Widget → AI Chat onglet → Recherche Sémantique. La carte est l'endroit où vous l'opérez :

• L'interrupteur — activez ou désactivez la récupération basée sur le sens pour le chat.
• Synchronisation en direct — une fois que l'index existe, il se resynchronise à chaque commit de vos docs, donc vous n'avez pas à vous souvenir de le reconstruire.
• Dernière mise à jour — si l'index reflète votre contenu actuel.
• Construire / Reconstruire — montre une estimation des coûts avant qu'il ne s'exécute, un progrès en direct que vous pouvez annuler, et les jetons et le coût après une exécution.

La construction de l'index appelle un modèle d'intégration sur l'ensemble de votre corpus, c'est pourquoi l'estimation est affichée avant l'exécution plutôt qu'après. Vous pouvez limiter les dépenses par source — voir la limite de Index Sémantique dans Plans Premium.

Personnalisation#

Vous contrôlez le comportement du chatbot sans écrire de code backend :

• Questions suggérées — remplissez l'état vide avec 3 à 5 invites de démarrage. Ce sont les textes les plus importants dans le widget : ils indiquent à un lecteur à quoi sert l'assistant.
• Invite système — remplacez l'ensemble d'instructions par défaut par votre propre voix et vos règles.
• Hooks pré/post-LLM — transformez l'invite avant que le modèle ne la voie, et post-traitez la réponse avant que le lecteur ne la voie. Voir Hooks de chat.

Quel modèle fait fonctionner le chat?#

Docsbook fait fonctionner le chat via OpenRouter par défaut, sur openai/gpt-4o-mini, et vous choisissez un modèle différent dans les paramètres de l'espace de travail. Le fournisseur peut être l'un des suivants :

providers:
  - openrouter
  - openai
  - gemini
  - anthropic

Il y a deux paramètres de modèle sous Paramètres ▸ Chat, car deux modèles différents sont en action :

• Modèle de chat AI Visitors — ce qui répond à vos lecteurs dans le chat des docs.
• Modèle Admin & AI Agent — ce qui fait fonctionner l'assistant dans votre tableau de bord : celui qui lit vos analyses, appelle des outils et édite vos docs.

Chaque paramètre liste ses propres modèles avec le prix par 1M de tokens à côté d'eux, donc un chat de lecteur bon marché et un assistant admin plus puissant — ou l'inverse — est un choix chacun. Un modèle moins cher permet de faire durer le même équilibre. Les traductions ont un paramètre de modèle qui leur est propre sous Paramètres ▸ Traductions.

Vous pouvez également apporter votre propre clé API de fournisseur depuis les paramètres de l'espace de travail. L'utilisation va alors à votre clé au prix propre du fournisseur et n'est pas déduite de votre solde Docsbook.

Chat multijoueur#

Appuyez sur Inviter dans la barre d'outils du chat pour amener un coéquipier dans la même session en direct. Les questions de documentation sont rarement un travail en solo : quelqu'un demande, quelqu'un d'autre connaît la moitié de la réponse, et le résultat finit par être collé dans Slack où personne ne le retrouve.

• Voir qui est là. Le bouton montre qui de votre équipe est actuellement dans ce chat.
• Inviter par e-mail. L'invitation fonctionne que le destinataire ait ou non déjà un compte Docsbook — le lien les guide à travers la connexion et directement dans le projet.
• Une réponse partagée. Vous posez tous les deux des questions, et vous regardez tous les deux le même flux de réponses arriver, de sorte qu'il parvienne à tout le monde en même temps au lieu d'être relayé au second degré.

Les sessions sont uniquement en direct. Rien concernant un chat partagé n'est enregistré après le départ de tout le monde.

Ce qu'un lecteur voit lorsque aucun chat n'est connecté#

Si un lecteur ouvre le widget de chat sur un site de documentation qui n'a pas de chat AI connecté, il voit une explication simple au lieu d'une erreur, lui demandant de contacter le propriétaire du site pour le configurer. Le widget ne tombe jamais silencieusement en panne et ne montre jamais de trace de pile à un lecteur.

Liens#

• Hooks de chat — intercepter le prompt et la réponse.
• Sources — ce que l'assistant lit avant de répondre.
• Serveur MCP — gérer les paramètres de chat depuis Claude Code.
• Tarification — sur quoi repose une réponse.