# 什么是 GitBook Agent？

GitBook Agent 是一个 AI 搭档，会在你身边协同工作，帮助你保持文档准确、完整且及时更新。

该 Agent 与 GitBook 深度集成，因此你无需学习新的工作流程即可利用它——它会使用你已经熟悉的流程与你协同工作。

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

### GitBook Agent 能做什么？

GitBook Agent 可以：

* **根据提示编写文档：** 让 Agent 用最新信息更新某个页面，将产品名称的每一次提及替换为新名称，或者执行你需要的任何其他操作。
* **将内容导入 GitBook：** 在 Agent 聊天侧边栏中附加 PDF、Microsoft Word 文档等文件。Agent 可以提取内容并将其格式化为你空间中的页面。
* **构思并实施更大的变更：** 描述你的需求，Agent 将打开一个变更请求，解释其计划中的编辑，响应你的反馈，然后实施你们一起制定的方案。
* **理解你的样式指南：** 在站点设置中添加你的样式指南，Agent 在撰写或审阅内容时会应用它。
* **遵循自定义的站点级说明：** 向 Agent 提供针对某个站点的具体说明，例如以特定方式添加链接，或避免特定的块类型。
* **翻译你的文档：** 选择你想翻译的内容，选择一种语言，Agent 就会完成文档本地化工作。
* **从评论中召唤：** 在页面上的任意块中添加评论，输入 @gitbook，并告诉 Agent 你需要什么。
* **审阅变更请求：** 在你的变更请求中将 Agent 添加为审阅者。它可以充当文档检查器，识别或修复错误，提出改进建议，并标记对样式指南的偏离。

#### 自动文档建议

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

进入 [Agent 审核](/docs/documentation/zh/gitbook-agent/agent-audit.md) 了解更多。
{% endhint %}

Agent 还可以连接到与你团队用于理解产品和用户需求相同的信号：支持会话、工单，以及来自已连接工具的线程。

借助这些上下文，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>让 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。每当它为该站点创建或编辑内容时，Agent 都会将这些作为上下文使用。

要添加样式指南或自定义说明，请打开你的站点的 **设置** 然后选择 **代理** 选项卡。在自定义说明字段中添加你的说明。

你可以通过在变更请求中打开 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 AI 的功能这一目的，将你添加到 GitBook Agent 的信息与 OpenAI 共享。有关更多信息，请查看 OpenAI 的隐私政策。

</details>

<details>

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

GitBook Agent 在测试版期间对所有方案均免费。

[翻译](/docs/documentation/zh/gitbook-agent/translations.md) 按月作为单独的附加项定价。访问 [定价部分](/docs/documentation/zh/gitbook-agent/translations.md#pricing) 了解更多。

</details>

<details>

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

可以，你可以覆盖 GitBook Agent 的默认个性和语气。所以如果你希望输出更详细，或者让它遵循特定的风格或语气，只需告诉 Agent——无论是在站点级说明中，还是在变更请求中的单独提示里。

</details>


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.