# 使用 GitBook Agent 编写
GitBook Agent 是一个强大的工具，可为你在 GitBook 中的文档生成内容。
Agent 能做很多事情，从在页面上撰写小段文本，到编辑现有区块，并在变更请求中创建新页面、章节等。
{% hint style="info" %}
#### GitBook Agent 遵循你的样式指南
你可以 [添加你自己的样式指南和自定义说明](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/what-is-gitbook-agent#add-a-style-guide-and-custom-instructions) 在站点级别——因此无论何时你请求它协助，Agent 都会始终匹配你的语气和风格。
{% endhint %}
### GitBook Agent 能做什么？
GitBook Agent 与 GitBook 应用深度集成，因此它了解你可以在编辑器中创建的区块，以及你的空间中的更广泛内容。
这意味着你可以使用 Agent 来：
* 根据你的提示撰写新内容
* 搜索现有页面并更新特定内容
* 重新格式化内容，以充分利用 GitBook 的不同区块
* 更新代码示例
* 在页面之间移动内容
* 在特定位置添加新页面
### 如何与 GitBook Agent 交互
有几种与 GitBook Agent 协作的方式：
* 在现有变更请求中打开 Agent，并告诉它你需要什么
* 使用 GitBook Agent 规划并实施一个新的变更请求
* 在区块的评论中标记 Agent
* 在页面的空白行中创建新内容
让我们逐一了解这些方式，看看它们是如何工作的。
#### 在任何变更请求中打开 GitBook Agent 聊天窗口
你可以随时通过点击 **GitBook Agent** 按钮在空间标题栏中打开变更请求里的 Agent 聊天窗口。这会在应用右侧打开 Agent 的聊天窗口。
在变更请求中打开 GitBook Agent
该 **改进** 菜单为你提供一组预设项，让 GitBook Agent 执行常见操作以改进你的页面内容。
你可以通过以下方式访问 **改进** 菜单：在编辑器中将鼠标悬停在页面标题上，或打开页面的 **操作菜单** 
.
在“改进”菜单中，你可以让 Agent：
* 为页面添加图标
* 根据页面内容生成页面描述
* 修正拼写和语法
* 重写以与其他页面保持一致
* 针对 SEO 进行优化
* 添加摘要和后续步骤部分
* 链接到相关主题和页面
* 将单个页面拆分为多个页面
前两个选项是条件性的——它们会根据你的页面内容而变化。因此，如果你的页面已经有图标和描述，你就不会在菜单中看到这些选项。
选择任何一个选项，Agent 就会立即开始执行你的任务。
#### 在空白区块中创建新内容
你可以使用 GitBook Agent 在页面上的任何空白行创建内容。它可以创建各种内容——以 Markdown 格式排版——包括代码示例、模板、页面摘要等。
按下 `空间` 在任何空白行上，或输入 `/` 并选择 **使用 AI 编写** 以启动 GitBook Agent。
你可以立即开始输入任何你想要的提示。GitBook Agent 会分析提示并据此生成内容。例如：
> 帮我写一段两段式概述，解释为什么文档对产品团队很重要。
或者，你也可以从建议的提示或提示起始语中选择一个：
* **继续写作** – GitBook Agent 会分析你当前页面上的内容，然后据此生成更多内容。
* **解释……** – 选择此项，然后告诉 GitBook Agent 你想让它解释什么。这不受你页面内容的限制，所以你可以让它解释任何内容。
* **总结** – 总结你页面上的所有内容。这非常适合在详细文档底部撰写 TL;DR，或在顶部添加简短摘要，方便快速了解的人查看。
* **解释这个** – 这会用更简单的语言解释你页面上的复杂信息——包括解释首字母缩略词和其他术语。如果你正在阅读的页面包含大量复杂信息，或者你想为不太技术化的人添加说明，这非常适合。
* **翻译** – 将你当前页面翻译成指定数量的语言之一。如果你想翻译成不在列表中的语言，只需在提示框中输入该语言即可。
### 为 GitBook Agent 编写有效提示
GitBook Agent 就像一个擅长接受指令的队友。你需要给它清晰的指示和上下文，才能获得最佳结果。
以下是编写好提示的一些快速建议：
* **拆分任务** – Agent 最擅长完成聚焦的任务。将复杂项目拆分成更小的步骤，并让 Agent 一次完成一个。
* **具体明确** – 像 `@gitbook improve this page` 这样的通用提示会应用一般最佳实践，但如果没有更具体的指导，Agent 可能无法实现你心中的目标。
* **关注结果** – 如果你听说客户正在遇到某个具体问题，请把这些问题——或你想实现的结果——告诉 Agent。它会基于这些结果提出改进建议。
* **给出直接指令** – 如果你希望 Agent 在分步指南中使用 stepper 区块，或者添加一个包含多个可展开区块的 FAQ 部分，请精确告诉它第一次就要怎么做，才能获得正确结果。
* **使用宽泛提示以进行更大范围的改进** – 对于修正拼写错误、跨页面更新功能名称，或从文档中移除特定区块类型等维护任务，你可以使用诸如 `@gitbook replace all instances of v2.3.9 with v2.4.0`.