n8n 中文文档

OpenAI 聊天模型

使用 OpenAI 聊天模型节点将 OpenAI 的聊天模型与对话代理结合使用[^1]。

提示

在 n8n Cloud 上,你可以使用 Gateway credits 网关积分运行 OpenAI Chat Model 节点,而无需自己的 OpenAI API key。在节点的凭据字段中选择 Use Gateway credits 使用网关积分,即可无需 OpenAI 账户运行该节点。

在此页面上,您将找到 OpenAI Chat Model 节点的节点参数和更多资源的链接。

提示

Credentials 凭证

您可以在OpenAI 凭据文档找到该节点的身份验证信息。

提示

Parameter resolution in sub-nodes 子节点参数解析

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

大多数节点,包括根节点,接受任意数量的项目作为输入,处理这些项目,并输出结果。您可以使用表达式引用输入项目,节点会依次为每个项目解析表达式。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 会依次解析为每个名称。

在子节点中,表达式始终解析为第一项。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 始终解析为名字。

节点参数

型号

选择用于生成完成的模型。

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

使用响应 API

OpenAI 提供两个端点用于从模型生成输出:

  • Chat Completions 聊天完成:聊天完成 API 端点根据构成对话的消息列表生成模型响应。该 API 要求用户手动处理会话状态,例如通过添加 Simple Memory 子节点。对于新项目,OpenAI 建议使用 Responses API。
  • Responses 回应:响应 API 是一个代理循环,允许模型在一个 API 请求的范围内调用多个内置工具。它还通过传递 conversation_id 来支持持久对话。

如果你希望模型使用 Responses API 生成输出,请切换到 Use Responses API 使用 Responses API。否则,OpenAI Chat Model 节点将默认使用 Chat Completions API。

有关 Chat Completions 和 Responses API 的比较,请参阅 OpenAI 文档。

内置工具

OpenAI Responses API 提供了一系列内置工具 来丰富模型的响应。如果您希望模型能够访问以下内置工具,请切换到 Use Responses API 使用响应 API:

  • Web Search 网页搜索:允许模型在生成响应之前在网络上搜索最新信息。
  • File Search 文件搜索:允许模型在生成响应之前从之前上传的文件中搜索您的知识库以获取相关信息。有关更多信息,请参阅OpenAI 文档。
  • Code Interpreter 代码解释器:允许模型在沙盒环境中编写和运行Python代码。

提示

Use with AI Agent node 与AI Agent节点配合使用

仅当将 OpenAI 聊天模型节点与 AI Agent 节点结合使用时,才支持内置工具。例如,当将 OpenAI 聊天模型节点与基本 LLM 链节点结合使用时,内置工具不可用。

节点选项

使用这些选项可以进一步调整节点行为。无论你是否使用 Responses API 来生成模型输出,这些选项都可用。

频率惩罚

使用此选项控制模型重复自身的机会。较高的值会减少模型重复自身的机会。

代币最大数量

输入使用的最大令牌数,用于设置完成长度。

存在处罚

使用此选项控制模型谈论新主题的机会。较高的值会增加模型谈论新主题的机会。

采样温度

使用此选项控制采样过程的随机性。较高的温度会创建更多样化的采样,但会增加幻觉的风险。

超时

输入最大请求时间(以毫秒为单位)。

最大重试次数

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

顶部 P

使用此选项设置完成应使用的概率。使用较低的值来忽略不太可能的选项。

其他节点选项(仅限响应 API)

切换到 Use Responses API 使用响应 API 时,以下附加选项可用。

对话 ID

此响应所属的对话。此响应完成后,此响应的输入项和输出项将自动添加到此对话中。

提示缓存密钥

使用此键缓存类似的请求以优化缓存命中率。

安全标识符

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

服务等级

选择适合您需求的服务等级:自动、灵活、默认或优先。

元数据

一组用于存储结构化信息的键值对。您最多可以将 16 对附加到一个对象,这对于添加可用于通过 API 或在仪表板中进行搜索的自定义数据非常有用。

顶级对数概率

定义 0 到 20 之间的整数,指定每个标记位置最有可能返回的标记数量,每个标记都有一个关联的对数概率。

输出格式

选择响应格式:文本、JSON 架构或 JSON 对象。如果您想接收 JSON 格式的数据,建议使用 JSON Schema。

提示

配置包含唯一 ID、版本和可替换变量的提示。提示是通过 OpenAI 仪表板配置的。

模板和示例

浏览 n8n-nodes-langchain.lmchatopenai 集成模板 或 搜索所有模板

相关资源

有关该服务的更多信息,请参考 LangChain 的 OpenAI 文档。

有关参数的更多信息,请参考 OpenAI 文档。

查看 n8n 的 Advanced AI 高级 AI 文档。

常见问题

有关常见问题和建议的解决方案,请参阅常见问题。

[^1]:AI 代理是能够响应用户请求、做出决策并执行现实世界任务的人工智能系统。他们使用大型语言模型 (LLM) 来解释用户输入,并就如何利用现有的信息和资源最好地处理请求做出决策。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。