用途:当用户报告或描述运维问题且需要深度异步分析(约 5–8 分钟)时,使用本技能在 AWS DevOps Agent 上执行根因调查。若只是快速询问成本、架构或拓扑,应改用 chatting-with-aws-devops-agent 技能。
主要能力:发起调查并返回 taskId、executionId;轮询任务状态;按 ASC/DESC 拉取 journal 记录避免重复获取;获取推荐及详细缓解方案;汇总发现(PLANNING、SEARCHING、ANALYSIS、FINDING、ACTION、SUMMARY、SUGGESTION)并以进度更新形式反馈。
必要用法:先做 pre-flight,收集服务身份(package.json、pom.xml、Cargo.toml、requirements.txt、Makefile)、git log --oneline -10、git diff --stat;排查错误时附加完整堆栈或日志片段、相关 IaC 文件。调用 aws_devops_agent__investigate(title=...) 启动,保存 taskId 与 executionId。每 30–45 秒用 aws_devops_agent__get_task(task_id="TASK_ID") 查状态,用 aws_devops_agent__list_journal_records(execution_id="EXEC_ID", order="ASC") 取新发现,并利用 next_token 只取增量。完成后用 list_journal_records(order="DESC", limit=10)、list_recommendations(task_id="TASK_ID")、get_recommendation(recommendation_id="REC_ID") 获取结论。SigV4 多空间场景需先调用 multi-space orchestration 技能确定 agent_space_id,并在所有调用中传入;bearer token 无需此步。
回退路径:远端 MCP 不可用时改用 aws-mcp,命令包括 aws devops-agent create-backlog-task --agent-space-id SPACE_ID --task-type INVESTIGATION --title '...' --priority HIGH --description '...' --region us-east-1,随后用 get-backlog-task 与 list-journal-records 轮询并告知用户已切换直连 AWS API。
限制与安全:建议中的命令或代码一律不得自动执行,必须展示并说明后由用户明确批准;若推荐含 CDK/CFN/Terraform 变更,只在本地生成 diff 供审阅。CREATED 超 60 秒、早期记录为空属正常;FAILED 时仍可呈现部分发现;10 分钟无进度应提示可能停滞。其他细节见 REFERENCE.md。