# 连接

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

已连接的内容可以出现在 [AI 搜索](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/publishing-documentation/ai-search) 并在 [GitBook Assistant](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/publishing-documentation/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。

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

{% step %}

### GitBook 同步记录

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

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

{% step %}

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

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

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

### 连接设置

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

#### 标签

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

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

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

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

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

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

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

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

开启 **在搜索 / 助手中公开显示** 使来自该连接的记录可供访问者搜索，并可用于回答问题。

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

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

#### 搜索排名提升

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

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