> 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/gitbook-agent/automatic-docs-improvements.md).

# 自动文档改进

{% hint style="warning" %}
**此功能目前处于抢先体验阶段。**

我们正在逐步开放访问权限。请持续关注下方功能的更多进展。
{% endhint %}

GitBook Agent 可以识别你的文档中的问题——例如内容缺口、过时页面和错误信息——并提出并实施改进。

## GitBook Agent 可以检测到什么？

* **内容缺口** 当 GitBook 发现用户就你的产品提出文档难以回答的问题时，就会出现，例如：
  * 客户向你的支持团队提出了一个在文档中找不到答案的问题。
  * 某个 API 端点缺少完整文档。
* **过时内容** 当你页面上的内容已被外部来源中的内容所取代时，会被检测到，例如：
  * 某个 SDK 更新更改了函数签名。
  * 某项付费功能已移至免费套餐，但文档尚未更新。
* **错误内容** 当文档网站上的内容明显错误时，会被标记，例如：
  * 某个指南指向的 API 已不再存在，或者该功能已停止提供。
  * 外部来源，例如你的营销网站，与文档内容不一致。

## 识别如何工作

{% stepper %}
{% step %}

#### 连接来源

当 GitBook Agent 连接到外部来源，如你的支持工单系统、公开论坛或营销网站时，效果最佳。某些来源在设置完成前需要额外的 API 密钥或身份验证。 [详细了解我们的连接。](/docs/documentation/zh/mian-xiang-du-zhe-de-ai/connections.md)
{% endstep %}

{% step %}

#### GitBook Agent 会生成发现

GitBook 会定期审查你的来源，并根据结果生成发现。GitBook 会收集这些发现供你的团队审阅。 [详细了解我们如何摄取数据。](/docs/documentation/zh/mian-xiang-du-zhe-de-ai/connections.md)
{% endstep %}

{% step %}

#### 审查你的发现

审查你的发现，以开始修复问题。每个发现都包含问题摘要、所属主题、支持性证据，以及 GitBook 用作上下文的页面链接。
{% endstep %}

{% step %}

#### 修复或归档

GitBook Agent 可以自动修复部分发现。当该选项可用时，你可以创建 [变更请求](/docs/documentation/zh/xie-zuo/change-requests.md) 可直接从该发现中创建。你也可以归档不想保留在活动列表中的发现。
{% endstep %}
{% endstepper %}

若要申请访问 GitBook Agent 的自动文档改进功能，请打开你网站的 **设置**.

<figure><img src="/files/47112bc49921d9b197ee7f8bcc3fa5ae95cdd563" alt=""><figcaption></figcaption></figure>

## 自动修复

当某个发现支持自动修复时，GitBook 会显示一个 **创建变更请求** 操作，以便 GitBook Agent 可以生成建议修复方案供你的团队审阅。若要跳过该建议，请改为归档该发现。GitBook 不会重新打开你已归档的发现。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/gitbook-agent/automatic-docs-improvements.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.