Skip to main content
此为预览文档，正式版本尚未发布。
Automation 把“何时触发”和“执行什么工作”保存为一条可复用规则。适合日报、定期检查和外部事件处理。需要固定多步骤拓扑时使用 Workflow；Automation 主要负责触发 Agent 或 Team。

​
界面导览

Automation 的执行说明和触发配置

当前控制台截图，使用固定演示数据。

在编辑窗口中先确认 Runbook 和执行 Agent，再选择输出方式、完成策略与触发时间。核对时区后保存；回到详情页使用 Run now 检查首次执行。

​
核对触发计划

Automation 的 Cron、时区和下次触发预览

每周一上午 09:00，Asia/Shanghai；预览显示接下来的触发时间。

​
创建工作日报

在 WORK → Automations 新建规则，按下面的示例配置： 检查计划预览给出的未来触发时间。先保持规则关闭并使用 Test run，阅读 Runbook、执行结果和产物，再启用规则。Test run 会实际执行工作，可能调用模型和工具。

​
控制重复与积压

Skip 在已有运行占用时跳过新触发；Queue 顺序排队，适合每个事件都需要处理的工作。设置 Queue timeout 限制过期工作积压，用 Run timeout 限制单次执行时长。队列等待与运行超时是两个不同阶段。 在 Runs 中检查 status、waitReason、输入、输出、错误和关联 Issue。关闭规则用于停止后续自动触发；要停止某次已存在的运行，应使用该 Run 的 Cancel。

​
使用 Webhook

添加 Webhook trigger，从详情复制对应 URL，保存创建或轮换时显示的 secret。发送 JSON 对象或数组，同时携带 X-Automation-Secret 和稳定的 Idempotency-Key：
这些环境变量由你填写为详情中的值。重传同一事件使用相同 key 和请求内容；不同事件使用新 key。事件筛选填写 build.completed 等名称，留空接受全部事件。JSON 内的 event 字段可以指定事件类型。 轮换 secret 后同步更新发送方。标准第三方 webhook 不一定能发送该认证头，必要时使用你管理的适配服务转换请求。 测试 webhook 前启用规则和对应 trigger；手工 Test run 可用于尚未启用的规则，两者的启用条件不同。事件载荷会作为 Trigger data 附到任务说明中，Runbook 应明确哪些字段是证据、缺少哪些资料时需要报告未知。载荷中的地址不会自动赋予 Agent 读取能力。 需要把 CI 事件用于研发闭环时，参考全 Hosted 团队案例的事件桥接扩展，明确仓库、PR、提交和原工作的关联；收到事件不等于原 Team 已恢复执行。

​
排查与重新执行

Deliveries 回答“事件是否收到、是否被过滤”；Runs 回答“工作是否执行、结果如何”。事件被接收不等于工作完成。确认规则、trigger、事件筛选和运行时可用性后，再考虑 Replay delivery 或 Rerun；它们会产生新的处理机会，可能重复业务副作用。 下一步：Issues · Team 协作。