SuperAPI AI 工具集

debugging-executions

部署与运维

查看项目

更新于 10-16 01:33

技能介绍

用途:调试 n8n 中执行失败或成功但输出错误、参数为空的运行。当用户报告工作流仍失败时,需用 executions(action="run") 或 verify-built-workflow 复现失败路径并查看真实结果,不得仅凭重述宣称已修复。

版本区分:已发布工作流运行的是发布版而非草稿。executions(action="list", workflowId) 每行返回 workflowVersionId、workflow.activeVersionId 与 workflow.draftVersionId;只有版本号与发布版一致的行才跑的是线上代码。修复后需发布才能真正上线,上线后需新的运行来确认。

失败排查:executions(action="debug") 含 failedNode.resolvedParameters,包括 parameters(原始)、resolved(替换后)、failedExpressions 与 emptyResolutions。标记 reason: "unreconstructable-context" 的并非真实缺陷。要验证节点修复,可用 executions(action="run-step", workflowId, nodeName, reuseExecutionId=<失败执行>) 复用真实输入重跑该节点。

安全前提:run-step 是真实运行,会使用真实凭证与数据。读操作(get、getAll、search、list、download、GET 请求)或工作流内转换(Set、IF、Filter、无网络或文件访问的 Code)可运行;写操作(create、update、upsert、delete、send、append、非 GET 请求)不要真实运行,不确定时按写操作处理,改用 debug 与 get-resolved-node-parameters 排查。

mockInput:可只针对单个节点提供输入,用于探测空列表、缺字段等边界情况,或区分节点本身错误与上游输入错误;但 mock 运行不能证明整条链路结果,且不使写节点变安全。

工具运行:工具须经拥有它的节点(通常是 Agent)运行。mockInput 提供 Agent 输入而非工具参数;工具参数用 toolArguments 传入,取自 $fromAI。声明 $fromAI 参数的工具缺少参数会被拒绝;持有多个工具的节点与子节点(模型、记忆、嵌入)不能这样直接运行。

成功但值错误:调用 executions(action="get-resolved-node-parameters", executionId, nodeName),优先检查 emptyResolutions,多数空参数是表达式解析为 null/undefined/""。

限制:不编造功能;触发型工作流测试需匹配触发器输出结构。