Skip to content
Datablau DAM数据治理产品手册
数据治理智能体 模块手册下载 PDF

精灵设计与发布 ​

精灵是数据治理智能体中可复用的原子能力。它应当只承担一个边界清楚的任务,例如查询对象、补充描述、检查标准关联或生成待审核建议。需要多个步骤、条件和结果传递时,应使用例程编排精灵。

设计前准备 ​

开始前明确以下内容:

项目需要明确的内容
任务边界精灵完成什么,不处理什么
输入对象标识、空间、数据范围和必填参数
输出文本、结构化结果、建议或待审批变更
工具DAM 内部服务、MCP、命令或 Skill
权限查询权限、写入权限和审批要求
失败处理参数缺失、工具不可用或结果为空时的返回方式

不要把“治理整个系统”作为一个精灵的职责。过大的职责会导致参数、权限和结果难以验收。

创建精灵 ​

进入“配置管理 → 治理精灵”,选择目标智能体后创建精灵。根据页面实际字段填写编码、名称、描述和提示词。编码应长期稳定,名称用于列表展示,描述应说明适用对象和结果。

输入参数 ​

为每个参数定义名称、类型、是否必填、默认值和业务含义。提示词中的变量必须与参数名称一致;对象 ID、名称和展示文本不要混作同一参数。对数组或对象参数,明确每个成员的结构和允许为空的条件。

提示词与边界 ​

提示词至少写清:

  1. 任务目标和处理范围。
  2. 参数如何解释,以及没有参数时怎样返回。
  3. 应调用的工具和调用顺序。
  4. 输出字段、格式和证据要求。
  5. 发现冲突、权限不足或无法确认时如何报告。

提示词不能替代工具权限,也不能把模型的推断写成已完成的 DAM 操作。

工具绑定 ​

精灵可以按部署配置使用 DAM 工具、MCP、内部服务、命令或 Skill。只绑定完成任务所需的工具,并逐项检查服务地址、连接模式、请求头、超时和参数 JSON。工具测试通过只表示连接可用,还需要用真实对象验证返回内容。

测试与验收 ​

使用受控样本至少测试四类输入:正常对象、缺失必填参数、空结果和工具失败。检查输入是否被正确映射、工具是否调用了预期对象、输出字段是否稳定,以及是否产生了不应有的写入。涉及标准、质量、安全或资产变更时,默认先输出建议并交由人工审批。

保存、启用和发布 ​

保存前复核编码、输入 Schema、工具和提示词的对应关系。启用状态控制精灵是否可调用;“作为工具暴露”会影响其他智能体或例程是否能够发现它。发布前记录当前配置、测试样例和已知限制,避免直接覆盖正在使用的配置。

不同环境可能提供版本、复制、导入 ZIP 或从 Skill 扫描生成等入口。导入或自动生成后仍须人工检查内容、依赖和权限,不能以生成成功作为验收结论。

常见问题 ​

现象排查顺序
精灵列表为空确认已选择正确的智能体,并检查当前账号的配置权限
参数未替换对照输入参数名称、提示词变量和例程映射
工具连接失败检查地址、连接模式、请求头、超时和服务端日志
返回内容不稳定收紧输出 Schema,减少无关工具,并增加边界条件
任务显示成功但对象未改变核对精灵是否只有查询权限,以及结果是否需要人工审批

相关文档 ​