Skip to content

Chat Trigger 触发器节点#

在构建聊天机器人及其他聊天界面的 AI 工作流时使用 Chat Trigger 节点。你可以配置用户如何访问聊天：使用 n8n 提供的界面，或使用自己的界面，并可添加认证。

你必须连接一个 agent 或 chain 根节点。

工作流执行使用

发送到 Chat Trigger 的每条消息都会执行一次工作流。这意味着用户在一次对话中发送 10 条消息，会消耗 10 次执行额度。请查看你的付费计划了解额度详情。

Manual Chat trigger

该节点替代了 1.24.0 版本中的 Manual Chat Trigger 节点。

Node parameters 节点参数#

Make Chat Publicly Available 公开聊天#

设置聊天是否公开可用（开启）或仅通过手动聊天界面可用（关闭）。

在构建工作流时建议保持关闭。当你准备发布工作流并允许用户访问聊天时，再将其打开。

Mode 模式#

选择用户访问聊天的方式，可选：

  • Hosted Chat 托管式聊天：使用 n8n 的托管聊天界面。推荐大多数用户使用，因为你可以通过节点选项进行配置，无需额外设置。
  • Embedded Chat 嵌入式聊天：此选项要求你创建自己的聊天界面。你可以使用 n8n 的 chat widget 或自行构建。你的聊天界面必须调用该节点中 Chat URL 聊天 URL 显示的 webhook URL。

Authentication 认证#

选择是否以及如何限制聊天访问，可选：

  • None 无：聊天不使用认证，任何人都可使用。
  • Basic Auth 基本认证：聊天使用基本认证。
    • 选择或创建一个带用户名和密码的 Credential for Basic Auth 基本认证凭据。所有用户必须使用相同的用户名和密码。
  • n8n User Auth n8n 用户认证：仅登录 n8n 账号的用户可使用聊天。

Initial Message(s) 初始消息#

此参数仅在使用 Hosted Chat 托管式聊天 时可用。用于配置用户进入页面时 n8n 聊天界面显示的消息。

Make Available in n8n Chat 在 n8n Chat 中可用#

选择是否在 Chat Hub 中提供该 agent。

Agent Name 代理名称#

Chat Hub 中显示的 agent 名称。

Agent description 代理描述#

Chat Hub 中显示的 agent 描述。

Node options 选项#

可用选项取决于聊天模式。

Hosted chat options 托管式聊天选项#

Allowed Origin (CORS) 允许来源（CORS）#

设置可访问聊天 URL 的来源。输入允许跨域非预检请求的 URL，使用逗号分隔。

使用 *（默认）允许所有来源。

Input Placeholder, Title, and Subtitle 输入占位符、标题和副标题#

输入聊天界面中这些元素的文本。

View screenshot

可自定义文本元素

Load Previous Session 加载上一次会话#

选择是否加载之前聊天会话的消息。

如果选择 Off 关闭 以外的任何选项，你必须将 Chat Trigger 与所使用的 Agent 连接到一个 memory 子节点。当你将 Load Previous Session 加载上一次会话 设置为 From Memory 来自 Memory 时，Chat Trigger 上会出现 memory 连接器。n8n 建议将 Chat Trigger 与 Agent 连接到同一个 memory 子节点，以确保两者使用同一数据来源。

View screenshot

将节点连接到 memory

Response Mode 响应模式#

当你在处理聊天的 agent 或 chain 后还需要后续步骤时，请使用该选项。可选：

  • When Last Node Finishes 当最后一个节点完成时：Chat Trigger 节点会返回响应码以及工作流中最后执行节点的数据输出。
  • Using Response Nodes 使用响应节点：Chat Trigger 节点按 Chat 节点或 Respond to Webhook 节点中定义的方式进行响应。在该响应模式下，Chat Trigger 只会显示这些节点定义的消息，而不会输出最后执行节点的数据。

Using Response Nodes

该模式替代了 Chat Trigger 节点 1.2 版本中的 “Using Respond to Webhook Node” 模式。

  • Streaming response 流式响应：在工作流处理中将数据实时流式返回给用户。需要工作流中支持流式输出的节点（例如 AI agent 节点）。

Require Button Click to Start Chat 需点击按钮才能开始聊天#

设置是否在聊天界面显示 New Conversation 新对话 按钮（开启）或不显示（关闭）。

View screenshot

新对话按钮

Embedded chat options 嵌入式聊天选项#

Allowed Origin (CORS) 允许来源（CORS）#

设置可访问聊天 URL 的来源。输入允许跨域非预检请求的 URL，使用逗号分隔。

使用 *（默认）允许所有来源。

Load Previous Session 加载上一次会话#

选择是否加载之前聊天会话的消息。

如果选择 Off 关闭 以外的任何选项，你必须将 Chat Trigger 与所使用的 Agent 连接到一个 memory 子节点。当你将 Load Previous Session 加载上一次会话 设置为 From Memory 来自 Memory 时，Chat Trigger 上会出现 memory 连接器。n8n 建议将 Chat Trigger 与 Agent 连接到同一个 memory 子节点，以确保两者使用同一数据来源。

View screenshot

将节点连接到 memory

Response Mode 响应模式#

当你在处理聊天的 agent 或 chain 后还需要后续步骤时，请使用该选项。可选：

  • When Last Node Finishes 当最后一个节点完成时：Chat Trigger 节点会返回响应码以及工作流中最后执行节点的数据输出。
  • Using Response Nodes 使用响应节点：Chat Trigger 节点按 Chat 节点或 Respond to Webhook 节点中定义的方式进行响应。在该响应模式下，Chat Trigger 只会显示这些节点定义的消息，而不会输出最后执行节点的数据。

Using Response Nodes

该模式替代了 Chat Trigger 节点 1.2 版本中的 “Using Respond to Webhook Node” 模式。

  • Streaming response 流式响应：在工作流处理中将数据实时流式返回给用户。需要工作流中启用支持流式输出的节点。

模板和示例#

Template widget placeholder.

相关资源#

查看 n8n 的高级 AI文档。

手动设置聊天响应#

当你不希望直接将 Agent 或 Chain 节点的输出发送给用户时，需要手动设置聊天响应。也就是说，你希望在发送给用户前先修改 Agent 或 Chain 节点的输出，或执行其他处理。

在基础工作流中，Agent 和 Chain 节点会输出名为 output 或 text 的参数，Chat Trigger 会将该参数的值作为聊天响应发送给用户。

如果你需要手动创建发送给用户的响应，必须创建名为 text 或 output 的参数。如果使用其他参数名，Chat Trigger 会将整个对象作为响应发送，而不只是其中的值。

Chat 节点

当你使用 Chat 节点手动创建响应时，必须将 Chat Trigger 的响应模式设置为 “Using Response Nodes”。

常见问题#

有关常见问题及解决方案，请参阅常见问题。