# 什么是 GitBook Agent？

GitBook Agent 是一个与您并肩工作的 AI 团队成员，帮助您保持文档的准确、完整和最新。

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

{% hint style="info" %}
如果您希望在本地环境使用 AI 助手编辑文档，您可以使用 [GitBook 的 skill.md 文件](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/ai-coding-assistants-and-skillmd).
{% endhint %}

### GitBook Agent 能做什么？

GitBook Agent 可以：

* **根据提示撰写文档：** 要求 Agent 使用最新信息更新页面、将所有产品名称替换为新名称，或执行您需要的任何其他操作。
* **构思并实施更大范围的更改：** 描述您需要的内容，Agent 将发起变更请求、说明其计划的编辑内容、对您的反馈作出回应，然后实施你们共同制定的计划。
* **理解您的风格指南：** 将您的风格指南添加到组织设置中，Agent 在编写或审阅内容时将始终应用该指南。
* **遵循自定义的组织级指令：** 在组织级别向 Agent 提供具体指示，例如以特定方式添加链接，或避免使用特定的区块类型。
* **翻译您的文档：** 选择您要翻译的内容，选择一种语言，Agent 将负责本地化您的文档。
* **从评论中召唤：** 在页面的任何区块添加评论，输入 @gitbook 并告诉 Agent 您的需求。
* **审查变更请求：** 将 Agent 添加为变更请求的审阅者。它可以充当文档 linter，识别或修复错误、提出改进建议并标记与风格指南不符之处。

#### 自动文档建议

Agent 还可以连接到您的团队用来了解产品和用户需求的相同信号：支持对话、工单以及来自您已连接工具的讨论串。

有了这些上下文，Agent 可以主动识别空白、提出更新建议并自动生成文档更改。这样您的文档可以随着产品演进，用户也能在需要的时间和地点获得正确的信息。

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

前往 **组织设置 → GitBook Agent** 以申请访问权限。
{% endhint %}

### 探索 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="write-and-edit-with-ai">write-and-edit-with-ai</a></td></tr><tr><td><strong>使用 GitBook Agent 审阅</strong></td><td>让 Agent 检查您的拼写、语法和风格</td><td><a href="review-change-requests-with-gitbook-agent">review-change-requests-with-gitbook-agent</a></td></tr><tr><td><strong>翻译您的文档站点</strong></td><td>GitBook Agent 可以创建自动更新的本地化内容</td><td><a href="translations">translations</a></td></tr></tbody></table>

### 添加风格指南和自定义指令

您可以通过添加团队的风格指南或有关希望 Agent 如何与团队配合的具体指令来配置 GitBook Agent。Agent 在为您的组织创建或编辑内容时会将这些作为上下文。

要添加风格指南或自定义指令，请打开您的 **组织设置** 然后选择 **GitBook Agent** 部分。点击 **设置** 选项卡并在文本输入字段中添加您的指令。

您也可以通过在变更请求中打开 GitBook Agent 聊天窗口，然后打开 **操作菜单** <picture><source srcset="broken-reference" 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&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt=""></picture> 并选择 **配置 GitBook Agent** <picture><source srcset="broken-reference" 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&#x26;token=67bdbb00-ebf3-4a2d-9df8-0c822406f71c" alt=""></picture>.

#### 自定义指令示例

以下是可以在 GitBook Agent 设置中添加的自定义指令示例。

<pre data-overflow="wrap"><code><strong>您是 Stripe 的一名技术作者。使用清晰、直接的语言，并优先保证准确性而非华丽修辞。对于指南类内容，始终用一句话总结引入概念，并将内容分成结构良好的章节。对于快速入门，始终使用步骤器，并确保每一步以行动为主且简明扼要。
</strong></code></pre>

### 常见问题解答

<details>

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

我们始终遵循数据保护措施以保持您的数据私密。

GitBook Agent 不会将您的数据用于训练 AI 模型。我们会将您添加到 GitBook Agent 的信息与 OpenAI 共享，唯一目的是为您提供 GitBook AI 的功能。有关更多信息，请查看 OpenAI 的隐私政策。

</details>

<details>

<summary>GitBook Agent 收费是多少？</summary>

GitBook Agent 在测试期间对所有计划均为免费。

[翻译服务](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/gitbook-agent/translations) 作为每月附加服务单独计费。请访问 [定价部分](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/translations#pricing) 以了解更多信息。

</details>
