用途:面向阿里云 SLS(Simple Log Service),把口语化的数据问题转成分析任务,自动定位并拉取项目内日志、指标等数据,完成清洗、聚合、转换、统计、趋势与异常分析,并生成图表和结构化结论报告。
主要能力:自然语言理解;数据获取;数据处理;数据分析;可视化。会话由“数字员工”(agentId)处理,可用 --digital-employee 指定,优先级为参数 > SLS_DATA_AGENT_EMPLOYEE 环境变量 > 脚本默认 apsara-ops。可用 --skill 选择内置技能:builtin.sls.sls-sql-generation(SQL 生成)、builtin.sls.spl-generation(SPL 生成)、builtin.sls.sls-loongcollector(LoongCollector 采集运维)、builtin.sls.sls-visualization(仪表盘助手);省略则用通用能力。--logstore 指定目标 logstore 以限定数据源范围。
使用方式:需设置 SLS_DATA_AGENT_PROJECT、SLS_DATA_AGENT_REGION(必填),可选 SLS_DATA_AGENT_EMPLOYEE、SLS_DATA_AGENT_LOGSTORE、SLS_DATA_AGENT_SKILL。凭证走阿里云 Credentials SDK 默认链(STS / RAM 角色 / CLI profile ~/.aliyun/config.json / 环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID+ALIBABA_CLOUD_ACCESS_KEY_SECRET)。先执行 pip3 install -r scripts/requirements.txt,再运行 python3 scripts/call_sls_data_agent.py --logstore my_logstore --question "<完整数据分析请求>" --pipe;追问时用 --thread "<thread_id>" 复用上下文。--pipe 为必需,保证 stdout 输出 THREAD 行与 === DATA AGENT ANSWER BEGIN/END === 分隔符。
限制与注意:单次会话可能触发多步内部分析,耗时数分钟,默认超时 30 分钟;应在一次提问中给出项目、时间范围、目标 logstore/字段、待分析指标与期望图表或结论形式;追问务必复用 --thread,否则丢失上下文;结论须基于 BEGIN/END 之间真实返回,不得编造,为空可同 --thread 重试一次,仍为空则说明无有效数据。常见错误:401/403 凭证或授权问题;404 数字员工或项目不存在;ConfigError 缺少必填配置;CredentialError 无有效凭证源;空闲超时;ModuleNotFoundError 需先安装依赖。API 端点默认 starops.cn-beijing.aliyuncs.com,可用 SLS_DATA_AGENT_ENDPOINT 覆盖,采用 ACS3-HMAC-SHA256 签名。