> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-docs-automation-github-pr-review.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 自动化概览

> 使用 Mintlify 自动化来自动维护内容。按计划运行 agent，或在 GitHub 与 GitLab 仓库推送时触发运行。

自动化会按计划或在仓库发生变更时自动运行 agent。每个自动化都会为 agent 定义一个提示词，以及触发其运行的条件。自动化同时支持 GitHub 和 GitLab 仓库。

当自动化运行时，agent 会读取你的项目内容以及任何已连接的仓库，然后按照提示词进行更新。

<Tip>
  对于周期性任务，例如发布更新日志或审计 SEO 元数据，使用按计划运行的自动化。

  对于响应式维护任务，例如翻译或在源代码变更时更新内容，使用由内容或代码变更触发的自动化。
</Tip>

<div id="trigger-types">
  ## 触发器类型
</div>

自动化支持三种触发器类型。

* **内容更新（Content update）**：当内容推送到你的 Mintlify 项目仓库时运行，包括 pull request 合并和直接推送。
* **代码变更（Code change）**：当已连接的源代码仓库中有 pull request 合并时运行。
* **自定义计划（Custom schedule）**：按周期性计划运行。自动化会在预定时间的 10 分钟内进入队列。

每个自动化只能有一个触发器。你无法在单个自动化中组合多种触发器类型。

<div id="pull-request-grouping">
  ## Pull request 分组
</div>

自动化会将相关更改分组到单个 pull request 中，而不是为每个更改都打开一个单独的 pull request。当后续运行产生的更多更改属于某个已打开的 pull request 时，agent 会将这些更改追加到该 pull request，而不是另开重复的 pull request。分组方式因自动化而异。请参阅[预定义自动化](/zh/automations/reference)了解每个自动化的具体行为。

<Note>
  Draft changelog、Draft improvements from assistant conversations、Draft improvements from user feedback 以及自定义自动化不会分组或追加。每次运行都会以本次运行的更改单独打开一个 pull request。
</Note>

<div id="usage-limits">
  ## 使用限制
</div>

自动化运行会计入你的积分使用量。单次运行消耗的积分取决于任务规模：agent 读取的内容量、变更的文件数量以及运行时长。上下文仓库越大、提示词越宽泛，使用的积分就比范围窄的运行更多。

可在控制台的 [Usage](https://app.mintlify.com/settings/organization/usage) 页面查看积分使用情况、设置超额用量并管理你的积分套餐。

每个自动化每天最多可运行 500 次。失败的运行不计入此限制。

<div id="next-steps">
  ## 后续步骤
</div>

<CardGroup cols={2}>
  <Card title="预定义自动化" icon="list" href="/zh/automations/reference">
    所有预定义自动化的参考：触发器、更新模式和必需配置。
  </Card>

  <Card title="管理自动化" icon="toggle-right" href="/zh/automations/manage">
    启用预定义自动化并配置触发器、更新模式和上下文。
  </Card>

  <Card title="创建自定义自动化" icon="plus" href="/zh/automations/create">
    使用你自己的触发器、指令和上下文仓库构建自动化。
  </Card>

  <Card title="学习最佳实践" icon="book-open" href="/zh/guides/use-automations">
    选择合适的触发器、撰写有效的指令并审查结果。
  </Card>
</CardGroup>