用途:该技能用于调用阿里云 STAROps Agent,通过 STAROps OpenAPI 获取流式诊断回答,适合排查服务错误或异常、做根因分析、查询工作区拓扑与服务列表或指标、分析 APM 链路与错误率/延迟/请求量、告警分诊与事件调查,以及就 STAROps 工作区或服务提问。
主要能力:直接调用 STAROps OpenAPI 的 CreateThread(POST /digitalEmployee/{employeeId}/thread)与 CreateChat(POST /chat),以流式方式返回诊断过程与结论。
配置:脚本从环境变量和可选 JSON 配置文件读取连接信息,环境变量与命令行参数覆盖配置文件。配置文件加载顺序为用户配置 ~/.starops/config.json、项目配置 ./.starops/config.json(覆盖用户配置)、显式配置 --config <path> 或 STAROPS_AGENT_CONFIG(覆盖前两者)。必填三项为 employeeId、workspace、uid,可来自环境变量或配置文件,对应 STAROPS_AGENT_EMPLOYEE、STAROPS_AGENT_WORKSPACE、STAROPS_AGENT_UID;可选有 STAROPS_AGENT_ENDPOINT(默认 starops.cn-beijing.aliyuncs.com)、STAROPS_AGENT_PROJECT、STAROPS_AGENT_TIMEOUT(默认 1800)、STAROPS_AGENT_IDLE_TIMEOUT(默认 60)、STAROPS_AGENT_CONFIG。配置键名须与文档一致,不可使用别名。凭据使用阿里云凭据默认链,不定义技能专用 AccessKey 变量。
使用方式:先安装依赖 pip3 install -r scripts/requirements.txt,再在技能根目录运行。首次调用 python3 scripts/call_starops_agent.py --question "<完整用户上下文>" --pipe 会自动创建线程;后续追问必须复用线程 python3 scripts/call_starops_agent.py --thread "<thread_id>" --question "<追问>" --pipe。--pipe 为强制参数,输出含 THREAD、STAROPS_URL 与答案分隔块;--json 与 --pipe 互斥,不用于智能体调用。
限制:调用为长耗时设计,单次 CreateChat 可能包含多个内部诊断步骤,默认超时 30 分钟;若长时间无 SSE 事件会以空闲超时错误失败。该技能用于智能体推理与诊断,不用于直接资源管理,ECS、OSS、RDS、SLS、RAM 变更应使用对应官方 CLI、SDK 或专用技能。最终报告必须基于 STAROPS ANSWER BEGIN/END 之间的实际内容,不得编造诊断结论;若回答为空或不完整,可用同一线程重试一次,仍无有效数据则如实说明。所有请求需使用 User-Agent 模板 AlibabaCloud-Agent-Skills/alibabacloud-starops-chat/{session-id},每次调用生成一个 32 位十六进制 session-id 并在本次调用的所有请求中保持一致。常见错误包括 401 凭据或权限问题、404 员工 ID/工作区/UID 不匹配、配置缺失、凭据链无有效来源、空闲超时、流中断和依赖未安装。