n8n 工作流自动错误分析与 AI 修复建议

用 Error Trigger 捕获失败 → 调用 n8n API 获取工作流结构 → 经 OpenRouter 交给 AI Agent 分析根因与修复步骤 → 转换为 HTML 邮件通过 Gmail 发出

给谁

使用 n8n 搭建自动化流程、需要监控生产环境故障的运营人员或开发者

你会得到

当任意被监控的 n8n 工作流在生产执行中失败时，自动收到包含 AI 根因分析与逐步修复建议的邮件通知

你需要

n8n · gmail

步骤

1. 准备环境与凭证

   在 n8n 实例中完成以下前置配置：1) 进入 Settings > API 生成 API Key，备用；2) 确保实例已设置 N8N_EDITOR_BASE_URL 环境变量（值为编辑器根 URL，如 https://your-n8n.example.com）；3) 注册 OpenRouter 账号并获取 API Key；4) 准备 Gmail 账号用于 OAuth2 授权发信；5) 确认发件目标邮箱地址。

2. 导入模板并确认 Error Trigger

   从 n8n 模板市场导入本模板。工作流第一个节点为 Error Trigger，它是入口节点：当实例中其他工作流在生产执行中失败时自动激活。该节点无需额外参数配置。

3. 配置 Get Workflow JSON 节点

   打开「Get Workflow JSON」节点（HTTP Request 类型）。URL 已预置表达式：={{`${$env.N8N_EDITOR_BASE_URL}/api/v1/workflows/${$json.workflow.id}`}}。在 Credentials 中选择或新建「Generic Credential」类型为 httpHeaderAuth，Header Name 填 X-N8N-API-KEY，Value 填入你的 n8n API Key。Response Format 保持 JSON。

   搭建指导 · 来源原文。Get Workflow JSON 节点的 Headers 配置；Generic Credential 的 httpHeaderAuth

   复制提示词

   **Name:** `X-N8N-API-KEY`
   **Value:** API-KEY

4. 配置 Debugger Agent 与 AI 模型

   打开「Debugger Agent」节点（AI Agent 类型），promptType 为 define。在 Model 连接中选择「Gemini 2.5 Pro」（OpenRouter Chat Model），并在该模型节点的 Credentials 中配置 openRouterApi。然后填入以下提示词：

   运行提示词 · 来源原文。Debugger Agent 节点的 Text（用户提示词）字段

   复制提示词

   =A workflow has failed. Here is the data:
   
   ## Error Details
   - **Workflow Name:** {{ $json.name }}
   - **Failed Node Name:** {{ $('Error Trigger').item.json.execution.error.node.name }}
   - **Failed Node Type:** {{ $('Error Trigger').item.json.execution.error.node.type }}
   - **Error Message:** {{ $('Error Trigger').item.json.execution.error.message }}
   
   ## Full Workflow Structure (JSON)
   
   {{ JSON.stringify($('Get Workflow JSON').item.json) }}
   
   ---
   
   Based on all the information above, please provide the following in markdown format:
   
   ### Root Cause Analysis:
   A brief explanation of what likely caused this specific error in the context of the workflow. Analyze the failed node and the nodes that feed data into it.
   
   ### Suggested Fix:
   Provide clear, step-by-step instructions on how to fix the issue in the n8n editor. Be specific. For example, if it's a rate limit, suggest adding a "Wait" node. If it's a data mapping error, explain which expression is likely wrong.

   运行提示词 · 来源原文。Debugger Agent 节点的 System Message 字段

   复制提示词

   =You are an expert n8n automation developer and debugger. Your task is to analyze a workflow error and provide a clear, actionable diagnosis and solution. Do not be conversational; provide the analysis directly in markdown.

5. 配置邮件格式与发送

   打开「Convert Markdown To HTML」节点，mode 保持 markdownToHtml，markdown 字段填入 ={{ $json.output }}，destinationKey 为 responseHtml。然后打开「Send Debugging Email」节点（Gmail 类型）：在 sendTo 填入你的收件邮箱；subject 使用表达式 =N8N Automation Error (Workflow: {{ $('Get Workflow JSON').item.json.name }}); message 保持模板中的 HTML 表达式，其中包含失败执行的直接链接、错误节点名称与类型、错误消息，以及 AI 分析结果 {{ $json.responseHtml }}。在 Credentials 中配置 gmailOAuth2。

6. 绑定目标工作流并激活

   对每个需要监控的工作流：1) 打开该目标工作流；2) 点击右上角「⋯」选择 Settings；3) 在 Error Workflow 下拉菜单中选择本「AI-Powered Workflow Debugger & Notifier」工作流；4) 点击 Save；5) 确保目标工作流处于 Active（激活）状态。注意：Error Trigger 仅在自动执行（如 Webhook、定时触发）失败时触发，手动测试不会触发。

你是一个 n8n 自动化调试助手搭建向导。用户将导入一个模板，用于在 n8n 工作流生产执行失败时自动进行 AI 分析并发送邮件。请按以下顺序协助用户：1) 确认 n8n 实例、N8N_EDITOR_BASE_URL、API Key、OpenRouter Key、Gmail OAuth2 是否就绪；2) 指导导入模板并核对 Error Trigger → Get Workflow JSON → Debugger Agent → Convert Markdown To HTML → Send Debugging Email 的节点连接；3) 协助填入 Debugger Agent 的提示词与模型凭证；4) 指导在目标工作流的 Settings > Error Workflow 中绑定本调试工作流并激活。不要替用户生成或发送任何凭证。