n8n 中文文档

OpenAI 函数代理

警告

Feature availability 功能可用性

OpenAI Functions Agent 已自 n8n 1.82.0 起弃用。新增或更新的 AI Agent 节点会改用 Tools Agent。只有仍在使用 AI Agent 节点版本 1 的工作流才能选择 OpenAI Functions Agent。

AI Agent 节点版本 1 会在 n8n 3.0 中移除,因此所有工作流中的 OpenAI Functions Agent 都将停止工作。详情请参阅 n8n 3.0 breaking changes。

使用 OpenAI Functions Agent 节点来使用 OpenAI 函数模型{:target=_blank .external-link}。这些是检测何时应该调用函数并响应应该传递给函数的输入的模型。

有关 AI Agent 节点本身的更多信息,请参阅 AI Agent。

您可以将此代理与聊天触发器节点一起使用。附加一个内存子节点,以便用户可以与多个查询进行持续对话。会话之间的记忆不会持续存在。

提示

OpenAI Chat Model required 需要 OpenAI 聊天模型

您必须将 OpenAI 聊天模型 与此代理结合使用。

节点参数

使用以下参数配置 OpenAI Functions Agent。

提示

选择您希望节点如何构造提示(也称为用户的查询或聊天输入)。

选择:

  • Take from previous node automatically 自动从前一个节点获取:如果选择此选项,节点将期望来自名为 chatInput 的前一个节点的输入。
  • Define below 定义如下:如果选择此选项,请提供静态文本或动态内容表达式,以用作 Prompt (User Message) 提示(用户消息) 字段中的提示。

需要特定输出格式

该参数控制您是否希望节点需要特定的输出格式。打开时,n8n 会提示您将这些输出解析器之一连接到节点:

节点选项

使用这些选项来调整 OpenAI Functions Agent 节点的行为:

系统消息

如果您想在对话开始之前向客服人员发送消息,请输入您要发送的消息。

使用此选项来指导代理的决策。

最大迭代次数

输入模型应运行的次数,以尝试根据用户提示生成正确的答案。

默认值为 10。

返回中间步骤

选择是否在最终输出中包含代理采取的中间步骤(打开)或不包含(关闭)。

这对于根据代理采取的步骤进一步改进代理的行为可能很有用。

跟踪元数据

为此 agent 的 tracing event 添加自定义键值 metadata。这有助于在 LangSmith 等 tracing 工具中过滤和调试运行。

key 或 value 为空的条目会被忽略。

模板和示例

请参阅主 AI Agent 节点的 模板和示例 部分。

常见问题

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

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