> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/guides.md).

# 指南

探索使用 GitBook Agent 创建、改进和维护文档的指南

GitBook Agent 可借助 AI 帮助你创建、改进和维护文档。这些指南介绍适用于团队的实用工作流程。

#### 探索

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-pen-to-square">:pen-to-square:</i></h4></td><td><h4>如何使用 AI 编写文档</h4></td><td>将 GitBook Agent 用作文档工作的 AI 队友</td><td><a href="https://gitbook.com/docs/guides/editing-and-publishing-documentation/how-to-write-documentation-with-ai.md">How to write documentation with AI</a></td></tr><tr><td><h4><i class="fa-wand-magic-sparkles">:wand-magic-sparkles:</i></h4></td><td><h4>使用 GitBook Agent 简化文档工作流</h4></td><td>了解内容更新与维护的实用工作流程</td><td><a href="https://gitbook.com/docs/guides/editing-and-publishing-documentation/gitbook-agent-prompt-examples.md">How to streamline your docs workflow with GitBook Agent</a></td></tr><tr><td><h4><i class="fa-brain-circuit">:brain-circuit:</i></h4></td><td><h4>将 AI 引入文档工作流程</h4></td><td>规划由 AI 辅助、由人掌控的流程</td><td><a href="https://gitbook.com/docs/guides/docs-workflow-optimization/introducing-ai-into-your-product-documentation-workflow.md">How to use AI in your docs</a></td></tr><tr><td><h4><i class="fa-code-pull-request">:code-pull-request:</i></h4></td><td><h4>协作处理变更请求</h4></td><td>与团队一起审查、讨论并合并文档变更</td><td><a href="https://gitbook.com/docs/guides/editing-and-publishing-documentation/how-to-collaborate-on-change-requests.md">How to collaborate on change requests</a></td></tr></tbody></table>

#### 快速指南

<details>

<summary>如何使用 GitBook Agent 创建初稿？</summary>

GitBook Agent 可以根据范围明确的请求生成变更草稿。

本指南介绍如何补充上下文、审查草稿并完善内容。

<button type="button" class="button secondary" data-action="ask" data-query="How do I create a first documentation draft with GitBook Agent? Show me how to add context, request a draft, review the change, and refine the content. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>如何使用 GitBook Agent 审查变更请求？</summary>

GitBook Agent 可以审查文档变更，并在合并前发现问题。

本指南介绍如何请求审查、处理反馈并批准变更。

<button type="button" class="button secondary" data-action="ask" data-query="How do I review a documentation change request with GitBook Agent? Show me how to request a review, address feedback, and approve the change. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>如何自动发现并修正文档缺漏？</summary>

GitBook Agent 可以发现过时或不完整的文档，并准备修正内容。

本指南介绍如何执行改进、审查建议的变更并发布更新。

<button type="button" class="button secondary" data-action="ask" data-query="How do I find and fix documentation gaps with GitBook Agent? Show me how to run automatic improvements, review suggested changes, and publish updates. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>如何使用 GitBook Agent 翻译文档？</summary>

GitBook Agent 可以翻译内容，并确保译文与源文保持一致。

本指南介绍如何创建译文、审查本地化内容并管理更新。

<button type="button" class="button secondary" data-action="ask" data-query="How do I translate documentation with GitBook Agent? Show me how to create translations, review localized content, and manage source updates. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/zh/gitbook-dai-li/guides.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
