# 管理自动化 (/zh/automations/manage)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 2193 · updated: 2026-07-31 -->
Related: [预定义自动化](/zh/automations/reference.md), [用于 agent 和自动化的集成](/zh/automations/integrations.md), [创建自定义自动化](/zh/automations/create.md)

<div id="prerequisites">
  ## 前置条件 [#前置条件]
</div>

* 一个已连接到 GitHub 或 GitLab 仓库的 Mintlify 项目
* 对于 GitHub：在你计划用于自动化的每个仓库上都安装 [Mintlify GitHub 应用](/zh/deploy/github)
* 对于 GitLab：已连接的 GitLab 账户（请参见下方[GitLab 设置](#gitlab-setup)）

<Tip>
  你也可以通过 [`mint automations`](/zh/cli/commands#mint-automations) 在终端中创建、列出和删除自动化。CLI 适合用于脚本和 CI。控制台是配置和监控自动化运行最简单的方式。
</Tip>

<div id="enable-an-automation">
  ## 启用自动化 [#启用自动化]
</div>

1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。
2. 点击自动化旁边的开关以启用它。

   <Frame>
     <img src="/_assets/74d90cf5f87b84fd5b7b2022086d866a5b918949dfaa49b96df7ca1af346573f" alt="自动化控制台。" className="block dark:hidden" />

     <img src="/_assets/fcddd98f4c36849c167c1bce53cc3f240338f33c75b7822e14fc4dcb5da1701f" alt="自动化控制台。" className="hidden dark:block" />
   </Frame>

   如果自动化可以使用默认设置运行，它会立即激活。否则，设置面板会打开，让你填写任何必需的配置。

   <Frame>
     <img src="/_assets/befd7701afa6b3962a0278a9dee2ea629bf7385769a9af2b1003c62600b05042" alt="自动化的配置选项。" className="block dark:hidden" />

     <img src="/_assets/da0caabe03a68d7a49118c1b8c65010fe8449472cf43e9fa705e6b8c8214f383" alt="自动化的配置选项。" className="hidden dark:block" />
   </Frame>
3. 如果设置面板打开，请填写必填字段。
4. 点击 **Turn on automation**。

要更改已激活自动化的设置，点击它旁边的 <Icon 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;M21.3175 7.14139L20.8239 6.28479C20.4506 5.63696 20.264 5.31305 19.9464 5.18388C19.6288 5.05472 19.2696 5.15664 18.5513 5.36048L17.3311 5.70418C16.8725 5.80994 16.3913 5.74994 15.9726 5.53479L15.6357 5.34042C15.2766 5.11043 15.0004 4.77133 14.8475 4.37274L14.5136 3.37536C14.294 2.71534 14.1842 2.38533 13.9228 2.19657C13.6615 2.00781 13.3143 2.00781 12.6199 2.00781H11.5051C10.8108 2.00781 10.4636 2.00781 10.2022 2.19657C9.94085 2.38533 9.83106 2.71534 9.61149 3.37536L9.27753 4.37274C9.12465 4.77133 8.84845 5.11043 8.48937 5.34042L8.15249 5.53479C7.73374 5.74994 7.25259 5.80994 6.79398 5.70418L5.57375 5.36048C4.85541 5.15664 4.49625 5.05472 4.17867 5.18388C3.86109 5.31305 3.67445 5.63696 3.30115 6.28479L2.80757 7.14139C2.45766 7.74864 2.2827 8.05227 2.31666 8.37549C2.35061 8.69871 2.58483 8.95918 3.05326 9.48012L4.0843 10.6328C4.3363 10.9518 4.51521 11.5078 4.51521 12.0077C4.51521 12.5078 4.33636 13.0636 4.08433 13.3827L3.05326 14.5354C2.58483 15.0564 2.35062 15.3168 2.31666 15.6401C2.2827 15.9633 2.45766 16.2669 2.80757 16.8741L3.30114 17.7307C3.67443 18.3785 3.86109 18.7025 4.17867 18.8316C4.49625 18.9608 4.85542 18.8589 5.57377 18.655L6.79394 18.3113C7.25263 18.2055 7.73387 18.2656 8.15267 18.4808L8.4895 18.6752C8.84851 18.9052 9.12464 19.2442 9.2775 19.6428L9.61149 20.6403C9.83106 21.3003 9.94085 21.6303 10.2022 21.8191C10.4636 22.0078 10.8108 22.0078 11.5051 22.0078H12.6199C13.3143 22.0078 13.6615 22.0078 13.9228 21.8191C14.1842 21.6303 14.294 21.3003 14.5136 20.6403L14.8476 19.6428C15.0004 19.2442 15.2765 18.9052 15.6356 18.6752L15.9724 18.4808C16.3912 18.2656 16.8724 18.2055 17.3311 18.3113L18.5513 18.655C19.2696 18.8589 19.6288 18.9608 19.9464 18.8316C20.264 18.7025 20.4506 18.3785 20.8239 17.7307L21.3175 16.8741C21.6674 16.2669 21.8423 15.9633 21.8084 15.6401C21.7744 15.3168 21.5402 15.0564 21.0718 14.5354L20.0407 13.3827C19.7887 13.0636 19.6098 12.5078 19.6098 12.0077C19.6098 11.5078 19.7888 10.9518 20.0407 10.6328L21.0718 9.48012C21.5402 8.95918 21.7744 8.69871 21.8084 8.37549C21.8423 8.05227 21.6674 7.74864 21.3175 7.14139Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M15.5195 12C15.5195 13.933 13.9525 15.5 12.0195 15.5C10.0865 15.5 8.51953 13.933 8.51953 12C8.51953 10.067 10.0865 8.5 12.0195 8.5C13.9525 8.5 15.5195 10.067 15.5195 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> 设置按钮。使用弹窗头部的开关可以在不离开设置视图的情况下启用或禁用自动化。

<div id="configurations">
  ## 配置 [#配置]
</div>

<div id="trigger">
  ### 触发器 [#触发器]
</div>

每个自动化都有一个默认触发器来控制运行时机。要更改触发器，在设置面板中选择不同选项。

* **内容更新（Content update）**：每当你向项目仓库推送内容时运行，包括 pull request 合并和直接推送。
* **代码变更（Code change）**：当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。
* **自定义计划（Custom schedule）**：按你定义的周期性计划运行。自动化会在预定时间的 10 分钟内进入队列。
* **集成（Integration）**：当已连接的共享集成中发生所选事件时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。

<div id="update-mode">
  ### 更新模式 [#更新模式]
</div>

每个自动化都有一种默认的更新方式：要么直接将更改合并到你的内容仓库，要么打开一个 pull request 以供审查。

要在自动化更新内容之前要求审查，请在设置面板中选择 **Require review**。

<Note>
  对于 GitHub 仓库，自动更新要求 Mintlify GitHub 应用对所有针对部署分支的规则集（包括组织级和仓库级规则集）拥有绕过权限。设置说明请参见[配置 automerge](/zh/guides/configure-automerge)。

  对于 GitLab 仓库，automerge 使用 GitLab OAuth 连接，并且要求每个项目至少具有 Maintainer 角色。
</Note>

<div id="context-repositories">
  ### 上下文仓库 [#上下文仓库]
</div>

对于自定义自动化和部分预定义自动化，你可以添加上下文仓库——自动化运行时 agent 读取的额外源代码仓库。这在你的自动化提示词引用了项目仓库之外的代码、API 或其他内容时很有用。

每个自动化最多可添加 10 个上下文仓库。对于每个 GitHub 仓库，请安装 Mintlify GitHub 应用。在 [GitHub App settings](https://app.mintlify.com/settings/organization/github-app) 页面添加仓库。

<div id="integrations">
  ### 集成 [#集成]
</div>

对于自定义自动化和其他受支持的预定义自动化，你可以启用[集成](/zh/automations/integrations)，让 agent 在运行时从 Notion、Jira 或 Linear 等共享工具获取上下文。

打开自动化设置，并在 **Tools** 中选择集成。你可以直接从选择器连接尚未连接的共享集成。个人集成仅供其所有者在使用 Slack agent 时使用，不能添加到自动化。

如果选择 &#x2A;*集成（Integration）** 作为触发器，触发该自动化的集成会自动添加为工具。有关连接范围、支持的事件和权限，请参见[集成](/zh/automations/integrations)。

<div id="slack-notifications">
  ### Slack 通知 [#slack-通知]
</div>

在自动化运行时向一个或多个频道发送 Slack 消息。

要启用 Slack 通知：

1. 在你的工作区安装 [Mintlify Slack 应用](/zh/agent/slack)。
2. 在控制台的 [Automations](https://app.mintlify.com/products/automations) 页面点击 **Configure Slack**。
3. 选择一个或多个用于接收通知的频道。
4. 点击 **Save changes**。

启用后，Mintlify 会在以下情况下向所选频道发送消息：

* 自动化打开了 pull request 等待审查。
* 自动化的 pull request 已等待审查三天。
* 自动化合并了 pull request 或未能完成。

<div id="instructions">
  ### 指令 [#指令]
</div>

添加可选指令，这些指令会在每次运行时附加到自动化的基础提示词。使用它们来调整风格、语气或其他项目特有的行为，而无需更改核心自动化逻辑。

<div id="target-languages">
  ### 目标语言 [#目标语言]
</div>

启用 **Translate content** 自动化时，选择一种或多种语言以与你的源内容保持同步。

* Mintlify 会读取你 `docs.json` 中定义的[languages](/zh/organize/navigation#languages)以识别默认语言，并预选已配置的目标语言。
* 你必须至少选择一个目标语言才能保存自动化。
* 你无法选择源语言作为目标。

随时可通过打开自动化设置并编辑 **Translate to** 字段来添加目标语言。

## GitLab 设置 [#gitlab-设置]

要在自动化中使用 GitLab 仓库，请通过 [GitLab OAuth](https://app.mintlify.com/settings/organization/gitlab-oauth) 设置页面连接每个项目。请连接自动化涉及的所有仓库——你的文档仓库以及任何触发或上下文仓库。你必须在每个项目中至少具有 Maintainer 角色。

<Note>
  自动化需要付费的 GitLab 套餐。代理使用短期项目访问令牌来访问仓库，GitLab 的 Free 套餐不支持此功能。
</Note>

<div id="disable-an-automation">
  ## 禁用自动化 [#禁用自动化]
</div>

1. 进入控制台中的 [Automations](https://app.mintlify.com/products/automations) 页面。
2. 点击自动化旁边的开关以禁用它。

当你重新启用一个计划自动化或更改其计划时，Mintlify 会从当前时间重新计算下次运行时间。已禁用的自动化不会保留待运行时间。

<div id="run-an-automation-manually">
  ## 手动运行自动化 [#手动运行自动化]
</div>

你可以按需触发任何已启用的自动化，而无需等待其下一次预定或事件触发的运行。

1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。
2. 点击你要启动的自动化旁边的 <Icon 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;M18.8906 12.846C18.5371 14.189 16.8667 15.138 13.5257 17.0361C10.296 18.8709 8.6812 19.7884 7.37983 19.4196C6.8418 19.2671 6.35159 18.9776 5.95624 18.5787C5 17.6139 5 15.7426 5 12C5 8.2574 5 6.3861 5.95624 5.42132C6.35159 5.02245 6.8418 4.73288 7.37983 4.58042C8.6812 4.21165 10.296 5.12907 13.5257 6.96393C16.8667 8.86197 18.5371 9.811 18.8906 11.154C19.0365 11.7084 19.0365 12.2916 18.8906 12.846Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> 运行按钮。

手动运行会使用自动化的当前配置，会计入你的积分使用量，并与按计划运行的记录一起出现在运行历史中。

<div id="trigger-a-scheduled-automation-via-api">
  ## 通过 API 触发计划自动化 [#通过-api-触发计划自动化]
</div>

对于使用**自定义计划**触发器的自动化，你可以从自己的工具中启动一次运行，而无需等待下一次计划时间。使用 [Trigger automation](/zh/api/automations/trigger) 端点，可以从 CI/CD 流水线、发布脚本或任何可以发起经过身份验证的 HTTP 请求的服务触发一次运行。

通过 API 触发的运行与计划运行的行为完全相同：它们会处理上次完成运行以来发生的所有变更，会计入积分使用量，并出现在运行历史中。

<div id="view-run-history">
  ## 查看运行历史 [#查看运行历史]
</div>

每个自动化都会保存历史运行日志，包括状态和所做更改的摘要。

1. 进入控制台中的 [Automations](https://app.mintlify.com/products/automations?tab=runs) 页面。
2. 使用下拉菜单按特定自动化或状态进行过滤。

每次运行会显示以下状态之一：

* **Review needed**：agent 已完成运行，但更改需要你团队中的成员审查并合并。
* **Running**：agent 正在执行该自动化任务。
* **Accepted**：agent 已完成运行，更改已合并到你的仓库。
* **Closed**：agent 已完成运行，但有人拒绝了这些更改。
* **Failed**：agent 无法完成运行。失败的运行不会计入每日运行限制。
* **No action needed**：agent 完成了运行，但未发现需要更新的内容。

点击单次运行即可查看其提示词、读取或更改的文件，以及它打开的任何 pull request。

<div id="continue-a-run-in-the-editor">
  ## 在编辑器中继续运行 [#在编辑器中继续运行]
</div>

当自动化完成并在分支上创建更改后，你可以直接在编辑器中打开这些更改，进行查看、调整或发布。

1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。
2. 点击你想在编辑器中继续处理的工作流运行旁边的 **View changes**。

编辑器会打开到该自动化的分支，并自动展开 agent 面板。agent 面板会列出该自动化更改的每个页面。点击任意页面即可查看自动化所做的更改。

编辑器中的 agent 拥有该自动化的完整上下文，包括自动化的提示词、所做更改的摘要，以及修改了哪些页面。你可以让 agent 在无需重新解释背景的情况下，继续优化或扩展这些更改。