> 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/agent-gitbook/channels.md).

# Canaux

Utilisez l’assistant IA et l’agent GitBook dans Slack, GitHub, Linear et Jira

{% hint style="warning" %}

#### Les canaux sont en accès anticipé

Nous déployons progressivement l’accès aux canaux. Restez à l’écoute pour suivre les progrès sur les fonctionnalités ci-dessous.
{% endhint %}

Les canaux apportent [Assistant IA](/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) et [Agent GitBook](/docs/documentation/fr/agent-gitbook/overview.md) dans les outils que votre équipe utilise déjà. Une fois connecté, votre équipe peut mentionner `@GitBook` dans Slack, GitHub ou Linear pour poser des questions, ouvrir des demandes de modification et garder votre documentation à jour — sans quitter leur flux de travail existant.

Lorsque vous ajoutez un canal, vous choisissez comment GitBook apparaît dans cet outil. Chaque configuration fonctionne selon l’un des deux modes :

**Agent de support :** L’Assistant IA répond aux questions de votre équipe ou des visiteurs directement dans le canal. Posez une question, obtenez une réponse extraite de votre documentation. Dans Slack, les citations de ces réponses renvoient vers l’URL du site publié pour la documentation qu’elles citent. Par exemple, une réponse citée renvoie vers votre site de documentation, et non `app.gitbook.com`.

**Collaborateur :** GitBook Agent rejoint l’équipe comme un coéquipier. Mentionnez `@GitBook` pour ouvrir des demandes de modification, demander des corrections ou maintenir votre documentation synchronisée avec ce qui se passe dans cet outil. Dans Slack, les messages peuvent renvoyer vers `app.gitbook.com` lorsqu’ils font référence à un contexte de workflow interne, comme une demande de modification ou du contenu de brouillon. Lorsque GitBook Agent crée une demande de modification à partir d’un canal, il la relie automatiquement au fil de discussion, au ticket ou à la pull request d’origine.

Vous pouvez exécuter plusieurs configurations par canal — par exemple, le mode Agent de support pour un canal Slack orienté client, et le mode Collaborateur dans un autre canal pour votre équipe de documentation.

Pour ajouter un canal, ouvrez **Paramètres** et cliquez sur **Canaux**.

Utilisez les canaux lorsque les questions d’assistance, les signalements de bugs ou les retours produit commencent dans Slack, GitHub, Linear ou Jira et que vous voulez que GitBook réponde au même endroit.

{% hint style="info" %}

#### Vous cherchez à intégrer AI Assistant dans votre site web ou votre produit ?

Rendez-vous sur [Intégrer dans votre produit](/docs/documentation/fr/publish/embedding.md) pour apprendre à intégrer AI Assistant.
{% endhint %}

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FvdGn4ibGuysRhvoOiAkI%2F26_05_01_channels%402x.png?alt=media&amp;token=e6cececa-7769-4e66-8f27-2995a822c946" alt=""><figcaption></figcaption></figure>

### Canaux disponibles

<table data-view="cards"><thead><tr><th></th><th><select><option value="mjZVekTsgGQo" label="En cours" color="blue"></option><option value="exlMMXLVjkth" label="Prévu" color="blue"></option><option value="WK4vEyJjJM8h" label="Disponible" color="blue"></option></select></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Slack</strong></td><td><span data-option="WK4vEyJjJM8h">Disponible</span></td><td></td><td></td></tr><tr><td><strong>Linear</strong></td><td><span data-option="WK4vEyJjJM8h">Disponible</span></td><td></td><td></td></tr><tr><td><strong>GitHub</strong></td><td><span data-option="WK4vEyJjJM8h">Disponible</span></td><td></td><td></td></tr><tr><td><strong>Jira</strong></td><td><span data-option="WK4vEyJjJM8h">Disponible</span></td><td></td><td></td></tr></tbody></table>

### Bientôt disponible

<table data-view="cards"><thead><tr><th></th><th><select><option value="mjZVekTsgGQo" label="En cours" color="blue"></option><option value="exlMMXLVjkth" label="Prévu" color="blue"></option><option value="WK4vEyJjJM8h" label="Disponible" color="blue"></option></select></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Discord</strong></td><td><span data-option="exlMMXLVjkth">Prévu</span></td><td></td><td></td></tr><tr><td><strong>Intercom</strong></td><td><span data-option="exlMMXLVjkth">Prévu</span></td><td></td><td></td></tr><tr><td><strong>Microsoft Teams</strong></td><td><span data-option="exlMMXLVjkth">Prévu</span></td><td></td><td></td></tr><tr><td><strong>Google Chat</strong></td><td><span data-option="exlMMXLVjkth">Prévu</span></td><td></td><td></td></tr><tr><td><strong>Demander un canal</strong></td><td></td><td><i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i></td><td><a href="https://github.com/orgs/GitbookIO/discussions/new?category=feature-requests">https://github.com/orgs/GitbookIO/discussions/new?category=feature-requests</a></td></tr></tbody></table>

### Vue d’ensemble

Les canaux connectent GitBook à des flux de travail externes.

Ils vous permettent de :

* Répondre aux questions sans quitter la conversation source.
* Apporter le contexte de la documentation existante aux flux de support et produit.
* Transformer des conversations importantes en mises à jour de la documentation avec [Agent GitBook](/docs/documentation/fr/agent-gitbook/overview.md).

Utilisez les canaux lorsque la conversation commence en dehors de GitBook, mais que la réponse ou le suivi doit faire partie de votre processus de documentation.

### Plateformes prises en charge

Les canaux prennent en charge ces plateformes :

* **Slack** pour les conversations et les fils de support.
* **GitHub** pour les issues, le contexte des pull requests et les workflows de discussion.
* **Linear** pour le suivi des issues et les workflows de retours produit.
* **Jira** pour transformer les tickets en mises à jour de la documentation.

Chaque plateforme utilise le même modèle de base.

GitBook reçoit les événements pris en charge de la plateforme connectée, rassemble le contexte de vos connaissances et répond via [Assistant IA](/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) ou [Agent GitBook](/docs/documentation/fr/agent-gitbook/overview.md).

### Rôles et autorisations

Les canaux prennent en charge deux rôles :

* **Collaborateur** — peut effectuer des modifications.
* **Agent de support** — fournit des informations en lecture seule.

Choisissez le rôle en fonction de ce que le canal doit faire.

#### Collaborateur

Utilisez **Collaborateur** lorsque le canal doit aider à transformer les conversations en travail de documentation.

Un canal collaborateur peut utiliser GitBook Agent pour aider à créer ou mettre à jour le travail de documentation dans GitBook, par exemple en ouvrant ou en faisant progresser une demande de modification.

#### Agent de support

Utilisez **Agent de support** lorsque le canal doit uniquement répondre à des questions.

Un canal d’agent de support utilise la documentation existante et les connaissances connectées pour répondre avec un contexte en lecture seule. Il n’apporte aucune modification au contenu.

### Fonctionnement

Les canaux gèrent les événements entrants provenant de votre plateforme connectée.

Un événement entrant peut être un nouveau message, une mention, une mise à jour d’issue ou une autre activité prise en charge provenant de Slack, GitHub, Linear ou Jira.

GitBook traite ces événements en quatre étapes :

{% stepper %}
{% step %}

### Recevoir un événement

La plateforme connectée envoie un événement pris en charge à GitBook via le canal que vous avez installé.
{% endstep %}

{% step %}

### Rassembler le contexte

GitBook recherche le contexte de documentation pertinent ainsi que toute autre connaissance disponible sur le site.
{% endstep %}

{% step %}

### Appliquer le rôle du canal

Si le canal est un **Agent de support**, GitBook renvoie des informations en lecture seule.

Si le canal est un **Collaborateur**, GitBook peut également transformer la conversation en travail de documentation via GitBook Agent.
{% endstep %}

{% step %}

### Répondre dans l’outil source

La réponse réapparaît dans Slack, GitHub, Linear ou Jira, afin que le flux de travail reste au même endroit.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
La couverture exacte des événements dépend de la plateforme et du déploiement de votre accès anticipé. Si un déclencheur n’est pas encore disponible dans votre espace de travail, il n’a pas encore été documenté publiquement.
{% endhint %}

### Installation et autorisation

Pour installer un canal, ouvrez le tableau de bord de votre site et choisissez **Paramètres → Canaux**.

Puis choisissez la plateforme que vous souhaitez connecter.

Slack, GitHub et Linear utilisent un flux OAuth ou d’installation d’application. GitBook vous redirige vers la plateforme, vous autorisez l’accès, puis vous revenez dans GitBook pour terminer la configuration.

{% hint style="warning" %}
Les périmètres d’autorisation et les exigences d’administration spécifiques à chaque plateforme ne sont pas encore entièrement documentés.

Examinez attentivement l’écran d’autorisation avant d’approuver l’accès.
{% endhint %}

{% tabs %}
{% tab title="Slack" %}
{% stepper %}
{% step %}

### Lancer l’installation

Dans **Paramètres → Canaux**, sélectionnez **Slack**.
{% endstep %}

{% step %}

### Autoriser Slack

Connectez-vous à Slack si nécessaire.

Puis choisissez l’espace de travail Slack dans lequel vous souhaitez installer le canal et approuvez l’accès demandé.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Après la redirection de Slack, terminez la configuration du canal dans GitBook.

Choisissez le rôle que le canal doit utiliser et enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="GitHub" %}
{% stepper %}
{% step %}

### Lancer l’installation

Dans **Paramètres → Canaux**, sélectionnez **GitHub**.
{% endstep %}

{% step %}

### Autoriser GitHub

Connectez-vous à GitHub si nécessaire.

Puis choisissez le compte personnel ou l’organisation où vous souhaitez installer l’application GitBook et approuvez l’accès demandé.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Après la redirection de GitHub, terminez la configuration du canal dans GitBook.

Choisissez le rôle que le canal doit utiliser et enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Linear" %}
{% stepper %}
{% step %}

### Lancer l’installation

Dans **Paramètres → Canaux**, sélectionnez **Linear**.
{% endstep %}

{% step %}

### Autoriser Linear

Connectez-vous à Linear si nécessaire.

Puis choisissez l’espace de travail Linear que vous souhaitez connecter et approuvez l’accès demandé.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Après la redirection de Linear, terminez la configuration du canal dans GitBook.

Choisissez le rôle que le canal doit utiliser et enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Jira" %}
Connectez Jira à votre site GitBook, puis ajoutez le `gitbook` libellé à un ticket. GitBook Agent utilise le ticket pour rédiger une demande de modification que votre équipe pourra examiner.

#### Avant de commencer

Vous avez besoin des éléments suivants :

* Un accès administrateur à votre site GitBook, avec les canaux disponibles et GitBook Agent activé et non suspendu.
* Un site Jira Cloud, l’adresse e-mail d’un compte Atlassian et un jeton API pour ce compte. Le compte doit avoir accès aux projets que vous souhaitez utiliser et l’autorisation de commenter les issues et de les lier.

#### Connecter Jira

{% stepper %}
{% step %}

### Commencer la configuration

Ouvrez les paramètres de votre site **Paramètres → Canaux**. Sous **Jira**, cliquez sur **Ajouter une configuration**.

Jira utilise le **Collaborateur** rôle pour aider votre équipe à maintenir la documentation.
{% endstep %}

{% step %}

### Connectez votre compte Jira

Saisissez les informations suivantes :

* **URL du site Jira :** votre URL Jira Cloud, par exemple `https://votre-site.atlassian.net`.
* **Adresse e-mail du compte :** l’adresse e-mail du compte Atlassian qui a créé le jeton.
* **Jeton API Jira :** [créez un jeton API dans Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens), puis collez-le ici.

Cliquez sur **Connecter Jira**. Une fois la connexion réussie, GitBook affiche les projets disponibles.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Choisissez les projets que vous souhaitez que GitBook prenne en charge. Si vous laissez la sélection vide, tous les projets accessibles au compte connecté seront inclus. Seules les issues étiquetées `gitbook` lancer le travail de documentation.

Définissez **Statut Jira lors de la fusion** à **Terminé**, ou le statut équivalent dans le workflow de votre projet, de sorte que la fusion de la demande de modification termine également le ticket. Cliquez **Enregistrer**. GitBook confirme avec le message « Configuration Jira enregistrée ».
{% endstep %}
{% endstepper %}

#### Créer une demande de modification à partir d’un ticket

{% stepper %}
{% step %}

### Décrivez la modification de la documentation

Ouvrez ou créez un ticket Jira dans l’un des projets couverts par votre configuration. Donnez-lui un titre clair et décrivez ce que la documentation doit indiquer.

Par exemple, utilisez le titre « Documenter la rotation de la clé API » et incluez les étapes de rotation, les personnes autorisées à les effectuer et ce qui arrive à l’ancienne clé.
{% endstep %}

{% step %}

### Ajoutez l’attribut `gitbook` label

Ajouter des `gitbook` aux étiquettes du ticket et enregistrez-le.

GitBook Agent rédige une demande de modification à partir du titre et de la description du ticket, puis ajoute un commentaire et un lien vers la demande de modification dans Jira.
{% endstep %}

{% step %}

### Relire le brouillon

Suivez le lien depuis Jira pour ouvrir la demande de modification dans GitBook. Passez en revue les changements proposés, effectuez les modifications nécessaires et fusionnez lorsque la documentation est prête.
{% endstep %}
{% endstepper %}

#### Facultatif : demander une autre modification depuis Jira

Tant que la demande de modification est ouverte, ajoutez un commentaire contenant `@gitbook` et la modification souhaitée. Par exemple :

> @gitbook Ajoutez une note expliquant quand l’ancienne clé API cesse de fonctionner.

GitBook Agent met à jour le brouillon lié et publie un commentaire de mise à jour dans Jira. Modifier uniquement le titre ou la description du ticket ne demande pas une autre modification.
{% endtab %}
{% endtabs %}

### Retours et réactions

Les réactions permettent à votre équipe de donner rapidement un retour sur les réponses du canal.

Utilisez les réactions lorsque vous souhaitez indiquer si une réponse était utile.

Ce retour aide GitBook à comprendre quelles réponses fonctionnent bien dans de vrais flux de travail.

{% hint style="info" %}
Le mappage exact des réactions n’est pas encore documenté et peut varier selon la plateforme pendant l’accès anticipé.
{% endhint %}


---

# 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/agent-gitbook/channels.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.