Chat Trigger 节点#
在为聊天机器人和其他聊天界面构建 AI 工作流时使用 Chat Trigger 节点。您可以使用 n8n 提供的界面或自定义界面来配置用户访问聊天的方式，并支持添加身份验证功能。 必须连接代理（agent）或链（chain）根节点。
工作流执行用量说明
发送至 Chat Trigger 的每条消息都会执行您的工作流。这意味着当用户发送 10 条消息的对话会话将消耗您执行额度中的 10 次执行次数。请查看您的付费计划了解额度详情。
手动聊天触发器
自 1.24.0 版本起，本节点已取代原有的 Manual Chat Trigger 节点。
节点参数#
公开聊天权限#
设置聊天是否应公开可用（开启）或仅能通过手动聊天界面访问（关闭）。 构建工作流时请保持关闭状态。当准备激活工作流并允许用户访问聊天时再开启此选项。
访问模式#
选择用户访问聊天的方式。可选选项包括：
- 托管聊天：使用 n8n 的托管聊天界面。推荐大多数用户使用，因为您可以通过节点选项配置界面，无需进行其他设置。
- 嵌入式聊天：此选项需要您创建自定义聊天界面。您可以使用 n8n 的聊天组件或自行构建。您的聊天界面必须调用节点聊天 URL 中显示的 Webhook 地址。
身份验证#
选择是否及如何限制聊天访问权限。可选选项包括：
- 无：聊天不启用身份验证。任何人都可以使用聊天功能。
- 基础认证：聊天使用基础身份验证。
- 选择或创建包含用户名和密码的基础认证凭据，所有用户必须使用相同的用户名和密码。
- n8n 用户认证：仅限登录 n8n 账户的用户可使用聊天功能。
初始消息#
此参数仅在启用托管聊天时可用。用于配置用户进入页面时 n8n 聊天界面显示的欢迎消息。
节点选项#
可用选项取决于聊天模式的选择。
托管聊天选项#
允许的源站 (CORS)#
设置可访问聊天 URL 的源站。输入允许进行跨域非预检请求的 URL 逗号分隔列表。
使用 *（默认值）允许所有源站。
输入框占位符、标题与副标题#
配置聊天界面中这些文本元素的显示内容。 查看截图 可自定义的文本元素
加载历史会话#
选择是否加载之前聊天会话中的消息记录。
若选择关闭以外的任何选项，必须将聊天触发器（Chat Trigger）和您正在使用的智能体（Agent）连接到记忆（Memory）子节点。当设置加载历史会话为从记忆加载时，聊天触发器上将出现记忆连接器。n8n 建议将聊天触发器和智能体同时连接到同一个记忆子节点，这能确保两个节点具有统一的数据源。
查看截图 连接节点到记忆系统
响应模式#
当工作流在聊天处理智能体（Agent）或链（Chain）之后还有其他执行步骤时，使用此选项。可选模式：
- 末节点完成时：聊天触发器节点将返回工作流中最后执行节点的响应代码和数据输出。
- 使用响应节点：聊天触发器节点将按照回复聊天节点或回复Webhook节点中的定义进行响应。在此响应模式下，聊天触发器将仅显示这些节点中定义的消息，不会输出工作流中最后执行节点的数据。
使用响应节点（Response Nodes） 此模式取代了 Chat Trigger 节点 1.2 版本中的"使用响应 Webhook 节点（Using Respond to Webhook Node）"模式。
- 流式响应（Streaming response）：在工作流处理过程中，支持将数据实时流式传输回用户。要求工作流中包含支持流式传输的节点（例如 AI 代理节点）。
需要点击按钮开始聊天#
设置是否在聊天界面显示新对话按钮（开启）或不显示（关闭）。 查看截图 新对话按钮
嵌入式聊天选项#
允许的来源（CORS）#
设置可以访问聊天 URL 的来源。输入允许进行跨域非预检请求的 URL 列表，以逗号分隔。
使用 *（默认值）允许所有来源。
加载先前会话#
选择是否加载先前聊天会话中的聊天消息。 如果选择关闭以外的任何选项，必须将聊天触发器（Chat trigger）和正在使用的代理（Agent）连接到记忆子节点（memory sub-node）。当加载先前会话设置为来自记忆时，聊天触发器上会出现记忆连接器。n8n 建议将聊天触发器和代理都连接到同一个记忆子节点，这可以确保两个节点使用单一可信数据源。 查看截图 将节点连接到记忆
响应模式#
当构建的工作流在处理聊天的代理（agent）或链（chain）之后还有其他步骤时，使用此选项。可选值：
- 当最后一个节点完成时：聊天触发器节点返回工作流中最后执行的节点的响应代码和数据输出。
- 使用响应节点：聊天触发器节点按照响应聊天节点或响应 Webhook节点中的定义进行响应。在此响应模式下，聊天触发器将仅显示这些节点中定义的消息，而不会输出工作流中最后执行的节点的数据。
使用响应节点 此模式取代了 Chat Trigger 节点 1.2 版本中的"使用响应 Webhook 节点"模式。
- 流式响应：在工作流处理过程中，支持将数据实时流式传输回用户。需要启用流式支持功能的节点。
模板和示例#
使用简单向量存储、表单触发器和 OpenAI 的 RAG 入门模板 由 n8n 团队提供 查看模板详情 将多个触发器统一到单个工作流中 由 Guillaume Duvernay 提供 查看模板详情 通过新 Jotform 提交触发外拨 Vapi AI 语音通话 由 Aitor | 1Node 提供 查看模板详情 浏览聊天触发器集成模板，或搜索所有模板
相关资源#
查看 n8n 的高级 AI 文档。
手动设置聊天响应#
当您不希望直接将 Agent 或 Chain 节点的输出发送给用户时，需要手动设置聊天响应。这种情况下，您可以获取 Agent 或 Chain 节点的输出，在将其发送回用户之前进行修改或进行其他处理。
在基础工作流中，Agent 和 Chain 节点会输出名为 output 或 text 的参数，聊天触发器会将该参数的值作为聊天响应发送给用户。
如果您需要手动创建发送给用户的响应，必须创建一个名为 text 或 output 的参数。如果使用不同的参数名称，聊天触发器会将整个对象作为响应发送，而不仅仅是参数值。
响应聊天节点 当使用响应聊天节点手动创建发送给用户的响应时，必须将聊天触发器的响应模式设置为"使用响应节点"。
常见问题#
关于常见问题或疑问及建议解决方案，请参阅常见问题。 与文档聊天
本页面 !点赞 有帮助 !点踩 没有帮助
感谢您的反馈！ 提交
上一页 压缩 下一页 常见问题
基于 Material for MkDocs Insiders 构建