n8n

n8n 是一个工作流自动化平台，提供用于 Agent、链、模型、记忆、工具和数据源的可视化 AI 节点。其 OpenAI Chat Model 子节点可以使用自定义的兼容 OpenAI 的端点，而非直接调用 OpenAI。

当 n8n AI Agent 或链需要使用网关管理的凭证、模型别名、路由、策略和遥测时，可以将该模型子节点连接到 AISIX。n8n 继续运行工作流和执行工具，AISIX 则治理已配置子节点发出的模型请求。

此集成适用于 OpenAI Chat Model 子节点，不代表 n8n 通用 OpenAI 应用节点的所有操作均兼容；后者还会调用服务提供方专用的文件、图像、音频、助手及其他 API。

前置条件

开始之前，请准备以下内容：

在 OpenAI Chat Model 子节点中为 AISIX 连接创建凭证：

在工作流中添加或打开 OpenAI Chat Model 子节点。
在 Credential to connect with 下创建 OpenAI 凭证。
将 API Key 设置为 AISIX 调用方 API Key。
将 Base URL 设置为包含 /v1 的 AISIX 代理 API 根路径，例如 https://gateway.example.com/v1。
将 Organization ID 留空。
保存凭证。

n8n 通过 GET /v1/models 验证凭证。AISIX 对调用方密钥进行身份认证，并返回该密钥可访问的别名。

选择 AISIX 连接和 Chat Completions 路径：

请显式设置 Use Responses API，不要依赖随版本变化的默认值。对于本文介绍的 Chat Completions 路径，必须将其关闭。

在此配置中，不要启用 Web Search、File Search 或 Code Interpreter 等 OpenAI 托管的内置工具。这些工具属于 OpenAI 的 Responses 服务，而非 n8n 工作流的工具调用循环。

模型值应为 AISIX 别名，而非上游服务提供方的模型 ID。n8n 向 AISIX 发送提示词和工具定义，工作流继续负责节点执行、记忆、分支、重试和数据流转。

进行最小交互测试时，将 Chat Trigger 连接到 AI Agent，附加已配置的 OpenAI Chat Model，然后运行工作流聊天。要验证增量输出，请将 Chat Trigger 的响应模式设置为 Streaming。

发送简短提示词，并确认以下结果：

如果工作流由 Webhook、调度或其他触发器启动，请单独验证该执行路径。测试和生产执行可能使用不同的凭证或工作流版本。

向 AI Agent 附加一个结果确定的 n8n 工具，例如 Calculator，并提出需要使用该工具的问题。确认 Agent 调用工具、接收结果并返回最终回答。

使用工具的一个对话轮次通常至少产生两个模型请求：第一个返回工具调用，下一个包含工具结果。设置 AISIX 限流和检查用量时，请考虑这种请求增多的情况。使用 AISIX Cloud 时，设置预算也应将其计入。

现象	检查项
凭证验证失败	确认 Base URL 以 `/v1` 结尾，且 `GET /v1/models` 接受调用方密钥。
模型列表为空	确认调用方密钥可访问至少一个 AISIX 别名，或通过模型 ID 模式输入别名。
请求到达 `/v1/responses`	关闭 OpenAI Chat Model 子节点上的 Use Responses API。
请求返回 `403`	确认 n8n 凭证中的调用方密钥可访问所选别名。
Agent 未使用工具就直接回答	确认工具已附加到 AI Agent，且所选上游模型支持兼容 OpenAI 的工具调用。
通用 OpenAI 节点操作失败	此集成仅用于 OpenAI Chat Model 子节点，除非已单独验证所需的 AISIX 端点。