流程编排功能介绍文档

一、产品简介

流程编排把一次运维处理收成可重复执行的流程。一条流程从一个触发器开始,后面接动作、条件分支和人工审批。触发方式包括表单、定时、Webhook 和 NATS。动作可以直接调用作业执行、HTTP 请求、OpsPilot 智能体、意图分类、记忆读写、文档生成和平台通知渠道。

它适合把「收到告警或填一张表 → 判断 → 在授权主机上执行或通知 → 必要时等人审批 → 留下执行记录」固定下来,而不是每次在作业管理和聊天窗口之间手工接力。

二、产品核心优势

  1. 先选触发器,再往下接步骤
    新建流程时先选择表单、定时、Webhook 或 NATS。定时按频率运行。Webhook 适合外部系统调用。NATS 适合由告警等平台消息触发。表单会生成填写页,提交后启动流程。

  2. 动作复用平台里已经有的能力
    作业执行在授权目标上运行 Linux 或 Windows 脚本。对外通知走系统管理里已经配好的邮件、企业微信、飞书、钉钉或 Webhook。智能体、意图分类、记忆读取和记忆写入使用当前组织可用的 OpsPilot 能力。文档生成按 Word 或 Excel 模板产出可下载文件。

  3. 条件和审批把自动执行停在该停的地方
    条件分支用结构化规则判断,只有「满足」和「不满足」两条出口,不接受自由表达式。人工审批指定候选审批人,通过后继续,驳回时必须填写原因并进入驳回分支。

  4. 每次运行都有状态和记录
    首页查看最近执行、趋势和待自己审批的事项。执行记录的状态为「排队中」「执行中」「等待审批」「终止中」「结果未知」「成功」「失败」「已超时」「已终止」。测试运行可以手动停止。

三、产品应用场景

  • 告警触发一套固定处理
    用 NATS 或 Webhook 接收告警,经条件分支决定是通知值班人,还是调用作业在授权主机上收集信息。

  • 变更前先审批再执行
    表单收集变更内容,流程进入人工审批。通过后执行作业或发送通知,驳回则停在驳回分支。

  • 定时产出一份报告
    定时触发后读取记忆或调用智能体整理内容,再用文档生成节点产出文件,通过通知渠道送出。

1. 首页

核心定位

首页汇总流程运行情况,并把待自己处理的审批放在手边。

核心能力

  • 运行概览:查看执行数量、成功失败和最近一段趋势。
  • 最近执行:从最近记录进入执行详情,或按流程名称筛选执行记录。
  • 待我审批:展示流程名称、审批标题、发起人和剩余时间。未设置截止时间时明确显示未设置。可以从这里进入执行记录中的待审批页签。

界面指引:

界面截图待补充。

  • 操作关注点:日常先看待审批是否到期,再看失败和超时的最近执行。

2. 流程

核心定位

流程是一张从触发器开始的画布。保存后才能被表单、定时、Webhook 或 NATS 启动。

核心能力

  • 流程列表:按名称维护流程,进入画布编辑。
  • 组织范围:流程和其中引用的智能体、记忆空间、通知渠道都限制在当前组织可用的范围内。
  • 上游引用:后续节点可以引用触发输入、运行信息和前序节点输出。引用时从字段列表选择,而不是拼接未声明的字段。

2.1 触发器

每条流程的第一个节点是触发器,且只能有一个起点。

  • 表单:设计填写字段。用户打开表单页提交后启动流程。适合变更申请和人工发起的检查。
  • 定时:按设定频率启动。适合巡检、对账和定期报告。
  • Webhook:向外部提供调用入口。可选择等待流程结果后再响应。
  • NATS:订阅平台消息通道。适合告警中心等已经进入消息通道的事件触发流程。

2.2 条件分支

核心定位

用结构化规则决定走满足还是不满足。

核心能力

  • 结构化条件:左值、比较方式和右值来自字段或字面量。不接受自由表达式。
  • 组合方式:多条规则按「满足全部」或「满足任意」合成一个结果。最多 10 条。
  • 两个出口:画布只提供满足和不满足。不会按条件条数拆成多路分支。

2.3 人工审批

核心定位

把流程停在指定的人处理之后,再决定继续或驳回。

核心能力

  • 审批标题和说明:展示给审批人,说明这次要决定什么。
  • 候选审批人:只有候选人可以处理。没有处理权限时只能查看。
  • 通过:确认后沿通过路径继续。
  • 驳回:必须填写原因,流程进入驳回分支。
  • 上下文:审批人看到的是这份执行带入的公开上下文,而不是整份内部运行数据。

2.4 动作节点

动作来自平台内置节点。各节点的输入可以引用上游字段。

  • 作业执行:在授权目标上执行用户编写的 Linux 或 Windows 脚本,输出统一 JSON 结果。会改变目标主机,执行前确认目标和脚本。
  • HTTP 请求:按方法和完整 URL 发起请求。运行时做地址限制和响应大小限制。
  • 智能体:调用当前组织可用的 OpsPilot 智能体处理输入,可附加提示词和知识文件。
  • 意图分类:用当前组织可用的模型,把输入分到预先定义的意图。
  • 记忆读取:从当前组织可用的记忆空间检索相关内容,可指定返回条数。
  • 记忆写入:把流程产生的内容写入记忆空间,供以后的流程或智能体使用。
  • 文档生成:按 Word 或 Excel 模板和结构化数据生成受控下载文件。
  • 对外通知:通过系统管理已配置的邮件、企业微信、飞书、钉钉或 Webhook 投递。可附带文档生成节点产出的文件。

3. 执行记录

核心定位

每一次触发对应一条执行。执行记录用来查看状态、审批和失败原因。

核心能力

  • 状态:「排队中」「执行中」「等待审批」「终止中」「结果未知」「成功」「失败」「已超时」「已终止」。
  • 全部与待我审批:全部执行查看有权限的记录。待我审批只看当前用户能处理的审批。
  • 详情:查看触发方式、发起人、节点输入输出和审批决定。已终止的审批保留审批内容供查看。
  • 停止测试运行:测试运行停在中间时可以手动停止,避免测试流程一直占用。
  • 从首页下钻:首页的流程名称会带到执行记录的筛选条件。

注意:
作业执行和对外通知会作用于主机或外部渠道。先用表单触发在测试数据上跑通条件和审批,再启用定时、Webhook 或 NATS。

一、前置条件

  • 当前账号具备流程的编辑和执行权限。审批人账号具备执行记录的审批权限。
  • 通知步骤需要系统管理中至少有一个可用渠道,例如邮件。
  • 如果后面要改成作业执行,目标主机和脚本权限以作业管理为准。本入门先不在主机上执行命令。

二、创建流程并选择触发器

  1. 打开 「流程」,新建流程并填写名称。流程归属于当前组织。
  2. 进入编排画布。第一个节点只能是触发器。
  3. 选择 表单。为表单增加字段,至少保留一个文本字段,例如「变更说明」。
  4. 保存流程。表单触发会提供填写入口,提交后启动一次执行。

界面指引:

界面截图待补充。

  • 操作关注点:画布提示先选触发器。后面的节点才能引用触发输入里的字段。

三、加上条件分支和审批

  1. 在触发器后添加 条件分支。
  2. 增加结构化条件。多条规则可以要求「满足全部」或「满足任意」。画布只有「满足」和「不满足」两个出口,不会按条件条数拆成多路。
  3. 条件左值可以选择上游字段,例如表单里的变更说明,或运行信息里的执行标识。不要手写脚本表达式。
  4. 在「满足」出口添加 人工审批。填写审批标题,候选审批人至少包含一个可登录用户。
  5. 在审批通过的后续路径添加 对外通知。选择系统管理里已配置的渠道,标题和正文可以引用上游字段。

四、运行并审批

  1. 打开该流程的表单入口,填写变更说明并提交。
  2. 到 「执行记录」 找到这次运行。状态应进入等待审批。
  3. 审批人打开 「首页」 的待审批事项,或在执行记录中切换到 「待我审批」。
  4. 打开详情,查看审批标题、候选人和审批上下文。通过则流程继续并发送通知。驳回必须先填写原因。
  5. 执行结束后,记录状态变为成功、失败或已终止。测试运行如果停在中间,可以手动停止。

五、换成其他触发方式

按场景替换第一个触发器,后面的条件、审批和动作可以保留。

  1. 定时:设置触发频率。到点后自动产生执行,不需要打开表单。
  2. Webhook:启用后把调用地址交给外部系统。按页面给出的方式提交触发数据。需要等待流程结果时,使用触发器上的等待响应模式。
  3. NATS:填写平台内的消息通道,用于接收告警中心等已经进入消息通道的事件。不要把密钥写进流程说明。

六、需要动主机或生成文件时

  1. 作业执行:选择授权目标,编写 Linux 或 Windows 脚本。节点输出统一的 JSON 结果,供后续节点引用。这个节点会改变目标主机,先在测试目标上运行。
  2. HTTP 请求:填写方法、完整 URL 和参数。运行时会限制内网探测和响应大小。
  3. 智能体 / 意图分类:选择当前组织可用的 OpsPilot 智能体或模型。意图分类需要先定义意图列表。
  4. 记忆读取 / 记忆写入:选择当前组织可用的记忆空间。读取用于把历史上下文交给后续节点,写入用于把本次结论存回去。
  5. 文档生成:选择 Word 或 Excel 模板和结构化数据,生成后的文件可被通知节点当作附件。

七、结果验证与闭环

  • 执行记录里能看到触发类型、发起人和每个节点的状态。
  • 审批通过后,通知渠道收到内容,且内容中的字段与表单提交一致。
  • 驳回后流程进入驳回分支,不会继续执行通过路径上的动作。
  • 首页趋势和最近执行与执行记录中的状态一致。

暂无评论

发送评论 编辑评论


				
上一篇
下一篇
正在准备导出…