n8n Builder_开发编程 skill-PHP中文网

n8n Builder

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

专家级 n8n 工作流构建器，可通过 n8n REST API 以编程方式创建、部署和管理 n8n 工作流。用于创建工作流、自动化任务、构建自动化流程、设计工作流管道、连接服务或管理现有工作流。支持处理 Webhook 流、定时任务、AI 代理、数据库同步、条件逻辑、错误处理及各类 n8n 节点配置。

n8n 工作流程构建器

功能概述

n8n 工作流程构建器是一项面向实际任务的技能，主要用于Setup. 需要两个环境变量: 1.；N8N URL — n8n 实例 URL (例如: https://your-n8n.example.com).；

核心要点

N8N API KEY — n8n API 键(Settings → API → 创建 API 键).；
Workflow.。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

n8n 工作流构建器

环境准备

需配置以下两个环境变量：

N8N_URL — n8n 实例地址（例如：https://your-n8n.example.com）
N8N_API_KEY — n8n API 密钥（设置 → API → 创建 API 密钥）

工作流构建流程

理解自动化需求 — 明确触发方式（Webhook / 定时调度 / 手动执行）、数据源、处理逻辑、输出目标及错误处理要求。
设计工作流 JSON — 依据 references/workflow-schema.md 中定义的 Schema 编写合法的 n8n 工作流 JSON。可参考 references/workflow-patterns.md 中提供的常用模式作为模板。
通过 API 部署 — 使用 scripts/n8n-api.sh create 命令从文件部署，或通过管道将 JSON 输入至 scripts/n8n-api.sh create-stdin。
启用工作流 — 对于基于触发器的工作流，使用 scripts/n8n-api.sh activate 启用。
验证部署结果 — 列出所有工作流以确认是否成功部署：scripts/n8n-api.sh list。

API 脚本参考

# 列出全部工作流
scripts/n8n-api.sh list

# 从 JSON 文件创建工作流
scripts/n8n-api.sh create /tmp/workflow.json

# 从标准输入创建工作流
echo '{"name":"Test",...}' | scripts/n8n-api.sh create-stdin

# 获取、启用、停用、删除、执行工作流
scripts/n8n-api.sh get 
scripts/n8n-api.sh activate 
scripts/n8n-api.sh deactivate 
scripts/n8n-api.sh delete 
scripts/n8n-api.sh execute 

# 列出凭证与标签
scripts/n8n-api.sh credentials
scripts/n8n-api.sh tags

构建 Workflow JSON

每个工作流必须包含：name、nodes[]、connections{}、settings{}。

每个节点必须包含：id、name、type、typeVersion、position、parameters。

连接关系（connections）以源节点的显示名称（display name）为键，映射其输出至目标节点。

完整 Schema、支持的节点类型及表达式语法，请参阅 references/workflow-schema.md；涵盖 Webhook、定时调度、AI Agent、数据库同步、错误处理等场景的完整工作流示例，请参阅 references/workflow-patterns.md。

关键规范

settings 中必须始终设置 "executionOrder": "v1"
节点名称（name）在单个工作流内必须唯一
节点 ID（id）必须唯一 — 建议使用具描述性的 slug，例如 webhook1、code1
节点位置（position）应从 [250, 300] 开始，并保持约 200px 的水平间距
IF 节点具有两个输出分支：索引 0 表示 true 分支，索引 1 表示 false 分支
Webhook 类型工作流 若 responseMode 设为 responseNode，则必须包含 respondToWebhook 节点
凭证（Credentials）必须已在 n8n 中预先创建 — 可通过 scripts/n8n-api.sh credentials 检查
启用前务必测试 — 对手动触发类工作流，使用 scripts/n8n-api.sh execute 进行验证
对存在风险的 HTTP/API 节点，应设置 continueOnFail: true，并在后续节点中显式检查错误