Alibabacloud Data Agent Skill
by @sdk-team
Invoke Alibaba Cloud Apsara Data Agent for Analytics via CLI to perform natural language-driven data analysis on enterprise databases. Data Agent for Analyti...
clawhub install alibabacloud-data-agent-skillπ About This Skill
name: alibabacloud-data-agent-skill description: | Invoke Alibaba Cloud Apsara Data Agent for Analytics via CLI to perform natural language-driven data analysis on enterprise databases. Data Agent for Analytics is an intelligent data analysis agent developed by Alibaba Cloud Database team for enterprise users. It automatically completes requirement analysis, data understanding, analysis insights, and report generation based on natural language descriptions. This tool supports: discovering data resources (instances/databases/tables) managed in DMS, initiating query or deep analysis sessions, real-time progress tracking, and retrieving analysis conclusions and generated reports. Use this Skill when users need to query databases, analyze data trends, generate data reports, ask questions in natural language, or mention "Data Agent", "data analysis", "database query", "SQL analysis", "data insights". compatibility: | Requires valid Alibaba Cloud credentials (default credential chain or API_KEY); Requires dependencies in requirements.txt to be installed; Data sources must be managed in Alibaba Cloud Apsara Database or DMS. domain: AIOps
metadata: author: DataAgent Team version: "1.7.2"
Changelog
ls command API response parsing (support case-insensitive field names), optimize SKILL documentation structure, separate ANALYSIS mode specification documentInstallation
Configure Credentials
This Skill uses Alibaba Cloud default credential chain (recommended) or API_KEY authentication.
Option 1: Default Credential Chain (Recommended)
The Skill uses Alibaba Cloud SDK's default credential chain to automatically obtain credentials, supporting environment variables, configuration files, instance roles, etc.
See Alibaba Cloud Credential Chain Documentation
Option 2: API_KEY Authentication (File Analysis Only)
export DATA_AGENT_API_KEY=your-api-key
export DATA_AGENT_REGION=cn-hangzhou
Get API_KEY: Data Agent Console
Permission Requirements
RAM users need AliyunDMSFullAccess or AliyunDMSDataAgentFullAccess permissions.
See RAM-POLICIES.md for detailed permission information.
Debug Mode
DATA_AGENT_DEBUG_API=1 python3 scripts/data_agent_cli.py file example.csv -q "analyze"
π‘ Getting Started Tips
internal_data_employees (DataAgent's built-in test database containing employee, department, and salary data) for first-time experienceassets/example_game_data.csv for file analysis experienceData Agent CLI β Unified Command-Line Data Analysis Tool
Overview
scripts/data_agent_cli.py helps users complete the full workflow from discover data β initiate analysis β track progress β get results.
Core Concepts
> β οΈ Key Prerequisite: Data Agent can only analyze databases that have been imported into Data Agent Data Center.
>
> - Data Center: Data Agent's data center, only databases here can be analyzed
> - DMS: Alibaba Cloud Data Management Service, stores metadata of all databases
> - Relationship: Databases registered in DMS β Databases in Data Center
>
> Usage Flow:
> 1. First use ls to check if the target database exists in Data Center
> 2. If not found, use dms subcommand to search for database info, then use import subcommand to import it
> 3. After successful import, you can use db subcommand for analysis
Analysis Modes
> See ANALYSIS_MODE.md for details
Session Reuse
Use db/file to create a session for initial analysis, then use attach --session-id to reuse the session for follow-up questions.
> See COMMANDS.md and WORKFLOWS.md for details
Quick Start
# 1. List available databases
python3 scripts/data_agent_cli.py ls2. Query analysis (synchronous response)
python3 scripts/data_agent_cli.py db \
--dms-instance-id --dms-db-id \
--instance-name --db-name \
--tables "employees,departments" -q "Which department has the highest average salary"3. Follow-up question (reuse session)
python3 scripts/data_agent_cli.py attach --session-id -q "Break down by month"
> π See WORKFLOWS.md and COMMANDS.md for complete workflows, command reference, and best practices
Project Structure
# Skill root directory
βββ SKILL.md # This document
βββ scripts/ # Source code
β βββ data_agent/ # SDK module
β βββ cli/ # CLI module
β βββ data_agent_cli.py # CLI entry point
β βββ requirements.txt # Dependencies
βββ sessions/ # Session data
βββ references/ # Reference documents
π‘ Examples
# 1. List available databases
python3 scripts/data_agent_cli.py ls2. Query analysis (synchronous response)
python3 scripts/data_agent_cli.py db \
--dms-instance-id --dms-db-id \
--instance-name --db-name \
--tables "employees,departments" -q "Which department has the highest average salary"3. Follow-up question (reuse session)
python3 scripts/data_agent_cli.py attach --session-id -q "Break down by month"
> π See WORKFLOWS.md and COMMANDS.md for complete workflows, command reference, and best practices