Skip to content

Chat 节点#

将 Chat 节点与 Chat Trigger 节点配合使用，可将消息发送到聊天界面并可选等待用户响应。这支持聊天工作流中的 human-in-the-loop（HITL）用例，让你在一次执行中进行多轮对话。Chat 节点也可作为 AI Agent 的工具使用。

所有功能同时支持嵌入式与托管式聊天界面。

Chat Trigger 节点

Chat 节点要求工作流中存在 Chat Trigger 节点，并且其 Response Mode 响应模式 设置为 "Using Response Nodes 使用响应节点"。

旧版本

在旧版本中，该节点名为 "Respond to Chat"，并使用单一的 "Wait for User Reply" 切换。现在该功能被重构为两个独立操作，并新增更多响应类型。

Node parameters 节点参数#

此节点可用作 AI 工具

此节点可用于增强 AI 代理的功能。以这种方式使用时，许多参数可以自动设置，或使用 AI 指导的信息设置 - 在 AI 工具参数文档中了解更多信息。

使用以下参数配置该节点。

Operation 操作#

Chat 节点支持以下操作：

  • Send Message 发送消息：将消息发送到聊天界面。发送后工作流会继续执行。
  • Send and Wait for Response 发送并等待响应：向聊天界面发送消息并等待用户响应。该操作会暂停工作流执行，直到用户提交响应。

选择 Send and Wait for Response 发送并等待响应 将启用额外参数与选项，详见等待响应。

Message 消息#

要发送到聊天界面的消息。该参数适用于两种操作。

Node options 选项#

使用这些 Options 选项 进一步调整节点行为。

Add Memory Input Connection 添加内存输入连接#

选择是否将 Chat 节点中的消息提交到已连接的 memory。使用同一 memory 连接 agent 或 chain 根节点 与 Chat 节点，会将相同的会话 key 关联到这些消息，从而捕获完整的消息历史。

Waiting for a response 等待响应#

选择 Send and Wait for Response 发送并等待响应 后，你可以发送消息并暂停工作流执行，直到用户响应。这支持在一次执行中进行多轮对话和审批流程。

Response Type 响应类型#

你可以选择以下响应类型：

  • Free Text 自由文本：用户可以在聊天中输入任意响应。这与旧版 "Wait for User Reply" 的行为一致。
  • Approval 审批：用户可使用消息中的内联按钮进行批准或拒绝。你也可以允许用户输入自定义响应。

不同类型会启用不同的参数与选项。

Free Text 参数与选项#

使用 Free Text 响应类型时，用户可以输入任意消息作为响应。

Use cases 用例： - 开放式问题 - 收集详细反馈 - 请求特定信息

Options 选项： * Limit Wait Time 限制等待时间：是否在指定时间限制后自动恢复工作流执行。该限制可以是时间间隔或具体时间点。

Approval 参数与选项#

使用 Approval 响应类型时，消息会显示内联按钮，用户可点击批准或拒绝。该响应类型与 n8n 中其他 human-in-the-loop（HITL）节点的模式一致。

Use cases 用例： - 简单的是/否决策 - 审批流程 - 确认操作

使用 Approval 响应类型时，可用参数如下：

  • Type of Approval 审批类型：选择只显示批准按钮，或同时显示批准与拒绝按钮。
  • Approve Only 仅批准：仅显示一个批准按钮。

  • Approve and Disapprove 批准与拒绝：显示两个按钮（默认）。

  • Approve Button Label 批准按钮标签：显示在批准按钮上的文本。默认值：Approve。

  • Disapprove Button Label 拒绝按钮标签：显示在拒绝按钮上的文本（仅当审批类型为 "Approve and Disapprove" 时显示）。默认值：Disapprove。

  • Block User Input 阻止用户输入：是否阻止用户输入自定义消息（启用）或允许用户输入响应（禁用，默认）。

  • disabled 禁用（默认）：用户既可点击按钮，也可输入自定义消息。输入的消息会被视为带有自定义消息的拒绝。
  • enabled 启用：用户只能通过按钮交互。

Approval 响应类型还提供以下选项：

  • Limit Wait Time 限制等待时间：是否在指定时间限制后自动恢复工作流执行。该限制可以是时间间隔或具体时间点。

相关资源#

查看 n8n 的高级 AI文档。

有关如何设置聊天界面，请参阅 Chat Trigger 节点文档。

模板和示例#

Template widget placeholder.

常见问题#

  • Chat 节点作为子代理的工具时无法使用。
  • Chat 节点在子工作流中无法使用。这包括将子工作流作为 AI Agent 工具的用法。
  • 确保 Chat Trigger 节点的 Response Mode 响应模式设置为 "Using Response Nodes 使用响应节点"，否则 Chat 节点无法正常工作。

有关 Chat Trigger 节点的常见问题与解决方案，请参阅Chat Trigger 节点常见问题。