Assistant GitBook

GitBook Assistant offre aux utilisateurs des réponses basées sur vos docs et adaptées à leur situation — pas seulement des réponses génériques

L'assistant GitBook

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

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

L'Assistant utilise la récupération agentique pour comprendre le contexte des requêtes en se basant sur la page actuelle de l'utilisateur, les pages lues précédemment et les conversations antérieures.

Essayez de poser une question à l'Assistant dans la boîte ci-dessous :

Activer GitBook Assistant

Pour activer GitBook Assistant, ouvrez le tableau de bord de votre site, allez dans Paramètres page et choisissez IA & MCP dans le menu de gauche. Ici, vous pouvez activer GitBook Assistant parmi les options disponibles.

Ajouter des questions suggérées

Les questions suggérées sont des invites préécrites 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 le Paramètresde votre site, sous la IA & 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).

• Restez précis. « Comment faire pour… ? » vaut mieux que « Parlez-moi de… ».

• Couvrez différentes intentions : démarrage rapide, tutoriel, dépannage et référence.

Si vous intégrez l'Assistant dans votre produit, vous pouvez également définir dynamiquement des suggestions dans la configuration de l'intégration. Voir Personnaliser l'intégration.

Utiliser GitBook Assistant dans les docs publiés

Les utilisateurs peuvent accéder à GitBook Assistant de trois manières :

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

• Cliquez sur le bouton GitBook Assistant

  

  à côté de la barre "Poser ou rechercher…" barre

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

Étendre GitBook Assistant avec des serveurs MCP

Vous pouvez également ajouter des sources de données externes à GitBook Assistant pour lui donner plus de contexte et de données à partir desquelles extraire des réponses. Vous pouvez le faire en connectant l'Assistant à des serveurs MCP pour des plateformes externes, telles que :

• Votre communauté (Slack, Discord, GitHub Communities, etc.)

• Outils de support (Intercom, etc.)

• La feuille de route future de votre produit (GitHub, Linear, etc.)

• Docs pour intégrations externes avec des produits

Pour ajouter un serveur MCP à GitBook Assistant, suivez ces étapes :

1

Ouvrez les paramètres de votre site

Accédez au tableau de bord de votre site et choisissez l'option Paramètres dans l'en-tête du site. Ensuite, choisissez la IA & MCP section dans le menu de gauche

2

Ajouter un nouveau serveur

En bas de la page se trouve un tableau montrant tous les serveurs MCP connectés. Pour ajouter un nouveau serveur, cliquez sur Ajouter un serveur MCP

3

Choisissez votre serveur MCP

Pour ajouter votre serveur, vous devrez lui donner un nom, ajouter l'URL du serveur et configurer les en-têtes HTTP qui seront envoyés avec la requête au serveur lorsque un utilisateur soumettra une requête.