> 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/what-is-gitbook-agent.md).

# 什么是 GitBook Agent？

GitBook Agent 是一个与你并肩工作的 AI 队友。它帮助你保持文档的准确、完整和最新。GitBook Agent 与 GitBook 深度集成。你无需为使用它而建立新的工作流程。

{% hint style="info" %}
如果你在本地用 AI 助手编辑文档，请使用 [GitBook 的 skill.md 文件](/docs/documentation/zh/getting-started/ai-documentation/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/creating-content/styleguide.md)，GitBook Agent 会在撰写或审阅内容时将其视为唯一依据。
* **遵循自定义的网站级说明：** 为 GitBook Agent 提供站点特定的说明，例如如何添加链接或应避免哪些块类型。
* **翻译你的文档：** 选择你想翻译的内容，选择一种语言，GitBook Agent 就会本地化你的文档。
* **从评论中召唤：** 为页面上的任意块添加评论，输入 `@gitbook`，然后告诉 GitBook Agent 你需要什么。
* **审阅更改请求：** 将 GitBook Agent 添加为你更改请求的审阅者。它可以充当文档校对器，标记风格指南问题，并建议或修复错误。

#### 自动文档建议

{% hint style="warning" %}
**自动文档建议目前处于抢先体验阶段**

前往 [自动改进文档](/docs/documentation/zh/gitbook-agent/automatic-docs-improvements.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="/pages/a47919b6edcf8b0f45ffa22377d52becea6544de">/pages/a47919b6edcf8b0f45ffa22377d52becea6544de</a></td></tr><tr><td><strong>使用 GitBook Agent 审阅</strong></td><td>让 GitBook Agent 检查你的内容是否存在拼写、语法和风格问题</td><td><a href="/pages/7e087e2d7715580040d4eabdc7a47d4f423fc7bf">/pages/7e087e2d7715580040d4eabdc7a47d4f423fc7bf</a></td></tr><tr><td><strong>翻译你的文档站点</strong></td><td>GitBook Agent 可以创建自动更新的本地化版本</td><td><a href="/pages/dd016bc5bf4a2bc46275e16bf58ac27690862969">/pages/dd016bc5bf4a2bc46275e16bf58ac27690862969</a></td></tr></tbody></table>

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

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

无论何时为该站点创建或编辑内容，GitBook Agent 都会使用这些上下文。

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

你也可以从更改请求中打开此界面。打开 GitBook Agent 聊天窗口，然后打开 **操作菜单** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/d05670ba93b683794fb3fe95a9fc7ab5c7fceafd" alt=""></picture> 并点击 **配置 GitBook Agent** <picture><source srcset="/files/CG9bVSmdbJnQxrYiNbRI" media="(prefers-color-scheme: dark)"><img src="/files/9bcd313f64920f73d3606c61b9fbde5ddf8e3f6b" 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-agent/translations.md) 按月作为附加项单独定价。访问 [定价部分](/docs/documentation/zh/gitbook-agent/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 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/what-is-gitbook-agent.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.