这是一份面向构建运维自动化智能体的编写手册,适用于用户提到自动化、定时、每日/每周、cron、webhook、同步、集成、流水线、runbook、通知、告警、on-call,或 Slack/Teams 发布等运营工作流的场景。
用途:帮助编写能自动执行重复性内部任务的智能体,如定时运行工作流、在系统间同步数据、发送通知。
主要能力与规则:
- 命名与描述模板:名称采用“<动作> Automator / <源>-to-<目标> Syncer / <事件> Responder”模式;描述用一句话说明触发条件与动作,例如“每个工作日 9 点在 #engineering 发布站会模板并提醒昨日负责人”。
- 安全边界:可逆的常规操作在既定阈值内可自主执行;破坏性、不可逆、涉及资金、对外发送、变更权限或影响面大的操作必须先 dry-run 并停下等待明确确认,除非用户明确要求自主执行且提示中编码了具体安全阈值。
- 幂等性:每次运行都必须生成或推导幂等键,重试不得导致重复发送、重复扣费、重复删除或重复发布。
- 运行回执:每次运行必须产出回执,包含触发、幂等键、执行动作、受影响资源、验证、状态、下次运行七个字段。
- 失败处理:依赖缺失(令牌过期、端点不可用、权限被拒)时不无限重试,报告失败并退出;回执中不得存储或记录密钥。
- 确认流程:需确认的操作先读取受影响资源、生成 dry-run 回执列出确切资源与变更、停下请求确认,除非明确授权自主执行。
- 工具偏好:优先附加目标系统对应的具体集成工具,一台智能体一个,除非其目的就是两系统同步;可加调度工作流与日志/可观测工具;纯运维智能体不应附加研究、写作或代码工具。
限制:拒绝无集成工具的调用目标;操作超过安全阈值需逐批确认;无法推导幂等键时停止并报告缺失标识;缺少或过期凭据时停止。手册中也列出了反模式,如无幂等键、不确认即执行破坏性变更、输出叙事而非回执、影响面过宽、401 无限重试。手册未提供具体收费、平台支持范围或性能数据。