Assistant IA
L’Assistant IA fournit aux utilisateurs des réponses exactes et contextuelles tirées de l’ensemble de votre base de connaissances — pas seulement de votre documentation
L’assistant IA donne à 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 peut apparaître dans la barre latérale ou la zone de recherche de vos docs publiées.
Considérez-le comme un expert produit à la disposition de tous vos utilisateurs, aux endroits et aux moments où ils en ont le plus besoin.
L’assistant utilise une récupération agentique pour comprendre le contexte des requêtes en fonction de la page actuelle de l’utilisateur, des pages déjà lues et des conversations précédentes.
Essayez de poser une question à l’assistant dans la zone ci-dessous :
Configurer l’assistant IA
Pour configurer l’assistant IA, ouvrez menu, sous Outils dans la barre latérale du site, puis cliquez sur Assistant IA. Vous pouvez ici activer l’assistant et personnaliser ses instructions, son message de bienvenue et les questions suggérées.
Ajouter des instructions personnalisées
Les instructions personnalisées ajustent le ton de l’assistant et ajoutent des connaissances ou une terminologie propres au produit, afin que ses réponses correspondent toujours à votre style global.
Personnaliser un message de bienvenue
Le message de bienvenue est la première chose que les visiteurs voient lorsqu’ils ouvrent l’assistant sans conversation en cours. Utilisez-le pour définir les attentes ou orienter les utilisateurs vers un workflow spécifique.
Ajouter des questions suggérées
Les questions suggérées sont des invites prédéfinies affichées lorsque l’assistant s’ouvre sans conversation en cours. 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.
Bonnes pratiques pour les questions suggérées :
Commencez par un objectif réel de l’utilisateur (configuration, dépannage, intégration).
Utilisez les mots employés par vos utilisateurs (évitez les noms de code internes).
Restez spécifique. « Comment puis-je… ? » est préférable à « Parlez-moi de… ».
Couvrez différents types d’intention : démarrage rapide, mode d’emploi, dépannage et référence.
Choisissez où l’assistant apparaît
Sous Apparence, définissez Emplacement pour choisir où les lecteurs accèdent à l’assistant :
Barre latérale (par défaut) — l’expérience de chat complète, disponible avec les formules de site Ultimate
Zone de recherche — des réponses intégrées à côté des résultats de recherche par mot-clé, disponibles avec les formules de site Premium et Ultimate
La désactivation Assistant IA puis la réactivation réinitialise Emplacement de Barre latérale. Si votre site utilise l’emplacement dans la barre de recherche, définissez-le à nouveau après avoir réactivé l’assistant.
Utiliser l’assistant IA dans les docs publiées
La manière dont les lecteurs accèdent à l’assistant dépend de son emplacement.
Emplacement dans la barre latérale
Les utilisateurs peuvent accéder à l’assistant GitBook de trois façons :
Appuyez sur ⌘ + I sur Mac ou Ctrl + I sur PC
Cliquez sur le GitBook Assistant bouton à côté du 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
Emplacement dans la barre de recherche
Avec Emplacement défini sur Zone de recherche, les utilisateurs peuvent poser une question directement dans la Poser une question ou rechercher… barre en haut de la page, à côté des résultats par mot-clé.
Ils peuvent l’ouvrir en cliquant directement dessus, ou en appuyant sur ⌘ + K sur Mac ou Ctrl + K sur PC.
En plus d’une réponse synthétique, vos utilisateurs verront aussi, en dessous, une section dépliable qui affiche les sources utilisées par l’assistant pour créer sa réponse, ainsi que des questions connexes sur lesquelles vous pouvez cliquer pour poursuivre.
L’assistant répond à partir du contenu de votre site de docs, ainsi que de toutes les sources que vous avez ajoutées via les connexions.
L’assistant ne répond pas à travers des sections publiées individuelles sur différents sites de docs.
La recherche multi-section n’est disponible que lors de l’affichage de sections qui se trouvent sur le même site.
Recherche dans la documentation publiée
La recherche par mot-clé est automatiquement activée sur chaque site, que l’assistant soit activé ou non.
Vos utilisateurs peuvent rechercher des mots-clés dans votre site de docs et accéder rapidement à des pages ou à des sections de page spécifiques sur l’ensemble de votre site.
Intégrez l’assistant IA dans votre produit
Vous pouvez intégrer directement l’assistant GitBook à votre produit ou à votre site web, offrant aux utilisateurs un accès instantané à une aide propulsée par l’IA sans quitter votre application. L’assistant peut être intégré dans le cadre de Intégration Docs, qui inclut l’onglet Assistant pour le chat alimenté par l’IA, l’onglet Recherche pour la découverte ciblée et l’onglet Docs pour parcourir votre documentation.
Choisissez la méthode d’intégration qui convient à votre stack :
Balise <script> autonome – Configuration rapide avec une
<script>baliseNode.js/NPM – Intégration côté serveur ou au moment de la compilation
Composant React – Composants React préconstruits
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 tous les événements disponibles
Étendez les connaissances de l’assistant IA
L’assistant IA peut utiliser des connaissances externes via les connexions et des serveurs MCP.
Vous pouvez utiliser des connexions lorsque vous souhaitez que GitBook synchronise des enregistrements dans votre site, ou utiliser des serveurs MCP lorsque vous souhaitez connecter l’assistant IA à des outils personnalisés.
Connexions
Les connexions conviennent mieux aux sources riches en contenu :
tickets et discussions GitHub
conversations Slack ou Discord
contenu d’assistance
docs externes, centres d’aide et sites web
des serveurs MCP
Les serveurs MCP conviennent mieux aux outils et aux données en temps réel :
État actuel du compte ou du produit
Systèmes internes qui changent souvent
Actions telles que la création de tickets ou le signalement de bugs
Sources que vous ne souhaitez pas synchroniser dans GitBook
Ouvrez les paramètres de votre site
Ouvrez le tableau de bord de votre site. Ensuite, choisissez Paramètres → Connexions.
Connecter une source
Choisissez un type de source. Ensuite, autorisez-la ou saisissez l’URL à importer.
Exposer les enregistrements à l’assistant IA
Activer Exposer dans la recherche / l’assistant pour la connexion.
GitBook peut alors utiliser ces enregistrements dans la recherche et l’assistant IA.
Ouvrez les paramètres de votre site
Ouvrez le tableau de bord de votre site. Ensuite, choisissez Paramètres → IA et MCP.
Ajouter un nouveau serveur
Dans le tableau des serveurs MCP, cliquez sur Ajouter un serveur MCP.
Saisissez les détails du serveur
Donnez un nom au serveur. Ajoutez son URL.
Configurez ensuite tous les en-têtes HTTP que GitBook doit envoyer avec chaque requête.
Mis à jour
Ce contenu vous a-t-il été utile ?