# 什么是 GitBook Agent？

GitBook Agent 是一位与你并肩工作的 AI 队友。它帮助你保持文档准确、完整并保持最新。GitBook Agent 与 GitBook 深度集成。你不需要新的工作流程就能使用它。

{% hint style="info" %}
如果你在本地使用 AI 助手编辑文档，请使用 [GitBook 的 skill.md 文件](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/ai-coding-assistants-and-skillmd).
{% endhint %}

### GitBook Agent 能做什么？

GitBook Agent 可以：

* **根据提示编写文档：** 让 GitBook Agent 更新某个页面、重命名产品，或执行你需要的任何其他更改。
* **将内容导入 GitBook：** 在 GitBook Agent 聊天侧边栏中附加 PDF 和 Microsoft Word 文档等文件。GitBook Agent 会提取内容并将其格式化为你空间中的页面。
* **规划并实施更大的变更：** 描述你需要什么。GitBook Agent 会打开一个变更请求，解释其编辑内容，回应反馈，并实施你们共同创建的计划。
* **理解你的风格指南：** 在站点设置中添加你的风格指南，GitBook Agent 在编写或审阅内容时会应用它。
* **遵循自定义的站点级说明：** 向 GitBook Agent 提供站点特定说明，例如如何添加链接或应避免哪些块类型。
* **翻译你的文档：** 选择你想翻译的内容，选择一种语言，GitBook Agent 会为你的文档进行本地化。
* **从评论中召唤：** 在页面上的任意块添加评论，输入 `@gitbook`，并告诉 GitBook Agent 你的需求。
* **审阅变更请求：** 将 GitBook Agent 添加为你变更请求的审阅者。它可以充当文档检查器，标记风格指南问题，并建议或修复错误。

#### 自动文档建议

{% hint style="warning" %}
**自动文档建议处于早期访问阶段**

前往 [agent-audit](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-dai-li/agent-audit "mention") 了解更多。
{% 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="write-and-edit-with-ai">write-and-edit-with-ai</a></td></tr><tr><td><strong>使用 GitBook Agent 进行审阅</strong></td><td>让 GitBook 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>

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

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

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

要添加风格指南或自定义说明，请打开你站点的 **设置** 并选择 **Agents** 选项卡。在自定义说明字段中添加你的说明。

你也可以从变更请求中打开此界面。打开 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 设置中添加的自定义说明示例。

{% 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 在 beta 期间对所有方案免费。如果你不是 Pro 用户且未处于试用期，免费使用包括每周 10 条消息。

[翻译](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/gitbook-dai-li/translations) 按月附加功能单独计费。请访问 [定价部分](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/translations#pricing) 以了解更多。

</details>

<details>

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

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

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

</details>