# 连接

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

已连接的内容可以显示在 [AI 搜索](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/docs-site/ai-search) 并 [GitBook Assistant](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/ai-yu-sou-suo/gitbook-ai-assistant)中。一些连接还可以帮助 GitBook 生成变更请求。

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

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FRJwCRgQ7bEF45BpqdXOQ%2F25_03_30_connections%402x.png?alt=media&#x26;token=3bbf0d47-e72a-43a3-ae1b-79e91b6aa180" alt=""><figcaption></figcaption></figure>

### 连接的工作方式

{% 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 %}

### 连接设置

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

#### 标签

使用 **标签** 为该连接起一个清晰的名称。

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

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

{% hint style="warning" %}
自动生成变更请求目前处于早期访问阶段。

参见 [agent-audit](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/agent-audit "mention") 有关申请访问权限的信息
{% endhint %}

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

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

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

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

这使已连接的内容能够出现在你站点的 AI 驱动搜索体验中，以及 GitBook Assistant 的回复中。

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

#### 搜索排名提升

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

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