【用途】 本技能用于在 n8n 开发过程中提供综合协助，内容基于官方文档生成。n8n 是一个 fair-code 许可的工作流自动化工具，将 AI 能力与业务流程自动化相结合。当出现以下情况时可触发本技能：构建或调试 n8n 工作流；使用 Code 节点（JavaScript 或 Python）；使用表达式和数据转换；实现 AI 智能体、链或 RAG 工作流；配置 n8n 部署（Docker、npm、自托管）；设置 Webhook、凭据或集成；处理工作流中的错误；使用队列模式扩展 n8n；创建自定义节点或对 n8n 进行白标；以编程方式使用 n8n API；在 n8n 中使用 LangChain；迁移到 n8n v1.0。
【主要能力与核心概念】 核心组件包括：工作流（节点相连的可视化自动化流程）、节点（工作流中的单个操作，如触发器、动作、逻辑等）、表达式（使用 {{ }} 语法访问和转换数据的代码片段）、凭据（API 密钥与认证信息的安全存储）、执行（单次工作流运行及其数据和状态）。 数据结构方面：n8n 以 items（JSON 对象数组）在节点间传递数据；每个 item 有一个包含主数据的 json 属性；二进制数据单独存储在 binary 属性中；表达式中使用 $json 访问当前 item 的数据。 AI 能力包括：智能体（可使用工具并做出决策的 AI）、链（预定义的 AI 操作序列）、记忆（存储对话历史以提供上下文）、工具（AI 智能体可调用的函数）、向量数据库（存储和检索嵌入以用于 RAG）。
【使用方式与示例】 技能提供快速参考示例，包括：基础表达式访问数据（如 {{ $json.name }}、{{ $node["HTTP Request"].json.response }}、{{ $("HTTP Request").all() }}）；带认证的 HTTP 请求（启用“失败时重试”、最大重试次数 3、重试间隔 1000 毫秒；使用批处理限制速率，每批 10 项、批间隔 1000 毫秒）；Code 节点转换数据（JavaScript，使用 $input.all() 并返回带 json 属性的 items）；Code 节点过滤数据（Python）；使用 Luxon 处理日期（$now、toFormat、plus、DateTime.fromISO）；JWT 认证凭据（密钥类型、Secret、算法 HS256/RS256/ES256 等）；工作流错误处理（Code 节点 try-catch 或设置错误工作流）；HTTP 请求分页（通用分页配置）；带工具的 AI 智能体；环境变量与静态数据（$env、getWorkflowStaticData）。
【适用场景与学习路径】 初学者：从基础工作流创建入手，学习触发节点（Webhook、Schedule、Manual）、动作节点（HTTP Request、Set、Edit Fields）、表达式语法与数据结构，常见模式如 Webhook → HTTP Request → Set → Respond to Webhook。中级用户：掌握 Code 节点、表达式内置方法、Luxon 日期操作、JMESPath、错误处理与数据操作。高级用户：AI 与 LangChain、扩展与性能（队列模式、数据库优化、执行数据清理、任务运行器）、自定义开发（自定义节点、白标、API、外部密钥）以及高级模式（子工作流、Webhook 认证、复杂数据转换、实时数据处理）。
【常见问题与限制】 文档列出常见问题及解决方案：HTTP 请求错误（400、403、429、404 等）、表达式错误（v1.0+ 起表达式错误会导致工作流失败）、数据类型问题（类型转换、空值处理、二进制数据处理）。迁移到 v1.0 的变化包括：新的执行顺序（深度优先）、Code 节点支持 Python（Pyodide）、强制用户管理（不再使用 BasicAuth）、默认使用 WebSocket 推送后端、要求 Node 18.17.0 或更高版本。环境配置提供 Docker 运行命令与关键环境变量（N8N_HOST、N8N_PORT、N8N_PROTOCOL、WEBHOOK_URL、N8N_ENCRYPTION_KEY、DB_TYPE、EXECUTIONS_MODE）。参考文件包括 llms-txt.md（适配 LLM 的完整文档）和 llms-full.md（含高级配置、扩展与性能、安全与认证、自定义节点开发、白标与嵌入选项等深度技术细节）。
【关于本技能】 本技能自动生成自 n8n 官方文档，示例取自文档中的真实模式，聚焦可立即使用的实用模式。如需更新，可使用相同配置重新运行抓取器以基于最新信息重建技能。本技能为 rawveg/skillsforge-marketplace 中的 n8n 条目，具体安装方式与定价信息暂未提供。