Alibabacloud Data Agent Skill — Alibabacloud 数据代理技能

元数据： 作者：DataAgent Team 版本： "1.7.2" 更改日志 v1.7.2：使用阿里云默认凭证链替代显式 AK/SK，添加 User-Agent 头，修复 RAM 策略通配符问题 v1.7.1：修复 CLI ls 命令 API 响应解析（支持大小写不敏感的字段名称），优化 SKILL 文档结构，分离 ANALYSIS 模式规范文档 v1.7.0：支持 API_KEY 身份验证，原生异步执行模式，会话隔离，增强的附加模式，优化日志输出

安装 配置凭证 本 SKILL 使用阿里云默认凭证链（推荐）或 API_KEY 身份验证。 选项 1：默认凭证链（推荐） SKILL 使用阿里云 SDK 的默认凭证链自动获取凭证，支持环境变量、配置文件、实例角色等。 请参阅阿里云凭证链文档 选项 2：API_KEY 身份验证（仅文件分析） export DATA_AGENT_API_KEY=你的-api-key export DATA_AGENT_REGION=cn-hangzhou 获取 API_KEY：Data Agent 控制台 权限要求 RAM 用户需要 AliyunDMSFullAccess 或 AliyunDMSDataAgentFullAccess 权限。 请参阅 RAM-POLICIES.md 获取详细的权限信息。

调试模式 DATA_AGENT_DEBUG_API=1 python3 scripts/data_agent_cli.py file example.csv -q "analyze" 💡 入门提示 使用内置的 demo 数据库 internal_data_employees（DataAgent 的内置测试数据库，包含员工、部门和工资数据）进行第一次体验 或使用本地文件 assets/example_game_data.csv 进行文件分析体验

Data Agent CLI —— 统一的命令行数据分析工具 概述 scripts/data_agent_cli.py 帮助用户完成从发现数据到启动分析、跟踪进度、获取结果的整个工作流程。 核心概念 ⚠️ 关键前提：Data Agent 只能分析已导入到 Data Agent 数据中心的数据库。 数据中心：Data Agent 的数据中心，只有这里的数据库才能被分析 DMS：阿里云数据管理服务，存储所有数据库的元数据 关系：在 DMS 中注册的数据库 ≠ 数据中心中的数据库 使用流程： 首先使用 ls 命令检查目标数据库是否存在于数据中心 如果未找到，使用 dms 子命令搜索数据库信息，然后使用 import 子命令导入它 导入成功后，可以使用 db 子命令进行分析

分析模式 ASK_DATA（默认）：同步执行，亚秒级响应，适合快速 Q&A ANALYSIS：深度分析，需要 5-40 分钟，需要生成子代理进行异步执行或使用 --async-run 参数 请参阅 ANALYSIS_MODE.md 获取详细信息

会话复用 使用 db/file 创建一个会话进行初始分析，然后使用 attach --session-id 复用会话进行后续问题。 请参阅 COMMANDS.md 和 WORKFLOWS.md 获取详细信息

快速入门 # 1. 列出可用的数据库 python3 scripts/data_agent_cli.py ls # 2. 查询分析（同步响应） python3 scripts/data_agent_cli.py db \ --dms-instance-id --dms-db-id \ --instance-name --db-name \ --tables "employees,departments" -q "哪个部门的平均工资最高" # 3. 后续问题（复用会话） python3 scripts/data_agent_cli.py attach --session-id -q "按月分解"

📖 请参阅 WORKFLOWS.md 和 COMMANDS.md 获取完整的工作流程、命令参考和最佳实践

项目结构 # SKILL 根目录 ├── SKILL.md # 本文档 ├── scripts/ # 源代码 │ ├── data_agent/ # SDK 模块 │ ├── cli/ # CLI 模块 │ ├── data_agent_cli.py # CLI 入口点 │ └── requirements.txt # 依赖 ├── sessions/ # 会话数据 └── references/ # 参考文档