OpenAI 聊天模型节点#
使用 OpenAI 聊天模型节点（OpenAI Chat Model node），可将 OpenAI 的聊天模型与对话式 智能代理 结合使用。 在本页面中，您将找到该节点的参数说明以及相关资源链接。
凭据
有关此节点的身份验证信息，请参见此处。
子节点中的参数解析
当使用表达式处理多个数据项时，子节点（sub-nodes）的行为与其他节点有所不同。
大多数节点（包括根节点）可以接收任意数量的数据项作为输入，逐个处理这些项并输出结果。您可以使用表达式引用输入项，节点会依次为每个输入项解析该表达式。例如，若有五个 name 值作为输入，表达式 {{ $json.name }} 将依次解析为每一个名称。
而在子节点中，表达式始终只解析为第一个输入项。例如，同样有五个 name 值作为输入时，表达式 {{ $json.name }} 始终解析为第一个名称。
节点参数#
模型#
选择用于生成回复的模型。 n8n 会从 OpenAI 动态加载模型，因此您只会看到您的账户可用的模型。
内置工具#
OpenAI 响应 API 提供了一系列内置工具，可用于增强模型的响应能力：
- 网页搜索（Web Search）：允许模型在生成响应前通过网络搜索最新信息。
- MCP 服务器（MCP Servers）：允许模型连接到远程 MCP 服务器。了解更多关于将远程 MCP 服务器用作工具的信息，请参见此处。
- 文件搜索（File Search）：允许模型在生成响应前，从先前上传的文件中搜索知识库以获取相关信息。更多信息请参考 OpenAI 官方文档。
- 代码解释器（Code Interpreter）：允许模型在一个沙箱环境中编写并运行 Python 代码。
节点选项#
使用这些选项可以进一步优化节点的行为。
基础 URL#
在此输入一个 URL，以覆盖 API 的默认 URL。
频率惩罚（Frequency Penalty）#
使用此选项控制模型重复自身内容的可能性。值越高，模型重复的可能性越低。
最大 Token 数量（Maximum Number of Tokens）#
输入使用的最大 token 数量，用于设置生成结果的长度。
响应格式（Response Format）#
选择 文本（Text） 或 JSON。选择 JSON 可确保模型返回有效的 JSON 格式。
存在惩罚（Presence Penalty）#
使用此选项控制模型引入新话题的可能性。值越高，模型谈论新话题的可能性越大。
采样温度（Sampling Temperature）#
使用此选项控制采样过程的随机性。较高的温度会增加输出的多样性，但也会增加产生幻觉（hallucinations）的风险。
超时时间（Timeout）#
输入请求的最大时间（单位：毫秒）。
最大重试次数（Max Retries）#
输入请求失败后最多重试的次数。
Top P#
使用此选项设置生成结果时考虑的概率范围。使用较低的值可忽略概率较小的选项。
对话 ID（Conversation ID）#
指定此响应所属的对话。当响应完成后，输入项和输出项将自动添加到该对话中。
提示缓存键（Prompt Cache Key）#
使用此键缓存相似请求，以提高缓存命中率。
安全标识符（Safety Identifier）#
应用一个标识符来追踪可能违反使用策略的用户。
服务层级（Service Tier）#
选择适合您需求的服务层级：Auto（自动）、Flex（灵活）、Default（默认）或 Priority（优先级）。
元数据（Metadata）#
一组键值对，用于存储结构化信息。您可以向对象附加最多 16 对元数据，便于通过 API 或仪表板进行搜索时使用自定义数据。
Top Logprobs#
定义一个介于 0 到 20 之间的整数，表示在每个 token 位置返回最可能的 token 数量，每个 token 都附带相应的对数概率（log probability）。
输出格式（Output Format）#
选择响应格式：文本（Text）、JSON Schema 或 JSON Object。如果您希望以 JSON 格式接收数据，建议使用 JSON Schema。
提示词（Prompt）#
配置包含唯一 ID、版本号以及可替换变量的提示词。
推理努力程度（Reasoning Effort）#
控制 AI 结果的推理深度：低（Low）、中（Medium）或高（High）。
模板与示例#
AI 代理聊天 由 n8n 团队提供 查看模板详情
构建你的第一个 WhatsApp 聊天机器人 由 Jimleuk 提供 查看模板详情
使用 AI 抓取并总结网页内容 由 n8n 团队提供 查看模板详情
浏览 OpenAI 聊天模型集成模板，或 搜索所有模板
相关资源#
更多服务信息，请参考 LangChain 的 OpenAI 文档。 更多参数说明，请参考 OpenAI 官方文档。 查看 n8n 的 高级 AI 文档。
常见问题#
关于常见问题及建议解决方案，请参阅 常见问题。