> 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/analytics/content-gaps.md).

# 内容缺口

找到你的文档未能回答的问题，按严重程度排序，并使用 GitBook Agent 将其补上

{% hint style="info" %}
内容缺口处于 Beta 版，并且仅适用于 Ultimate 站点方案。
{% endhint %}

内容缺口会显示你的文档没有回答哪些问题。GitBook 会扫描访客在你的文档中提出的问题，以及你已连接来源中的支持工单、电子邮件、论坛和其他记录。它每天会将这些问题与你的内容进行比较，找出文档未回答的问题，并按严重程度进行排序。

从任何缺口出发，GitBook Agent 都可以创建一个将其补上的变更请求。

在站点侧边栏中，前往 **改进 → 内容缺口**.

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-489320e17f7eef5f995911b381ba4de6ea54d1af%2Fcontent-gaps.png?alt=media" alt="The Content gaps screen showing summary tiles, the filter row, and a list of gaps with their topics and evidence counts"><figcaption></figcaption></figure>

顶部的四个卡片显示 GitBook 找到了多少个差距、其中有多少属于高严重性、已有多少变更请求从差距中合并，以及哪个来源贡献最多。

## GitBook 检测什么

GitBook 标记四种问题：

* **内容缺口** 当 GitBook 发现客户提出的问题难以通过文档解答时，就会出现内容缺口，例如：
  * 一位客户向你的支持团队提出一个问题，但他们在文档中找不到答案。
  * 某个 API 端点缺少完整文档。
* **内容过时** 当页面内容已被外部来源中的内容取代时，系统会检测到内容过时，例如：
  * 一次 SDK 更新更改了某个函数的签名。
  * 某个付费功能已移至免费层级，但文档尚未更新。
* **内容有误** 当文档站点中的内容明显有误时，系统会将其标记为内容有误，例如：
  * 某篇指南指向已不再存在的 API，或指向已经停止支持的功能。
  * 外部来源，例如你的营销网站，与文档内容不一致。
* **其他** 用于归类不属于上述类别的问题。

## 工作原理

{% stepper %}
{% step %}

#### 连接你的来源

如果 GitBook 能将文档与客户提问的渠道进行比对，就能发现更多内容缺口，例如支持工单系统、公开论坛或营销网站。某些来源需要额外的 API 密钥或身份验证才能完成设置。 [详细了解连接。](https://gitbook.com/docs/documentation/zh/ai-for-your-readers/connections.md)
{% endstep %}

{% step %}

#### GitBook 每日扫描

GitBook 每天会检查一次你的来源，并将其发现与你已发布的内容进行比较。文档未能回答的每个问题都会成为一个缺口。
{% endstep %}

{% step %}

#### 查看缺口

每个缺口都会说明问题、背后的证据，以及修复建议。按严重程度排序，找出最值得优先修复的缺口。
{% endstep %}

{% step %}

#### 填写或拒绝

你可以通过创建 [变更请求](https://gitbook.com/docs/documentation/zh/collaborate/change-requests.md) 来填补缺口，也可以拒绝不打算处理的缺口。GitBook 不会重新打开你已拒绝的缺口。
{% endstep %}
{% endstepper %}

## 筛选列表

一个拥有大量历史内容的网站一次可能会暴露出成千上万个缺口。筛选列表，找出值得处理的那些：

| 筛选         | 选项                                 | 用它来                                                     |
| ---------- | ---------------------------------- | ------------------------------------------------------- |
| 状态         | **待处理**, **已更改**, **已拒绝**, **已解决** | 将未处理的缺口与以下内容区分开来：已有变更请求涵盖的缺口、你的团队否决的建议，以及已合并的变更请求关闭的缺口。 |
| 严重程度       | **高**, **中**, **低**                | 优先处理影响最大的缺口。                                            |
| 日期         | **最近 7 天**, **最近 30 天**            | 查看最近一次发布或支持请求激增暴露了什么。                                   |
| 主题         | 网站上的任何主题                           | 专注于文档中的某个区域。主题的分组方式与 AI 助手报告中的分组方式相同。                   |
| 类型         | 内容缺口、过时内容、错误内容、其他                  | 将缺失的文档与出错的文档区分开来。                                       |
| 来源         | 任何已连接的来源                           | 查看单个来源报告的内容，例如只有 Intercom 看到的缺口。                        |
| GitBook 代理 | 已处理，未处理                            | 找出尚无人接手的缺口。                                             |

按严重性对筛选后的列表排序，将最具破坏性的差距置于顶部。

拒绝缺口表示你的团队已考虑该建议并决定不予采纳。这会将它从待处理列表中移除，同时保留已作出决定的记录。按 **已解决** 筛选，即可查看已通过合并变更请求而关闭的缺口。

## 审查缺口

每次审查一个差距都遵循相同的路径：

1. 在“内容缺口”页面中，筛选出你想处理的缺口列表。
2. 点击一个缺口将其打开。
3. 阅读 **问题**, **证据**和 **建议** 以判断该缺口是否确实存在，以及是否值得填补。
4. 打开关联的来源记录，亲自检查证据。
5. 点击 **创建变更请求**，或点击 **拒绝** （如果该缺口不值得填补）。
6. 审查 GitBook Agent 起草的变更请求，然后将其合并。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-42b4c70f8e2337ff35332e9dec1383df4bf35e2f%2F25_03_30_site_findings%402x.png?alt=media" alt="A single content gap showing its status, severity, type, and topic, with Reject and Create change request actions above the motivation"><figcaption></figcaption></figure>

### 缺口显示什么

打开缺口后，你会看到它的名称、状态、严重程度、类型和主题。状态是一个下拉菜单，因此你无需离开缺口即可更改状态。下方的 **原因说明** 部分分为三部分，阐述了相关依据：

* **问题** 说明文档未能解释什么，以及这会给读者带来什么影响。
* **证据** 列出 GitBook 发现的情况：目前哪些页面涉及该主题、遗漏了哪些内容，以及来源记录显示用户提出了哪些问题。
* **建议** 提出应撰写哪些内容、放置在何处，以及应从哪些页面添加链接。

在“动机”下方，GitBook 会列出该发现所依据的来源记录——单独的支持对话、讨论或页面，每条都有链接，因此你可以打开原始内容完整阅读。

{% hint style="info" %}
只有已连接来源的记录才会显示。如果缺口来自支持对话，只有在连接了相应支持平台后，才会显示这些对话。请参阅 [连接](https://gitbook.com/docs/documentation/zh/ai-for-your-readers/connections.md) 以了解如何进行设置。
{% endhint %}

### 从缺口创建变更请求

当一个缺口可以自动修复时，横幅会说明该发现可以在变更请求中解决，并提供两个操作。

点击 **创建变更请求** ，将差距交给 GitBook Agent。Agent 会读取这条发现及其提及的页面，然后起草变更。如果修复涉及多个页面，一条差距可能会生成多个变更请求。

Agent 工作时，屏幕会显示进度；完成后会列出生成的内容，并提供每项内容的审核链接。从这里开始，它们的处理方式与其他任何 [变更请求](https://gitbook.com/docs/documentation/zh/collaborate/change-requests.md) 一样——你可以清楚地看到具体变更的内容，并遵循常规的审核和合并规则。请参阅 [使用 GitBook Agent 审查变更请求](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/review-change-requests-with-gitbook-agent.md) 了解 Agent 如何协助审核。

合并变更请求即可解决该差距，并将其从队列中移除。筛选 **已解决** 即可再次找到它。

### 拒绝缺口

点击 **拒绝** 当某个内容缺口不值得填补时——问题超出了范围、页面已有答案，或发现内容误读了证据。拒绝后，该缺口会从未处理列表中移除，GitBook 也不会重新打开它。

{% hint style="info" %}
更改缺口状态（包括拒绝它）需要该站点的编辑权限。你无法使用的操作会显示为禁用，并附带说明。
{% endhint %}

## 使用你自己的代理处理缺口

“内容缺口”页面上的所有内容也可通过 [GitBook API](https://gitbook.com/docs/developers/gitbook-api/api-reference) 和 [GitBook MCP 服务器](https://gitbook.com/docs/documentation/zh/docs-as-code/gitbook-mcp.md)访问，因此你自己的代理或脚本可以在 GitBook 应用之外处理内容缺口。你的代理或脚本可以执行以下操作：

* 列出某个站点的缺口，并查看每个缺口背后的证据：源记录、AI 助手提问以及它影响的页面。
* 解决、拒绝或重新打开一个缺口。
* 让 GitBook Agent 通过生成变更请求来修复内容缺口，就像 **创建变更请求** 在应用中的操作一样。
* 通过设置以下内容，将你自己编写的变更请求关联到它所修复的缺口 `siteFindingId`。当关联到该缺口的所有变更请求都合并后，该缺口便会解决。

## 设置

在“内容缺口”页面上，点击 **“设置”** 即可查看 GitBook 会扫描哪些来源，以及每个来源提供了什么内容。

### 来源

“ **来源** ”列表会显示所有正在导入内容的连接、已扫描的内容，以及由此产生的缺口数量。每种来源使用自己的计量单位：网站按页面计，YouTube 频道按视频计，GitHub Discussions 按讨论计，支持平台则按对话计。

你的文档本身也是一种来源。 **AI 助手** 会同时报告访客在你的网站上提出但未得到解答的问题，以及这些问题暴露出的内容缺口。请查看 [AI 助手](https://gitbook.com/docs/documentation/zh/analytics/insights/ai-insights.md) 报告，全面了解这些问题。

每个来源都会显示在你为连接设置的标签下，因此两个网站连接会分别显示，而不会合并为一条记录。

点击 **显示内容缺口** 可按任意来源筛选列表，仅查看该来源的内容缺口。

### 连接

“ **连接** ”部分会显示你尚未连接的来源，例如 Zendesk、Freshdesk、Front、HubSpot、Zoho Desk、Pylon、GitHub Issues 和 MCP 服务器。

点击 **管理连接** 以打开“连接”页面，你可以在此添加数据源、查看同步状态和记录数量、设置搜索排名，并浏览 GitBook 已导入的各条记录。请参阅 [连接](https://gitbook.com/docs/documentation/zh/ai-for-your-readers/connections.md) 了解各个连接器会索引哪些内容，以及如何进行设置。


---

# 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/analytics/content-gaps.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.
