创建自定义自动化
创建 Mintlify 自动化，按计划、仓库推送或集成事件运行。添加上下文仓库和自定义 agent 提示词。
自定义自动化使用你编写的指令，按计划、在仓库推送时、在已连接的集成事件发生时或在收到 webhook 请求时运行 agent。当预定义自动化无法覆盖你需要的行为，或者你希望将自己的提示词与特定的上下文仓库和集成组合在一起时，使用自定义自动化。有关所有自动化共享的触发器、更新模式和配置选项的概述，请参见自动化。
- Pro 或 Enterprise 计划。集成（Integration）触发器需要 Enterprise 计划。
- 一个已连接到 GitHub 或 GitLab 仓库的 Mintlify 项目
- 对于 GitHub：在你计划用于自动化的每个仓库上都安装 Mintlify GitHub 应用
- 对于 GitLab：已连接的 GitLab 账户（请参见下方GitLab 设置）
agent 运行在受限互联网访问的隔离沙箱中。它无法在运行时安装额外的包或工具。引用不可用工具的提示词可能产生意外结果或失败。
- 在控制台中打开 Automations 页面。
- 点击 New automation。
- 在配置页面上，设置自动化名称、触发器、提示词、上下文仓库、集成和更新模式。有关各字段的详细说明，请参见配置。
- 点击 Save。
你也可以让 Slack 中的 agent 为你创建自动化，只需描述你希望该自动化执行的操作。
有效的自动化指令聚焦于单一任务，并定义清晰、可验证的结果。由于 agent 是非确定性的，自动化结果会有所差异，但格式良好的指令能产生更一致的结果。
- 描述结果。 告诉 agent 一次成功的运行应该是什么样的。
- 撰写流程。 给 agent 一份按步骤执行的指南。
- 保持范围窄。 将复杂任务拆分到多个自动化中，而不是合并到一个提示词里。
更多示例和模式请参见使用自动化。
通过手动运行来测试新的自动化，这样就无需等待其触发器发生。手动运行使用自动化的当前配置，并与自动运行一起显示在运行历史中。使用集成或 webhook 触发器的自动化无法手动运行；请改为发送事件或 webhook 请求。要为测试运行选择范围，请参见手动运行自动化。
在运行历史中审查该次运行，查看提示词、agent 更改的文件以及它打开的任何拉取请求。如果结果不符合预期，请更新你的指令并再次运行。
GitLab 设置
要在自动化中使用 GitLab 仓库，请通过 GitLab OAuth 设置页面连接每个项目。请连接自动化涉及的所有仓库——你的文档仓库以及任何触发或上下文仓库。你必须在每个项目中至少具有 Maintainer 角色。
自动化需要付费的 GitLab 套餐。代理使用短期项目访问令牌来访问仓库，GitLab 的 Free 套餐不支持此功能。
- 在控制台中打开 Automations 页面。
- 点击自动化卡片上的 设置按钮以打开其配置页面。
- 更新配置中描述的任何字段。
- 点击 Save。
删除自动化是永久性的，会移除其配置和运行历史。
- 在控制台中打开 Automations 页面。
- 点击自动化卡片上的 设置按钮以打开其配置页面。
- 点击页面底部的 Delete automation 并确认。