SuperAPI AI 工具集

n8n-builder

智能体与模型

查看项目

更新于 10-15 17:30

技能介绍

用途:根据技能内的参考文档生成合法的 n8n 工作流 JSON,供程序化创建工作流自动化、脚手架式搭建 AI 智能体与 RAG 流程使用。核心理念是 schema 合规,从而让 n8n 导入时不出现运行时校验错误。

主要能力与用法:按顺序阅读 schema.md(根结构与 settings)、nodes.md(节点定义与 typeVersion)、connections.md(图拓扑与 AI 连接类型),涉及动态值时阅读 expressions.md,涉及具体节点时阅读 integrations.md,再按 workflow.template.md 套用模板生成 JSON,最后执行校验脚本:uv run .claude/skills/n8n-builder/scripts/validate-workflow.py,可加 --strict。校验共 12 项自动检查,包括根字段、节点 id/名称唯一性、UUID 格式、连线目标存在性、AI 连接键与 type 匹配、LangChain 工作流需 executionOrder: "v1" 等。

关键约束:2025 年 12 月的破坏性变更包括数据库要求 PostgreSQL(不再支持 MySQL/MariaDB)、移除 "language": "python" 而改用 pythonNative 与 task runners、ExecuteCommand 与 LocalFileTrigger 默认禁用、Code 节点默认阻止环境变量访问、Agent 类型选择被移除(v1.82+ 统一为 Tools Agent)。生成时应设 active: false,不要硬编码凭据 ID,用占位名便于跨实例迁移;节点名冲突会被自动重命名并静默破坏表达式;AI 工具必须用 AI 连接类型而非 main,否则智能体无法发现;单个智能体只能连一个 ai_languageModel。

适用场景:需要批量或程序化产出 n8n 工作流、搭建带工具与记忆的智能体、构建 RAG 检索增强流程、以及希望导入前完成结构校验的场合。限制:凭据 ID 与 errorWorkflow UUID 因实例而异,导入后需重新分配;pinData 需小于 12MB 且不含二进制;AI 工作流缺少 executionOrder 会异步排序失败;文档未提供具体价格、平台支持范围或效果指标。

分类:办公与效率。