跳转到主要内容
自动化会自动运行 agent，让你的内容无需手动维护就能保持准确。本指南介绍如何选择合适的自动化、有效地配置它，以及撰写能产生一致结果的指令。

​
何时使用自动化

自动化最适合以下任务：
  • 重复性：相同任务定期在可预测的计划下运行，或每当特定事件发生时运行。
  • 耗时：手动完成需要时间但遵循一致模式的任务。
  • 响应式：应在代码或内容变更时自动发生的任务，例如在功能发布后更新文档。
对于一次性或探索性任务，请直接在控制台或 Slack 中使用 agent。

​
选择触发器

每个自动化都基于三种触发器类型之一运行。选择与你需要的工作完成时机相匹配的触发器。
触发器使用场景
内容更新（Content update）任务应在你的项目内容变更时运行——翻译新页面、修复失效链接或审计 SEO 元数据。
代码变更（Code change）任务应在源代码变更时运行——在 PR 合并后更新 API 规范或文档。
自定义计划（Custom schedule）任务应按固定节奏运行——发布每周更新日志或运行定期的语法检查。

​
预定义自动化

Mintlify 为最常见的内容维护任务提供了预定义自动化。在控制台的 Automations 页面打开其中任何一个。 详情请参见预定义自动化。

​
自定义自动化

为预定义选项未涵盖的任务创建自定义自动化。自定义自动化让你完全控制触发器、指令和上下文仓库。 设置步骤请参见创建自定义自动化。

​
撰写有效的指令

自定义自动化指令是 agent 每次运行时遵循的提示词。指令的质量直接影响结果的一致性。 描述结果，而不仅仅是任务。 告诉 agent 完成后是什么样子。 
Review the API reference pages.
撰写流程。 Agent 遵循按步骤指令比开放式提示词更可靠。
Example procedure
1. Read the merged pull request diff from the trigger repository.
2. Identify any changed API endpoints, parameters, or response shapes.
3. Search the documentation for pages that reference those endpoints.
4. Update the affected pages to match the changes in the pull request.
5. Open a pull request with a summary of the pages you changed and why.
保持范围窄。 一个把单一事情做好的自动化，比一个试图做许多事情的自动化更可靠。将复杂任务拆分到多个自动化中。 指定文件和目录。 你对 agent 应查看的位置越精确，它花在搜索上的时间就越少。
Example with specific paths
Check every MDX file in the /content directory for broken internal links (links beginning with /). 
For each broken link, either fix the path or remove the link if no replacement exists.

​
使用上下文仓库

对于自定义自动化和部分预定义自动化，你可以添加自动化运行时 agent 会读取的上下文仓库。 在以下情况添加上下文仓库：
  • 你的内容引用了存放在独立仓库中的代码、API 或配置。
  • 你希望 agent 在决定要更新什么时，将你的内容与源代码进行对比。
  • 自动化提示词引用了 Mintlify 项目仓库之外的文件。
每个自动化最多可添加 10 个上下文仓库。

​
更新模式

决定在更改上线前你希望进行多少审查。
  • 自动（Automatic）：更改直接合并到你的 Mintlify 项目仓库，无需审查。适用于低风险、高频任务，如翻译、语法检查和链接修复。
  • 要求审查（Require review）：agent 打开 pull request，由人工审查后再合并。适用于会改变内容含义的任务，如与代码变更同步或更新 API 参考。

​
控制积分使用量

每次自动化运行都会消耗积分。例如，大多数 update from code changes 自动化运行会消耗 40 到 180 积分。更新许多页面的复杂运行会消耗更多积分。 为 cron 任务安排在特定时间运行可以让你更精确地控制积分使用量。例如，让自动化每天或每周运行一次，就可以确切了解它每月会创建多少 pull request。基于推送触发的自动化在每月之间可能差异更大，因为它们取决于内容或代码变更的频率。

​
审查并改进自动化结果

自动化是自动运行的，但定期审查会有帮助。
  1. 打开 Automations 页面上的 Runs 选项卡，查看最近的运行历史和状态。
  2. 点击某次运行以阅读 agent 的摘要，并审查它打开的任何 pull request。
  3. 如果结果不一致，请优化你的指令：添加更具体的流程、缩小文件范围或将自动化拆分为更小的任务。
启用新自动化后，通常进行几个审查周期就足以微调指令。

相关主题

管理自动化如何长期维护文档使用 Claude Code 编写文档