> 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/publish/embedding.md).

# Intégrer dans votre produit

Intégrez votre documentation dans votre produit ou votre site web à l’aide de Docs Embed.

L’intégration Docs est une fenêtre puissante sur les connaissances de votre produit, que vous pouvez ajouter à n’importe quel produit ou site Web. Les utilisateurs peuvent poser des questions à [GitBook Assistant](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md), rechercher dans votre documentation ou parcourir directement les pages, sans quitter votre produit. Vous pouvez ouvrir l’intégration à l’aide d’un bouton, l’ajouter à n’importe quel composant ou la contrôler entièrement par programmation.

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-47120dd47f43cd781d9f5da4f34c80039fd765fa%2F25_10_21_emebeddable_assistant.png?alt=media" alt="Embed GitBook Assistant into your product or website"><figcaption><p>Intégrez votre documentation dans votre produit ou site web</p></figcaption></figure></div>

## Vue d’ensemble

L’intégration Docs peut contenir trois onglets :

* **Assistant**: Le [Assistant GitBook](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) — une interface de chat basée sur l’IA pour aider les utilisateurs à trouver des réponses
* **Recherche** : une interface axée sur la recherche pour trouver rapidement des pages et poser des questions ciblées
* **Documentation** : un navigateur permettant de parcourir votre site de documentation

Tous les onglets sont activés par défaut. Si vous définissez `tabs`, l’intégration n’affiche que les onglets que vous indiquez.

Vous pouvez personnaliser et remplacer la configuration par défaut à l’aide d’actions personnalisées, d’outils, de questions suggérées, de l’ [accès authentifié](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access.md) et bien plus encore.

## Commencer

{% stepper %}
{% step %}
**Prérequis**

Avant d’intégrer votre documentation, assurez-vous que :

1. **Votre documentation est publiée** et accessible à une URL (par exemple, `https://docs.company.com`).
2. **Vous avez récupéré l’URL du script d’intégration** dans les paramètres de votre site (Paramètres → IA et MCP → Intégration).

{% hint style="info" %}
Si vous souhaitez utiliser l’onglet Assistant, [GitBook Assistant doit être activé](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) pour votre site de documentation (Paramètres → IA et MCP).
{% endhint %}
{% endstep %}

{% step %}
**Mise en œuvre**

Utilisez notre skill pour intégrer rapidement GitBook Assistant à votre produit à l’aide de votre pile existante.

{% file src="/files/a126064ad2ece89666c681a5e71c858a9d2923e8" %}

Sinon, poursuivez votre lecture dans la documentation pour l’approche qui correspond à votre configuration :

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-code">:code:</i></td><td><strong>Balise script autonome</strong></td><td>Ajoutez une balise &#x3C;script> pour l’installation la plus rapide, puis personnalisez son apparence</td><td><a href="https://gitbook.com/docs/documentation/fr/publish/embedding/implementation/script.md">Balise script</a></td></tr><tr><td><i class="fa-box">:box:</i></td><td><strong>Node.js/NPM</strong></td><td>Installez via NPM pour le rendu côté serveur ou le contrôle au moment de la compilation</td><td><a href="https://gitbook.com/docs/documentation/fr/publish/embedding/implementation/nodejs.md">Node.js/NPM</a></td></tr><tr><td><i class="fa-react">:react:</i></td><td><strong>Composant React</strong></td><td>Utilisez des composants React préconçus pour une intégration fluide</td><td><a href="https://gitbook.com/docs/documentation/fr/publish/embedding/implementation/react.md">React</a></td></tr></tbody></table>

{% hint style="info" %}
Si votre documentation utilise l’ [accès authentifié](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access.md), suivez les étapes décrites dans [la procédure de configuration de l’intégration avec une documentation authentifiée](https://gitbook.com/docs/documentation/fr/publish/embedding/using-with-authenticated-docs.md).
{% endhint %}
{% endstep %}

{% step %}
**Configuration**

* [Personnaliser l’intégration](https://gitbook.com/docs/documentation/fr/publish/embedding/configuration/customizing-docs-embed.md) – Ajouter des messages de bienvenue, des actions personnalisées et des suggestions
* [Créer des outils personnalisés](https://gitbook.com/docs/documentation/fr/publish/embedding/configuration/creating-custom-tools.md) – Connecter Assistant aux API de votre produit
  {% endstep %}
  {% endstepper %}

## Pour aller plus loin

Pour consulter la référence complète de l’API et le code source, voir le [`@gitbook/embed` package sur GitHub](https://github.com/GitbookIO/gitbook/tree/main/packages/embed).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/publish/embedding.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
