Databuff
GitHub
Skip to content

中文  |  English

User Guide · Custom Digital Experts

Beyond the built-in AI Brain, Query Expert, and Inspection Expert, you can create custom digital experts, bind remote MCP tools, and connect external systems such as SkyWalking, Prometheus, and Zabbix into the conversation flow.

Four steps: Register MCP → Create expert → Bind tools → Verify in chat


Overall Flow

StepActionNotes
Register MCP toolTool Management → MCP Tools → New MCP
Create custom expertDigital Experts → New Expert, type SPECIALIST
Bind MCPCheck MCP Tool ID in expert Tools allowlist
Verify in chatAsk the AI Brain directly; it routes automatically

MCP registration details: External MCP Integration.


① Register MCP Tool

AI Platform → Tool Management → MCP Tools → New MCP

FieldExample
Tool IDopen-api
Connection URLhttp://your-mcp-host:18900/sse
ProtocolSSE
StatusEnabled

Create MCP tool

After saving, tools exposed by this MCP are registered at runtime for the expert to call.


② Create Custom Digital Expert

AI Platform → Digital Experts → New Expert

Basic Info

FieldExampleNotes
Expert IDopenapiGlobally unique
NameOpen API AssistantDisplay name
TypeSPECIALISTProfessional expert dispatchable by AI Brain
CategoryExternal integrationFor grouping
DescriptionCall external Open API via MCP…Clear scope helps auto-routing
StatusEnabledDisabled experts are not dispatched

Custom expert list

Capabilities and Prompt

FieldExample
Tool modeAllowlist (ALLOWLIST)
ToolsCheck open-api
SkillsOptional
PromptSee example below

Prompt example:

text
You are the DataBuff APM Open API assistant. Use the MCP tool open-api to call external systems (SkyWalking, Prometheus, Zabbix, etc.).

Principles:
1. Prefer open-api MCP tools to complete tasks.
2. Answer only from real tool responses — do not fabricate data.
3. Reply in English and state which external tools were called.

After saving, the new expert appears in the list with bound Tools count in the capabilities column.


③ AI Brain Auto-routing

No AI Brain config changes are required. When a custom expert is enabled, the AI Brain includes it in the dispatch list and picks the best match from the user question and expert description.

Users always talk only to the AI Brain; complex collaboration happens in the background.


④ Verify in Chat

AI Platform → AI Chat, ask the AI Brain directly:

text
Query SkyWalking via external API — which services exist right now?

What You Will See

  1. AI Brain understands the question and calls dispatchExpertTask to send work to Open API Assistant
  2. Open API Assistant calls external tools via open-api MCP (e.g. listSkyWalkingLayers, listSkyWalkingServices)
  3. When the expert finishes, AI Brain summarizes and replies

Expand the reasoning trace to see the full multi-expert chain:

AI Brain dispatching to Open API Assistant

Shortcut entries such as Open API Assistant also appear below the chat input, indicating the expert is part of the platform.


Expert Types

TypePurpose
BRAINSingle entry point — understand, dispatch, summarize (use built-in AI Brain; do not duplicate)
SPECIALISTProfessional executor dispatchable by AI Brain (recommended for custom experts)
CUSTOMGeneric custom type

Division of Labor with Built-in Experts

ExpertStrength
Query ExpertDataBuff APM metrics, traces, topology
Inspection ExpertService health inspection and anomaly diagnosis
Custom expertExternal system data via MCP