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

# Intégrer dans votre produit

L'intégration Docs est une fenêtre puissante sur vos connaissances produit que vous pouvez ajouter à n'importe quel produit ou site web. Les utilisateurs peuvent poser des questions à [Assistant GitBook](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md), recherchez dans votre documentation ou parcourez directement les pages sans quitter votre produit. Vous pouvez ouvrir l'intégration avec un bouton, l'insérer dans n'importe quel composant de votre choix ou la contrôler entièrement par programmation.

<div data-with-frame="true"><figure><img src="/files/fa30e5d6314d06e869ba314fbf52aff416db952f" alt="Embed GitBook Assistant into your product or website"><figcaption><p>Intégrez votre documentation à votre produit ou site web</p></figcaption></figure></div>

## Vue d'ensemble

L'intégration Docs peut contenir trois onglets :

* **Assistant**: Le [Assistant GitBook](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md) - une interface de chat optimisée par 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
* **Docs**: un navigateur pour 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 listez.

Vous pouvez personnaliser et remplacer la configuration par défaut avec des actions personnalisées, des outils, des questions suggérées, [Accès authentifié](/docs/documentation/fr/publier/site-audience/authenticated-access.md), et plus encore.

## Commencer

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

Avant d'intégrer votre documentation, assurez-vous de :

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

{% hint style="info" %}
Si vous souhaitez utiliser l'onglet Assistant, [l'Assistant GitBook doit être activé](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md) pour votre site de documentation (Paramètres → IA & MCP).
{% endhint %}
{% endstep %}

{% step %}
**Implémentation**

Utilisez notre outil pour intégrer rapidement GitBook Assistant à votre produit avec votre pile existante.

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

Sinon, poursuivez votre lecture dans la documentation pour trouver 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 la configuration la plus rapide, puis personnalisez son apparence</td><td><a href="/pages/4dc1d3f8d5ec9575d99303b30bef8f5f1d640815">/pages/4dc1d3f8d5ec9575d99303b30bef8f5f1d640815</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="/pages/e8c7f9c571db4eda727e3880fc19ac45de2dd07d">/pages/e8c7f9c571db4eda727e3880fc19ac45de2dd07d</a></td></tr><tr><td><i class="fa-react">:react:</i></td><td><strong>Composant React</strong></td><td>Utilisez des composants React préconstruits pour une intégration fluide</td><td><a href="/pages/070ed664c89c2f2d14982a633fb3100c008fee72">/pages/070ed664c89c2f2d14982a633fb3100c008fee72</a></td></tr></tbody></table>

{% hint style="info" %}
Si votre documentation utilise [Accès authentifié](/docs/documentation/fr/publier/site-audience/authenticated-access.md), suivez les étapes de [comment configurer l'intégration avec une documentation authentifiée](/docs/documentation/fr/publier/embedding/using-with-authenticated-docs.md).
{% endhint %}
{% endstep %}

{% step %}
**Configuration**

* [Personnaliser l'intégration](/docs/documentation/fr/publier/embedding/configuration/customizing-docs-embed.md) – Ajoutez des messages de bienvenue, des actions personnalisées et des suggestions
* [Créer des outils personnalisés](/docs/documentation/fr/publier/embedding/configuration/creating-custom-tools.md) – Connectez l'Assistant à vos API produit
  {% endstep %}
  {% endstepper %}

## Pour aller plus loin

Pour la référence complète de l'API et le code source, consultez 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 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/publier/embedding.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.