用途：通过命令行调用阿里云瑶池 Data Agent for Analytics，用自然语言对企业数据库进行需求分析、数据理解、分析洞察及报告生成。
主要能力：统一 CLI（data_agent_cli.py）完成“发现数据→发起分析→跟踪进度→获取结果”。子命令包括 ls（列出 Data Center 中数据库与表）、db（连接数据库发起分析）、file（上传或分析数据中心文件，支持 --file-id）、attach（复用会话继续对话或断点续传）、dms（发现 DMS 数据）、import（将 DMS 数据库导入 Data Center）、reports（查看/下载报告与图表）。
关键前提：只能分析已导入 Data Agent Data Center 的数据库；DMS 中注册的数据库不等于 Data Center 中的数据库，需先 ls 检查，无则用 dms 搜索、import 导入后再用 db 分析。
分析模式：db/file 通过 --session-mode 指定。ASK_DATA（默认）即问即答、秒级响应、同步执行；ANALYSIS 深度分析，耗时 5-40 分钟，建议 spawn 子 Agent 后台执行，状态包括 waiting_input（等待确认）、completed、failed。
使用方式：先配置凭证与地域，检查或写入 ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET，文件分析场景可用 DATA_AGENT_API_KEY；同时配置时优先 AK/SK。需配置 DATA_AGENT_REGION，并确保 RAM 用户具有 AliyunDMSFullAccess 或 AliyunDMSDataAgentFullAccess。可用 assets/example_game_data.csv 体验。常用命令：python3 dms-data-agent/data_agent_cli.py ls；db --dms-instance-id <ID> --dms-db-id <ID> --instance-name <NAME> --db-name <DB> --tables "t1,t2" -q "谁的销售额最高"；attach --session-id <ID> -q "按月分解"；file --file-id ... -q "数据概览"。调试可设 DATA_AGENT_DEBUG_API=1。
限制：会话有效期 6 小时，超时需重新发起；会话状态存放在 sessions/{session_id}/（status.txt、progress.log、checkpoint.txt、result.json 等）；避免重复创建新会话，应使用 attach 复用。费用、价格与平台支持等暂未提供。