> 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-dai-li/overview.md).

# 概览

与 AI 队友协作，让你的文档保持准确、完整并及时更新

GitBook Agent 是一个与你并肩工作的 AI 搭档。它帮助你保持文档准确、完整且最新。GitBook Agent 与 GitBook 深度集成。你无需采用新的工作流程即可使用它。

{% hint style="info" %}
如果你使用 AI 助手在本地编辑文档，请使用 [GitBook 的 skill.md 文件](/docs/documentation/zh/docs-as-code/ai-coding-assistants-and-skillmd.md).
{% endhint %}

### GitBook Agent 可以做什么？

GitBook Agent 可以：

* **根据提示撰写文档：** 让 GitBook Agent 更新页面、重命名产品，或执行你需要的任何其他更改。
* **将内容导入 GitBook：** 在 GitBook Agent 聊天侧边栏中附加 PDF 和 Microsoft Word 文档等文件。GitBook Agent 会提取内容并将其格式化为你版块中的页面。
* **规划并实施更大的更改：** 描述你的需求。GitBook Agent 会发起变更请求，解释其编辑内容，响应反馈，并实施你们共同制定的计划。
* **遵循你的风格指南：** 在 [风格指南](/docs/documentation/zh/chuang-jian-nei-rong/styleguide.md)中定义你团队的写作规则，GitBook Agent 在撰写或审阅内容时会将其视为唯一依据。
* **遵循自定义的网站级说明：** 给 GitBook Agent 提供特定站点的说明，例如如何添加链接或应避免哪些块类型。
* **翻译你的文档：** 选择你想翻译的内容，选择一种语言，GitBook Agent 会为你的文档进行本地化。
* **从评论中唤出：** 在页面中的任意块上添加评论，输入 `@gitbook`，然后告诉 GitBook Agent 你的需求。
* **审查变更请求：** 在你的变更请求中将 GitBook Agent 添加为审阅者。它可以充当文档检查器，标记风格指南问题，并建议或修复错误。

#### 自动文档建议

{% hint style="warning" %}
**内容缺口功能处于测试版。**

前往 [内容缺口](/docs/documentation/zh/analytics/content-gaps.md) 了解更多。
{% endhint %}

GitBook Agent 还可以连接到你团队用来了解产品和客户需求的信号：来自已连接工具的支持对话、工单和线程。

借助这些上下文，GitBook Agent 可以识别空白、提出更新建议，并自动生成文档更改。

随着你的文档随产品不断演进，客户会在需要时获得正确的信息。

### 探索 GitBook Agent 的功能

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>使用 GitBook Agent 撰写</strong></td><td>根据提示创建内容，或编辑单个块</td><td><a href="/docs/documentation/zh/gitbook-dai-li/write-and-edit-with-ai.md">使用 GitBook Agent 编写</a></td></tr><tr><td><strong>使用 GitBook Agent 审阅</strong></td><td>让 GitBook Agent 检查你的拼写、语法和风格</td><td><a href="/docs/documentation/zh/gitbook-dai-li/review-change-requests-with-gitbook-agent.md">使用 GitBook Agent 审查变更请求</a></td></tr><tr><td><strong>翻译你的文档站点</strong></td><td>GitBook Agent 可以创建自动更新的本地化版本</td><td><a href="/docs/documentation/zh/gitbook-dai-li/translations.md">翻译</a></td></tr></tbody></table>

### 添加风格指南和自定义说明

你可以使用团队的风格指南或站点特定说明来配置 GitBook Agent。

GitBook Agent 在为该站点创建或编辑内容时会使用这些上下文。

要添加风格指南或自定义说明，请打开你站点的 **设置** 在网站侧边栏中并点击 **Agents**。在自定义说明字段中添加你的说明。

你也可以从变更请求中打开此界面。打开 GitBook Agent 聊天窗口，然后打开 **操作菜单** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt=""></picture> 并点击 **配置 GitBook Agent** <picture><source srcset="/files/CG9bVSmdbJnQxrYiNbRI" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwkBqgOPry9HAcW4cxJk0%2Fsettings.svg?alt=media&amp;token=67bdbb00-ebf3-4a2d-9df8-0c822406f71c" alt=""></picture>.

#### 自定义说明示例

下面是一个你可以在 GitBook Agent 设置中添加的自定义说明示例。

{% code overflow="wrap" %}

```
你是一名 Stripe 的技术写作者。使用清晰、直接的语言，把准确性放在润色之上。对于指南，始终先用一句话总结概念，然后将内容拆分为结构良好的各个部分。对于快速入门，始终使用步骤器，并让每一步都以动作为先且简洁明了。
```

{% endcode %}

### 常见问题

<details>

<summary>GitBook Agent 如何使用我的数据？</summary>

我们遵循数据保护实践，以保护你的数据隐私。

GitBook Agent 不会使用你的数据来训练 AI 模型。我们仅为提供 GitBook Agent 而与 OpenAI 共享你添加到 GitBook Agent 的信息。更多信息请参阅 OpenAI 的隐私政策。

</details>

<details>

<summary>GitBook Agent 的费用是多少？</summary>

GitBook Agent 在测试期间对所有套餐免费。如果你不是 Pro 计划且不在试用期内，免费使用包括每周 10 条消息。

[翻译](/docs/documentation/zh/gitbook-dai-li/translations.md) 按月附加收费。访问 [定价部分](/docs/documentation/zh/gitbook-dai-li/translations.md#pricing) 了解更多信息。

</details>

<details>

<summary>我可以覆盖 GitBook Agent 输出的默认语气吗？</summary>

可以。你可以覆盖 GitBook Agent 的默认个性和语气。

如果你希望获得更详细的输出，或特定的风格或语气，请在站点级说明中或变更请求中的提示里告诉 GitBook Agent。

</details>


---

# 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/gitbook-dai-li/overview.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.
