# 连接

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

关联内容可以显示在 [AI 搜索](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/docs-site/ai-search) 和 [GitBook Assistant](https://gitbook-v2-lrp5kto0w-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%2FbbH4i4bbDdzpkvc57s9h%2F26_03_30_connections%402x.png?alt=media&#x26;token=92203fbd-dc21-4348-aa93-8806ca03c1b9" 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-shen-he](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-agent/agent-shen-he "mention") 以了解如何申请访问权限
{% endhint %}

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

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

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

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

这使得关联内容可以出现在你站点的 AI 驱动搜索体验以及 GitBook Assistant 的回复中。

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

#### 搜索排名提升

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

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