# Intégrer dans votre produit

Le Docs Embed 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 leurs questions au [Assistant GitBook](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/gitbook-ai-assistant) ou parcourir directement votre documentation, sans quitter votre produit. Vous pouvez ouvrir l’Embed avec un bouton, l’intégrer dans n’importe quel composant de votre choix, ou le contrôler entièrement de manière programmatique.

<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%2F5krgZgNq1Mj79a3aVB7h%2Femebeddable_assistant.png?alt=media&#x26;token=a89feaac-3656-400b-8dcd-e7969f79d92d" 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

Le Docs Embed se compose de plusieurs onglets qui s’affichent automatiquement, selon la configuration de votre site :

* **Assistant** : Le [Assistant GitBook](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/gitbook-ai-assistant) - une interface de chat alimentée par l’IA pour aider les utilisateurs à trouver des réponses
* **Documentation** : Un navigateur pour parcourir votre site de documentation

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é](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/authenticated-access)et plus encore.

## Commencer

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

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

1. **Votre documentation est publiée** et accessible via une URL (par ex. : `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 & MCP → Embed).

{% hint style="info" %}
Si vous souhaitez utiliser l’onglet Assistant, [GitBook Assistant doit être activé](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/gitbook-ai-assistant) pour votre site de documentation (Paramètres → IA & MCP).
{% endhint %}
{% endstep %}

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

Utilisez notre assistant pour intégrer rapidement GitBook Assistant à votre produit en utilisant votre pile existante.

{% file src="<https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwQVBQvp3ux8OvL8wk785%2FGITBOOK_ASSISTANT_SKILL.md?alt=media&token=7eea78bf-1ebb-49a2-a6eb-1c5a8331542a>" %}

Sinon, poursuivez la lecture de 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><h4><i class="fa-code">:code:</i></h4></td><td><strong>Balise de script autonome</strong></td><td>Ajoutez une balise &#x3C;script> pour la configuration la plus rapide, puis personnalisez son apparence</td><td><a href="embedding/implementation/script">script</a></td></tr><tr><td><h4><i class="fa-box">:box:</i></h4></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="embedding/implementation/nodejs">nodejs</a></td></tr><tr><td><h4><i class="fa-react">:react:</i></h4></td><td><strong>Composant React</strong></td><td>Utilisez des composants React prêts à l’emploi pour une intégration fluide</td><td><a href="embedding/implementation/react">react</a></td></tr></tbody></table>

{% hint style="info" %}
Si votre documentation utilise [Accès authentifié](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/authenticated-access)， suivez les étapes dans [comment configurer l’embed avec une documentation authentifiée](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/embedding/using-with-authenticated-docs).
{% endhint %}
{% endstep %}

{% step %}
**Configuration**

* [Personnalisation de l’Embed](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/embedding/configuration/customizing-docs-embed) – Ajoutez des messages de bienvenue, des actions personnalisées et des suggestions
* [Création d’outils personnalisés](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/embedding/configuration/creating-custom-tools) – Connectez 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).