【Alix】Agent执行故障诊断助手
产品介绍
# Agent执行故障诊断助手 > 帮你从 Agent、Workflow 和多智能体任务的运行记录中，还原执行过程，找到最早出现且有日志证据支持的故障点。 ## 这是什么 Agent运行失败时，最终界面往往只显示“执行失败”“任务终止”或一段错误信息，但真正的问题可能更早已经发生： - 某个工具调用超时； - 调用了工具，却没有收到返回结果； - 一个 Agent 把任务交给另一个 Agent，但对方没有回执； - 中间步骤已经失败，最终状态却仍然显示成功； - 日志缺少关键字段，现有材料不足以判断原因。 Agent执行故障诊断助手会整理这些运行记录，尽量回答三个问题： 1. 实际执行到了哪里？ 2. 最早从哪个事件开始出现异常？ 3. 这个结论是日志明确记录的，还是根据链路缺口推断的？ ## 有什么用 它可以帮助你： - 还原 Agent 或工作流的关键执行顺序； - 定位明确失败、工具超时和异常重试； - 发现工具调用无返回、交接无回执和父事件缺失； - 识别“最终显示成功，但中间实际存在异常”的情况； - 区分已确认故障、疑似断点和证据不足； - 告诉你还缺少哪些日志，下一步应该补查什么。 它尤其适合： - 正在搭建或调试 Agent、Workflow 的用户； - 使用 Coze、Dify、n8n、OpenClaw、LangGraph 等工具的人； - 需要检查多 Agent 协作、工具调用和节点执行的人； - 负责 AI 应用测试、验收或故障复盘的人。 ## 怎么使用 ### 方法一：直接交给支持 Skill 的 Agent 安装完整 Skill 后，上传或粘贴运行日志，然后输入： ```text 请使用 Agent执行故障诊断助手分析这份运行记录。 还原关键执行链，找出最早且有证据支持的故障点， 并区分已确认故障、疑似断点和证据不足。 ``` 支持的常见材料包括： - JSON、JSONL、NDJSON、CSV 日志； - 工具调用与返回记录； - 节点执行记录； - 多 Agent 交接记录； - 带时间、事件编号和状态的文字化运行轨迹。 如果暂时没有完整日志，也可以先提供现有错误记录。材料不足时，它会告诉你最少还需要补充什么，而不是凭空猜测原因。 ### 方法二：本地运行诊断脚本 电脑安装 Python 3 后，在 Skill 根目录运行： ```bash python scripts/diagnose_trace.py sample.json --output diagnosis.json --markdown diagnosis.md ``` 运行后会生成： - `diagnosis.json`：机器可读结果； - `diagnosis.md`：便于人工查看的诊断报告。 脚本只使用 Python 标准库，不需要额外安装第三方依赖。 ## 简单例子 假设一段运行记录显示： ```text 10:00:00 Agent开始执行订单查询任务 10:00:01 Agent调用 order_api 10:01:01 order_api返回 timeout 10:01:02 整个任务标记为 failed ``` 普通错误提示可能只告诉你“任务失败”。 使用本 Skill 后，合理的诊断结果会是： ```text 总体状态：failed 最早故障点：order_api 返回 timeout 的事件 结论级别：已确认故障 判断理由：日志明确记录工具调用超时 说明：最后的任务失败是后续结果，不是最早根因。 下一步：检查 order_api 的响应时间、网络状态和超时设置，并在修复后重新运行。 ``` 它的重点不是重复最后一句“任务失败”，而是向前找到最早出现异常的位置，并说明证据是否足够。 ## 诊断结果怎么看 报告通常包含六部分： 1. **总体判断**：运行正常、存在异常、已确认失败或无法判断； 2. **关键时间线**：与判断有关的主要事件； 3. **问题清单**：异常类型、严重程度和对应事件； 4. **最早故障点**：最早可定位的位置和判断理由； 5. **证据缺口**：还缺少哪些材料； 6. **下一步建议**：一至三项可以继续验证的动作。 需要注意： > “日志里没有观察到”不等于“绝对没有发生”。 诊断结论只覆盖现有运行记录能够证明的范围。 ## 它不做什么 这份 Skill 不负责： - 自动接入所有 Agent 平台并实时监控； - 判断 Agent 生成的业务内容是否正确； - 在没有日志的情况下猜测故障原因； - 自动修改工作流、修复代码或执行回滚； - 替代专业监控系统或法律取证。 它提供的是一个有证据、有边界的排障起点，而不是万能故障修复器。 ## 隐私提醒 运行日志可能包含 API Key、Token、Cookie、用户信息、内部接口和业务数据。提交日志前请先人工脱敏。 脚本能够遮蔽部分常见凭证样式并截断过长错误摘要，但不能代替人工检查。测试时请使用假凭证，不要上传真实密钥。
资源信息
许可证信息摘自官方源，可能过时或缺失。商用前请以原仓库的 LICENSE 文件为准。
信息边界说明
本页信息摘自官方文档，仅作技术信息呈现，不代表本站的判断或推荐。价格、配额、可用性以官方最新说明为准。你离开本站后的任何行为（申请 Key、付费、部署、商用），本站不做任何承诺与担保。
同类推荐
Agent Browser
官方未说明用于 AI 代理的浏览器自动化 CLI。当用户需要与网站交互（包括浏览页面、填写表单、点击按钮、截图等）时使用。
Find Skills
需申请 Key帮助用户发现和安装智能体技能，当用户询问如「如何做X」、「找X的技能」、「有能做...的吗」等问题时
self-improving agent
官方未说明记录自身发现以实现自我改进的技能
Agent Browser
官方未说明用于 AI 代理的浏览器自动化 CLI。当用户需要与网站交互（包括浏览页面、填写表单、点击按钮、截图等）时使用。
WorkBuddy签到助手
官方标注收费需申请 KeyWorkBuddy签到助手（WorkBuddy「Buddy 加油站」每日签到自动化 Skill，接口直签，跨平台 Windows/macOS/Linux）。当用户说"每天自动签到 / 每日签到 / 自动领 Buddy 加油站积分 / 现在签个到 / 帮我签到一次 / WorkBuddy 打卡 / 检查签到环境 / 派猫猫旅行 / 猫猫旅行 / 领旅行奖励 / 自动派猫猫 / Buddy 在旅行吗 / 推送签到结果 / 签到通知发钉钉 / 客户端更新后签不了 / 5.6.2 签到失败 / 登录态加密了 / Mac 上签不了 / 需要授权 / 长效令牌 / refreshToken / 不开客户端签到 / 令牌自动续期"时使用。三通道自动择一：本机登录态可用（如 Windows）零配置直签；无法本地解密（如 macOS）走一次性网页授权；或一次性保存长效令牌后自动续期，客户端不开也能签。支持派猫猫旅行全自动闭环（先领后派）、桌面通知与 12 类渠道推送（钉钉/飞书/企业微信/微信等），对齐 totorosir-push-message，可设每日 09:00 自动签到。
Proactive Agent
免费增值需申请 Key将 AI 代理从任务执行者转变为能够预见需求、持续优化的主动伙伴。现已支持 WAL Protocol、Working Buffer、Autonomous Crons 及经过实战验证的模式。属于 Hal Stack 🦞。
什么是技能
技能（Skill）是封装好的单项能力，比如文字识别、文档摘要、关键词提取。开发者把调用逻辑和提示词打包，使用者像用插件一样加载即可，无需了解底层模型。启枢技能 收录大量技能，可直接试跑或编入方案。