# Connexions

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

Le contenu connecté peut apparaître dans [Recherche IA](/docs/documentation/fr/docs-site/ai-search.md) et [Assistant GitBook](/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 le **Paramètres** de votre site et cliquez sur **Connexions**.

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

### Fonctionnement des connexions

{% stepper %}
{% step %}

#### Connecter une source

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

{% hint style="info" %}
Si vous connectez YouTube, saisissez l’identifiant de la chaîne — pas 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 à partir de cette source, comme des tickets, des discussions, 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 sont actualisées une fois par jour par défaut. Vous pouvez également lancer une actualisation manuellement depuis le **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 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 connexion

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

#### Libellé

Utiliser **Libellé** pour donner à la connexion un nom clair.

Cela rend la source plus facile à identifier 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 modification est actuellement en accès anticipé.

Voir [Audit de l’agent](/docs/documentation/fr/gitbook-agent/agent-audit.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 peut examiner.

#### Exposer dans la recherche / l’Assistant

Activez **Exposer dans la recherche / l’Assistant** pour rendre les enregistrements de cette connexion consultables par les visiteurs et disponibles pour répondre aux questions.

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

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

#### Boost du classement de recherche

Utiliser **Boost du classement de 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.


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/fr/ia-et-recherche/connections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
