精灵设计与发布
精灵是数据治理智能体中可复用的原子能力。它应当只承担一个边界清楚的任务,例如查询对象、补充描述、检查标准关联或生成待审核建议。需要多个步骤、条件和结果传递时,应使用例程编排精灵。
设计前准备
开始前明确以下内容:
| 项目 | 需要明确的内容 |
|---|---|
| 任务边界 | 精灵完成什么,不处理什么 |
| 输入 | 对象标识、空间、数据范围和必填参数 |
| 输出 | 文本、结构化结果、建议或待审批变更 |
| 工具 | DAM 内部服务、MCP、命令或 Skill |
| 权限 | 查询权限、写入权限和审批要求 |
| 失败处理 | 参数缺失、工具不可用或结果为空时的返回方式 |
不要把“治理整个系统”作为一个精灵的职责。过大的职责会导致参数、权限和结果难以验收。
创建精灵
进入“配置管理 → 治理精灵”,选择目标智能体后创建精灵。根据页面实际字段填写编码、名称、描述和提示词。编码应长期稳定,名称用于列表展示,描述应说明适用对象和结果。
输入参数
为每个参数定义名称、类型、是否必填、默认值和业务含义。提示词中的变量必须与参数名称一致;对象 ID、名称和展示文本不要混作同一参数。对数组或对象参数,明确每个成员的结构和允许为空的条件。
提示词与边界
提示词至少写清:
- 任务目标和处理范围。
- 参数如何解释,以及没有参数时怎样返回。
- 应调用的工具和调用顺序。
- 输出字段、格式和证据要求。
- 发现冲突、权限不足或无法确认时如何报告。
提示词不能替代工具权限,也不能把模型的推断写成已完成的 DAM 操作。
工具绑定
精灵可以按部署配置使用 DAM 工具、MCP、内部服务、命令或 Skill。只绑定完成任务所需的工具,并逐项检查服务地址、连接模式、请求头、超时和参数 JSON。工具测试通过只表示连接可用,还需要用真实对象验证返回内容。
测试与验收
使用受控样本至少测试四类输入:正常对象、缺失必填参数、空结果和工具失败。检查输入是否被正确映射、工具是否调用了预期对象、输出字段是否稳定,以及是否产生了不应有的写入。涉及标准、质量、安全或资产变更时,默认先输出建议并交由人工审批。
保存、启用和发布
保存前复核编码、输入 Schema、工具和提示词的对应关系。启用状态控制精灵是否可调用;“作为工具暴露”会影响其他智能体或例程是否能够发现它。发布前记录当前配置、测试样例和已知限制,避免直接覆盖正在使用的配置。
不同环境可能提供版本、复制、导入 ZIP 或从 Skill 扫描生成等入口。导入或自动生成后仍须人工检查内容、依赖和权限,不能以生成成功作为验收结论。
常见问题
| 现象 | 排查顺序 |
|---|---|
| 精灵列表为空 | 确认已选择正确的智能体,并检查当前账号的配置权限 |
| 参数未替换 | 对照输入参数名称、提示词变量和例程映射 |
| 工具连接失败 | 检查地址、连接模式、请求头、超时和服务端日志 |
| 返回内容不稳定 | 收紧输出 Schema,减少无关工具,并增加边界条件 |
| 任务显示成功但对象未改变 | 核对精灵是否只有查询权限,以及结果是否需要人工审批 |
