> 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/ai-for-your-readers/connections.md).

# Connexions

Connectez des sources externes à AI Assistant et à GitBook Agent

Les connexions vous permettent d’intégrer du contenu externe à votre site de documentation.

Le contenu connecté peut apparaître dans [l’assistant IA](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md), afin que les visiteurs obtiennent des réponses fondées sur tout ce que vous publiez, et pas seulement sur votre documentation. Certaines connexions aident également GitBook à générer des demandes de modification et à repérer les [lacunes de contenu](https://gitbook.com/docs/documentation/fr/analytics/content-gaps.md). Une connexion à un serveur MCP peut aussi permettre aux visiteurs d’effectuer des tâches depuis votre documentation.

Dans la barre latérale de votre site, accédez à **Paramètres → Connexions**.

### Connexions disponibles

Vous pouvez connecter des plateformes d’assistance, des communautés de développeurs et d’autres sources de contenu :

* Intercom, Zendesk, Freshdesk, Front, HubSpot, Zoho Desk et Pylon
* GitHub Discussions et GitHub Issues
* YouTube, un site web ou un serveur MCP

### Comment fonctionnent les connexions

{% stepper %}
{% step %}

#### Connecter une source

Sélectionnez un type de source. Ensuite, autorisez-la ou saisissez l’URL que vous souhaitez importer dans GitBook.

{% hint style="info" %}
Si vous connectez YouTube, saisissez l’ID de la chaîne — pas le nom de la chaîne.

Un nom de canal ne fonctionnera pas pour cette source.

Dans YouTube Studio, ouvrez **Paramètres** → **Chaîne** → **Paramètres avancés**.

Copiez l’ **ID de la chaîne**.

Si l’URL de votre chaîne contient `/channel/`, copiez la partie située après `/channel/`.
{% endhint %}

Chaque connexion crée un flux d’enregistrements provenant de cette source, tels que des issues, des discussions, des tickets, des conversations, des pages ou des vidéos.
{% endstep %}

{% step %}

#### GitBook synchronise les enregistrements

Après avoir enregistré la connexion, GitBook commence à synchroniser les enregistrements provenant de cette source.

Dans la liste des connexions, vous pouvez consulter l’état de la synchronisation, le nombre d’enregistrements et l’heure de la dernière synchronisation.

Par défaut, les URL connectées sont actualisées une fois par jour. Vous pouvez aussi déclencher une actualisation manuelle depuis les **Paramètres** → **Connexions**.
{% endstep %}

{% step %}

#### Choisissez comment les enregistrements sont utilisés

Pour chaque connexion, vous pouvez choisir si ses enregistrements apparaissent dans la recherche et dans l’Assistant IA, et s’ils aident GitBook à générer des demandes de modification.

Vous pouvez également ajuster le classement de recherche de la connexion afin de prioriser ou de déprioriser ses enregistrements.
{% endstep %}
{% endstepper %}

### Vérification de vos connexions

La page Connexions se compose de trois parties : **Connecter une source** pour ajouter un connecteur, **Connexions** pour gérer celles que vous avez déjà, et **Enregistrements** pour parcourir le contenu ingéré par GitBook.

#### Le tableau des connexions

Chaque source connectée possède une ligne :

| Colonne                  | Ce qu'elle affiche                                                                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source                   | Le connecteur, ainsi que le compte, le canal ou l'URL vers lesquels il pointe.                                                                                      |
| Statut                   | Si la synchronisation la plus récente s'est terminée.                                                                                                               |
| Enregistrements          | Combien d'éléments la source a apportés, comptés dans les unités propres à cette source — pages, vidéos, discussions ou conversations.                              |
| Recherche                | Le coefficient de boost du classement de recherche de la connexion. Ce champ est vide lorsque l’option **Afficher dans la recherche / l’assistant** est désactivée. |
| Dernière synchronisation | Il y a combien de temps la connexion a été actualisée pour la dernière fois.                                                                                        |

#### Enregistrements

La liste des **Enregistrements** affiche les éléments individuels ingérés par GitBook pour toutes les connexions, du plus récent au plus ancien. Chaque enregistrement indique son titre, le connecteur d’origine, la date à laquelle GitBook l’a traité et un lien vers la source.

Un site volumineux peut accumuler des milliers d’enregistrements ; la liste est donc paginée. Utilisez-la pour vérifier qu’une source importe bien le contenu attendu avant d’activer l’option **Afficher dans la recherche / l’assistant** : si une connexion à un site Web renvoie des articles de blog alors que vous vouliez des pages de produit, vous le verrez d’abord ici.

### Paramètres de la connexion

Lorsque vous modifiez une connexion, vous pouvez configurer ces options :

#### Libellé

Utilisez **Libellé** pour donner un nom explicite à la connexion.

Cela facilite l’identification de la source dans la liste des connexions, surtout si vous connectez plusieurs dépôts, sites web ou chaînes.

#### Générer automatiquement des demandes de modification

{% hint style="warning" %}
La génération automatique des demandes de changement est en version bêta.

Consultez [Lacunes de contenu](https://gitbook.com/docs/documentation/fr/analytics/content-gaps.md) pour savoir comment GitBook repère les lacunes dans votre documentation.
{% endhint %}

Activez **Générer automatiquement des demandes de modification** pour permettre à GitBook de tirer des enseignements des enregistrements de la connexion et de suggérer des mises à jour de la documentation.

GitBook peut utiliser ces enregistrements pour créer des demandes de modification avec des changements suggérés que votre équipe pourra examiner.

#### Afficher dans la recherche / l’assistant

Activez **Afficher dans la recherche / l’assistant** pour que les visiteurs puissent rechercher les enregistrements de cette connexion et obtenir des réponses qui s’appuient sur leur contenu.

Cela permet au contenu connecté d’apparaître dans l’expérience de recherche de votre site, optimisée par l’IA, ainsi que dans les réponses de l’Assistant IA.

{% hint style="warning" %}
L’activation de l’option **Afficher dans la recherche / l’assistant** rend les enregistrements de cette connexion accessibles à toutes les personnes pouvant accéder au site, y compris aux visiteurs externes si le site est partagé avec l’extérieur.
{% endhint %}

#### Augmentation du classement dans la recherche

Utilisez **Boost du classement dans les résultats de recherche** pour donner la priorité aux enregistrements d’une connexion dans les résultats de recherche, ou au contraire les reléguer.

Augmentez la valeur si cette source doit apparaître plus souvent. Diminuez-la si cette source doit avoir moins de poids que votre documentation principale.

### Détails du connecteur

Tous les connecteurs de cette section peuvent fournir du contexte à [l’assistant IA](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md). GitBook Agent peut utiliser les enregistrements résolus pour identifier les [lacunes dans le contenu](https://gitbook.com/docs/documentation/fr/analytics/content-gaps.md) et suggérer des mises à jour de la documentation.

#### Intercom

GitBook indexe les conversations résolues avec au moins une réponse d'un agent de support humain ou IA. Il n'indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter Intercom, utilisez une clé API avec un accès en lecture aux conversations. Vous contrôlez son périmètre et sa date d’expiration.

#### Zendesk

GitBook indexe les conversations résolues avec au moins une réponse d'un agent de support humain ou IA. Il n'indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter Zendesk, saisissez le sous-domaine de votre compte Zendesk, par exemple `gitbook.zendesk.com`. Vous avez également besoin d’une clé API disposant d’un accès en lecture aux conversations. Vous pouvez en définir la portée et la date d’expiration.

#### Pylon

GitBook indexe les conversations résolues avec au moins une réponse d'un agent de support humain ou IA. Il n'indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter Pylon, utilisez des identifiants avec un accès en lecture aux conversations.

#### GitHub Discussions

GitBook indexe les discussions résolues avec au moins une réponse. Il n'indexe pas les discussions non résolues ou indésirables.

Pour connecter GitHub Discussions, utilisez des identifiants avec un accès en lecture aux discussions.

#### GitHub Issues

GitBook indexe les problèmes résolus. Il n’indexe pas les problèmes ouverts, non résolus ou indésirables.

Pour connecter GitHub Issues, utilisez des identifiants avec un accès en lecture aux issues.

#### Données stockées pour ces connecteurs

GitBook ne stocke que la conversation, la discussion ou le problème. Nous ne stockons pas de métadonnées ni d'informations personnelles.

GitBook masque les informations sensibles avant le stockage. Nous ne stockons pas d'informations sensibles dans l'enregistrement indexé.

### Conservation des données et confidentialité

#### Qu’est-ce que GitBook indexe ?

GitBook indexe le contenu de vos connexions et l’utilise dans la recherche, les demandes de modification et d’autres fonctionnalités reposant sur le contenu. Chaque élément indexé à partir d’une connexion est appelé un **enregistrement.** Les tickets Intercom et Freshdesk, les pages de sites Web et bien d’autres éléments sont des exemples d’enregistrements.

Nous utilisons les enregistrements pour suggérer des modifications de contenu et fournir un contexte supplémentaire aux agents qui travaillent dans GitBook.

Nous conservons les enregistrements tant que la source reste connectée. Si vous supprimez la connexion, nous supprimons tous les enregistrements stockés. Nous ne supprimons aucun contenu généré à l’aide de ces enregistrements comme contexte, ni le contenu des enregistrements de journaux de conversation IA stockés.

Par exemple, vous pourriez connecter Intercom et GitBook suggère une modification de la documentation basée sur un ticket d’assistance Intercom fermé. Si vous supprimez ensuite la connexion Intercom, toutes nos données stockées spécifiques à Intercom sont supprimées, mais les demandes de modification resteront.

#### FAQ

<details>

<summary>Quelle est votre politique concernant les PII ?</summary>

En général, GitBook ne demande que les champs source qu’il peut utiliser comme contexte (voir les pages des connecteurs pour plus de détails sur chaque source).

Lorsque nous ingérons un enregistrement, nous le faisons passer par des processus de masquage des PII. Le premier est un masquage en mémoire de tous les e-mails, numéros de téléphone, adresses et autres informations personnelles.

Nous faisons ensuite passer l’enregistrement par une 2e étape de traitement des données personnelles (PII) à l’aide d’un LLM tiers. Il s’agit d’une requête conforme à ZDR, sans conservation, qui n’est pas stockée sur les serveurs de notre tiers et n’est utilisée dans aucun entraînement.

Des données personnelles (PII) peuvent exister sur nos serveurs pendant quelques minutes le temps que nous effectuions ce prétraitement, mais nous ne stockons que l’enregistrement post-traité.

</details>

<details>

<summary>Envoyez-vous des données à des tiers ?</summary>

Nous utilisons un tiers pour masquer les PII après la fin de notre masquage PII initial interne.

Nous utilisons également le contenu de l’enregistrement expurgé chez des fournisseurs tiers lors de la création de demandes de modification et de la réponse aux questions des utilisateurs.

Par exemple, lors de la rédaction de contenu avec GitBook Agent, l’agent peut inclure du contenu provenant d’un enregistrement externe comme contexte supplémentaire.

</details>

<details>

<summary>GitBook utilise-t-il les données pour entraîner des modèles, directement ou via des tiers ?</summary>

Non, nous n’utilisons pas les données des enregistrements pour l’entraînement et nous vérifions auprès de nos fournisseurs tiers qu’ils ne le font pas non plus.

</details>

<details>

<summary>Puis-je limiter les enregistrements que GitBook récupère ?</summary>

Les exigences propres à chaque connecteur et les enregistrements indexés sont répertoriés dans [Détails du connecteur](#connector-details).

</details>


---

# 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/ai-for-your-readers/connections.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.
