> 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/lia-pour-vos-lecteurs/gitbook-ai-assistant.md).

# Assistant IA

L’Assistant IA fournit aux utilisateurs des réponses précises et contextuelles issues de l’ensemble de votre base de connaissances — pas seulement de votre documentation

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FlzOUuOwM4Vffctmf3VHC%2F25_03_31_gitbook_assistant%402x.png?alt=media&amp;token=914e435f-6305-41d8-b05c-23884ceba4e7" alt="GitBook Assistant"><figcaption><p>L’assistant GitBook</p></figcaption></figure>

L’assistant IA 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 web ou à votre produit, et peut apparaître dans la barre latérale ou dans le champ de recherche de votre documentation publiée.

Considérez-le comme un expert produit disponible pour 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 à partir de la page actuelle de l’utilisateur, des pages déjà consultées et des conversations précédentes.

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

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

## Configurer l’assistant IA <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

Pour configurer l’assistant IA, ouvrez **Personnaliser**, 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 d’accueil 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 systématiquement à votre style global.

{% hint style="info" %}
Les instructions personnalisées affinent le ton et les connaissances de l’Assistant. Elles ne peuvent pas contourner ses garde-fous intégrés.
{% endhint %}

### Personnaliser un message d’accueil

Le message d’accueil 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 flux de travail spécifique.

### 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 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 flux de travail utiles.

#### Bonnes pratiques pour les questions suggérées :

* Commencez par un objectif réel de l’utilisateur (installation, dépannage, intégration).
* Utilisez les mots employés par vos utilisateurs (évitez les noms de code internes).
* Restez précis. « Comment puis-je… ? » est préférable à « Parlez-moi de… ».
* Couvrez différents types de besoins : démarrage rapide, mode d’emploi, dépannage et documentation de 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/publier/embedding/configuration/customizing-docs-embed.md#adding-suggestions).
{% endhint %}

### Choisissez où l’Assistant apparaît <a href="#choose-your-sites-search-experience" id="choose-your-sites-search-experience"></a>

Sous **Apparence**, définissez **Emplacement** pour choisir comment 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
* **Champ de recherche** — des réponses intégrées aux résultats de recherche par mots-clés, disponibles avec les formules de site Premium et Ultimate

{% hint style="info" %}
Le message d’accueil de l’Assistant s’applique uniquement à l’emplacement dans la barre latérale ; il est donc masqué lorsque **Emplacement** est défini sur **Champ de recherche**.
{% endhint %}

{% hint style="warning" %}
Désactiver **Assistant IA** puis réactiver réinitialise **Emplacement** à **Barre latérale**. Si votre site utilise l’emplacement dans le champ de recherche, configurez-le à nouveau après avoir réactivé l’Assistant.
{% endhint %}

## Utiliser l’assistant IA dans la documentation publiée <a href="#how-do-i-use-gitbook-ai-in-published-docs" id="how-do-i-use-gitbook-ai-in-published-docs"></a>

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 <kbd>⌘</kbd> + <kbd>I</kbd> sur Mac ou <kbd>Ctrl</kbd> + <kbd>I</kbd> sur PC
* Cliquez sur le **GitBook Assistant** <i class="fa-gitbook-assistant">:gitbook-assistant:</i> bouton à côté de la **Poser une question ou rechercher…** barre
* Tapez une question dans la **Poser une question ou rechercher…** barre et choisissez l’option « Poser… » en haut du menu

### Emplacement de la barre de recherche

Avec **Emplacement** défini sur **Champ 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 <kbd>⌘</kbd> + <kbd>K</kbd> sur Mac ou <kbd>Ctrl</kbd> + <kbd>K</kbd> sur PC.

En plus d’une réponse synthétisée, vos utilisateurs verront aussi ci-dessous une section dépliable qui affiche les sources que l’Assistant a utilisées pour rédiger 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 documentation et de toutes les sources que vous avez ajoutées via [les connexions](/docs/documentation/fr/lia-pour-vos-lecteurs/connections.md).

{% hint style="warning" %}
L’Assistant ne répond pas à travers des sections publiées individuelles sur différents [sites de documentation](/docs/documentation/fr/publier/publish-a-docs-site.md).

La recherche multi-section n’est disponible que lors de la consultation de [sections](/docs/documentation/fr/gerer-votre-site/site-structure/site-sections.md) qui se trouvent sur le même site.
{% endhint %}

## Recherche dans la documentation publiée

La recherche par mots-clés 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 documentation et accéder rapidement à des pages ou sections de page spécifiques sur l’ensemble de votre site.

## Intégrez l’Assistant IA 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 assistance alimentée par l’IA sans quitter votre application. L’Assistant peut être intégré dans le cadre de [Docs Embed](/docs/documentation/fr/publier/embedding.md), qui inclut l’onglet Assistant pour le chat alimenté par l’IA, l’onglet Recherche pour une découverte ciblée, et l’onglet Docs pour parcourir votre documentation.

Choisissez la méthode d’intégration qui correspond à votre stack :

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

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

* [Utiliser l’Assistant intégré avec des docs authentifiées](/docs/documentation/fr/publier/embedding/using-with-authenticated-docs.md) – Requis si vos docs nécessitent une connexion
* [Personnaliser l’intégration de l’Assistant](/docs/documentation/fr/publier/embedding/configuration/customizing-docs-embed.md) – Messages de bienvenue, actions et suggestions
* [Créer des outils d’intégration personnalisés](/docs/documentation/fr/publier/embedding/configuration/creating-custom-tools.md) – Connectez Assistant à vos API
* [Référence de l’API](/docs/documentation/fr/publier/embedding/configuration/reference.md) – 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](/docs/documentation/fr/lia-pour-vos-lecteurs/connections.md) et [serveurs MCP](/docs/documentation/fr/lia-pour-vos-lecteurs/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 IA à 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 sont idéales pour les sources riches en contenu :</p><ul><li>problèmes 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 sont idéaux pour les 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 la création de tickets ou le signalement de bugs</li><li>Sources que vous ne voulez 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 IA**

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

GitBook peut ensuite utiliser ces enregistrements dans la recherche et l’Assistant IA.
{% 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/lia-pour-vos-lecteurs/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.