# 渠道

{% hint style="warning" %}

#### 频道目前处于抢先体验阶段

我们正在逐步开放频道访问权限。请持续关注下方功能的更多进展。
{% endhint %}

频道将 [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/ai-yu-sou-suo/gitbook-ai-assistant) 和 [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent) 带入到工作已经发生的工具中。

频道将 [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/ai-yu-sou-suo/gitbook-ai-assistant) 和 [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent) 带入你团队已经在使用的工具中。连接后，你的团队可以提及 `@GitBook` 在 Slack、GitHub 或 Linear 中提问、发起变更请求，并保持文档更新——无需离开现有工作流程。

频道将 [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/ai-yu-sou-suo/gitbook-ai-assistant) 和 [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent) 带入你团队已经在使用的工具中。连接后，你的团队可以提及 `@GitBook` 在 Slack、GitHub 或 Linear 中提问、发起变更请求，并保持文档更新——无需离开现有工作流程。

添加频道时，你可以选择 GitBook 在该工具中的呈现方式。每个配置都有两种模式之一：

**支持助手：** GitBook Assistant 会直接在频道中回答你团队成员或访客的问题。提出问题，即可获得从文档中提取的答案。在 Slack 中，这些回复里的引用会链接到它们所引用文档的已发布网站 URL。例如，带引用的答案会链接到你的文档站点，而不是 `app.gitbook.com`.

**协作者：** GitBook Agent 会作为队友加入。提及 `@GitBook` 即可打开变更请求、请求编辑，或让文档与该工具中的动态保持同步。在 Slack 中，消息可以链接到 `app.gitbook.com` 当它们引用内部工作流上下文时，例如变更请求或草稿内容。当 Agent 从频道创建变更请求时，它会自动将其链接到原始线程、问题或拉取请求。

你可以为每个频道运行多个配置——例如，在面向客户的 Slack 频道中使用支持助手模式，在另一个频道中为你的文档团队使用协作者模式。

要添加频道，请打开你站点的 **设置** 并点击 **频道**.

当支持问题、错误报告或产品反馈始于 Slack、GitHub 或 Linear，并且你希望 GitBook 直接在原地回复时，请使用频道。

{% hint style="info" %}

#### 想将 GitBook Assistant 嵌入到你的网站或产品中吗？

前往 [embedding](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/docs-site/embedding "mention") 了解如何嵌入 GitBook Assistant。
{% endhint %}

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

### 可用频道

<table data-view="cards"><thead><tr><th></th><th><select><option value="mjZVekTsgGQo" label="进行中" color="blue"></option><option value="exlMMXLVjkth" label="计划中" color="blue"></option><option value="WK4vEyJjJM8h" label="可用" 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">可用</span></td><td></td><td></td></tr><tr><td><strong>Linear</strong></td><td><span data-option="WK4vEyJjJM8h">可用</span></td><td></td><td></td></tr><tr><td><strong>GitHub</strong></td><td><span data-option="WK4vEyJjJM8h">可用</span></td><td></td><td></td></tr></tbody></table>

### 即将推出

<table data-view="cards"><thead><tr><th></th><th><select><option value="mjZVekTsgGQo" label="进行中" color="blue"></option><option value="exlMMXLVjkth" label="计划中" color="blue"></option><option value="WK4vEyJjJM8h" label="可用" 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">计划中</span></td><td></td><td></td></tr><tr><td><strong>Intercom</strong></td><td><span data-option="exlMMXLVjkth">计划中</span></td><td></td><td></td></tr><tr><td><strong>Microsoft Teams</strong></td><td><span data-option="exlMMXLVjkth">计划中</span></td><td></td><td></td></tr><tr><td><strong>Google Chat</strong></td><td><span data-option="exlMMXLVjkth">计划中</span></td><td></td><td></td></tr><tr><td><strong>请求添加频道</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>

### 概览

频道将 GitBook 连接到外部工作流。

它们让你可以：

* 无需离开源对话即可回答问题。
* 将现有文档上下文带入支持和产品工作流。
* 借助 [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent).

当对话开始于 GitBook 之外，但答案或后续处理属于你的文档流程时，请使用频道。

### 受支持的平台

频道目前支持以下平台：

* **Slack** 用于对话和支持线程。
* **GitHub** 用于问题、拉取请求上下文和讨论工作流。
* **Linear** 用于问题跟踪和产品反馈工作流。

每个平台都使用相同的核心模型。

GitBook 会接收来自已连接平台的受支持事件，汇总你知识库中的上下文，并通过以下任一方式回复 [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/ai-yu-sou-suo/gitbook-ai-assistant) 或 [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent).

### 角色与权限

频道支持两种角色：

* **协作者** — 可以进行更改。
* **支持助手** — 提供只读信息。

根据频道需要执行的操作选择角色。

#### 协作者

在以下情况下使用 **协作者** 当频道必须帮助将对话转化为文档工作时。

协作者频道可以使用 GitBook Agent 帮助在 GitBook 中创建或更新文档工作，例如发起或推进变更请求。

#### 支持助手

在以下情况下使用 **支持助手** 当频道只需要回答问题时。

支持助手频道会使用现有文档和已连接的知识，以只读上下文进行回复。它不会修改内容。

### 工作原理

频道会处理来自你已连接平台的传入事件。

传入事件可以是新消息、提及、问题更新，或来自 Slack、GitHub 或 Linear 的其他受支持活动。

GitBook 按四个步骤处理这些事件：

{% stepper %}
{% step %}

### 接收事件

已连接的平台会通过你安装的频道向 GitBook 发送受支持的事件。
{% endstep %}

{% step %}

### 收集上下文

GitBook 会查找相关文档上下文以及站点可用的其他知识。
{% endstep %}

{% step %}

### 应用频道角色

如果该频道是 **支持助手**，GitBook 会返回只读信息。

如果该频道是 **协作者**，GitBook 还可以通过 GitBook Agent 将对话转化为文档工作。
{% endstep %}

{% step %}

### 在源工具中回复

回复会返回到 Slack、GitHub 或 Linear 中，因此工作流始终保持在同一处。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
具体支持的事件范围取决于平台和你的抢先体验开放进度。如果某个触发器在你的工作区中尚不可用，则它尚未公开记录。
{% endhint %}

### 安装与授权

要安装频道，请打开你的网站仪表板并选择 **设置** → **频道**.

然后选择你要连接的平台。

每个平台都使用 OAuth 或应用安装流程。GitBook 会将你转到平台，你批准访问，然后返回 GitBook 完成设置。

{% hint style="warning" %}
特定平台的权限范围和管理员要求尚未完全记录。

在批准访问之前，请仔细查看授权界面。
{% endhint %}

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

### 开始安装

在 **设置** → **频道**中，选择 **Slack**.
{% endstep %}

{% step %}

### 授权 Slack

如有需要，请登录 Slack。

然后选择你要安装频道的 Slack 工作区，并批准所请求的访问权限。
{% endstep %}

{% step %}

### 在 GitBook 中完成设置

在 Slack 将你重定向回来后，在 GitBook 中完成频道设置。

选择频道应使用的角色并保存配置。
{% endstep %}
{% endstepper %}
{% endtab %}

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

### 开始安装

在 **设置** → **频道**中，选择 **GitHub**.
{% endstep %}

{% step %}

### 授权 GitHub

如有需要，请登录 GitHub。

然后选择你要安装 GitBook 应用的个人账户或组织，并批准所请求的访问权限。
{% endstep %}

{% step %}

### 在 GitBook 中完成设置

在 GitHub 将你重定向回来后，在 GitBook 中完成频道设置。

选择频道应使用的角色并保存配置。
{% endstep %}
{% endstepper %}
{% endtab %}

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

### 开始安装

在 **设置** → **频道**中，选择 **Linear**.
{% endstep %}

{% step %}

### 授权 Linear

如有需要，请登录 Linear。

然后选择你要连接的 Linear 工作区，并批准所请求的访问权限。
{% endstep %}

{% step %}

### 在 GitBook 中完成设置

在 Linear 将你重定向回来后，在 GitBook 中完成频道设置。

选择频道应使用的角色并保存配置。
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

### 反馈与反应

反应可让你的团队对频道回复快速反馈。

当你想表示某个回复是否有帮助时，请使用反应。

这些反馈有助于 GitBook 了解哪些回复在真实工作流中效果良好。

{% hint style="info" %}
具体的反应映射尚未记录，在抢先体验期间可能因平台而异。
{% endhint %}