【Alix】Agent执行故障诊断助手
Introduction
# 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、用户信息、内部接口和业务数据。提交日志前请先人工脱敏。 脚本能够遮蔽部分常见凭证样式并截断过长错误摘要，但不能代替人工检查。测试时请使用假凭证，不要上传真实密钥。
Resource Information
License information is collected from official sources and may be outdated or missing. Refer to the LICENSE file in the original repository before commercial use.
Information boundary
Information on this page is collected from official documents for technical presentation only and does not imply our endorsement. Pricing, quotas and availability are subject to the latest official statements. We make no commitment regarding any action you take after leaving this site.
Similar skills
Agent Browser
Not specified用于 AI 代理的浏览器自动化 CLI。当用户需要与网站交互（包括浏览页面、填写表单、点击按钮、截图等）时使用。
Find Skills
API key required帮助用户发现和安装智能体技能，当用户询问如「如何做X」、「找X的技能」、「有能做...的吗」等问题时
self-improving agent
Not specified记录自身发现以实现自我改进的技能
Agent Browser
Not specified用于 AI 代理的浏览器自动化 CLI。当用户需要与网站交互（包括浏览页面、填写表单、点击按钮、截图等）时使用。
WorkBuddy签到助手
Marked paidAPI key requiredWorkBuddy签到助手（WorkBuddy「Buddy 加油站」每日签到自动化 Skill，接口直签，跨平台 Windows/macOS/Linux）。当用户说"每天自动签到 / 每日签到 / 自动领 Buddy 加油站积分 / 现在签个到 / 帮我签到一次 / WorkBuddy 打卡 / 检查签到环境 / 派猫猫旅行 / 猫猫旅行 / 领旅行奖励 / 自动派猫猫 / Buddy 在旅行吗 / 推送签到结果 / 签到通知发钉钉 / 客户端更新后签不了 / 5.6.2 签到失败 / 登录态加密了 / Mac 上签不了 / 需要授权 / 长效令牌 / refreshToken / 不开客户端签到 / 令牌自动续期"时使用。三通道自动择一：本机登录态可用（如 Windows）零配置直签；无法本地解密（如 macOS）走一次性网页授权；或一次性保存长效令牌后自动续期，客户端不开也能签。支持派猫猫旅行全自动闭环（先领后派）、桌面通知与 12 类渠道推送（钉钉/飞书/企业微信/微信等），对齐 totorosir-push-message，可设每日 09:00 自动签到。
Proactive Agent
FreemiumAPI key required将 AI 代理从任务执行者转变为能够预见需求、持续优化的主动伙伴。现已支持 WAL Protocol、Working Buffer、Autonomous Crons 及经过实战验证的模式。属于 Hal Stack 🦞。
What is a Skill
A Skill is a packaged single capability, such as text recognition, document summarization, or keyword extraction. Developers wrap the calling logic and prompts into a plugin-like unit, so users can load it without understanding the underlying model. StackPilot indexes a large number of skills that can be tried instantly or assembled into a plan.