用途：诊断 AgentCore 代理或环境为何无法正常工作，适用于代理返回错误或错误答案、工具调用失败或超时、本地正常但部署后失败、CloudWatch 无日志、AgentCore CLI 异常或环境损坏、agentcore 命令找不到或缺少前置条件等场景。不适用于部署失败（用 agents-deploy）、新建项目脚手架（用 agents-get-started）、质量度量与监控（用 agents-optimize）。
主要能力：支持交互式描述问题，也支持 traces、logs、memory、doctor 等子命令；自动读取 traces 与日志而非要求开发者粘贴；按症状分类诊断，包括模型访问被拒、工具调用失败、答案错误、记忆不生效、代理超时、maxVms 配额超限、424 Failed Dependency、本地连接被拒、网关鉴权错误、无 traces、CloudWatch 日志缺失等。
必要用法：先运行 agentcore --version，要求 v0.9.0 或以上，旧版本需先 agentcore update。常用命令包括 agentcore traces list --runtime <AgentName> --since 1h、agentcore traces get <traceId> --runtime <AgentName>、agentcore logs --runtime <AgentName> --since 1h --level error、agentcore status --type gateway、agentcore status --type memory、agentcore status --type credential。CLI 自身问题加载 references/doctor.md。
限制与注意：CloudWatch 写入到可读延迟约 10 秒，建议等待约 15 秒再读 trace 或 eval；本地 dev 默认端口 HTTP 8080、MCP 8000、A2A 9000，被占用时会自动递增，需以 CLI 横幅为准；Docker/Container 构建需用 opentelemetry-instrument 包装入口，否则日志不出现；记忆提取为异步，需等待 5–30 秒，session ID 需为至少 33 字符的 UUID v4。资料未提供收费、价格与平台支持范围等信息。