例程编排与运行
例程把多个精灵组合为可复用的治理流程，负责节点顺序、输入输出映射、失败策略和运行记录。例程不改变精灵本身的职责；同一个精灵可以被多个例程复用。
规划例程
先画出业务任务的输入、处理步骤和验收结果，再在页面中创建节点。每个节点只选择一个精灵，并写清本节点完成的动作。独立的只读检查可以并行；存在数据依赖或写入依赖时使用串行连接。
| 规划项 | 说明 |
|---|---|
| 入口参数 | 例程调用者必须提供的对象、空间或筛选条件 |
| 节点 | 对一个精灵的一次调用 |
| 参数映射 | 入口参数或上游输出如何传给下游节点 |
| 依赖 | 节点执行前必须完成的节点 |
| 失败策略 | 当前节点失败后继续执行或终止例程 |
| 结果 | 供调用方查看或供后续节点使用的结构化输出 |
创建和编排
- 进入“配置管理 → 治理精灵 → 例程”，创建例程并填写稳定编码、名称和描述。
- 定义入口参数，说明每个参数的类型、必填性和业务范围。
- 添加精灵节点，为节点填写可识别的步骤名称。
- 选择精灵，核对该精灵的输入参数和权限依赖。
- 将入口参数或上游输出映射到节点输入；逐项检查名称、类型和空值处理。
- 按业务依赖连接节点。只有互不依赖的节点才安排并行。
- 配置失败策略。关键写入或审批前置检查通常应终止，非关键统计节点才考虑继续。
- 保存后运行测试，检查完整路径、分支和异常路径。
连接执行箭头不代表参数已经映射。每个节点都要单独检查输入来源，尤其是数组、对象和上游空结果。
测试与发布
至少使用正常输入、空结果、缺失必填项、工具不可用和部分节点失败五组样例。测试时同时检查节点顺序、参数内容和业务结果。对会修改元数据、标准、质量、安全或资产的精灵，发布前应设置人工确认或审批边界。
发布后不要直接修改正在使用的例程定义。若环境支持版本或复制，应先复制为新配置，完成回归后再切换调用方。例程模板、空间实例和调度配置分别维护，发布模板不会自动覆盖已经创建的空间实例。
调度和运行记录
例程可由空间、智能体调用或按部署提供的调度入口运行。调度频率、启停状态和首次运行时间应在实际环境中单独确认。执行历史中应检查：
- 例程输入和最终状态。
- 每个节点的开始结束时间、输入输出和工具调用。
- 失败节点及异常消息。
- 继续策略是否导致后续节点使用了不完整结果。
- 写入型节点是否产生了预期的待审批记录或治理变更。
节点诊断
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 例程未启动 | 调度未启用、入口参数为空或实例未发布 | 先查实例、发布状态和入口参数 |
| 某节点跳过 | 上游失败且策略为终止，或条件未满足 | 查看上游节点状态和分支条件 |
| 节点反复失败 | 工具服务、权限或输入结构错误 | 单独运行该精灵并比对输入 Schema |
| 节点成功但结果为空 | 对象范围无匹配，或上游输出字段映射错误 | 查看节点实际输入和查询范围 |
| 下游结果不完整 | 并行节点尚未汇总，或继续策略忽略失败 | 增加汇总节点并显式处理失败结果 |
与其他 DIG 对象的关系
智能体负责理解目标并选择能力；精灵执行原子任务；例程固化顺序和映射；数据智能空间承载业务范围、文档和治理阶段；智能体模板保存可复用配置。它们的名称和权限并不互相替代。