Skip to content

聊天触发器节点

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

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

工作流执行使用情况

每条发送至聊天触发器的消息都会执行您的工作流程。这意味着,如果用户在一次对话中发送了 10 条消息,则会占用您执行限额中的 10 次执行次数。请查看您的付款计划,了解限额详情。

手动聊天触发器

此节点取代了版本 1.24.0 中的手动聊天触发器节点。

节点参数

公开聊天

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

在构建工作流程时,请将此功能关闭。当您准备激活工作流程并允许用户访问聊天时,请将其打开。

模式

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

  • 托管聊天:使用 n8n 的托管聊天界面。推荐大多数用户使用,因为您可以使用节点选项配置界面,无需进行任何其他设置。
  • 嵌入式聊天:此选项要求您创建自己的聊天界面。您可以使用 n8n 的聊天小部件,也可以自行构建。您的聊天界面必须调用节点中“聊天 URL”中显示的 Webhook URL。

验证

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

  • :聊天不使用身份验证。任何人都可以使用聊天。
  • 基本身份验证:聊天使用基本身份验证。
    • 选择或创建
    • 包含用户名和密码
    • 的基本身份验证凭证
    。所有用户必须使用相同的用户名和密码。
  • n8n 用户授权:只有登录 n8n 帐户的用户才能使用聊天。

初始消息

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

节点选项

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

托管聊天选项

允许来源 (CORS)

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

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

输入占位符、标题和副标题

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

View screenshot

可定制的文本元素

加载上一个会话

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

如果您选择除“关闭”以外的任何选项,则必须将聊天触发器和您正在使用的代理连接到内存子节点。当您将“加载上一个会话”设置为“从内存”时,聊天触发器上的内存连接器会显示。n8n 建议将聊天触发器和代理连接到同一个内存子节点,因为这可以确保两个节点拥有单一可信来源。

View screenshot

将节点连接到内存

响应模式

在构建包含处理聊天的客服人员或客服链之后步骤的工作流程时,请使用此选项。选项包括:

  • 当最后一个节点完成时:聊天触发器节点返回工作流中执行的最后一个节点的响应代码和数据输出。
  • 使用“响应 Webhook”节点:聊天触发器节点按照响应 Webhook节点中的定义进行响应。

需要点击按钮才能开始聊天

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

View screenshot

新建对话按钮

嵌入式聊天选项

允许来源 (CORS)

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

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

加载上一个会话

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

如果您选择除“关闭”以外的任何选项,则必须将聊天触发器和您正在使用的代理连接到内存子节点。当您将“加载上一个会话”设置为“从内存”时,聊天触发器上的内存连接器会显示。n8n 建议将聊天触发器和代理连接到同一个内存子节点,因为这可以确保两个节点拥有单一可信来源。

View screenshot

将节点连接到内存

响应模式

在构建包含处理聊天的客服人员或客服链之后步骤的工作流程时,请使用此选项。选项包括:

  • 当最后一个节点完成时:聊天触发器节点返回工作流中执行的最后一个节点的响应代码和数据输出。
  • 使用“响应 Webhook”节点:聊天触发器节点按照响应 Webhook节点中的定义进行响应。

模板和示例

没有任何

查看 n8n 的高级 AI文档。

手动设置聊天响应

如果您不想直接将代理节点或链节点的输出发送给用户,则需要手动设置聊天响应。相反,您希望获取代理节点或链节点的输出,并对其进行修改或执行其他操作,然后再将其发送回用户。

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

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

常见问题

对于常见问题或问题以及建议的解决方案,请参阅常见问题