帮助中心

简体中文

English

简体中文

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

数据治理智能体后台管理 ​

本指南供管理员维护智能体及其可复用资源。统一入口为 DIG 主导航“配置管理”；先核对当前智能体，再维护属于该智能体的模型、工具、Skill、文件和治理能力。

配置关系 ​

text
智能体
├── 模型
├── MCP 服务
├── 内部服务
├── Skill
├── 提示词与参数
└── Workspace

精灵完成单一治理动作，例程编排多个精灵，用户文件提供受控上下文。

管理员应遵循最小权限原则，只为智能体配置完成职责所需的模型和工具。

智能体管理 ​

智能体管理

创建或导入智能体 ​

  1. 进入“配置管理 → 智能体”，选择“添加智能体”或“导入智能体”。
  2. 填写智能体名称，在系统提示词中说明职责、允许处理的数据范围和输出要求。
  3. 选择已批准的模型。
  4. 配置系统提示词和必要参数。
  5. 绑定完成任务所需的工具、内部服务和 Skill。
  6. 按需配置 Workspace。
  7. 使用非敏感样本进行测试。
  8. 保存并按页面提供的发布流程开放使用。新建会话后核对是否可以选择该智能体。

导入智能体时应检查包的来源、依赖服务、权限和提示词，不能直接把测试环境配置发布给用户。

智能体模板 ​

模板是不可执行的配置快照，分为“数据治理智能体模板”和“业务查询智能体模板”。已实例化的智能体与模板相互隔离，模板更新不会自动覆盖实例，例程调度也不随模板复制。完整步骤见创建和发布智能体模板。

测试与发布 ​

测试应覆盖正常输入、空输入、错误对象、超大范围、权限不足和服务不可用。发布前确认结果进入人工审批，且智能体不会向无权用户暴露工具或数据。

模型管理 ​

进入“配置管理 → 大模型配置”维护共享模型配置，按 LLM 或 Text Embedding 类型设置参数。当前页面要求连接测试通过后才能保存，向量模型还需核对实际向量维度。具体字段、大模型参数建议、模型发现、复制及排查见模型服务。

连接可达不等于模型能够正确调用治理工具。保存后还需在目标智能体中验证小范围任务，并区分默认模型与默认智能体。

MCP 管理 ​

MCP 管理

MCP 服务用于让 DIG 调用其他应用的工具。进入“配置管理 → MCP服务”，选择“添加MCP服务”后填写以下字段：

MCP 服务配置表单

查看 MCP 表单原图。图中地址和服务名称仅为当前环境示例。

字段用途与填写要求
名称在 MCP 列表中识别服务的名称。
服务地址DIG Server 可以访问的 MCP Server 地址。
连接模式当前表单提供 Streamable HTTP 和 SSE，按服务端协议选择。
连接超时（毫秒）单次连接测试的超时时间，页面提供默认值；按网络和服务响应情况调整。
自定义设置 JSON服务端要求的附加设置；必须使用合法 JSON。
请求头 JSON服务端要求的请求头；认证信息应按企业安全规范管理，不放入截图或普通提示词。
描述记录服务用途和适用智能体。

单击“测试”检查连通性，再保存。列表中的“工具（数量）”用于查看服务暴露的工具，“查看详情”用于核对工具定义；启用前系统还会由后端执行连通性测试。测试成功只表示服务可达，不代表返回内容正确，也不表示所有用户都有权执行全部工具。删除或停用前检查依赖的智能体、Skill 和精灵。

内部服务 ​

进入“配置管理 → 内部服务”。页面支持“上传 YAML”批量导入，也支持“添加内部服务”逐条定义。逐条添加时填写：

字段含义
名称在内部服务列表中显示的名称。
目标应用接口所属的 DAM 或其他应用。
描述说明用途、数据范围和风险。
服务接口接口的声明或标识。
服务路径实际调用路径。
方法名称底层接口的方法名称。
参数 JSON接口输入参数定义。

保存后页面会立即生效。内部服务通过底层程序接口提供能力，无需为每个接口另建 MCP 或命令行程序。导入或添加前检查接口用途、输入输出、身份传递和写操作风险；导入后以最小样本验证调用结果。

创建、修改、发布或删除类服务应比只读查询设置更严格的授权和审批。快速调用用于测试或受控执行，不能绕过业务权限。

Skill 管理 ​

Skill 封装可复用的治理步骤。配置内容可包括：

  • 适用范围和职责说明。
  • 提示词及其 Markdown 预览。
  • Skill 包路径和依赖接口。
  • 可调用工具与输入输出约束。
  • 测试用例和预期结果。

进入“配置管理 → 技能管理”，先选择作用域：

  • 智能体：保存在当前智能体工作目录，进入会话后按配置启用；可扫描工作区、上传 ZIP 或单击“添加 Agent 技能”。添加表单至少包含“Skill 编码”“名称”和“内容”，已有 Skill 还可切换“智能体默认启用”。
  • 全局：管理系统可用 Skill，单击“添加 Skill”维护编码、名称和内容，再编辑、删除或查看详情。
  • 用户：维护当前用户自己的 Skill，作用范围不等于全局 Skill。

编辑提示词后使用 Markdown 预览检查格式，核对 Jar、Python 包等依赖路径和 DAM 接口，再测试典型输入与失败情况。默认 Skill 优先复用，确有定制需求时再修改。定制 Skill 调用需要用户身份的接口时，使用运行时 ${session.token} 引用，不写入固定 Token。

治理精灵 ​

进入“配置管理 → 治理精灵”，选择当前智能体，在精灵、例程和执行历史之间切换。精灵只处理一个明确任务，例程组织步骤、参数传递和失败策略。具体操作见配置治理精灵和例程。

用户文件 ​

用户文件为会话和治理任务提供上下文。管理员可管理全部用户文件，普通用户管理本人文件；具体权限边界以当前环境为准。

进入“配置管理 → 用户文件管理”，选择当前智能体并查看文件列表。可编辑内容、引用到 AI 对话、下载、重命名或删除。新会话可继续引用已上传文件，无需重复上传。删除或替换前确认是否仍被会话、智能体或任务引用，避免历史任务失去依据。

参数管理 ​

进入“配置管理 → 参数配置”。系统参数由运行时提供；全局参数和“我的参数”是静态配置，在分发 Skill 和调用提示词时替换。全局与个人参数支持新增、编辑、复制、删除和预览。

系统参数示例包括 {workspace.dir}（智能体工具目录）和 {usr.name}（当前用户名称）。全局 baseUrl 和用户身份的配置见初始化设置。复制含认证信息的参数时应确认目标用户和用途；预览时不要把真实认证值放进截图或反馈文件。

常用提示词 ​

常用提示词用于复用成熟的任务表达，可在界面维护或按支持格式导入。提示词应包含目标、输入范围、规则、限制和输出要求。导入后预览格式并用样本验证，再提供给用户。

提示词不是权限控制手段，不能依赖文本指令阻止未授权的数据访问或写入操作。

上线前检查 ​

  • 智能体只对授权用户可见。
  • 模型、MCP 和内部服务连接正常，失败信息可定位。
  • 每个智能体只绑定完成职责所需的工具和 Skill。
  • 对会写入 DAM 的治理结果，已按企业审批策略确认是人工审批、批量审批还是允许自动通过；不要把“审批页面可用”误写成所有任务都强制人工审批。
  • 用户文件和参数的可见范围符合数据安全要求。
  • 凭据未出现在页面、日志、提示词和导出文件中。
  • 配置变更、测试和发布具有审计记录。

常见问题 ​

配置保存后似乎没有生效。 先核对当前智能体和实际对话使用的智能体是否一致，再检查依赖服务与参数。模板和空间实例隔离，更新模板不会修改既有实例。

模型测试成功，但治理任务失败。 继续检查 DAM 根地址、用户身份和工具调用日志。模型、MCP、内部服务是不同的连接环节。

新会话找不到原文件。 检查登录用户、当前智能体和文件列表，确认没有删除、替换或引用错误文件。

相关文档 ​