跳到主要内容

Conversational AI Agent（对话式 AI 智能体） 节点

注意

功能可用性

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 破坏性变更。

Conversational Agent 支持类似人类的对话，可保持上下文、理解用户意图并给出相关回答，通常用于构建聊天机器人、虚拟助手和客户支持系统。

Conversational Agent 在系统提示词中描述工具1，并通过解析 JSON 响应进行工具调用。首选 AI 模型不支持工具调用，或交互较简单时，它是一个通用选择。它更灵活，但准确性可能低于 Tools Agent。

AI Agent 节点本身的更多信息，请参阅 AI Agent。

可以将此智能体与 Chat Trigger（聊天触发器）节点配合使用。连接一个记忆子节点，即可让用户进行包含多次提问的连续对话。记忆不会跨会话保留。

节点参数 ​

使用以下参数配置 Conversational Agent。

Prompt（提示词） ​

选择节点构建提示词的方式，提示词也称为用户查询或聊天输入。

可选择：

  • Take from previous node automatically（自动取自上一个节点）：选择后，节点期望从上一个节点接收名为 chatInput 的输入。
  • Define below（在下方定义）：选择后，在 Prompt (User Message)（提示词，用户消息）字段中提供静态文本或用于动态内容的表达式，作为提示词。

Require Specific Output Format（要求指定输出格式） ​

此参数控制是否要求节点使用指定的输出格式。开启后，n8n 会提示你将以下某个输出解析器连接到节点：

节点选项 ​

使用以下选项调整 Conversational Agent 节点的行为：

Human Message（用户消息） ​

告诉智能体可使用哪些工具，并为用户输入添加上下文。

必须包含以下表达式和变量：

  • {tools}：提供已连接到 Agent 的工具字符串的 LangChain 表达式。请补充上下文或说明，解释谁应该使用这些工具，以及应如何使用。
  • {format_instructions}：提供已连接输出解析器节点的架构或格式的 LangChain 表达式。指令本身就是上下文，因此无需为此表达式额外补充上下文。
  • {{input}}：包含用户提示词的 LangChain 变量，由 Prompt（提示词）参数的值填充。请补充上下文，说明这是用户输入。

这些字符串的用法示例如下：

例如：

工具
------
助手可以请用户使用工具，查找有助于回答用户原始问题的信息。用户可以使用以下工具：

{tools}

{format_instructions}

用户输入
--------------------
以下是用户输入（记住：仅返回包含单个 action 的 JSON 对象的 Markdown 代码片段，不要返回任何其他内容）：

{{input}}

System Message（系统消息） ​

如果希望在对话开始前向智能体发送消息，请输入要发送的消息。

使用此选项引导智能体的决策。

Max Iterations（最大迭代次数） ​

输入模型为尝试根据用户提示词生成良好答案而运行的次数。

默认为 10。

Return Intermediate Steps（返回中间步骤） ​

选择是否在最终输出中包含智能体执行的中间步骤，开启时包含，关闭时不包含。

可根据智能体执行的步骤，进一步调整其行为。

Tracing Metadata（追踪元数据） ​

为此智能体的追踪事件添加自定义键值元数据，便于在 LangSmith 等追踪工具中筛选和调试运行。

键或值为空的条目会被忽略。

模板与示例 ​

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

常见问题 ​

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

Footnotes​

  1. 在 AI 场景中，工具是附加资源，AI 可在响应请求时调用它获取特定信息或功能。AI 模型可以通过工具与外部系统交互，或完成具体、专门的任务。 ↩

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