# 什么是 GitBook Agent？

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

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

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

### GitBook Agent 能做什么？

GitBook Agent 可以：

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

#### 自动文档建议

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.com/docs/documentation/zh/gitbook-dai-li-agent/translations) 作为每月附加项单独定价。请访问 [定价部分](https://gitbook.com/docs/documentation/zh/translations#pricing) 以了解更多信息。

</details>

<details>

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

可以，您可以覆盖 GitBook Agent 的默认个性和语气。因此如果您希望输出更详尽，或希望其遵循特定的风格或语气，只需告诉 Agent —— 在组织范围的指令中，或在变更请求的单独提示中。

</details>
