> 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/gitbook-agent/channels.md).
# Canaux
{% 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 [Assistant GitBook](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md) et [agent GitBook](/docs/documentation/fr/gitbook-agent/overview.md) dans les outils que votre équipe utilise déjà. Une fois connectés, 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 la manière dont GitBook apparaît dans cet outil. Chaque configuration fonctionne dans l’un des deux modes :
**Agent d’assistance :** 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 vos docs. Dans Slack, les citations dans ces réponses renvoient à l’URL du site publié pour les docs qu’elles référencent. Par exemple, une réponse citée renvoie vers le site de vos docs, pas `app.gitbook.com`.
**Collaborateur :** GitBook Agent rejoint l’équipe comme un collègue. Mentionnez `@GitBook` pour ouvrir des demandes de modification, demander des retouches 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 au contexte du flux de travail interne, comme une demande de modification ou du contenu de brouillon. Lorsque l’Agent crée une demande de modification à partir d’un canal, il la relie automatiquement au fil, au ticket ou à la pull request d’origine.
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 docs.
Pour ajouter un canal, ouvrez le **Paramètres** du tableau de bord de votre site, puis cliquez sur **Canaux**.
Utilisez les canaux lorsque les questions d’assistance, les rapports de bugs ou les retours produit commencent dans Slack, GitHub ou Linear et que vous voulez que GitBook réponde à cet endroit.
{% hint style="info" %}
#### Vous cherchez à intégrer GitBook Assistant dans votre site web ou votre produit ?
Allez dans [Intégrer dans votre produit](/docs/documentation/fr/publier/embedding.md) pour savoir comment intégrer GitBook Assistant.
{% endhint %}
### Canaux disponibles
### Vue d’ensemble
Les canaux connectent GitBook à des workflows externes.
Ils vous permettent de :
* Répondre aux questions sans quitter la conversation source.
* Apporter le contexte des docs existantes dans les workflows de support et produit.
* Transformer les conversations importantes en mises à jour de la documentation avec [agent GitBook](/docs/documentation/fr/gitbook-agent/overview.md).
Utilisez les canaux lorsque la conversation commence en dehors de GitBook, mais que la réponse ou le suivi doit s’intégrer à votre processus documentaire.
### Plateformes prises en charge
Les canaux prennent actuellement en charge ces plateformes :
* **Slack** pour les conversations et les fils d’assistance.
* **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 depuis la plateforme connectée, rassemble le contexte de vos connaissances, puis répond via soit [Assistant GitBook](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md) ou [agent GitBook](/docs/documentation/fr/gitbook-agent/overview.md).
### Rôles et autorisations
Les canaux prennent en charge deux rôles :
* **Collaborateur** — peut effectuer 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 travail de documentation.
Un canal Collaborateur peut utiliser GitBook Agent pour aider à créer ou à mettre à jour le travail de docs dans GitBook, comme ouvrir ou faire progresser une demande de modification.
#### Agent d’assistance
Utilisez **Agent d’assistance** lorsque le canal doit seulement répondre aux questions.
Un canal Agent d’assistance utilise les docs existantes et les connaissances connectées pour répondre avec un contexte en lecture seule. Il n’effectue aucune modification de contenu.
### Comment cela fonctionne
Les canaux traitent les événements entrants depuis 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 depuis 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 %}
### Recueillir le contexte
GitBook recherche le contexte documentaire pertinent ainsi que toute autre connaissance disponible sur le site.
{% endstep %}
{% step %}
### Appliquer le rôle du canal
Si le canal est un **Agent d’assistance**, GitBook renvoie des informations en lecture seule.
Si le canal est un **Collaborateur**, GitBook peut aussi transformer la conversation en travail documentaire 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 de votre déploiement en accès anticipé. Si un déclencheur n’est pas encore disponible dans votre espace de travail, cela n’a pas é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 envoie vers la plateforme, vous approuvez l’accès, puis vous revenez dans GitBook pour terminer la configuration.
{% hint style="warning" %}
Les portées d’autorisation et les exigences d’administration spécifiques à chaque plateforme 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 **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
Une fois la redirection depuis Slack effectuée, terminez la configuration du canal dans GitBook.
Choisissez le rôle que le canal doit utiliser, puis enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="GitHub" %}
{% stepper %}
{% step %}
### Démarrer 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 dans lequel vous souhaitez installer l’application GitBook et approuvez l’accès demandé.
{% endstep %}
{% step %}
### Terminer la configuration dans GitBook
Une fois la redirection depuis GitHub effectuée, terminez la configuration du canal dans GitBook.
Choisissez le rôle que le canal doit utiliser, puis enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="Linear" %}
{% stepper %}
{% step %}
### Démarrer 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
Une fois la redirection depuis Linear effectuée, terminez la configuration du canal dans GitBook.
Choisissez le rôle que le canal doit utiliser, puis enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% 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 lorsque vous voulez indiquer si une réponse a été utile.
Ces retours aident GitBook à comprendre quelles réponses fonctionnent bien dans des workflows réels.
{% 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/gitbook-agent/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.