# 自动化概览 (/zh/automations)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1389 · updated: 2026-07-30 -->

<Info>
  自动化需要 [Pro 或 Enterprise 方案](https://mintlify.com/pricing?ref=automations)。
</Info>

自动化会按计划，或在仓库或已连接集成发生变更时自动运行 agent。每个自动化都会为 agent 定义一个提示词，以及触发其运行的条件。自动化同时支持 GitHub 和 GitLab 仓库，二者具备相同的触发器、预定义自动化和更新模式。在本指南中，除非另有说明，"pull request" 也指 GitLab 的 merge request。

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

<Tip>
  对于周期性任务，例如发布更新日志或从 AI 助手对话中补齐内容缺口，使用按计划运行的自动化。

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

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

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

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

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

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

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

<Note>
  Draft changelog、Fill gaps from assistant conversations、Improve docs from user feedback、Update from support feedback 以及自定义自动化不会分组或追加。每次运行都会以本次运行的更改单独打开一个 pull request。Update from support feedback 每次运行最多可打开三个 pull request，为其识别出的每个不同主题各打开一个。
</Note>

<div id="reviewing-automation-pull-requests">
  ## 审查自动化 pull request [#审查自动化-pull-request]
</div>

当自动化打开或更新 pull request 时，Mintlify 会直接在其中添加上下文，让你无需离开 GitHub 或 GitLab 即可进行审查。

* **PR 标题** 包含生成它的自动化名称，方便你在浏览未关闭 PR 列表时一眼识别自动化 PR。
* **PR 描述** 总结了变更内容和原因。每当某次运行向已有 PR 追加新变更时，描述都会更新，显示一份记录每次运行所贡献内容的时间线。
* **PR 评论** 用于任何追加变更的运行，说明所做的变更以及 agent 使用了哪些源代码 pull request 作为上下文。
* **审阅者** 根据触发本次更新的源代码变更的作者分配。适用于在 GitHub 上以源代码仓库作为上下文的自动化。GitLab 不支持自动分配审阅者，因此请在 merge request 上手动指定审阅者。

<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="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M2 11.4C2 10.2417 2.24173 10 3.4 10H20.6C21.7583 10 22 10.2417 22 11.4V12.6C22 13.7583 21.7583 14 20.6 14H3.4C2.24173 14 2 13.7583 2 12.6V11.4Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M2 3.4C2 2.24173 2.24173 2 3.4 2H20.6C21.7583 2 22 2.24173 22 3.4V4.6C22 5.75827 21.7583 6 20.6 6H3.4C2.24173 6 2 5.75827 2 4.6V3.4Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M2 19.4C2 18.2417 2.24173 18 3.4 18H20.6C21.7583 18 22 18.2417 22 19.4V20.6C22 21.7583 21.7583 22 20.6 22H3.4C2.24173 22 2 21.7583 2 20.6V19.4Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/automations/reference">
    所有预定义自动化的参考：触发器、更新模式和必需配置。
  </Card>

  <Card title="管理自动化" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M19 12C19 13.6569 17.6569 15 16 15C14.3431 15 13 13.6569 13 12C13 10.3431 14.3431 9 16 9C17.6569 9 19 10.3431 19 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M16 6H8C4.68629 6 2 8.68629 2 12C2 15.3137 4.68629 18 8 18H16C19.3137 18 22 15.3137 22 12C22 8.68629 19.3137 6 16 6Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/automations/manage">
    启用预定义自动化并配置触发器、更新模式和上下文。
  </Card>

  <Card title="创建自定义自动化" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12.001 5.00003V19.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19.002 12.002L4.99998 12.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/automations/create">
    使用你自己的触发器、指令和上下文仓库构建自动化。
  </Card>

  <Card title="学习最佳实践" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M5.33333 3.00001C7.79379 2.99657 10.1685 3.88709 12 5.5V21C10.1685 19.3871 7.79379 18.4966 5.33333 18.5C3.77132 18.5 2.99032 18.5 2.64526 18.2792C2.4381 18.1466 2.35346 18.0619 2.22086 17.8547C2 17.5097 2 16.8941 2 15.6629V6.40322C2 4.97543 2 4.26154 2.54874 3.68286C3.09748 3.10418 3.65923 3.07432 4.78272 3.0146C4.965 3.00491 5.14858 3.00001 5.33333 3.00001Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M18.6667 3.00001C16.2062 2.99657 13.8315 3.88709 12 5.5V21C13.8315 19.3871 16.2062 18.4966 18.6667 18.5C20.2287 18.5 21.0097 18.5 21.3547 18.2792C21.5619 18.1466 21.6465 18.0619 21.7791 17.8547C22 17.5097 22 16.8941 22 15.6629V6.40322C22 4.97543 22 4.26154 21.4513 3.68286C20.9025 3.10418 20.3408 3.07432 19.2173 3.0146C19.035 3.00491 18.8514 3.00001 18.6667 3.00001Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/guides/use-automations">
    选择合适的触发器、撰写有效的指令并审查结果。
  </Card>
</CardGroup>