跳到主要内容

OpenAI Chat Model（OpenAI 聊天模型）

信息

在 n8n Cloud 上，可使用 Gateway 额度运行 OpenAI Chat Model 节点，无需自己的 OpenAI API 密钥。在节点的凭据字段选择 Use Gateway credits（使用 Gateway 额度），即可在没有 OpenAI 账户的情况下运行节点。

使用 OpenAI Chat Model 节点，将 OpenAI 聊天模型与对话智能体1配合使用。

本页列出了 OpenAI Chat Model 节点的参数，并提供更多资源的链接。

信息

凭据

此节点的身份验证信息，请参阅 OpenAI 凭据文档。

信息

子节点中的参数解析

使用表达式处理多个数据项时，子节点的行为与其他节点不同。

多数节点，包括根节点，可以接收任意数量的输入数据项，处理后输出结果。你可以用表达式引用输入数据项，节点会依次对每个数据项解析表达式。例如，输入包含五个 name 值时，表达式 {{ $json.name }} 会依次解析为每个名称。

在子节点中，表达式始终解析为第一个数据项。例如，输入包含五个 name 值时，表达式 {{ $json.name }} 始终解析为第一个名称。

节点参数 ​

Model（模型） ​

选择用于生成补全的模型。

n8n 从 OpenAI 动态加载模型，你只会看到自己的账户可用的模型。

Use Responses API（使用 Responses API） ​

OpenAI 提供两个用于生成模型输出的端点：

  • Chat Completions：Chat Completions API 根据组成对话的消息列表生成模型响应。用户需要手动管理对话状态，例如添加 Simple Memory 子节点。对于新项目，OpenAI 建议使用 Responses API。
  • Responses：Responses API 提供智能体循环，使模型可在一次 API 请求内调用多个内置工具。它还支持通过传入 conversation_id 实现持久会话。

如果希望模型使用 Responses API 生成输出，请开启 Use Responses API（使用 Responses API）。否则，OpenAI Chat Model 节点默认使用 Chat Completions API。

两者的对比，请参阅 OpenAI 文档中的 Chat Completions 与 Responses API 比较。

内置工具 ​

OpenAI Responses API 提供多种内置工具，用于丰富模型响应。开启 Use Responses API（使用 Responses API）后，模型可访问以下内置工具：

  • Web Search（网页搜索）：模型可先搜索互联网获取最新信息，再生成响应。
  • File Search（文件搜索）：模型可在先前上传的文件构成的知识库中搜索相关信息，再生成响应。更多信息请参阅 OpenAI 文档。
  • Code Interpreter（代码解释器）：模型可在沙箱环境中编写并运行 Python 代码。
信息

与 AI Agent 节点配合使用

仅当 OpenAI Chat Model 节点与 AI Agent 节点配合使用时，才支持内置工具。例如，与 Basic LLM Chain 节点配合时，内置工具不可用。

节点选项 ​

使用以下选项进一步调整节点行为。无论是否使用 Responses API 生成模型输出，下列选项都可用。

Frequency Penalty（频率惩罚） ​

使用此选项控制模型重复自身内容的可能性。值越高，重复的可能性越低。

Maximum Number of Tokens（最大 token 数） ​

输入使用的 token 数量上限，以设置补全长度。

Presence Penalty（存在惩罚） ​

使用此选项控制模型谈论新话题的可能性。值越高，谈论新话题的可能性越高。

Sampling Temperature（采样温度） ​

使用此选项控制采样过程的随机性。温度越高，采样结果越多样，但产生幻觉的风险也越高。

Timeout（超时） ​

输入请求的最长耗时，单位为毫秒。

Max Retries（最大重试次数） ​

输入请求的最大重试次数。

Top P ​

使用此选项设置补全使用的概率范围。较低值会忽略概率较低的选项。

附加节点选项，仅适用于 Responses API ​

开启 Use Responses API（使用 Responses API）后，可使用以下附加选项。

Conversation ID（会话 ID） ​

此响应所属的会话。响应完成后，该响应的输入数据项和输出数据项会自动添加到此会话。

Prompt Cache Key（提示词缓存键） ​

使用此键缓存相似请求，优化缓存命中率。

Safety Identifier（安全标识符） ​

应用标识符，以跟踪可能违反使用政策的用户。

Service Tier（服务层级） ​

选择符合需求的服务层级：Auto（自动）、Flex（灵活）、Default（默认）或 Priority（优先）。

Metadata（元数据） ​

用于存储结构化信息的一组键值对。每个对象最多可附加 16 对，便于添加自定义数据，并通过 API 或控制台搜索。

Top Logprobs（最高对数概率） ​

设置 0 到 20 之间的整数，指定每个 token 位置返回多少个最可能的 token，每个 token 都附带对应的对数概率。

Output Format（输出格式） ​

选择响应格式：Text（文本）、JSON Schema 或 JSON Object（JSON 对象）。希望接收 JSON 格式数据时，建议使用 JSON Schema。

Prompt（提示词） ​

配置提示词的唯一 ID、版本及可替换变量。提示词通过 OpenAI 控制台配置。

模板与示例 ​

浏览 OpenAI Chat Model（OpenAI 聊天模型）集成模板，或搜索所有模板

相关资源 ​

该服务的更多信息，请参阅 LangChain 的 OpenAI 文档。

参数的更多信息，请参阅 OpenAI 文档。

查看 n8n 的高级 AI 文档。

常见问题 ​

常见问题及建议的解决办法，请参阅常见问题。

Footnotes​

  1. AI 智能体是能够响应请求、作出决策并为用户执行现实任务的人工智能系统。它们使用大型语言模型（LLM）理解用户输入，并根据可用的信息和资源，决定如何最好地处理请求。 ↩

本文为社区中文翻译。查看对应英文原文