n8n 中文文档

聊天触发器

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

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

警告

工作流执行使用

发送到聊天触发器的每条消息都会执行您的工作流程。这意味着用户发送 10 条消息的一次对话将使用执行限额中的 10 次执行。检查您的付款计划以了解津贴的详细信息。

提示

功能可用性

聊天触发器节点从 n8n 1.24.0 开始可用,取代了手动聊天触发器节点。

节点参数

公开聊天

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

在构建工作流程时将其关闭。当您准备好发布工作流程并允许用户访问聊天时将其打开。

模式

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

  • 托管聊天:使用 n8n 的托管聊天界面。建议大多数用户使用,因为您可以使用 节点选项 配置接口,而无需执行任何其他设置。
  • 嵌入式聊天:此选项要求您创建自己的聊天界面。您可以使用 n8n 的 聊天小部件 或构建您自己的。您的聊天界面必须调用节点中 Chat URL 中所示的 Webhook URL。

认证

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

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

选择 n8n User Auth n8n 用户身份验证后,会出现 Require Workflow Execute Permission 要求工作流执行权限开关。启用后,触发聊天的用户还必须拥有该工作流所属项目中的工作流执行权限。已登录但无权执行该工作流的用户无法使用聊天。此选项适用于最终用户凭据:每位用户都可以使用自己连接的账户运行工作流。

初始消息

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

在 n8n 聊天中可用

选择是否使代理可供聊天中心使用。

代理名称

聊天中心上的代理名称。

代理描述

聊天中心上代理的描述。

节点选项

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

托管聊天选项

允许来源 (CORS)

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

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

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

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

查看截图 ![聊天小组件预览,显示 Input Placeholder、Title 和 Subtitle 文本字段](../../../.gitbook/assets/hosted-text-elements.png)

加载上一会话

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

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

查看截图 ![将节点连接到内存](../../../.gitbook/assets/connect-memory.png)

响应模式

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

  • 当最后一个节点完成时:聊天触发器节点返回工作流中执行的最后一个节点的响应代码和数据输出。
  • 使用响应节点:聊天触发节点按照 聊天 节点或 响应 Webhook 节点中的定义进行响应。在此响应模式下,聊天触发器将仅显示这些节点中定义的消息,而不输出工作流中执行的最后一个节点的数据。此模式取代了聊天触发器节点版本 1.2 中的“使用响应 Webhook 节点”模式。

  • 流式响应:在工作流程过程中启用实时数据流式传输回用户。需要工作流中支持流式传输的节点(例如,人工智能代理 节点)。

需要单击按钮开始聊天

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

查看截图 ![新对话按钮](../../../.gitbook/assets/new-conversation-button.png)

嵌入式聊天选项

允许来源 (CORS)

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

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

加载上一会话

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

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

查看截图 ![将节点连接到内存](../../../.gitbook/assets/connect-memory.png)

响应模式

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

  • 当最后一个节点完成时:聊天触发器节点返回工作流中执行的最后一个节点的响应代码和数据输出。
  • 使用响应节点:聊天触发节点按照 聊天 节点或 响应 Webhook 节点中的定义进行响应。在此响应模式下,聊天触发器将仅显示这些节点中定义的消息,而不输出工作流中执行的最后一个节点的数据。此模式取代了聊天触发器节点版本 1.2 中的“使用响应 Webhook 节点”模式。

  • 流式响应:在工作流程过程中启用实时数据流式传输回用户。需要启用流支持的节点。

模板和示例

浏览 n8n-nodes-base.compression 集成模板 或 搜索所有模板

相关资源

查看 n8n 的 Advanced AI 高级 AI 文档。

手动设置聊天响应

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

在基本工作流程中,代理和链节点输出名为 output 或 text 的参数,聊天触发器将此参数的值作为聊天响应发送给用户。

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

提示

聊天节点

当您使用 聊天 节点手动创建发送给用户的响应时,必须将聊天触发器响应模式设置为“使用响应节点”。

FAQ

如何将聊天界面连接到 n8n 工作流程?

添加聊天触发器节点作为工作流的触发器,然后将代理或链根节点连接到它。用户发送的每条消息都会运行工作流,因此您的后端逻辑会处理每条消息。

如何公开聊天或将其嵌入我的网站?

打开 公开聊天,然后选择 模式。 托管聊天使用 n8n 的托管界面,无需额外设置。 嵌入式聊天允许您使用 n8n 的 聊天小部件 或您自己的界面,该界面调用节点中显示的 聊天 URL Webhook。

如何在我的工作流程中设置聊天机器人的响应?

在基本工作流程中,聊天触发器将代理或链节点的 output 或 text 值发送给用户。要自定义响应,请创建名为 text 或 output 的参数。参见 手动设置聊天回复。如果您使用聊天节点,请将响应模式设置为使用响应节点。

常见问题

有关常见问题和建议的解决方案,请参阅 常见问题。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。