> 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/ia-et-recherche/connections.md).

# Connexions

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

Le contenu connecté peut apparaître dans [la recherche IA](/docs/documentation/fr/docs-site/ai-search.md) et [GitBook Assistant](/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant.md). Certaines connexions peuvent également aider GitBook à générer des demandes de modification.

Pour ajouter une connexion, ouvrez les **Paramètres** de votre site et cliquez sur **Connexions**.

<figure><img src="/files/bbd1b2ab540949a6c233a26a9fead68ef492f95f" alt=""><figcaption></figcaption></figure>

### Connexions disponibles

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

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Intercom</h4></td><td><a href="/pages/1da6a0148371717e37ea9aa6c30b3203220099bb">/pages/1da6a0148371717e37ea9aa6c30b3203220099bb</a></td></tr><tr><td><h4>Zendesk</h4></td><td><a href="/pages/b164b14f36814bfc4fa15edc7c740f2d2e252c4e">/pages/b164b14f36814bfc4fa15edc7c740f2d2e252c4e</a></td></tr><tr><td><h4>Freshdesk</h4></td><td></td></tr><tr><td><h4>Front</h4></td><td></td></tr><tr><td><h4>HubSpot</h4></td><td></td></tr><tr><td><h4>Zoho Desk</h4></td><td></td></tr><tr><td><h4>Pylon</h4></td><td><a href="/pages/f30050f26f2d455c573a1355f508c7acdd98e264">/pages/f30050f26f2d455c573a1355f508c7acdd98e264</a></td></tr><tr><td><h4>Discussions GitHub</h4></td><td><a href="/pages/4dc1e26023ed68662bb8fd82a10f2fd307eb8dfa">/pages/4dc1e26023ed68662bb8fd82a10f2fd307eb8dfa</a></td></tr><tr><td><h4>Problèmes GitHub</h4></td><td><a href="/pages/63b881e9caf29a7d08ff8bc51cbf6cf61e40b303">/pages/63b881e9caf29a7d08ff8bc51cbf6cf61e40b303</a></td></tr><tr><td><h4>YouTube</h4></td><td></td></tr><tr><td><h4>Site web</h4></td><td></td></tr><tr><td><h4>Serveur MCP</h4></td><td></td></tr></tbody></table>

### 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 faire importer par GitBook.

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

Un nom de chaîne 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 après `/channel/`.
{% endhint %}

Chaque connexion crée un flux d’enregistrements provenant de cette source, comme des problèmes, 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 de cette source.

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

Les URL connectées se rafraîchissent par défaut une fois par jour. Vous pouvez également lancer un rafraîchissement manuellement depuis les **Paramètres** → **Connexions**.
{% endstep %}

{% step %}

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

Pour chaque connexion, vous pouvez choisir si ses enregistrements apparaissent dans la recherche et GitBook Assistant, 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 donner plus ou moins de priorité à ses enregistrements.
{% endstep %}
{% endstepper %}

### Paramètres de la connexion

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

#### Étiquette

Utiliser **Étiquette** pour donner à la connexion un nom clair.

Cela facilite l’identification de la source dans la liste des connexions, en particulier 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 de demandes de modification est actuellement en accès anticipé.

Voir [Améliorations automatiques de la documentation](/docs/documentation/fr/agent-gitbook/automatic-docs-improvements.md) pour obtenir des informations sur la demande d’accès
{% endhint %}

Activez **Générer automatiquement des demandes de modification** pour permettre à GitBook d’apprendre à partir 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 rendre les enregistrements de cette connexion recherchables par les visiteurs et disponibles pour répondre aux questions.

Cela permet au contenu connecté d’apparaître dans l’expérience de recherche basée sur l’IA de votre site et dans les réponses de GitBook Assistant.

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

#### Boost du classement dans la recherche

Utiliser **Boost du classement dans la recherche** pour donner plus ou moins de priorité aux enregistrements d’une connexion dans la recherche.

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

### Conservation des données et confidentialité

#### Que GitBook indexe-t-il ?

GitBook indexe le contenu de vos connexions et l’utilise dans la recherche, les demandes de modification et d’autres fonctionnalités pilotées par le contenu. Chaque élément que nous indexons depuis une connexion est appelé un **enregistrement.** Parmi les exemples d’enregistrements, on trouve les tickets Intercom, les tickets Freshdesk, les pages de site web, et bien plus encore.

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, et ne supprimons pas non plus le contenu des enregistrements de vos journaux de conversations IA stockés.

Par exemple, vous pourriez connecter Intercom et GitBook suggère une modification de la documentation à partir d’un ticket d’assistance Intercom clos. 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.

Vous trouverez plus d’informations sur nos connecteurs sur la page spécifique de chaque connecteur.

#### FAQ

<details>

<summary>Quelle est votre politique concernant les données personnelles identifiables ?</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 प्रक्रés de masquage des données personnelles identifiables. La première consiste en un masquage en mémoire des e-mails, numéros de téléphone, adresses et autres informations personnelles.

Nous faisons ensuite passer l’enregistrement par une 2e étape de masquage des données personnelles identifiables à l’aide d’un LLM tiers. Il s’agit d’une requête sans stockage conforme au ZDR, 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 identifiables peuvent se trouver sur nos serveurs pendant quelques minutes le temps que nous effectuions ce prétraitement, mais nous ne stockons que l’enregistrement après traitement.

</details>

<details>

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

Nous utilisons un tiers pour masquer les données personnelles identifiables après la fin de notre masquage initial interne.

Nous utilisons également le contenu d’enregistrement masqué 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 le contenu d’un enregistrement externe comme contexte supplémentaire.

</details>

<details>

<summary>GitBook utilise-t-il les données pour l’entraînement de modèles, que ce soit lui-même ou via des tiers ?</summary>

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

</details>

<details>

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

Consultez les pages de nos connecteurs spécifiques pour savoir ce qui peut être configuré pour chaque source.

* [Intercom](/docs/documentation/fr/ia-et-recherche/connections/intercom.md)
* [Zendesk](/docs/documentation/fr/ia-et-recherche/connections/zendesk.md)
* Freshdesk
* Front
* HubSpot
* Zoho Desk
* [Pylon](/docs/documentation/fr/ia-et-recherche/connections/pylon.md)

</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 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/ia-et-recherche/connections.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.
