SuperAPI AI 工具集

diagnose-flow

通用与其它

查看项目

更新于 10-16 06:47

技能介绍

用途:diagnose-flow 是一个自主诊断代理技能,针对某次失败的流运行做全面故障分析。使用前需提供环境 ID、流 ID 和运行 ID,适用于用户要求诊断或深入排查特定运行失败时。

主要能力:先用 diagnose_run 做分类诊断,列出失败或超时的操作及对应修复建议;再并行获取整体运行状态、操作级执行轨迹和流定义上下文。对失败的循环,可用 get_run_action_repetitions 定位失败迭代。需要载荷证据时,用 includeSizes: true 请求操作内容,再按 which: "inputs" 或 "outputs" 获取单个操作内容,默认上限 256000 字节,超限内容只报告不转储。

分析流程:构建执行图,映射各操作的 runAfter 依赖并识别并行分支;筛选状态非 Succeeded 的操作,区分根失败(依赖均成功但自身失败)与级联跳过(因依赖失败被跳过);对每个根失败匹配常见模式,如授权/连接错误、表达式求值失败、外部服务 HTTP 4xx/5xx、超时、参数校验失败、操作类型不匹配等;再与流定义交叉核对参数、连接引用和表达式。最终输出诊断报告,含执行时间线、根因、具体修复及代码改动、置信度(高/中/低)。若修复属于定义变更,可用 edit_flow 做单操作或单参数的精准修改,大范围重写才回退到 update_flow。

依赖与限制:该技能依赖 FlowAgent MCP 工具,在 Claude Code 中显示为 mcp__flowagent__<tool>,在 Copilot CLI 中为 flowagent-<tool>;若未检测到 MCP 工具,说明插件未接入,需先运行 setup 技能。重复结果中 count 是返回数量而非总数,truncated: true 表示证据不完整。仅应获取必要载荷,并在报告中省略敏感值。其他收费、平台或效果信息暂未提供。