GitBook Assistant

GitBook Assistant fournit aux utilisateurs des réponses précises et contextuelles tirées de l’ensemble de votre base de connaissances — pas seulement de votre documentation

L’assistant GitBook

GitBook Assistant fournit à vos utilisateurs des réponses rapides et précises sur votre documentation en utilisant le langage naturel. Il est personnalisé pour vos utilisateurs, peut être intégré à votre site web ou à votre produit, et est disponible dans la barre latérale de vos docs publiées.

Voyez-le comme un expert produit accessible à tous vos utilisateurs, aux endroits et aux moments où ils en ont le plus besoin.

L’assistant utilise une recherche agentique pour comprendre le contexte des requêtes en fonction de la page actuelle de l’utilisateur, des pages lues précédemment et des conversations antérieures.

Essayez de poser une question à l’assistant dans la zone ci-dessous :

Activer GitBook Assistant

Pour activer GitBook Assistant, ouvrez le tableau de bord de votre site, accédez à la page Paramètres et choisissez IA et MCP dans le menu de gauche. Vous pouvez activer GitBook Assistant ici à partir des options disponibles.

Ajouter des questions suggérées

Les questions suggérées sont des invites rédigées à l’avance, affichées lorsque l’assistant s’ouvre sans conversation active. Elles aident les utilisateurs à comprendre ce qu’ils peuvent demander et peuvent vous aider à orienter vos utilisateurs vers des réponses ou des workflows utiles.

Vous pouvez ajouter des questions suggérées dans page Paramètresvotre site, sous la IA et MCP section.

Bonnes pratiques pour les questions suggérées :

• Commencez par un objectif utilisateur réel (configuration, dépannage, intégration).

• Utilisez les mots que vos utilisateurs utilisent (évitez les noms de code internes).

• Soyez précis. « Comment puis-je… ? » est préférable à « Parlez-moi de… ».

• Couvrez différents besoins : démarrage rapide, mode d’emploi, dépannage et référence.

Si vous intégrez l’assistant dans votre produit, vous pouvez également définir dynamiquement les suggestions dans la configuration de votre intégration. Consultez Personnalisation de l’intégration.

Utiliser GitBook Assistant dans les docs publiées

Les utilisateurs peuvent accéder à GitBook Assistant de trois façons :

• Appuyez sur ⌘ + I sur Mac ou sur Ctrl + I sur PC

• Cliquez sur le bouton GitBook Assistant à côté de la barre Poser une question ou rechercher… barre

• Saisissez une question dans la Poser une question ou rechercher… barre et choisissez l’option « Poser… » en haut du menu

Intégrer GitBook Assistant dans votre produit

Vous pouvez intégrer GitBook Assistant directement dans votre produit ou votre site web, offrant ainsi aux utilisateurs un accès instantané à une aide alimentée par l’IA sans quitter votre application. L’assistant peut être intégré dans le cadre de l’intégration de la documentation, qui comprend à la fois l’onglet Assistant pour le chat alimenté par l’IA et un onglet Docs pour parcourir votre documentation.

Choisissez la méthode d’intégration qui convient à votre pile :

• Balise de script autonome – Configuration rapide avec une balise <script>

• Node.js/NPM – Intégration côté serveur ou au moment de la compilation

• Composant React – Composants React prédéfinis

Guides supplémentaires d’intégration de l’assistant :

• Utiliser l’assistant intégré avec des docs authentifiées – Requis si vos docs nécessitent une connexion

• Personnaliser l’intégration de l’assistant – Messages de bienvenue, actions et suggestions

• Créer des outils d’intégration personnalisés – Connecter l’assistant à vos API

• Référence de l’API – Toutes les méthodes et événements disponibles

Étendre les connaissances de GitBook Assistant

GitBook Assistant peut utiliser des connaissances externes via des connexions et des serveurs MCP.

Vous pouvez utiliser les connexions lorsque vous souhaitez que GitBook synchronise des enregistrements dans votre site, ou utiliser des serveurs MCP lorsque vous souhaitez connecter GitBook Assistant à des outils personnalisés.

Connexions

Idéal pour

Les connexions fonctionnent mieux pour les sources riches en contenu :

• Issues et discussions GitHub

• Conversations Slack ou Discord

• Contenu d’assistance

• Docs externes, centres d’aide et sites web

des serveurs MCP

Idéal pour

Les serveurs MCP fonctionnent mieux pour les outils et les données en temps réel :

• État actuel du compte ou du produit

• Systèmes internes qui changent souvent

• Actions comme créer des tickets ou signaler des bugs

• Sources que vous ne voulez pas synchroniser dans GitBook

Ajouter une connexion

1

Ouvrez les paramètres de votre site

Ouvrez le tableau de bord de votre site. Puis choisissez page Paramètres → Connexions.

2

Connecter une source

Choisissez un type de source. Puis autorisez-la ou saisissez l’URL à importer.

3

Exposer les enregistrements à GitBook Assistant

Activez Exposer dans la recherche / l’assistant pour la connexion.

GitBook peut alors utiliser ces enregistrements dans la recherche et dans GitBook Assistant.

Ajouter un serveur MCP