N8n Workflow Patterns 说明文档

# n8n 工作流模式 构建 n8n 工作流的成熟架构模式。 --- ## 目的 教授构建 n8n 工作流的架构模式。提供结构、最佳实践以及针对常见用例的成熟方法。 ## 激活条件 - 构建工作流 - 工作流模式 - 工作流架构 - 工作流结构 - Webhook 处理 - HTTP API - API 集成 - 数据库同步 - AI 智能体 - 聊天机器人 - 定时任务 - 自动化模式 ## 文件数量 7 个文件，总计约 3,700 行 ## 优先级 **高** - 解决了 813 次 Webhook 搜索（最常见的用例） ## 依赖 **n8n-mcp 工具**： - search_nodes (查找模式节点) - get_node_essentials (理解节点操作) - search_templates (查找示例工作流) **相关技能**： - n8n MCP 工具专家 (查找和配置节点) - n8n 表达式语法 (在模式中编写表达式) - n8n 节点配置 (配置模式节点) - n8n 验证专家 (验证模式实现) ## 覆盖范围 ### 5 大核心模式 1. **Webhook 处理** (最常见 - 813 次搜索) - 接收 HTTP 请求 → 处理 → 响应 - 关键陷阱：数据位于 $json.body 下 - 身份验证、验证、错误处理 2. **HTTP API 集成** (892 个模板) - 从 REST API 获取 → 转换 → 存储/使用 - 身份验证方法、分页、速率限制 - 错误处理和重试 3. **数据库操作** (456 个模板) - 读取/写入/同步数据库数据 - 批处理、事务、性能 - 安全性：参数化查询、只读访问 4. **AI 智能体工作流** (234 个模板，270 个 AI 节点) - 具备工具访问权限和记忆的 AI 智能体 - 8 种 AI 连接类型 - 任何节点都可以是 AI 工具 5. **定时任务** (占所有工作流的 28%) - 循环自动化工作流 - Cron 计划、时区处理 - 监控和错误处理 ### 跨领域关注点 - 数据流模式（线性、分支、并行、循环） - 错误处理策略 - 性能优化 - 安全最佳实践 - 测试方法 - 监控和日志记录 ## 评估 5 个场景（预期 100% 覆盖）： 1. **eval-001**: Webhook 工作流结构 2. **eval-002**: HTTP API 集成模式 3. **eval-003**: 数据库同步模式 4. **eval-004**: 带有工具的 AI 智能体工作流 5. **eval-005**: 定时报告生成 ## 关键特性 ✅ **5 种成熟模式**：Webhook、HTTP API、数据库、AI 智能体、定时任务 ✅ *