Databuff
GitHub
Skip to content

中文  |  English

使用手册 · 自定义数字专家

除了内置的 AI 大脑、智能问数、巡检专家,你还可以创建自定义数字专家,绑定远程 MCP 工具,把 SkyWalking、Prometheus、Zabbix 等外部系统能力接入对话流程。

四步完成: 注册 MCP → 创建专家 → 绑定工具 → 对话使用


整体流程

步骤操作说明
注册 MCP 工具工具管理 → MCP 工具 → 新建 MCP
创建自定义专家数字专家 → 新建专家,类型选 SPECIALIST
绑定 MCP专家 Tools 白名单中勾选 MCP Tool ID
对话验证AI 对话直接向 AI 大脑提问,大脑自动路由

MCP 注册细节见 外部 MCP 集成


① 注册 MCP 工具

AI 平台 → 工具管理 → MCP 工具 → 新建 MCP

字段示例
Tool IDopen-api
连接地址http://your-mcp-host:18900/sse
协议SSE
状态启用

新建 MCP 工具

保存后,该 MCP 暴露的工具会在专家运行时自动注册,供专家调用。


② 创建自定义数字专家

AI 平台 → 数字专家 → 新建专家

基础信息

字段示例说明
Expert IDopenapi全局唯一标识
名称开放API助手展示名称
类型SPECIALIST可被 AI 大脑派发的专业专家
分类外部集成便于分组管理
描述通过 MCP 调用外部 Open API…写清职责,有助于大脑自动路由
状态启用禁用后大脑不再派发

自定义专家列表

能力与 Prompt

字段示例
工具模式白名单(ALLOWLIST)
Tools勾选 open-api
Skills可选
Prompt见下方示例

Prompt 示例:

text
你是 DataBuff APM 开放 API 助手,负责通过 MCP 工具 open-api 调用外部系统(SkyWalking、Prometheus、Zabbix 等)。

工作原则:
1. 优先调用 open-api MCP 暴露的工具完成任务。
2. 必须基于工具返回的真实数据回答,不要编造。
3. 用中文回答,说明调用了哪些外部工具。

保存后,专家列表中会出现新专家,能力列显示已绑定的 Tools 数量。


③ AI 大脑自动路由

无需修改 AI 大脑配置。自定义专家启用后,AI 大脑会自动将其纳入可派发列表,根据用户问题和专家描述选择最合适的专家执行。

用户始终只与 AI 大脑 对话,复杂协作在后台完成。


④ 对话验证

AI 平台 → AI 对话,直接向 AI 大脑提问:

text
通过外部 API 查询 SkyWalking 当前有哪些服务

你会看到什么

  1. AI 大脑理解问题,调用 dispatchExpertTask 派发给 开放API助手
  2. 开放API助手通过 open-api MCP 调用外部工具(如 listSkyWalkingLayerslistSkyWalkingServices
  3. 专家完成后,AI 大脑汇总结果回复用户

展开思考过程,可清晰看到各专家的协作链路:

AI 大脑派发给开放API助手

对话输入框下方也会出现 开放API助手 等自定义专家快捷入口,表示该专家已纳入平台能力体系。


专家类型说明

类型用途
BRAIN唯一入口,负责理解、派发、汇总(使用内置 AI 大脑,勿重复创建)
SPECIALIST专业执行者,可被大脑派发(自定义专家推荐选此类型)
CUSTOM通用自定义类型

与内置专家的分工

专家擅长
智能问数查 DataBuff 自身 APM 指标、Trace、拓扑
巡检专家服务健康巡检与异常诊断
自定义专家通过 MCP 查外部系统数据

相关文档