> 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/zh/ai-for-your-readers/connections.md).

# 连接

将外部来源连接到 GitBook Assistant 和 GitBook Agent

连接可将外部内容引入你的文档站点。

已连接的内容可以显示在 [AI 助手](/docs/documentation/zh/ai-for-your-readers/gitbook-ai-assistant.md)，因此访客获得的答案来自你发布的全部内容，而不只是你的文档。一些连接还可帮助 GitBook 生成变更请求并识别 [内容缺口](/docs/documentation/zh/analytics/content-gaps.md)。MCP 服务器连接还可以让访客根据你的文档执行任务。

在你网站的侧边栏中，前往 **设置 → 连接**.

### 可用连接

你可以连接支持平台、开发者社区和其他内容来源：

* Intercom、Zendesk、Freshdesk、Front、HubSpot、Zoho Desk 和 Pylon
* GitHub Discussions 和 GitHub Issues
* YouTube、一个网站或一个 MCP 服务器

### 连接如何运作

{% stepper %}
{% step %}

#### 连接一个来源

选择一种来源类型。然后授权它，或输入你希望 GitBook 导入的 URL。

{% hint style="info" %}
如果你连接的是 YouTube，请输入频道 ID，而不是频道名称。

频道名称不适用于此来源。

在 YouTube Studio 中，打开 **设置** → **频道** → **高级设置**.

复制 **频道 ID**.

如果你的频道 URL 包含 `/channel/`，请复制其后面的部分 `/channel/`.
{% endhint %}

每个连接都会从该来源创建一个记录流，例如问题、讨论、工单、对话、页面或视频。
{% endstep %}

{% step %}

#### GitBook 会同步记录

保存连接后，GitBook 会开始同步该来源中的记录。

在连接列表中，你可以查看同步状态、记录数量和上次同步时间。

已连接的 URL 默认每天刷新一次。你也可以从你站点的 **设置** → **连接**.
{% endstep %}

{% step %}

#### 选择记录的使用方式

对于每个连接，你可以选择其记录是否显示在搜索和 GitBook Assistant 中，以及是否帮助 GitBook 生成变更请求。

你还可以调整该连接的搜索排名，以提高或降低其记录的优先级。
{% endstep %}
{% endstepper %}

### 检查你的连接

连接页面有三个部分： **连接一个来源** 用于添加连接器， **连接** 用于管理你已有的连接，以及 **记录** 用于浏览 GitBook 已摄取的内容。

#### 连接表

每个已连接来源都有一行：

| 列    | 显示内容                                     |
| ---- | ---------------------------------------- |
| 来源   | 连接器，以及它所指向的账户、频道或 URL。                   |
| 状态   | 最近一次同步是否完成。                              |
| 记录   | 按该来源自身的单位计算的贡献项数量——页面、视频、讨论或对话。          |
| 搜索   | 该连接的搜索排名提升。关闭时此处为空。 **在搜索 / 助手中公开** 已关闭。 |
| 上次同步 | 该连接上次刷新的时间距今多久。                          |

#### 记录

该 **记录** 列表显示 GitBook 在所有连接中摄取的各个条目，按最新优先排序。每条记录都会显示其标题、来源的连接器、GitBook 处理它的时间，以及原始内容的链接。

大型站点会积累数千条记录，因此该列表是分页显示的。在启用之前，可先用它确认某个来源是否带来了你预期的内容 **在搜索 / 助手中公开**：当你需要的是产品页面时，返回博客文章的网站连接会先在这里显示。

### 连接设置

编辑连接时，你可以配置以下选项：

#### 标签

使用 **标签** ，为连接提供一个清晰的名称。

这会让来源在连接列表中更容易识别，尤其是在你连接了多个仓库、网站或频道时。

#### 自动生成变更请求

{% hint style="warning" %}
自动生成变更请求处于 Beta 阶段。

参见 [内容缺口](/docs/documentation/zh/analytics/content-gaps.md) ，了解 GitBook 如何识别文档中的缺口。
{% endhint %}

开启 **自动生成变更请求** ，让 GitBook 从该连接的记录中学习并建议文档更新。

GitBook 可以使用这些记录来创建变更请求，并附上建议的更改，供你的团队审阅。

#### 在搜索 / 助手中公开

开启 **在搜索 / 助手中公开** ，让访客可以搜索此连接中的记录，并可用于回答问题。

这使得已连接内容可以显示在你站点的 AI 驱动搜索体验中，以及 GitBook Assistant 的回复中。

{% hint style="warning" %}
启用 **在搜索 / 助手中公开** 会让该连接中的记录对任何能访问该站点的人可用——如果站点对外共享，包括外部访客。
{% endhint %}

#### 搜索排名提升

使用 **搜索排名提升** ，用于在搜索中提高或降低某个连接中的记录优先级。

如果此来源应更频繁地出现，请提高该值。如果此来源应比你的主要文档权重更低，请降低该值。

### 连接器详情

本节中的所有连接器都可以为 [AI 助手](/docs/documentation/zh/ai-for-your-readers/gitbook-ai-assistant.md)。GitBook Agent 可以利用已解决的记录来识别 [内容缺口](/docs/documentation/zh/analytics/content-gaps.md) 并建议文档更新。

#### Intercom

GitBook 会索引已解决的对话，这些对话至少有一条来自人工或 AI 支持代理的回复。它不会索引未关闭、未解决或垃圾对话。

要连接 Intercom，请使用具有对对话读取权限的 API 密钥。你可以控制其权限范围和到期时间。

#### Zendesk

GitBook 会索引已解决的对话，这些对话至少有一条来自人工或 AI 支持代理的回复。它不会索引未关闭、未解决或垃圾对话。

要连接 Zendesk，请输入你的 Zendesk 子域名，例如 `gitbook.zendesk.com`。你还需要一个具有对对话读取权限的 API 密钥。你可以控制其权限范围和到期时间。

#### Pylon

GitBook 会索引已解决的对话，这些对话至少有一条来自人工或 AI 支持代理的回复。它不会索引未关闭、未解决或垃圾对话。

要连接 Pylon，请使用具有对对话读取权限的凭据。

#### GitHub Discussions

GitBook 会索引已解决的讨论，这些讨论至少有一条回复。它不会索引未解决或垃圾讨论。

要连接 GitHub Discussions，请使用具有对讨论读取权限的凭据。

#### GitHub Issues

GitBook 会索引已解决的问题。它不会索引未关闭、未解决或垃圾对话。

要连接 GitHub Issues，请使用具有对问题读取权限的凭据。

#### 这些连接器存储的数据

GitBook 仅存储对话、讨论或问题。我们不存储元数据或个人信息。

GitBook 在存储前会删除敏感信息。我们不会在索引记录中存储敏感信息。

### 数据保留和隐私

#### GitBook 会索引什么？

GitBook 会索引你连接中的内容，并将其用于搜索、变更请求以及其他以内容驱动的功能。我们从连接中索引的每一项都称为一个 **记录。** 记录示例包括 Intercom 工单、Freshdesk 工单、网站页面等。

我们使用记录来建议内容更改，并为在 GitBook 中运行的代理提供额外上下文。

只要来源保持连接，我们就会保留这些记录。如果你移除连接，我们会删除所有存储的记录。我们不会删除任何使用这些记录作为上下文生成的内容，也不会从任何已存储的 AI 对话日志中移除记录内容。

例如，你可能连接了 Intercom，而 GitBook 基于一张已关闭的 Intercom 支持工单建议了一项文档更改。如果你随后移除 Intercom 连接，我们与 Intercom 相关的所有已存储数据都会被删除，但变更请求会保留。

#### 常见问题

<details>

<summary>你们关于 PII 的政策是什么？</summary>

通常，GitBook 只请求那些可用作上下文的源字段（有关每个来源的更多具体信息，请参见连接器页面）。

当我们摄取一条记录时，会先经过 PII 遮盖流程。第一步是在内存中遮盖任何电子邮件、电话号码、地址和其他个人信息。

然后，我们会通过第三方 LLM 进行第二步 PII 处理。这是一个符合 ZDR 的不存储请求，不会存储在第三方的服务器上，也不会用于任何训练。

在我们进行预处理期间，PII 可能会在我们的服务器上保留几分钟，但我们只存储处理后的记录。

</details>

<details>

<summary>你们会将数据发送给任何第三方吗？</summary>

在完成最初的内部 PII 遮盖后，我们会使用第三方来遮盖 PII。

在创建变更请求和回复用户问题时，我们也会在第三方提供商中使用已遮盖的记录内容。

例如，在使用 GitBook Agent 编写内容时，代理可能会将外部记录中的内容作为额外上下文。

</details>

<details>

<summary>GitBook 是否会将数据用于任何模型训练，无论是自行还是通过第三方？</summary>

不会，我们不使用记录数据进行训练，并且会向第三方提供商确认他们也不会这样做。

</details>

<details>

<summary>我可以限制 GitBook 拉取哪些记录吗？</summary>

各连接器的特定要求和已索引记录列在 [连接器详情](#connector-details).

</details>


---

# 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/zh/ai-for-your-readers/connections.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.