Skip to content

Chat Trigger 聊天触发器节点#

在为聊天机器人和其他聊天界面构建 AI 工作流时使用 Chat Trigger 聊天触发器节点。您可以配置用户访问聊天的方式,使用 n8n 提供的界面之一,或您自己的界面。您可以添加身份验证。

您必须连接代理或链 root node 根节点

Workflow execution usage 工作流执行使用

每条发送到 Chat Trigger 聊天触发器的消息都会执行您的工作流。这意味着用户发送 10 条消息的一次对话将使用您执行配额中的 10 次执行。请检查您的付费计划以了解您的配额详情。

Manual Chat trigger 手动聊天触发器

此节点从版本 1.24.0 开始替代了 Manual Chat Trigger 手动聊天触发器节点。

Node parameters 节点参数#

Make Chat Publicly Available 使聊天公开可用#

设置聊天是否应该公开可用(开启)或只能通过手动聊天界面使用(关闭)。

在构建工作流时请保持此选项关闭。当您准备激活工作流并允许用户访问聊天时,请开启此选项。

Mode 模式#

选择用户访问聊天的方式。从以下选择:

  • Hosted Chat 托管聊天:使用 n8n 的托管聊天界面。推荐给大多数用户,因为您可以使用 node options 节点选项 配置界面,无需进行任何其他设置。
  • Embedded Chat 嵌入式聊天:此选项要求您创建自己的聊天界面。您可以使用 n8n 的 chat widget 聊天小组件 或构建自己的。您的聊天界面必须调用节点中 Chat URL 聊天URL 显示的网络钩子 URL。

Authentication 身份验证#

选择是否以及如何限制对聊天的访问。从以下选择:

  • None 无:聊天不使用身份验证。任何人都可以使用聊天。
  • Basic Auth 基本认证:聊天使用基本身份验证。
    • 选择或创建一个 Credential for Basic Auth 基本认证凭据,包含用户名和密码。所有用户必须使用相同的用户名和密码。
  • n8n User Auth n8n用户认证:只有登录到 n8n 账户的用户才能使用聊天。

Initial Message(s) 初始消息#

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

Node options 节点选项#

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

Hosted chat options 托管聊天选项#

Allowed Origin (CORS) 允许的来源(CORS)#

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

使用 *(默认)允许所有来源。

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

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

查看截图

Customizable text elements

Load Previous Session 加载之前的会话#

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

如果您选择除 Off 关闭 之外的任何选项,您必须将 Chat trigger 聊天触发器和您正在使用的 Agent 代理连接到内存子节点。当您将 Load Previous Session 加载之前的会话 设置为 From Memory 从内存 时,Chat trigger 聊天触发器上会出现内存连接器。n8n 建议将 Chat trigger 聊天触发器和 Agent 代理连接到同一个内存子节点,因为这确保了两个节点的单一数据源。

查看截图

Connect nodes to memory

Response Mode 响应模式#

在构建处理聊天的代理或链之后有步骤的工作流时使用此选项。从以下选择:

  • When Last Node Finishes 当最后一个节点完成时:Chat Trigger 聊天触发器节点返回响应代码和工作流中执行的最后一个节点的数据输出。
  • Using 'Respond to Webhook' Node 使用"响应网络钩子"节点:Chat Trigger 聊天触发器节点按照 Respond to Webhook 响应网络钩子 节点中定义的方式响应。

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

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

查看截图

New Conversation button

Embedded chat options 嵌入式聊天选项#

Allowed Origin (CORS) 允许的来源(CORS)#

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

使用 *(默认)允许所有来源。

Load Previous Session 加载之前的会话#

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

如果您选择除 Off 关闭 之外的任何选项,您必须将 Chat trigger 聊天触发器和您正在使用的 Agent 代理连接到内存子节点。当您将 Load Previous Session 加载之前的会话 设置为 From Memory 从内存 时,Chat trigger 聊天触发器上会出现内存连接器。n8n 建议将 Chat trigger 聊天触发器和 Agent 代理连接到同一个内存子节点,因为这确保了两个节点的单一数据源。

查看截图

Connect nodes to memory

Response Mode 响应模式#

在构建处理聊天的代理或链之后有步骤的工作流时使用此选项。从以下选择:

  • When Last Node Finishes 当最后一个节点完成时:Chat Trigger 聊天触发器节点返回响应代码和工作流中执行的最后一个节点的数据输出。
  • Using 'Respond to Webhook' Node 使用"响应网络钩子"节点:Chat Trigger 聊天触发器节点按照 Respond to Webhook 响应网络钩子 节点中定义的方式响应。

模板和示例#

Browse 聊天触发器 integration templates, or search all templates

相关资源#

查看 n8n 的高级 AI文档。

Set the chat response manually 手动设置聊天响应#

当您不想直接将 Agent 代理或 Chain 链节点的输出发送给用户时,您需要手动设置聊天响应。相反,您希望获取 Agent 代理或 Chain 链节点的输出并修改它或在将其发送回用户之前对其进行其他操作。

在基本工作流中,Agent 代理和 Chain 链节点输出一个名为 outputtext 的参数,Chat trigger 聊天触发器将此参数的值作为聊天响应发送给用户。

如果您需要手动创建发送给用户的响应,您必须创建一个名为 textoutput 的参数。如果您使用不同的参数名称,Chat trigger 聊天触发器会将整个对象作为其响应发送,而不仅仅是值。

常见问题#

对于常见问题或故障和建议的解决方案,请参考 常见问题