# 连接

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

关联的内容可以显示在 [AI 搜索](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/docs-site/ai-search) 和 [GitBook 助手](https://gitbook-open-v2-preview.gitbook.workers.dev/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 会开始同步该来源的记录。

在连接列表中，你可以查看同步状态、记录数量和最后同步时间。
{% endstep %}

{% step %}

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

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

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

### 连接设置

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

#### 标签

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

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

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

{% hint style="warning" %}
自动生成变更请求目前处于抢先体验阶段。

查看 [agent-shen-he](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/gitbook-agent/agent-shen-he "mention") 以了解如何申请访问权限
{% endhint %}

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

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

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

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

这使关联内容能够出现在你站点的 AI 驱动搜索体验和 GitBook 助手回复中。

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

#### 搜索排名提升

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

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