> ## Documentation Index > Fetch the complete documentation index at: https://docs.flashduty.com/llms.txt > Use this file to discover all available pages before exploring further. # 自动化 > 让 AI SRE 按 cron 周期、HTTP API、On-call 故障事件或作战室创建自动运行一次任务，用一段任务提示词产出巡检、洞察或复盘结果；本文介绍自动化规则的新建、配置字段、触发方式、运行历史与权限。 > AI SRE 需在控制台开通，面向 On-call 专业版及以上订阅，按实际用量计费，详见[开通与计费](/zh/ai-sre/overview#开通与计费)。 ## 概述 自动化（Automation）让 AI SRE 按您设定的节奏自行跑一次 **隐藏会话**——它不出现在控制台左侧的会话列表里，而是在后台用一段固定的 **任务提示词** 驱动 Agent 完成工作，产出巡检、运营洞察或故障复盘等结果。 每条自动化是一条 **规则（rule）**。一条规则至少携带一种触发方式： * **按周期执行**：用 4 段或 5 段 cron 设定运行节奏（例如每周一上午、每天 09:15），到点自动跑。 * **经 API 调用**：生成一个带 Bearer Token 的触发地址，您在外部系统里用 `POST` 按需触发，把本次运行的上下文随请求体一起带进来。 * **On-call 故障触发**：选择要监听的 On-call 协作空间与严重程度，当匹配故障产生时自动拉起一次诊断运行。 * **作战室创建触发**：选择要监听的协作空间与严重程度，当匹配的故障创建作战室时自动拉起一次诊断运行；这次运行的会话建在作战室的 IM 群里，不在控制台。 什么时候用它：把重复的例行巡检（如每日健康巡检）、定期产出的洞察 / 复盘报告交给 AI SRE 自动跑；或者把 AI SRE 接进您已有的流水线、变更系统或 On-call 故障流，在事件发生时拉起一次诊断。 入口：左侧导航 **AI SRE → 自动化**，对应路由 `/ai-sre/automations`。 自动化跑出的每一次运行，本质上仍是一个 AI SRE 会话——只是它被标记为隐藏，不混进您的日常会话列表。您随时可以从运行历史点进去，看到这次运行完整的对话、工具调用与产物（跑在 IM 群里的 **作战室创建触发** 运行除外，见下文“作战室创建触发（War room created）”）。 ## 新建自动化 页面右上角有两个创建入口：**通过聊天创建** 会打开一条预填提示的会话，由 Agent 通过提问帮您确定任务内容和触发时间，不用填表单；**创建** 会打开起始选择面板，提供两条入口： 选择 **从零开始**，进入空白表单，手动填写名称、任务提示词与触发方式。适合您已经清楚要让 Agent 做什么、想完全自定义提示词的场景。 下方列出一组 **预设模板** 卡片（随界面语言显示中文或英文版本），常见的有 **值班周报**、**告警治理**、**故障自动分析**、**On-call 负载分析** 等。点击任一模板卡片，会用模板预置的名称与任务提示词预填表单，您在此基础上微调即可。 无论从哪条入口进入，接下来都是同一张配置表单。 ## 配置字段 配置表单的字段如下： | 字段 | 必填 | 说明 | | - | - | - | | 名称 | 是 | 规则名称，最长 255 字符。占位示例：`每周值班洞察`。 | | 范围 | 是 | 通过 **范围选择器** 选 **个人**（`team_id=0`）或某个 **团队**（`team_id>0`）。范围既决定这条规则的归属与编辑权限，也限定 **执行 Environment** 里可选的自托管 Runner——只有账户全局的 Runner，以及与该范围同团队的 Runner 才可选。 | | 执行环境 | 否 | 通过 **环境选择器** 选运行环境：**自动**（由系统挑选最优可用环境，默认值）、**云端沙箱**，或某个 **自托管（BYOC）Runner**。选了某个团队范围后，不属于该范围的团队 Runner 会被自动清除。 | | 任务提示词 | 是 | 描述要让 AI SRE 执行的任务，用富文本编辑器撰写。这段提示词就是每次运行时发给 Agent 的内容。占位提示：`描述 Flashduty AI SRE 要执行的任务。` | | 时区 | 否 | **按周期执行** 触发卡片里的字段（见下文“按周期执行（cron）”）：cron 表达式所依据的 **规则时区**，用一个可搜索的下拉框选择 IANA 时区名（如 `Asia/Shanghai`），选项按下拉框里的 UTC 偏移排列。新建规则时默认为你的生效时区（成员时区优先，成员未设置时回退账户时区）；没有可用时区时该字段留空，创建请求不携带它。 | **执行环境** 的“自动”会在每次运行时由系统挑选当前最优的可用环境；“云端沙箱”是平台托管的临时沙箱；自托管 Runner 则把运行落在您自己的机器上。三者的差异与连接方式见 运行环境。 ## 触发方式 一条规则必须 **至少配置一种触发方式**。当前控制台表单在“触发方式”区提供 **按周期执行**、**经 API 调用**、**On-call 故障触发** 与 **作战室创建触发** 四种入口，四种可同时启用。 ### 按周期执行（cron） 按时间周期自动运行。运行节奏支持两种 cron 写法： * **4 段**：`小时 日期 月份 星期`，系统自动补 `minute=0`，适合整点任务。 * **5 段**：`分钟 小时 日期 月份 星期`，适合分钟级任务，例如 `15 9 * * *` 表示每天 09:15。 秒级 6 段不支持。分钟必须是一个固定整数；其它字段只支持下表中的简单写法： | 段 | 取值范围 | | - | - | | 分钟（仅 5 段） | `0`–`59` 的固定整数 | | 小时 | `*`、`*/n`（n 为 1–23）或 `0`–`23` 的固定整数 | | 日期 | `*` 或 `1`–`31` | | 月份 | `*` 或 `1`–`12` | | 星期 | `*` 或 `0`–`7`（`0` 与 `7` 均表示周日） | 为免手写表达式，界面提供四种模式： | 模式 | 含义 | | - | - | | 每小时 | 每小时运行一次；默认整点，也可指定分钟 | | 每天 | 选一个时刻，每天该时刻运行 | | 每周 | 选星期几 + 时刻，每周该时刻运行 | | 自定义 | 直接填 4 段或 5 段 cron 表达式 | **时区**：**按周期执行** 按触发卡片中选择的 **时区** 计算，**每小时 / 每天 / 每周 / 自定义** 四种模式共用这一设置。 实际执行时间可能与设定时间存在 **分钟级延迟**，这是有意为之，用于把系统负载分散开。请不要把规则当作秒级精确的定时器使用。 编辑一条 **已启用**、且已经排好下一次运行（存在待执行的那一次）的规则时，改动 cron 表达式或 **时区** 会在触发卡片里多出一条提示：**已经排好、还没开始的那一次（`<时刻>`，`<原时区>`）不会再跑。下一次按 `<新时区>` 的钟面重算，实际开始最多比那个分钟再晚 5 分钟。** 只有确实改到了排期才会出现这条提示：把时区在空值与 `UTC` 之间切换不算改动（两者是同一个钟面），关闭 **按周期执行** 触发器、或这条规则当前没有待执行的运行时也不会出现。 ### 经 API 调用（HTTP POST） 让您在外部系统里按需触发这条自动化，而不依赖时间周期。 在“触发方式”中添加 **Call via API** 并保存规则。保存成功后，系统会一次性生成本次触发用的 **Token** 与 **触发地址**，并弹出一个包含 `curl` 示例的窗口。 Token **只显示一次**：请立即复制保存。关闭弹窗后无法再次查看，只能重新生成（轮换）一个新 Token——重新生成会使旧 Token 失效。 用 `POST` 调用触发地址，把 Token 放在 `Authorization: Bearer` 请求头里，请求体用 `text` 字段传入本次运行的上下文。弹窗里给出的 `curl` 示例形如： ```bash theme={null} curl -X POST 'https://<触发地址>' \ -H 'Authorization: Bearer ' \ -H 'Content-Type: application/json' \ -d '{"text":"描述本次运行的事件或上下文。"}' ``` 请求体里的 `text` 会作为本次运行的上下文交给 Agent，叠加在规则配置好的任务提示词之上。 请求成功后，响应的 `data` 会返回新建隐藏会话的信息。您可以保存 `session_id`，或直接使用 `session_url` 打开这次运行的完整对话、工具调用和产物： ```json theme={null} { "data": { "type": "routine_fire", "session_id": "", "session_url": "https:///ai-sre/chat?session_id=" } } ``` 一条规则可以 **同时** 启用“按周期执行”与“经 API 调用”：到点自动跑，也允许外部按需拉起。每种触发方式各占一行，可分别 **移除**。 ### On-call 故障触发 当您希望 AI SRE 随 On-call 故障自动启动时，添加 **On-call incident** 触发方式。触发器会向 On-call 侧注册订阅，只有匹配指定协作空间和严重程度的故障事件才会启动运行。 在“触发方式”中点击 **On-call incident** 卡片，表单会展开协作空间与严重程度条件。 在 **协作空间** 下拉框中选择要监听的 On-call 协作空间。个人范围规则可选择账户下可见的协作空间；团队范围规则会按所选团队收窄可选协作空间。 在 **严重程度** 中选择 `Critical`、`Warning`、`Info` 中的一个或多个值。启用该触发器时，协作空间和严重程度都至少需要一个值。 **相似故障合并分析** 默认开启：与正在分析的故障足够相似的新故障会并入那次分析，不再单独开会话；关闭后每个故障各自分析。规则详见[相似故障合并分析](#相似故障合并分析)。 如果通过 API 创建或更新规则，对应字段如下： | 字段 | 类型 | 说明 | | - | - | - | | `oncall_incident_trigger_enabled` | boolean | 是否启用 On-call 故障触发器。 | | `oncall_incident_channel_ids` | int64\[] | 监听的 On-call 协作空间 ID 列表；创建或启用该触发器时至少需要一个有效 ID。 | | `oncall_incident_severities` | string\[] | 监听的故障严重程度，支持 `Critical`、`Warning`、`Info`；创建或启用该触发器时至少需要一个值。 | | `oncall_incident_merge_similar` | boolean | 是否启用“相似故障合并分析”。默认开启；不传这个字段时按开启处理。 | 匹配事件到达后，系统会以 `oncall_incident` 作为 `trigger_kind` 创建运行，并把 `incident_id`、`channel_id`、`severity` 等事件上下文传给会话。同一个故障——相同触发器与相同 `incident_id`——始终复用同一次运行，避免同一故障重复拉起多个隐藏会话；与此并列，开关开启时，与正在分析的故障足够相似的**另一个**故障也会并入那一次运行、而不是新建会话，见下文“相似故障合并分析”。 运行结束时，AI SRE 会把一条总结评论写回触发它的故障：结论写在最前面、正文简明，末尾附本次运行的完整会话链接。这条写回记录本身也带有一个常显的 **接续对话** 入口，在故障时间线上读结论时就能直接进入当次会话，见[故障时间线 · AI SRE 代操作记录](/zh/on-call/incident/search-view-incident#ai-sre-代操作记录)。评论沿故障现有的通知链路送达（例如 IM 里故障卡片的刷新与回帖），关注这条故障的人不用打开控制台就能看到分析结果。该行为对所有启用 On-call 故障触发的规则自动生效——包括自定义提示词的规则，无需额外配置。 #### 相似故障合并分析 “相似故障合并分析”（`oncall_incident_merge_similar`，默认开启）决定一个故障事件是新建会话，还是并入本规则下已经在跑的分析。开启后，命中该触发器的故障会先与**同一条规则**的运行比较相似度： * 相似度**不低于 0.9** 时，该故障并入得分最高的那次分析，不再新建隐藏会话。0.9 是平台固定值，与 On-call [智能聚合](/zh/on-call/channel/noise-reduction)的默认合并阈值同一口径，不随协作空间的聚合配置变化。 * 相似度低于 0.9 时，该故障照常拉起一次自己的运行。 * 关闭该开关后，不做相似度比较，每个故障各自分析。 被比较的候选是那次运行正在分析的故障，以及此前已并入它的故障。合并只影响 AI SRE 的运行路由：**它不会在 Flashduty 中把两个故障合成一个**，本次会话绑定的故障也不变，两个故障各自存在、各自走通知与升级。被并入的故障没有自己的会话，因此也没有属于它自己的总结评论；本次分析若判断它与主故障同源，会在它的时间线上留下一条交叉引用评论，并把它一并写进结论。 在该分析的对话里，并入渲染为一条过程记录：`已并入本次分析` + `# `（被并入故障的名称，链接到该故障自己的页面，在新标签页打开），并标注 `相似度 <得分>`（保留两位小数）。在运行历史里，这次运行同样会标出它并入了哪次分析。 两条平台限制是固定的，不可配置： * **一次分析最多并入 20 个故障**。达到上限的那次分析不再接收相似故障，后来的相似故障另起一次运行，由新运行继续接收并入。 * **已结束的运行只在结束后 10 分钟内可被并入**。仍在运行（`running` / `retrying`）的运行随时可被并入；成功或部分成功结束（`succeeded` / `partial`）的运行在结束后 10 分钟内仍可被并入，此后到达的相似故障另起一次运行。失败、跳过、放弃的运行不再被并入。 <Note> 相似度比较依赖账户的 AIOps 能力与专业版及以上订阅：平台关闭 AIOps、或账户版本不满足时，比较不会执行，每个故障各自拉起一次运行。 </Note> ### 作战室创建触发（War room created） 当您希望故障一建作战室就让 AI SRE 进场时，添加 **War room created** 触发方式。触发器会向 On-call 侧注册一个订阅，只有匹配指定协作空间和严重程度的作战室创建事件才会启动运行。 <Steps> <Step title="添加触发方式"> 在“触发方式”中点击 **War room created** 卡片，表单会展开协作空间与严重程度条件；严重程度默认选中 `Critical`。 </Step> <Step title="选择协作空间"> 在 **协作空间** 下拉框中选择要监听的协作空间。个人范围规则可选择账户下可见的协作空间；团队范围规则会按所选团队收窄可选协作空间。启用该触发器时至少需要一个协作空间。 </Step> <Step title="选择严重程度"> 在 **严重程度** 中选择 `Critical`、`Warning`、`Info` 中的一个或多个值。启用该触发器时至少需要一个值。 </Step> </Steps> <Note> 这次运行的会话建在作战室的 **IM 群聊** 里，不在控制台——触发卡片上标着“会话基于 IM 群聊创建。”，并附一条平台提示：由于平台限制，可能对企业微信和钉钉集成不适用。 </Note> 如果通过 API 创建或更新规则，对应字段如下： | 字段 | 类型 | 说明 | | - | - | - | | `war_room_trigger_enabled` | boolean | 是否启用作战室创建触发器。 | | `war_room_channel_ids` | int64\[] | 监听的协作空间 ID 列表；创建或启用该触发器时至少需要一个有效 ID。 | | `war_room_severities` | string\[] | 监听的严重程度，支持 `Critical`、`Warning`、`Info`；创建或启用该触发器时至少需要一个值。 | 匹配的作战室创建后，系统会以 `war_room_created` 作为 `trigger_kind` 创建运行，并把 `incident_id`、`channel_id`、`severity` 等上下文带进会话。这次运行不在控制台里新建会话，而是直接在作战室群里跑一轮分析，结论也发回这个群。同一条触发器下、同一个故障只启动一次运行，重复的事件不会另起会话。 **执行环境**：这条触发方式不使用规则上的 **执行环境**——作战室里的分析用群里已经选好的执行环境。规则的唯一触发方式是作战室创建时，表单不显示环境选择器，只提示“作战室里的分析用这个群已经选好的执行环境，规则上不再选。”；同时启用了周期 / API / 故障触发时，环境选择器照常出现，并提示“周期、API 和故障触发使用这里的执行环境。作战室触发使用群里的执行环境，不会改掉群里已经选好的。”。 预设模板 **作战室初步分析**（模板键 `war_room_initial_analysis`，分类 **故障响应**）预置了这条触发方式与 `Critical` 严重程度；协作空间不由模板预置，需要您自己选。 ## 运行历史 每条规则都保留它的运行历史。点击规则行即可打开规则详情页（`/ai-sre/automations/:ruleId`）：左栏是 **配置信息**，右栏是 **执行历史**；右栏顶部的 **手动执行** 按钮可直接触发一次运行。规则的唯一触发方式是 **作战室创建触发** 时不会出现这个按钮——这类规则的运行跑在 IM 群里，没有控制台运行。 运行历史以表格呈现，列为： | 列 | 说明 | | - | - | | 名称 | 本次运行对应的隐藏会话标题（`session_name`），解析不到时显示会话 ID（`session_id`）。被并入其它分析的运行没有自己的会话，改显示对应的故障（`#<num> <title>`），并在下一行标明并入了哪次分析 | | 执行时间 | 本次运行的开始时间 | | 耗时 | 本次运行的持续时长 | | 触发方式 | 本次运行的触发类型标签，如 `定时`（schedule）、`HTTP POST`、`On-call incident`、`手动执行` 或 `作战室创建触发`（war\_room\_created） | | 执行位置 | 本次运行跑在哪里：`IM`（会话在 IM 群里，例如作战室创建触发的运行）或 `Web 控制台`（控制台里的隐藏会话）。对应 API 字段 `execution_place`，取值为 `im` / `web_console`；记录里没有这个字段时，作战室创建触发的运行按 `IM` 显示，其余按 `Web 控制台` 显示 | | 状态 | 本次运行的状态（见下表） | 运行状态的取值： | 状态 | 含义 | | - | - | | `running` | 运行中 | | `retrying` | 重试中 | | `succeeded` | 成功 | | `partial` | 部分成功 | | `failed` | 失败 | | `skipped` | 已跳过。两种情形共用这个状态：触发时判定不执行（例如规则所有者已失效、周期已停止），或该故障被并入另一个正在运行的分析（见上文“相似故障合并分析”） | | `blocked` | 已阻塞。本次运行产生了真实输出，但停在等待人工处理的连接器上——某个连接器还没配置，或需要管理员在控制台完成授权 | | `abandoned` | 已放弃（长时间未完成被系统终止） | 表格上方提供三个筛选项： * **时间范围**：默认显示 **最近 30 天**，可调整范围，最大跨度 **180 天**。 * **状态**：按上表中的运行状态过滤，或选 **全部状态**。 * **触发类型**：`全部触发类型` / `手动执行` / `定时` / `HTTP POST` / `On-call incident` / `作战室创建触发` 六选一。 API 返回的运行记录还包含 `trigger_kind`，可能取值为 `schedule`、`manual`、`http_post`、`oncall_incident`、`war_room_created` 或 `debug`。其中 `manual` 表示通过立即执行接口启动，`oncall_incident` 表示由匹配的 On-call 故障事件启动，`war_room_created` 表示由作战室创建触发启动（会话在 IM 群里）。被并入其它分析的运行不返回自己的 `session_id`，而是返回它并入的那次分析的会话 ID `joined_session_id` 与会话名 `joined_session_name`；这两个字段为空，表示这次运行有自己的隐藏会话。 点击一行，会跳转到这次运行对应的隐藏会话对话页，让您查看该次运行完整的消息、工具调用与产物。跑在 IM 群里的运行（`execution_place=im`，或由 `war_room_created` 触发）不跳转，而是弹出一句 **本分析位于 IM，请进入 IM 查看。**——这次分析的对话在 IM 群里读。被并入其它分析的运行没有自己的会话，点击它会打开接管这个故障的那次分析。 ### 未成功运行的原因行 运行状态为 `failed`、`blocked`、`abandoned` 或 `skipped` 时，“名称”列会在会话名下方显示失败**原因**（悬停查看全文）。常见原因： | 原因（`error_code`） | 处理 | | - | - | | AI SRE 未开通，或本周期额度/余额不足，本次未执行（`BalanceNotEnough`） | 到 **费用中心 → 订阅** 的 AI SRE 页签开通或充值 | | On-call 订阅已失效或版本不含 AI SRE，AI SRE 已暂停（`NoLicense`） | 到 **费用中心 → 订阅** 的 On-call 页签续订或升级 | | 执行超时未完成，已放弃（`task_run_stale`） | — | | 本次执行被中断（`interrupted`） | — | | 执行已结束，但没有生成最终回复（`no_final_response`） | — | | 已并入另一次分析（`similar_incident_fan_in`） | 点击该行打开接管故障的分析 | 其他原因直接显示系统记录的文本。 <Note> 运行历史在规则详情页中查看，因此需要对该规则有编辑权限。 </Note> ## 管理与权限 ### 启用 / 停用、编辑与删除 每条规则在 **操作** 列提供一组操作： | 操作 | 说明 | | - | - | | 启用 / 停用 | 行内开关。停用后规则保留，但不再触发；停用不会删除已有运行历史。 | | 立即执行 | 在规则行手动启动一次真实运行。该操作会先做运行前检查，然后为本次运行创建一个隐藏会话；同一规则手动执行最多每分钟一次。当规则的唯一触发方式是 **作战室创建触发** 时，列表和详情页都不提供这个操作——这类规则不会产生控制台运行，调用立即执行接口会直接报错。 | 点击规则行任意位置会打开该规则的详情页，在详情页里可以编辑配置、删除规则，也能看到运行历史（见上文“运行历史”一节）。 对您**没有编辑权限**的规则只能查看，不能启停或操作。 列表上方还提供两个筛选器：**范围**（全部 / 个人 / 团队，选“团队”后可多选具体团队）与 **状态**（全部状态 / 已启用 / 未启用）。 ### 作用域与权限 自动化规则与 AI SRE 下的其它资源（Skill、知识、MCP、Agent、运行环境）共用同一套两级作用域： | 维度 | 规则 | | - | - | | 归属 | **个人规则**归创建者所有；**团队规则**归该团队。**范围创建后不可修改**，需要换范围时，在规则详情页点击**克隆**，为副本选择新范围。创建团队规则时，操作者本人必须是该团队成员，账户 Owner 和管理员也不例外。团队规则在创建者离开团队后继续运行；个人规则在创建者不再是账户有效成员时会自动停用。 | | 可见 / 列表 | 账户 Owner 与管理员可见全部规则；普通成员可见自己创建的规则，以及自己所属团队的规则。 | | 编辑 / 管理（团队规则） | 仅规则归属团队的**当前成员**可操作（启用 / 停用、编辑、删除、立即执行）；创建者一旦离开该团队，就不再保留任何特权。账户 Owner 与管理员没有豁免，需要先加入该团队。 | | 编辑 / 管理（个人规则） | 仅创建者本人可管理和查看。账户 Owner 与管理员也无法查看或管理他人的个人规则。 | | HTTP POST 触发 | 通过触发地址发起一次真实运行时，鉴权只看该 trigger 的 Bearer Token；持有 Token 的外部系统可以触发，运行会按规则的个人或团队作用域创建隐藏会话。 | | On-call 故障触发 | 由已注册的故障订阅触发，不使用 HTTP POST Bearer Token；运行仍按规则的个人或团队作用域创建隐藏会话。 | | 作战室创建触发 | 由已注册的作战室创建订阅触发，不使用 HTTP POST Bearer Token；会话建在作战室的 IM 群里而不是控制台，运行仍按规则的个人或团队作用域归属。 | <Note> 账户 Owner / 管理员能在列表中看到其他成员的个人规则（见上表“可见 / 列表”），但点击进入详情页会被拒绝——“编辑 / 管理”权限对个人规则同样不因 Owner / 管理员身份而豁免，与团队规则一致。 </Note> <Warning> 账户是运行时唯一的安全边界，团队是“归属 / 编辑”标签。自动化规则的可见与管理沿用这套模型；与其它 AI SRE 资源一致的完整规则，详见各资源页面的“作用域”一节。 </Warning> ## 相关页面 <CardGroup cols={2}> <Card title="控制台对话" icon="comments" href="/zh/ai-sre/sessions"> 了解会话如何承载一次完整对话——自动化跑出的每次运行本质上就是一个隐藏会话。 </Card> <Card title="运行环境" icon="server" href="/zh/ai-sre/environments"> 了解自动、云端沙箱与自托管 Runner 的差异，以及自动化的执行环境选择。 </Card> <Card title="使用洞察" icon="gauge-high" href="/zh/ai-sre/insight"> 基于会话数据生成团队的故障处理与运营洞察，可作为定时自动化的产出目标。 </Card> <Card title="管理知识" icon="book" href="/zh/ai-sre/knowledge"> 为自动化运行提供领域知识，按团队范围加载。 </Card> <Card title="产物" icon="folder-open" href="/zh/ai-sre/artifacts"> 自动化运行产出的报告如果被发布，会作为产物沉淀在产物库里，可长期查看与分享。 </Card> </CardGroup> This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.