metadata: author: DataAgent Team version: "3.0.0"

Changelog

• v3.0.0 — Session mode tiers aligned with the platform: auto / lite / pro / ultra (defaults: auto for database, pro for file); legacy ASK_DATA/ANALYSIS/INSIGHT values are auto-mapped to lite/pro/ultra for backward compatibility. New plan_mode parameter on data_agent_create_session (force = always generate an execution plan, disable = skip planning), injected as SessionConfig.PlanMode. Generic multi-tenant identity mode: identity config section (legacy aily: alias still parsed) with configurable identity headers (defaults x-aily-*, Feishu Aily compatible) and two mapping styles — identity.default (global sharing: one RAM role + workspace/agent/mode session defaults for every identified user) and identity.groups.<name> (per-group role + session defaults + member list; group wins over default). Per-user tenants (isolated client, session store sessions_dir/identity/<user>/, RoleSessionName = <prefix>-<user_id> for ActionTrail attribution) via STS AssumeRole with auto-refresh. Follow-up questions on finished sessions: data_agent_send revives completed sessions from persisted state. YAML (config.yaml) + .env configuration replaces JSON-only config. Fixed SSE parsing without event: prefix lines and watcher lifetime on HTTP transports. Repackaged as a standalone skill; binaries are built from source by scripts/select-binary.sh (Go 1.23+).
• v2.x — Tool surface grew to 18 data_agent_* tools (discovery/import, workspaces, custom agents, file upload, session lifecycle). Event-driven waiting: data_agent_wait_result blocks until the session needs LLM attention; data_agent_status gained server-side wait_timeout; CRITICAL ANTI-LOOP rules against repetitive polling. data_agent_result returns chart images as MCP ImageContent. Clear split between workspace Data Center metadata (data_agent_list_workspace_databases, authoritative for create_session) and DMS discovery (data_agent_search_dms_databases, import only). API Key auth mode and file analysis flows.
• v2.0.0 — Initial Go MCP Server architecture: Session Daemon with background SSE monitoring, auto-confirm for ANALYSIS mode, core session tools.

Runtime Contract

This skill requires the data-agent MCP server to be registered in the host runtime. Installing the skill only gives the agent instructions; it does not automatically make data_agent_* tools available in every client.

For any Data Agent task, call the exposed MCP tools such as data_agent_list_workspace_databases, data_agent_create_session, data_agent_status, and data_agent_result. Do not answer from cached knowledge, do not run scripts/select-binary.sh as a one-off CLI workflow, do not start the bundled server during task execution, and do not call Alibaba Cloud APIs or the MCP HTTP endpoint directly with curl.

If no data_agent_* MCP tools are visible, stop immediately and report: "Data Agent MCP server is not registered in this agent runtime. Task aborted." In OpenClaw, AgentHub, or other hosted runtimes, MCP registration must be completed during the runtime setup/install phase; a task-running agent must not self-register, edit runtime config, launch select-binary.sh, probe localhost ports, or curl /mcp as a workaround.