> 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 l’avancement des fonctionnalités ci-dessous.
{% endhint %}

Les canaux intègrent [AI Assistant](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) et [GitBook Agent](https://gitbook.com/docs/documentation/fr/agent-gitbook/overview.md) aux outils que votre équipe utilise déjà. Une fois la connexion établie, votre équipe peut mentionner `@GitBook` dans Slack, GitHub ou Linear pour poser des questions, ouvrir des demandes de modification et tenir votre documentation à jour, sans quitter son environnement de travail habituel.

Lorsque vous ajoutez un canal, vous choisissez comment GitBook s’intègre à cet outil. Chaque configuration fonctionne selon l’un des deux modes suivants :

**Agent d’assistance :** AI Assistant répond directement dans le canal aux questions de votre équipe ou de vos visiteurs. Posez une question et obtenez une réponse tirée de votre documentation. Dans Slack, les citations de ces réponses renvoient à l’URL du site publié correspondant aux documents cités. Par exemple, une réponse citée renvoie à votre site de documentation, et non à `app.gitbook.com`.

**Collaborateur :** GitBook Agent rejoint votre équipe en tant que coéquipier. Mentionnez `@GitBook` pour ouvrir des demandes de modification, demander des modifications ou synchroniser votre documentation avec l’actualité de cet outil. Dans Slack, les messages peuvent renvoyer vers `app.gitbook.com` lorsqu’ils font référence au contexte d’un flux de travail interne, comme une demande de modification ou un brouillon. Lorsque GitBook Agent crée une demande de modification depuis un canal, il la relie automatiquement au fil de discussion, à l’issue ou à la demande de tirage à l’origine de celle-ci.

Vous pouvez exécuter plusieurs configurations par canal — par exemple, le mode agent d’assistance pour un canal Slack destiné aux clients, et le mode collaborateur dans un autre canal pour votre équipe de documentation.

Pour ajouter un canal, ouvrez la section **Étendre → 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 ?

Consultez [Intégrer dans votre produit](https://gitbook.com/docs/documentation/fr/publish/embedding.md) pour savoir comment 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%2Fgit-blob-64be9b2e2b4ae9ab530fa6eb244a3890f0fb36e4%2F26_05_01_channels%402x.png?alt=media" 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>

### Présentation

Les canaux connectent GitBook aux workflows externes.

Ils vous permettent de :

* Répondre aux questions sans quitter la conversation d’origine.
* Intégrer le contexte de la documentation existante aux workflows d’assistance et de gestion des produits.
* Transformez les conversations importantes en mises à jour de documentation avec [GitBook Agent](https://gitbook.com/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 relève de votre processus de documentation.

### Plateformes prises en charge

Les canaux prennent en charge ces plateformes :

* **Slack** pour les conversations et les fils d’assistance.
* **GitHub** pour les issues, le contexte des demandes de tirage et les échanges associés.
* **Linear** pour le suivi des issues et la gestion des retours sur le produit.
* **Jira** pour transformer les tickets en mises à jour de documentation.

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

GitBook reçoit les événements pris en charge depuis la plateforme connectée, recueille le contexte dans votre base de connaissances et répond par l’intermédiaire de [AI Assistant](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) ou de [GitBook Agent](https://gitbook.com/docs/documentation/fr/agent-gitbook/overview.md).

### Rôles et autorisations

Les canaux prennent en charge deux rôles :

* **Collaborateur** — peut apporter des modifications.
* **Agent d’assistance** — 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 travaux de documentation.

Un canal de type collaborateur peut utiliser GitBook Agent pour créer ou mettre à jour du contenu dans GitBook, par exemple en ouvrant une demande de modification ou en la faisant avancer.

#### Agent d’assistance

Utilisez **Agent d’assistance** lorsque le canal doit uniquement répondre aux questions.

Un canal de type agent d’assistance utilise la documentation existante et les sources de connaissances connectées pour répondre en s’appuyant sur un contexte en lecture seule. Il ne modifie pas le contenu.

### Fonctionnement

Les canaux traitent 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 par l’intermédiaire du canal que vous avez installé.
{% endstep %}

{% step %}

### Rassembler le contexte

GitBook recherche le contexte pertinent dans la documentation, ainsi que toute autre source de connaissances disponible sur le site.
{% endstep %}

{% step %}

### Appliquer le rôle du canal

Si le canal est configuré comme **Agent d’assistance**, GitBook fournit des informations en lecture seule.

Si le canal est configuré comme **Collaborateur**, GitBook peut également transformer la conversation en travail de documentation grâce à GitBook Agent.
{% endstep %}

{% step %}

### Répondre dans l’outil d’origine

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 prise en charge exacte des événements dépend de la plateforme et du déploiement de l’accès anticipé. Si un déclencheur n’est pas encore disponible dans votre espace de travail, il n’a pas été documenté publiquement.
{% endhint %}

### Installation et autorisation

Pour installer un canal, ouvrez le tableau de bord de votre site et sélectionnez **Étendre → Canaux**.

Choisissez ensuite 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 autorisations spécifiques à chaque plateforme et les exigences relatives aux administrateurs ne sont pas encore entièrement documentées.

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

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

### Démarrer l’installation

Dans **Extensions → Canaux**, sélectionnez **Slack**.
{% endstep %}

{% step %}

### Autoriser Slack

Connectez-vous à Slack si nécessaire.

Choisissez ensuite l’espace de travail Slack dans lequel vous souhaitez installer le canal, puis approuvez les autorisations demandées.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Une fois redirigé vers GitBook depuis Slack, terminez la configuration du canal dans GitBook.

Cliquez sur **Ajouter une configuration**. Dans la boîte de dialogue **Choisir un rôle** , sélectionnez le rôle à attribuer au canal, puis cliquez sur **Créer le canal**:

* **Agent d’assistance**: répondre aux questions des utilisateurs et leur apporter de l’aide. Il s’agit du rôle par défaut pour Slack.
* **Collaborateur**: travailler avec votre équipe pour tenir la documentation à jour et proposer des améliorations.
  {% endstep %}
  {% endstepper %}
  {% endtab %}

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

### Démarrer l’installation

Dans **Extensions → Canaux**, sélectionnez **GitHub**.
{% endstep %}

{% step %}

### Autoriser GitHub

Connectez-vous à GitHub si nécessaire.

Choisissez ensuite le compte personnel ou l’organisation dans laquelle vous souhaitez installer l’application GitBook, puis approuvez les autorisations demandées.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Une fois redirigé vers GitBook depuis GitHub, terminez la configuration du canal dans GitBook.

Cliquez sur **Ajouter une configuration**. Dans la boîte de dialogue **Choisir un rôle** , sélectionnez le rôle à attribuer au canal, puis cliquez sur **Créer le canal**:

* **Agent d’assistance**: répondre aux questions des utilisateurs et leur apporter de l’aide.
* **Collaborateur**: travailler avec votre équipe pour tenir la documentation à jour et proposer des améliorations. Il s’agit du rôle par défaut pour GitHub.
  {% endstep %}
  {% endstepper %}
  {% endtab %}

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

### Démarrer l’installation

Dans **Extensions → Canaux**, sélectionnez **Linear**.
{% endstep %}

{% step %}

### Autoriser Linear

Connectez-vous à Linear si nécessaire.

Choisissez ensuite l’espace de travail Linear que vous souhaitez connecter, puis approuvez les autorisations demandées.
{% endstep %}

{% step %}

### Terminer la configuration dans GitBook

Une fois redirigé vers GitBook depuis Linear, terminez la configuration du canal dans GitBook.

Choisissez le rôle à attribuer au canal, puis enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Jira" %}
Connectez Jira à votre site GitBook, puis ajoutez l’étiquette `gitbook` à un ticket. GitBook Agent s’appuie sur ce 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 la section **Extensions → Canaux**. Sous **Jira**, cliquez sur **Ajouter une configuration**.

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

{% step %}

### Connectez votre compte Jira

Saisissez les informations suivantes :

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

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

{% step %}

### Terminer la configuration dans GitBook

Choisissez les projets que vous souhaitez confier à GitBook. Si vous ne sélectionnez aucun projet, tous les projets accessibles au compte connecté seront inclus. Seuls les tickets portant l’étiquette `gitbook` déclenchent le travail de documentation.

Définissez le **statut Jira après la fusion** sur **Terminé**, ou sur le statut équivalent dans le flux de travail de votre projet, afin que la fusion de la demande de modification clôture également le ticket. Cliquez sur **Enregistrer**. GitBook confirme l’opération 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’étiquette `gitbook` libellé

Ajoutez `gitbook` aux libellés du ticket, puis 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 %}

### Commentaires et réactions

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

Utilisez les réactions pour indiquer si une réponse a été utile.

Ces commentaires aident GitBook à comprendre quelles réponses fonctionnent bien dans des situations réelles.

{% hint style="info" %}
La correspondance exacte des réactions n’est pas encore documentée et peut varier selon la plateforme pendant la période d’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.
