illegalCreed

中文

English

中文

English

Appearance

参考 ​

基于 n8n 官方文档（docs.n8n.io）+ GitHub Release Notes 编写，对照 2024-2026 AI 能力爆发期版本行为

速查 ​

  • 本质：开源工作流自动化平台（fair-code / Sustainable Use License），节点式可视化编排 + 70+ LangChain.js AI 节点
  • 核心抽象：Node / Trigger / Connection / Item（json + binary）/ Execution（manual / production）/ Credential
  • AI Root 节点：AI Agent（决策型、循环、必接 Chat Model + 可选 Memory/Tools/Vector Store）vs Basic LLM Chain（预定义序列、单次、不支持 Memory/Tools）
  • AI 子节点：Chat Model / Memory / Tools / Vector Store / Document Loaders / Text Splitters / Embeddings
  • Memory 仅 Agent 可用：Chain 接了不生效
  • Tool Calling 关键：$fromAI() 运行时根据用户输入动态填参数
  • RAG 五步：Load → Split → Embed（仅文本）→ Store → Retrieve
  • Vector Store：In-Memory / pgvector / Pinecone / Qdrant / Milvus / Supabase / Zep
  • Chat Model 供应商：OpenAI / Anthropic / Gemini / Mistral / Alibaba Qwen / MiniMax
  • MCP：MCP Client（运行时调用外部 MCP）+ MCP Trigger（n8n 作为 MCP 服务器）
  • AI 工程化：Evaluation + Evaluation Trigger（跑测试集）/ Guardrails（治理）/ AI Transform（批量变换）
  • 辅助：AI Workflow Builder / AI Assistant（自然语言生成工作流 / 编码帮助）
  • 部署双轨：Cloud（托管）vs Self-hosted（Docker / npm / Compose / K8s）；官方推 Docker 优先，npm 可能 sunset
  • 数据库：默认 SQLite（原型）/ PostgreSQL（生产推荐）/ MySQL / MariaDB / MS SQL
  • 关键环境变量：N8N_ENCRYPTION_KEY（生产必自定）/ WEBHOOK_URL / N8N_HOST / N8N_PORT=5678 / DB_TYPE / DB_POSTGRESDB_*
  • 许可：fair-code / Sustainable Use License；与 n8n 竞争的商业产品 / 托管有限制，商用前看 LICENSE

核心抽象 ​

抽象含义
Node工作流执行单元；Trigger（触发）+ Regular（动作）
Trigger工作流入口：Manual / Webhook / Schedule / Chat / Polling / MCP / Evaluation
Connection节点间数据流；扇出 / 循环 / 错误分支
Item节点间传递数据：json（结构化）+ binary（文件 / 媒体）
Execution一次完整运行；manual（调试）vs production（Trigger 触发）
Credential外部服务认证，AES-256 加密（密钥 = N8N_ENCRYPTION_KEY）

节点速查表 ​

Trigger 节点 ​

节点用途
Manual Trigger手动调试
WebhookHTTP 请求触发
Schedule TriggerCron / 间隔
Chat Trigger面向 AI 的对话入口
Polling Trigger周期查询外部系统
MCP Trigger接收 MCP 请求
Evaluation Trigger触发 AI 测试评估

Regular 节点（动作） ​

类别代表节点
HTTPHTTP Request（万能兜底）
数据库Postgres / MySQL / MongoDB / Redis / Snowflake / MS SQL
SaaSSlack / Gmail / Notion / Airtable / GitHub / Google Sheets 等 1000+
数据变换Set / Code（JS+Python）/ Filter / Item Lists / Merge / Split In Batches
文件Read/Write Files / Convert to File / Extract from File
流程控制IF / Switch / Loop / Sub-workflow Execution / Error Trigger

AI 节点族 ​

类别节点角色
RootAI Agent决策型，必接 Chat Model
RootBasic LLM Chain预定义序列，不支持 Memory/Tools
Sub-nodeChat ModelOpenAI / Anthropic / Gemini / Mistral / Qwen / MiniMax
Sub-nodeMemoryWindow Buffer / Postgres / Redis / Zep / Motorhead / Xata / Manager
Sub-nodeToolsWikipedia / SerpAPI / Calculator / HTTP Request / Custom Code / Call n8n Workflow
Sub-nodeVector StoreIn-Memory / pgvector / Pinecone / Qdrant / Milvus / Supabase
Sub-nodeDocument LoadersPDF / Web / Text / Notion
Sub-nodeText SplittersToken / Character / Recursive / Markdown
Sub-nodeEmbeddings仅支持文本
集成MCP Client调用外部 MCP 服务器
治理Guardrails输入 / 输出校验，防 prompt 注入
工程化AI Transform用 LLM 做批量数据变换
工程化Evaluation跑测试集评估 AI 工作流
辅助AI Workflow Builder / AI Assistant自然语言生成工作流 / 编码帮助

AI Agent vs Basic LLM Chain ​

维度AI AgentBasic LLM Chain
执行模型决策型、循环预定义序列、单次
必接Chat ModelChat Model
可选Memory / Tools / Vector Store—
Memory 支持✓✗
Tools 支持✓✗
成本慢、贵快、省
场景多轮对话 / 多工具 / 动态决策提示词 → 响应固定流程

Memory 类型 ​

类型持久化适用
Window Buffer会话级滚动窗口开发 / 原型
Postgres Chat Memory跨会话生产
Redis Chat Memory跨会话高吞吐
Zep跨会话 + 长期用户画像
Motorhead (Metal)跨会话Metal 用户
Xata跨会话 + 向量化Xata 用户
Chat Memory Manager—检查 / 裁剪 / 注入伪用户消息

Tools 一览 ​

Tool用途
Wikipedia查维基百科
SerpAPI搜索引擎结果
Calculator数学计算
HTTP Request Tool调任意 API / 抓网页
Custom Code ToolJS / Python 自定义代码
Call n8n Workflow Tool把任意 n8n 工作流当工具暴露（最大复用）

$fromAI(description, type) 让 Agent 在运行时根据用户输入动态填参数；静态参数无法处理多变自然语言输入。

Vector Store 与 RAG ​

五步管道 ​

text
[Document Loaders] → [Text Splitters] → [Embeddings] → [Vector Store] → [Retriever]

Vector Store 选型 ​

后端适用
In-Memory原型
Postgres pgvector已用 Postgres，复用
Pinecone云托管向量库
Qdrant开源高性能
Milvus大规模向量
SupabaseSupabase pgvector
Zep跨会话记忆 + 向量化

Embeddings 能力边界 ​

  • 仅支持文本：不支持图像 / 音频 embedding
  • 多模态 RAG 需要外接（HTTP Request 调外部 embedding 服务，或 Custom Code Tool）

关键环境变量 ​

变量用途
N8N_ENCRYPTION_KEY凭据 AES-256 加密密钥（生产必自定）
N8N_HOST / N8N_PORT=5678 / N8N_PROTOCOL实例地址
WEBHOOK_URLWebhook / OAuth 回调根 URL
N8N_USER_FOLDER用户数据目录
DB_TYPE / DB_POSTGRESDB_*切到 PostgreSQL（生产推荐）
EXECUTIONS_DATA_PRUNE / EXECUTIONS_DATA_MAX_AGE清理历史执行
N8N_METRICSPrometheus 指标暴露
N8N_LOG_LEVEL / N8N_LOG_OUTPUT日志级别 / 输出
GENAI_TIME_TO_RUN_ENABLEDAI 工作流相关实验性开关

后端元数据库 ​

数据库适用
SQLite（默认）原型 / 单实例开发
PostgreSQL生产推荐，多 worker、并发安全
MySQL / MariaDB已有 MySQL 栈
MS SQL微软生态

部署模式 ​

模式命令适用
Docker 轻量docker run -p 5678:5678 docker.n8n.io/n8nio/n8n原型
Docker Compose + Postgresdocker compose up -d生产推荐
npmnpx n8n / npm i -g n8n && n8n start仅原型（社区讨论 sunset）
KubernetesHelm / manifest大规模、多副本
Cloud注册 n8n.io/cloud不想运维

版本里程碑 ​

时期关键特性
早期（2019-2022）开源工作流自动化平台，fair-code 许可，1000+ 非 AI 集成
Advanced AI / LangChain 节点AI Agent / Chain / Memory / Tools / Vector Store / Document Loaders 节点族
ChatHub / Chat Trigger面向 AI 的对话入口体系
MCP Client / Trigger接入 Model Context Protocol
Evaluation + Evaluation TriggerAI 工作流测试体系（why test → run quick evaluations → use metrics）
Guardrails 节点输出治理、防 prompt 注入
AI Transform 节点用 LLM 做批量数据变换
AI Workflow Builder / AI Assistant自然语言生成 / 修改工作流
LangChain Code 节点代码内用 LangChain 短码
AI Starter Kit一键起含向量库的 AI 工作流环境
2024-2026 现状70+ AI 节点，覆盖 OpenAI / Anthropic / Gemini / Mistral / Alibaba / MiniMax；推 Docker 优先

部署趋势：Cloud + Self-hosted 双轨；社区推动 Docker 优先（npm-native 可能 sunset）。

反模式速查 ​

  • 给 Chain 节点接 Memory / Tools（不生效，需换 Agent）
  • 把全部私有数据塞 prompt 上下文（应走 RAG）
  • 用 npm 长期支撑生产自托管（请用 Docker + 独立 Postgres）
  • 改 prompt 不跑 Evaluation（凭肉眼会掩盖回归）
  • 把 Agent 当 Chain 用（单轮无工具，浪费循环成本）
  • Tool 不加 Guardrails 直接暴露（SSRF / prompt 注入）
  • 在 Cloud 上做深度定制（应切 Self-hosted）
  • 对话型 Agent 不接 Memory（生产换 Postgres / Redis / Zep）
  • 把 LLM 应用构建器（Dify / Flowise）当自动化引擎用
  • License 边界忽视（fair-code 与 n8n 竞争的商业产品 / 托管有限制）
  • 把「文档摘要未提及某特性」当「已废弃」

官方资源 ​