n8n 中文文档

对话式AI Agent节点

警告

Feature availability 功能可用性

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

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

Conversational Agent 进行类似人类的对话。它可以维护上下文,理解用户意图,并提供相关答案。此代理通常用于构建聊天机器人、虚拟助手和客户支持系统。

会话代理在系统提示符中描述工具[^1],并解析工具调用的 JSON 响应。如果您首选的 AI 模型不支持工具调用或者您正在处理更简单的交互,那么此代理是一个不错的通用选择。它更灵活,但可能不如工具代理准确。

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

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

节点参数

使用以下参数配置 Conversational Agent。

提示

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

选择:

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

需要特定输出格式

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

节点选项

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

人类消息

告诉代理它可以使用的工具,并为用户的输入添加上下文。

您必须包含这些表达式和变量:

  • {tools}:一个 LangChain 表达式,提供您连接到 Agent 的工具字符串。提供一些关于谁应该使用工具以及他们应该如何使用工具的上下文或解释。
  • {format_instructions}:一个 LangChain 表达式,提供您连接的输出解析器节点的模式或格式。由于指令本身就是上下文,您不需要为此表达式提供上下文。
  • {{input}}:一个包含用户提示的 LangChain 变量。此变量用 Prompt 参数的值填充。提供一些关于这是用户输入的上下文。

以下是您可能如何使用这些字符串的示例:

示例:

TOOLS
------
Assistant can ask the user to use tools to look up information that may be helpful in answering the user's original question. The tools the human can use are:

{tools}

{format_instructions}

USER'S INPUT
--------------------
Here is the user's input (remember to respond with a markdown code snippet of a JSON blob with a single action, and NOTHING else):

{{input}}

系统消息

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

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

最大迭代次数

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

默认值为 10。

返回中间步骤

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

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

跟踪元数据

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

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

模板和示例

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

常见问题

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

[^1]:在 AI 环境中,工具是一种附加资源,AI 在响应请求时可以参考该资源来获取特定信息或功能。人工智能模型可以使用工具与外部系统交互或完成特定的、有重点的任务。

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