> 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 GitBook Assistant et GitBook Agent dans Slack, GitHub et Linear
{% hint style="warning" %}
#### Les canaux sont actuellement 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 [GitBook Assistant](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md) et [GitBook Agent](/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 :** GitBook Assistant répond directement aux questions de votre équipe ou des visiteurs 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 les docs qu’elles mentionnent. Par exemple, une réponse citée renvoie vers votre site de docs, pas vers `app.gitbook.com`.
**Collaborateur :** GitBook Agent rejoint l’équipe comme un coéquipier. Mentionnez `@GitBook` pour ouvrir des demandes de modification, demander des changements ou garder 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 flux de travail interne, comme une demande de modification ou du contenu de brouillon. Lorsque Agent crée une demande de modification depuis un canal, il la relie automatiquement au fil, à l’issue 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** de votre site et cliquez sur **Canaux**.
Utilisez les canaux lorsque les questions de support, les rapports de bugs ou les retours produit commencent dans Slack, GitHub ou Linear et que vous souhaitez que GitBook réponde sur place.
{% hint style="info" %}
#### Vous souhaitez intégrer GitBook Assistant dans votre site web ou votre produit ?
Rendez-vous sur [Intégrer dans votre produit](/docs/documentation/fr/publier/embedding.md) pour apprendre à intégrer GitBook Assistant.
{% endhint %}
### Canaux disponibles
### Aperçu
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 [GitBook Agent](/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 actuellement 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.
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 [GitBook Assistant](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md) ou [GitBook Agent](/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 toute autre activité prise en charge provenant de Slack, GitHub ou Linear.
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 ou Linear, 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.
Chaque plateforme utilise un flux OAuth ou d’installation d’application. GitBook vous redirige vers la plateforme, vous approuvez 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 %}
{% 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 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/agent-gitbook/channels.md?ask=&goal=
```
`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.
