跳转到主要内容
1280X1280(1).PNG 工作流(workflow)决定 AI Agent 如何感知、思考、行动并适应复杂任务。 n8n 是一个工作流自动化平台,兼顾代码的灵活性和无代码的速度,GitHub 超 89.9k star。关键能力包括:
  • 按需编写代码:编写 JavaScript/Python 代码,添加 npm 包,或使用可视化界面
  • 原生 AI 平台:基于 LangChain 构建基于本地数据和模型的 AI 代理工作流
  • 完全掌控:自主托管,使用公平代码许可,或使用云服务
  • 企业级就绪:高级权限管理、单点登录(SSO)和离线部署
  • 活跃社区:400 多种集成和 900 多个现成可用的模板
通过 n8n 调用 PPIO 派欧云提供的高性能大模型 API 服务,可以构建自动化流程,同时完全掌控数据和部署。

PPIO × n8n 配置教程

前置工作:获取 PPIO API Key

将 PPIO API 接入 n8n(以及其他 AI 平台),需要准备三个基本信息:Base URL、Model ID 以及 API Key(密钥)。 Base URL 是 API 服务的根地址,API Key 用于身份验证和权限访问控制,Model ID 用于指定调用的具体模型资源。 获取 Base URL:PPIO 的 Base URL 固定地址为 https://api.ppio.com/openai。
1

获取并保存 API Key

首先,注册并登录 PPIO 派欧云。然后,打开 API 密钥管理页面,点击【创建】按钮,输入自定义密钥名称,生成 API 密钥。注意:密钥在服务端是加密存储,请在生成时保存好密钥(比如记录在备忘录里);若遗失密钥,可以在控制台上删除并创建一个新的密钥。1280X1280.PNG
2

获取模型 ID

获取需要使用的模型 ID,包括:
  • deepseek/deepseek-v4-pro
  • deepseek/deepseek-v4.1-flash
  • qwen/qwen3.8-max
  • zai-org/glm-5.3
此外,在模型广场点击任一模型后,可以从 API 接入指南获取 Base URL 以及模型 ID。更多信息比如最大上下文及价格可参考模型列表:https://ppio.com/pricing822b5696-ea02-4792-bb52-41a2ef6c56f8.png

在 n8n 中集成 PPIO API,构建聊天 AI Agent

准备工作:注册 n8n

n8n 有两种使用方式。 一是本地下载安装,使用 n8n 的开源代码许可。开源地址:https://github.com/n8n-io/n8n?tab=readme-ov-file 二是直接使用在线的云服务。本文以云服务方式演示如何用 n8n 构建一个简单的聊天 AI Agent。

创建一个新的工作流

新用户先打开 n8n 网址 https://n8n.io 注册。注册完成后进入 n8n 主界面,会看到一个空白的工作流;n8n 老用户可以直接创建一个新的工作流。 dad42f53-6e65-421e-885c-ab73419a9c20.png

添加触发节点(trigger node)

每个工作流都需要一个起点。在 n8n 中,这些被称为「触发节点」。我们从聊天节点开始。
1

打开节点菜单

选择「添加第一步」或按 Tab 打开节点菜单。fba77da3-71c5-4539-805e-051864be2136.png
2

搜索聊天触发器

搜索「聊天触发器(Chat Trigger)」。n8n 会显示与搜索相匹配的节点列表。0a437f71-f342-4938-918c-9127682ebf2c.png
3

添加聊天触发器节点

选择聊天触发器(Chat Trigger)将节点添加到画布,节点详细信息可以选择默认。82f332e7-6905-4d06-aa0b-b61c1c8c69af.png
4

返回画布

选择「返回画布」后,添加聊天节点成功。e7f93f7b-7639-4275-bddc-b406ab3b61f0.png

添加 AI Agent 节点

AI Agent 节点是将 AI 添加到工作流的核心。
1

添加节点

选择添加节点,触发节点上的连接器调出节点搜索。877e07f9-0ad4-400d-a5d6-8b7031b70610.png
2

选择 AI Agent 节点

输入「AI」并选择AI Agent节点来添加它。4792b6b7-f11e-4ff9-8509-7f0351152bee.png现在将显示AI Agent的编辑视图。有一些字段可以更改。由于我们使用的是Chat Trigger节点,因此提示的来源和规范的默认设置无需更改。49013383-8ce0-4a9f-82c7-61aec7cba670.png
3

返回画布

选择返回画布,添加 AI Agent 节点成功。371d2007-0519-4dee-bd4d-dbea602d906b.png

添加 PPIO API 凭证

AI Agent 需要附加聊天模型来处理输入的提示。
1

添加聊天模型

单击 AI 代理节点上的聊天模型的加号添加聊天模型。随即会出现「语言模型」的搜索对话框。这些是 n8n 内置支持的大模型。我们拉到最下方,选择 OpenAI Chat Model,以此来添加 PPIO 的模型(跟 OpenAI API 协议兼容)。ce53609b-0361-4a92-9ba5-417d1dcd2cfb.png
2

添加凭证

打开节点编辑器,为 PPIO 模型添加凭证,以此来让 n8n 与 PPIO 模型建立通信连接。此处的凭证,就是前面准备的 PPIO Base URL 以及 API Key。eef430e0-59d7-45d0-a5dd-b19934bcc41f.png
3

填写 API Key 与 Base URL

到了最关键的一步:新凭证可自定义名称,然后将提前准备好的 PPIO API Key 以及 Base URL 填写进去并保存。保存之后会弹出连接成功的提示。download.png56927b06-5fcf-4dd0-96ec-dafbe0bd2397.png
4

选择模型

返回上一步,此时会看到在模型 list 里出现 PPIO 支持的模型列表。我们选择 DeepSeek V4 Pro 作为演示实例。89e3259f-ff4f-4a25-af4d-cd6934e00fa3.png
5

返回画布确认

返回画布,此时看到聊天模型已经添加成功。3888287d-1f37-4bca-92f5-298cc9edba3a.png

测试节点

节点已连接到聊天触发器和聊天模型,点击 Open chat 测试工作流。输入问题后,聊天模型的响应出现在消息下方,日志窗口显示 AI 代理的输入和输出。回答成功后,工作流会显示绿色。 31dd4fd3-3a5b-4d68-b68b-457e79d9d5ec.png 到此,一个简单的聊天机器人 Agent 就配置完成了。

更改节点设置

除基本配置外,还有更个性化的参数设置。 聊天机器人默认的角色是一位「乐于助人的助手」,在 AI Agent 节点的「系统消息(System Message)」里设置,可以改变聊天机器人的初始设置,实现不同风格的聊天。 cefe1ddd-a26e-4fea-9df9-8b9e062f526f.png 将其改为「你是一位才华横溢的诗人,总是用押韵的对句回复」。 aec407ce-1891-499e-b72b-739f86b02ebe.png 再次问「你好吗」,效果如下: 5a4a3767-5001-43cd-99dd-dd68e07b20a4.png

添加记忆功能

聊天模型现在能给出有用的输出,但存在一些问题。比如,当你告诉聊天模型你的名字,例如「嗨,我叫路易」,等模型回复你之后,再次询问「我叫什么名字?」,AI 无论如何都无法回答你。 这是因为 n8n 的 AI Agent 工作流默认没有保存上下文,AI Agent 没有记忆。 要记住对话内容,AI Agent 需要保存上下文。可以在 AI Agent 节点中添加内存来实现。
1

添加简单内存

在 AI Agent 节点底部的记忆节点点击 + 号。在出现的面板中,选择「简单内存」。这将使用运行 n8n 实例的内存,通常足以满足简单使用需求。9a6fdcae-0d9b-4b70-99a7-cf1a5dd1a814.png
2

保持默认参数

参数不用修改,默认为 5 次交互,然后返回画布。dd687e26-dfc8-46d4-87f2-2aba6523f860.png
3

验证记忆效果

此时,当你告知模型你的名字后,它就会记住。cb19baed-1aa8-4584-adaa-b1d333395168.png
4

保存工作流

最后,在离开之前保存工作流。
至此,将 PPIO API 集成到 n8n 工作流的方式已经完成。
最后修改于 2026年11月11日