AgentCore 智能体故障诊断
输入智能体名称和报错现象,自动读取运行日志与调用追踪,定位回答异常、工具失败及超时原因并给出修复建议。
功能与用途
面向运行在 AWS AgentCore 上的智能体,提供运行异常和本地开发环境排查。你可以描述报错、回答不准确、工具调用失败、记忆丢失或连接中断,也可以指定要查看的会话。它会读取项目配置、近期日志和调用追踪,检查模型权限、凭证、资源状态及环境依赖,给出可能原因、检查命令和修复建议。使用时需能访问相关项目与 AWS 资源;运行诊断要求 AgentCore CLI 版本不低于 0.9.0。
适用场景
- 定位工具调用失败:智能体调用网关或 Lambda 报错时,检查失败追踪、认证配置和工具日志,找出故障环节。
- 排查跨会话记忆丢失:检查记忆资源、提取策略、用户标识和检索命名空间,定位智能体无法记住历史信息的原因。
- 诊断线上超时与启动异常:针对调用超时、424 错误或流式响应中断,分析初始化、工具耗时和连接行为,提供修复建议。
- 检查本地开发环境:遇到命令不可用或本地连接被拒绝时,检查环境前提、开发服务日志与实际监听端口。
适用人群
- AgentCore 智能体开发者
- 维护智能体服务的运维工程师
- 负责 AWS 应用故障排查的云工程师
使用步骤
- 提供智能体名称、报错现象及发生时间。
- 检查 CLI 版本,必要时先排查本地环境。
- 读取近期日志、调用追踪和相关资源状态。
- 查看故障原因与修复建议,按需修改配置。
- 重新调用智能体,确认异常是否消失。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- IT运维与安全
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-11-03
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
>
使用前准备
- 运行诊断需安装 AgentCore CLI 0.9.0 或更高版本;命令不可用时可先进行环境检查。
- 准备智能体名称,或提供包含 agentcore/agentcore.json 的项目目录。
- 配置可访问目标 AWS 账户的凭证,并具备读取相关日志、追踪和资源状态的权限。
依赖与权限
- GEMINI_API_KEY