精灵与例程
治理精灵（Governance Sprite）完成一个边界明确的原子任务，例如查询元数据或获取标准。例程（Routine）将多个精灵按确定的业务逻辑组合成可复用流程。精灵本身并不等同于周期运行的主动治理任务。
阅读配置时还需区分：输入参数 Schema 是精灵输入的名称、类型和约束说明，不是数据库 Schema；参数映射是把例程入口或上一步输出填给后续精灵的输入；工具才是实际读取或修改外部对象的执行接口。仅有提示词或执行箭头，不代表参数和工具已经可用。
进入管理页
进入“配置管理 → 治理精灵”，先选择“当前智能体”。页面包含“精灵”“例程”“执行历史”三个分区。没有选择智能体时，页面会提示选择要配置的智能体。
资源属于当前智能体，查不到已有精灵或例程时应先核对选择，不要立即重新创建同名对象。
设计一个精灵
需要逐项配置输入 Schema、工具和发布边界时，参阅精灵设计与发布。
先写清任务边界，再配置页面。一个精灵需要有明确输入、执行工具和可供下游使用的输出。
| 配置 | 用途 | 检查重点 |
|---|---|---|
| 编码、名称、描述 | 稳定标识并说明任务 | 名称不能掩盖多个不同职责 |
| 模板提示词 | 说明目标、边界、输出及异常处理 | 引用参数与输入 Schema 一致 |
| 输入参数 Schema | 定义参数名称、类型及说明 | 必填项、默认值和对象范围有明确含义 |
| 当前模型 | 执行必要的理解或转换 | 与任务所需能力相匹配 |
| MCP、内部服务或 Command Line | 分别通过协议工具、DAM 内部接口或命令行提供执行能力 | 只绑定该任务必需的能力，并核对权限与运行环境 |
| 启用、作为工具暴露 | 控制精灵是否可用及调用方式 | 发布前核对调用范围 |
查看精灵编辑原图。图中的命令和资源仅为界面示例；实际执行应使用已配置并验证的工具。
创建与测试精灵
- 在“精灵”分区创建精灵，填写编码、名称和描述。
- 编写模板提示词，明确只完成哪一件事，以及不能处理时怎样报告。
- 配置输入参数。提示词中类似
的占位符必须与实际参数名一致。 - 选择模型并绑定工具。
- 配置启用状态和是否作为工具暴露。
- 使用受控样本检查输入、输出和工具结果，再保存可用配置。
精灵也可以通过 AI 从已有 Skill、治理对话或过程提炼。生成后仍需检查职责、参数和工具依赖，不能把生成成功作为可运行证明。
设计例程
需要配置入口参数、节点映射、失败策略和执行诊断时，参阅例程编排与运行。
例程负责流程，精灵负责节点能力。先确定输入和期望输出，再安排步骤。例如，只读的“对象检查”流程可以先定位元数据，再分别检查描述和标准关联，最后汇总缺口。这是设计示例，不表示环境中已内置该例程。
查看例程画布原图。图中指标口径分析仅展示画布操作，节点名称取决于实际配置。
编排步骤
- 在“例程”分区创建例程，填写编码、名称、描述和入口参数。
- 添加精灵节点，为每个节点填写清楚的步骤名称。
- 选择该节点执行的精灵。
- 将入口参数或上游输出映射到节点输入。
- 按业务依赖连接步骤。后一步需要前一步输出时使用串行；彼此独立的下游任务才适合并行。
- 为各节点配置失败处理：“继续”或“终止”。关键写入步骤通常应终止，避免在错误输入上继续执行。
- 使用画布的参数关系显示、缩放、撤销和重做检查流程。
- 测试完整路径，保存后按环境提供的发布流程开放调用。
注意区分执行顺序和参数传递：连接了执行箭头并不自动证明所有必需参数都完成映射。检查每一个下游输入都有正确来源。
调度与模板关系
例程调度属于具体智能体实例。创建模板时复制精灵和例程配置，但不复制调度。空间实例需要周期执行时，在实例中单独配置，并核对首次实际触发记录。
查看执行历史
切换到“执行历史”，找到目标精灵或例程记录。例程应继续下钻到节点，检查输入、输出、状态、工具调用结果和失败原因。
| 现象 | 优先核对 |
|---|---|
| 列表为空 | 当前智能体是否正确，是否执行过任务 |
| 节点缺少参数 | 入口参数、占位符名称和上游输出映射 |
| 工具调用失败 | 模型、MCP、内部服务或命令执行环境的可用性 |
| 有些节点未执行 | 上游失败策略是否为终止，是否存在依赖 |
| 流程成功但业务结果不对 | 对象范围、节点输出语义与 DAM 实际记录 |
验收建议
分别测试正常输入、缺失必填参数、服务不可用及部分节点失败。对会修改 DAM 数据的节点保留人工确认，并在实际模块核对结果。执行日志中的成功只说明该次调用完成，业务验收仍应检查是否修改了正确对象和属性。