n8n AI工作流配置：用 AI Agent 节点连接大模型并输出结果

n8n 本身不会因为升级或安装某个插件就自动拥有 AI 能力，需要在工作流里添加 AI Agent 节点，并为它配置模型凭据。
下面按自托管 n8n 的常见界面，从创建凭据到验证输出完整走一遍。

先确认 n8n 版本和模型来源

开始前检查两件事：n8n 版本是否自带 AI Agent 节点，以及你准备用哪家大模型。

• 登录 n8n 后台，在左侧节点面板搜索 AI Agent。能搜到即可继续；搜不到说明版本偏旧，可先升级到当前稳定版再试。
• 模型来源需要 API Key。以 OpenAI 为例，到平台后台创建密钥，记录 Key 和可用的模型名。
• 如果 n8n 部署在服务器上，确认服务器能访问模型接口域名，避免后面测试时超时。

创建模型凭据

1. 在 n8n 左侧打开 Credentials，点击 Add credential。
2. 搜索并选择 OpenAI。
3. 在 API Key 字段粘贴密钥，Base URL 保持默认；如果你用的是兼容 OpenAI 格式的中转或自建服务，再改成对应地址。
4. 点击 Save，看到连接测试通过即可。

凭据保存后不要直接写进节点参数里，后续多个 AI 节点可以复用同一个凭据。

搭建最小可用的 AI 工作流

新建工作流，按下面顺序添加节点：

• 添加 Manual Trigger 作为手动触发入口。
• 添加 AI Agent 节点，把它连接到触发节点。
• 在 AI Agent 节点里配置 Chat Model，选择刚创建的 OpenAI 凭据，并填写模型名，例如 gpt-4o-mini。
• 在 Prompt 或系统提示词区域写清楚任务，例如“你是一个客服助手，根据用户问题给出简短回答”。
• 保存工作流，点击 Execute workflow 手动运行。

如果 AI Agent 节点要求连接 Memory 或 Tool，最小验证阶段可以先不接，只保留模型和提示词，减少变量。

常见报错和避坑点

配置过程中最容易卡在凭据和网络两类问题：

• 报 401 Unauthorized：API Key 填错、已失效或复制时带了空格，回凭据页重新粘贴并保存。
• 报 model not found：模型名写错，或当前账号没有该模型权限，换成账号可用的模型名再试。
• 报超时或连接失败：在服务器上执行 curl -I https://api.openai.com 检查出站网络，确认 DNS 和防火墙放行。
• 输出为空：检查提示词是否为空、AI Agent 节点是否真正连到触发节点，以及是否在节点里选错了凭据。

另外，不要把 API Key 直接写在节点表达式中，避免导出工作流时泄露；
需要多人协作时，用 n8n 的凭据共享功能管理。

验证输出是否正常

手动执行后，点开 AI Agent 节点的输出面板，确认返回内容包含模型生成的文本。
可以再改一次提示词，例如要求“用一句话回答”，重新执行，观察输出是否跟随变化。
能稳定返回文本，说明模型凭据和节点连接都已生效。

后续要把 AI 接入实际业务时，再在 AI Agent 后面接 Set 节点整理字段，或接 HTTP 请求节点把结果发送到你的系统。
先保证最小工作流跑通，再逐步增加节点，排错会简单很多。