Canaux
Utilisez GitBook Assistant et GitBook Agent dans Slack, GitHub et Linear
Les canaux sont actuellement en accès anticipé
Nous déployons progressivement l’accès aux canaux. Restez à l’écoute pour suivre les prochaines avancées sur les fonctionnalités ci-dessous.
Les canaux apportent GitBook Assistant et GitBook Agent dans les outils où le travail se fait déjà.
Les canaux apportent GitBook Assistant et GitBook Agent 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 maintenir vos docs à jour — sans quitter leur flux de travail habituel.
Les canaux apportent GitBook Assistant et GitBook Agent 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 maintenir vos docs à jour — sans quitter leur flux de travail habituel.
Lorsque vous ajoutez un canal, vous choisissez comment GitBook apparaît dans cet outil. Chaque configuration fonctionne dans l’un de deux modes :
Agent de support : GitBook Assistant répond aux questions de votre équipe ou des visiteurs directement dans le canal. Posez une question, obtenez une réponse extraite de vos docs. Dans Slack, les citations de ces réponses renvoient vers l’URL du site publié des docs qu’elles mentionnent. Par exemple, une réponse citée renvoie vers votre site de documentation, pas app.gitbook.com.
Collaborateur : GitBook Agent rejoint l’équipe en tant que coéquipier. Mentionnez @GitBook pour ouvrir des demandes de modification, demander des corrections ou maintenir vos docs synchronisées 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 interne du workflow, comme une demande de modification ou un contenu de brouillon. Lorsque Agent crée une demande de modification à partir d’un canal, il l’associe automatiquement au fil de discussion, à 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 en contact avec les clients, et le mode Collaborateur dans un autre canal pour votre équipe docs.
Pour ajouter un canal, ouvrez Paramètres de votre site et cliquez sur Canaux.
Utilisez les canaux lorsque les questions d’assistance, les signalements de bugs ou les retours produit commencent dans Slack, GitHub ou Linear et que vous souhaitez que GitBook réponde directement à cet endroit.
Vous souhaitez intégrer GitBook Assistant à votre site web ou à votre produit ?
Rendez-vous sur Intégrer dans votre produit pour découvrir comment intégrer GitBook Assistant.
Canaux disponibles
Slack
Linear
GitHub
Bientôt disponible
Vue d’ensemble
Les canaux relient GitBook à des flux de travail externes.
Ils vous permettent de :
Répondre aux questions sans quitter la conversation source.
Intégrer le contexte des docs existantes dans les flux de support et de produit.
Transformer les conversations importantes en mises à jour de la documentation avec GitBook Agent.
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 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 flux de discussion.
Linear pour le suivi des issues et les flux 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 depuis vos connaissances, et répond via GitBook Assistant ou GitBook Agent.
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 en mode collaborateur peut utiliser GitBook Agent pour aider à créer ou mettre à jour le travail de documentation dans GitBook, comme ouvrir ou faire progresser une demande de modification.
Agent de support
Utilisez Agent de support lorsque le canal doit seulement répondre aux questions.
Un canal d’agent de support utilise les docs existantes et les connaissances connectées pour répondre avec un contexte en lecture seule. Il ne modifie pas le 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 depuis Slack, GitHub ou Linear.
GitBook traite ces événements en quatre étapes :
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.
Les périmètres d’autorisation et les exigences d’administration propres à chaque plateforme ne sont pas encore entièrement documentés.
Examinez attentivement l’écran d’autorisation avant d’approuver l’accès.
Retour 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 souhaitez indiquer si une réponse a été utile.
Ce retour aide GitBook à comprendre quelles réponses fonctionnent bien dans de vrais flux de travail.
Mis à jour
Ce contenu vous a-t-il été utile ?