管理自动化

• 一个已连接到 GitHub 或 GitLab 仓库的 Mintlify 项目
• 对于 GitHub：在你计划用于自动化的每个仓库上都安装 Mintlify GitHub 应用
• 对于 GitLab：已连接的 GitLab 账户（请参见下方GitLab 设置）

1. 在控制台中打开 Automations 页面。
2. 点击自动化旁边的开关以启用它。
   
   如果自动化可以使用默认设置运行，它会立即激活。否则，该自动化的配置页面会打开，让你填写任何必需的配置。
3. 如果配置页面打开，请填写必填字段并点击 Save。

要更改已激活自动化的设置，点击其卡片上的 设置按钮以打开其配置页面。使用页面头部的开关可以启用或禁用自动化，然后点击 Save 应用你的更改。 每个自动化都有一个默认触发器来控制运行时机。要更改触发器，在自动化的配置页面上选择不同的触发器类型。

• 内容更新（Content update）：每当你向项目仓库推送内容时运行，包括 pull request 合并和直接推送。
• 代码变更（Code change）：当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。
• 自定义计划（Custom schedule）：按你定义的周期性计划运行。选择一个预设（Daily、Every Monday、Every Friday 或 Twice weekly）以及起始小时，或选择 Custom cron 并输入标准的 5 段式 cron 表达式（minute hour day month weekday）。cron 值以 UTC 存储；控制台会在你的本地时区与预设小时之间进行转换。自动化会在预定时间的 10 分钟内进入队列。
• 集成（Integration）：当已连接的共享集成中发生所选事件时运行，或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。请选择集成和事件，并填写出现的任何其他事件字段。对于 Slack 触发器，请选择一个或多个已添加 Mintlify Slack 应用的频道。

每个自动化都有一种默认的更新方式：要么直接将更改合并到你的内容仓库，要么打开一个 pull request 以供审查。 在自动化配置页面的 After automation runs 部分选择更新模式。选择 Update and merge changes 可自动合并更改。选择 Modify and wait for review 则要求在更改上线前进行审查。 对于自定义自动化和部分预定义自动化，你可以添加上下文仓库——自动化运行时 agent 读取的额外源代码仓库。这在你的自动化提示词引用了项目仓库之外的代码、API 或其他内容时很有用。 每个自动化最多可添加 10 个上下文仓库。对于每个 GitHub 仓库，请安装 Mintlify GitHub 应用。在 GitHub App settings 页面添加仓库。 对于自定义自动化和其他受支持的预定义自动化，你可以启用集成，让 agent 在运行时从 Notion、Jira 或 Linear 等共享工具获取上下文。 打开自动化的配置页面，并在 Tools 中选择你要使用的集成。你可以直接从选择器连接尚未连接的共享集成。个人集成仅供其所有者在使用 Slack agent 时使用，不能添加到自动化。 如果选择 集成（Integration） 作为触发器，触发该自动化的集成会自动添加为工具。有关连接范围、支持的事件和权限，请参见集成。 在自动化运行时向一个或多个频道发送 Slack 消息。 要启用 Slack 通知：

1. 在你的工作区安装 Mintlify Slack 应用。
2. 在控制台的 Automations 页面点击 Configure Slack。
3. 选择一个或多个用于接收通知的频道。
4. 点击 Save changes。

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

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

添加可选指令，这些指令会在每次运行时附加到自动化的基础提示词。使用它们来调整风格、语气或其他项目特有的行为，而无需更改核心自动化逻辑。 启用 Translate content 自动化时，选择一种或多种语言以与你的源内容保持同步。

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

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

​

GitLab 设置

要在自动化中使用 GitLab 仓库，请通过 GitLab OAuth 设置页面连接每个项目。请连接自动化涉及的所有仓库——你的文档仓库以及任何触发或上下文仓库。你必须在每个项目中至少具有 Maintainer 角色。

1. 进入控制台中的 Automations 页面。
2. 点击自动化旁边的开关以禁用它。

当你重新启用一个计划自动化或更改其计划时，Mintlify 会从当前时间重新计算下次运行时间。已禁用的自动化不会保留待运行时间。 你可以在控制台中删除自定义自动化。预定义自动化无法从控制台删除。请改为禁用它们，或使用 CLI 来移除。

1. 在控制台中打开 Automations 页面。
2. 点击自定义自动化卡片上的 设置按钮以打开其配置页面。
3. 点击页面底部的 Delete automation 并确认。

要在终端中删除任意自动化，请使用 mint automations。删除操作是永久性的，无法撤销。 你可以按需触发自动化，而无需等待其下一次预定或事件触发的运行。

1. 在控制台中打开 Automations 页面。
2. 点击自动化卡片上的 设置按钮以打开其配置页面。
3. 点击运行按钮（根据自动化不同，为 Test run 或 Run now）。
4. 选择运行范围。
   • Since a date：审查从所选日期到当前时间的更改。日期默认为该自动化的上次运行时间；如果从未运行过，则默认为七天前。
   • Everything：审查整个站点或仓库历史。此范围通常耗时更长，且比定向运行消耗更多额度。
   • Specific pull request：将运行限制为所选仓库中的一个 pull request。
5. 点击 Run now。

手动运行会在开始前保存自动化的当前配置并激活该自动化。这些运行会计入你的积分使用量，并与自动触发的运行一起出现在运行历史中。 你可以手动运行使用计划、内容更新或代码变更触发器的自动化。由集成触发的自动化仅在其配置的事件发生时运行，因此其运行按钮不可用。Translate content 自动化始终可以手动运行。 对于使用自定义计划触发器的自动化，你可以从自己的工具中启动一次运行，而无需等待下一次计划时间。使用 Trigger automation 端点，可以从 CI/CD 流水线、发布脚本或任何可以发起经过身份验证的 HTTP 请求的服务触发一次运行。 通过 API 触发的运行与计划运行的行为完全相同：它们会处理上次完成运行以来发生的所有变更，会计入积分使用量，并出现在运行历史中。 自动化页面上的 Runs 标签页会显示所有自动化的全部运行列表。 一次运行是自动化的一次执行。一次运行可以创建新的 pull request、更新现有的 pull request、运行失败，或未发现需要更改的内容。

1. 进入控制台中的 Automations 页面。
2. 使用下拉菜单按特定自动化或状态进行过滤。

每个结果会显示以下状态之一：

• Review needed：agent 已完成运行，但更改需要你团队中的成员审查并合并。
• Running：agent 正在执行该自动化任务。
• Accepted：agent 已完成运行，更改已合并到你的仓库。
• Closed：agent 已完成运行，但有人拒绝了这些更改。
• Failed：agent 无法完成运行。
• No action needed：agent 完成了运行，但未发现需要更新的内容。
• Modified PR：该结果将更改追加到了先前运行打开的 pull request 中。

你可以直接在列表中对结果执行操作。对于等待审查的运行，点击 Accept 合并更改，或点击 Preview 在编辑器中查看更改。对于失败的结果，点击 Re-trigger 重新开始运行。 要查看某次运行的提示词、读取或更改的文件，以及任何 pull request，请点击该运行的 操作菜单，然后点击 View run details。 当自动化完成并在分支上创建更改后，你可以直接在编辑器中打开这些更改，进行查看、调整或发布。

1. 在控制台中打开 Automations 页面。
2. 在 Runs 标签页中，点击你想在编辑器中继续处理的运行上的 Preview。

编辑器会打开到该自动化的分支，并自动展开 agent 面板。agent 面板会列出该自动化更改的每个页面。点击任意页面即可查看自动化所做的更改。 编辑器中的 agent 拥有该自动化的完整上下文，包括自动化的提示词、所做更改的摘要，以及修改了哪些页面。你可以让 agent 在无需重新解释背景的情况下，继续优化或扩展这些更改。