> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant.md).

# GitBook Assistant

{% hint style="info" %}
Cette fonctionnalité est disponible sur le [plan de site Ultime](https://www.gitbook.com/pricing).
{% endhint %}

<figure><img src="/files/dd3d963a9b2603b275a90605c415656d6028a9d5" alt="GitBook Assistant"><figcaption><p>L’assistant GitBook</p></figcaption></figure>

GitBook Assistant offre à 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 web ou à votre produit, et est disponible dans la barre latérale de vos docs publiés.

Considérez-le comme un expert produit accessible à tous vos utilisateurs, là où et quand 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 lues précédemment et des conversations précédentes.

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

<p align="center"><button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">Posez une question...</button></p>

## Activer GitBook Assistant <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

Pour activer GitBook Assistant, ouvrez **menu Personnaliser**, sous **Outils** dans la barre latérale du site, puis cliquez sur **Assistant IA**. Ici, vous pouvez activer GitBook Assistant parmi les 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 les **Paramètres**, dans la **IA et MCP** section.

#### **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).
* Soyez précis. « Comment puis-je… ? » vaut mieux que « Parlez-moi de… ».
* Couvrez différents objectifs : démarrage rapide, mode d’emploi, dépannage et référence.

{% hint style="info" %}
Si vous intégrez l’Assistant dans votre produit, vous pouvez également définir dynamiquement des suggestions dans votre configuration d’intégration. Voir [Personnaliser l’intégration](/docs/documentation/fr/docs-site/embedding/configuration/customizing-docs-embed.md#adding-suggestions).
{% endhint %}

## Utiliser GitBook Assistant dans les docs publiés <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

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

* Appuyez sur <kbd>⌘</kbd> + <kbd>I</kbd> sur Mac ou <kbd>Ctrl</kbd> + <kbd>I</kbd> sur PC
* Cliquez sur le **GitBook Assistant** <picture><source srcset="/files/KOSE771IpEtAlfLNdKX1" media="(prefers-color-scheme: dark)"><img src="/files/6e0689fe0d90fea7ac186eb3e91b5b73bf9ddea8" alt=""></picture> bouton à côté de la **Demander ou rechercher…** barre
* Saisissez une question dans la **Demander ou rechercher…** barre et choisissez l’option « Demander… » 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 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](/docs/documentation/fr/docs-site/embedding.md), qui comprend l’onglet Assistant pour le chat propulsé 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 pile :

* [**Balise de script autonome**](/docs/documentation/fr/docs-site/embedding/implementation/script.md) – Installation rapide avec une `<script>` balise
* [**Node.js/NPM**](/docs/documentation/fr/docs-site/embedding/implementation/nodejs.md) – Intégration côté serveur ou au moment de la compilation
* [**Composant React**](/docs/documentation/fr/docs-site/embedding/implementation/react.md) – Composants React prédéfinis

### Guides supplémentaires d’intégration de l’Assistant :

* [Utiliser l’Assistant intégré avec des documents authentifiés](/docs/documentation/fr/docs-site/embedding/using-with-authenticated-docs.md) – Requis si vos documents nécessitent une connexion
* [Personnaliser l’intégration de l’Assistant](/docs/documentation/fr/docs-site/embedding/configuration/customizing-docs-embed.md) – Messages de bienvenue, actions et suggestions
* [Créer des outils d’intégration personnalisés](/docs/documentation/fr/docs-site/embedding/configuration/creating-custom-tools.md) – Connecter l’Assistant à vos API
* [Référence de l’API](/docs/documentation/fr/docs-site/embedding/configuration/reference.md) – Toutes les méthodes et événements disponibles

## Étendre les connaissances de l’Assistant GitBook

L’Assistant GitBook peut utiliser des connaissances externes via [connexions](/docs/documentation/fr/ia-et-recherche/connections.md) et [serveurs MCP](/docs/documentation/fr/ia-et-recherche/mcp-servers-for-published-docs.md).

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 GitBook à des outils personnalisés.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th>Idéal pour</th></tr></thead><tbody><tr><td><strong>Connexions</strong></td><td><p>Les connexions conviennent le mieux aux sources riches en contenu :</p><ul><li>tickets et discussions GitHub</li><li>conversations Slack ou Discord</li><li>Contenu d’assistance</li><li>Documentation externe, centres d’aide et sites web</li></ul></td></tr><tr><td><strong>serveurs MCP</strong></td><td><p>Les serveurs MCP conviennent le mieux aux outils et données en direct :</p><ul><li>État actuel du compte ou du produit</li><li>Systèmes internes qui changent souvent</li><li>Actions comme créer des tickets ou signaler des bugs</li><li>Sources que vous ne souhaitez pas synchroniser dans GitBook</li></ul></td></tr></tbody></table>

{% tabs %}
{% tab title="Ajouter une connexion" %}
{% stepper %}
{% step %}
**Ouvrez les paramètres de votre site**

Ouvrez le tableau de bord de votre site. Puis choisissez **Paramètres** → **Connexions**.
{% endstep %}

{% step %}
**Connecter une source**

Choisissez un type de source. Puis autorisez-la, ou saisissez l’URL à importer.
{% endstep %}

{% step %}
**Exposer les enregistrements à l’Assistant GitBook**

Activer **Exposer dans la recherche / l’Assistant** pour la connexion.

GitBook peut alors utiliser ces enregistrements dans la recherche et l’Assistant GitBook.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Ajouter un serveur MCP" %}
{% stepper %}
{% step %}
**Ouvrez les paramètres de votre site**

Ouvrez le tableau de bord de votre site. Puis choisissez **Paramètres** → **IA et MCP**.
{% endstep %}

{% step %}
**Ajouter un nouveau serveur**

Dans le tableau des serveurs MCP, cliquez sur **Ajouter un serveur MCP**.
{% endstep %}

{% step %}
**Saisissez les détails du serveur**

Donnez un nom au serveur. Ajoutez son URL.

Puis configurez les en-têtes HTTP que GitBook doit envoyer avec chaque requête.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.