AI 消息对话节点 & 组件嵌入
一、功能概述
二、适用场景
三、对话触发（Chat Trigger）节点说明
3.1 节点能力
四、如何插入 对话触发 节点
4.1 插入入口
1.
2.
3.
4.2 节点使用限制
五、为流程添加对话相关节点
5.1 对话触发（Trigger）
5.2 回复对话消息（Action）
六、参数配置说明（重点）
6.1 对话触发（Trigger）参数说明
| 参数 | 说明 |
|---|---|
| 触发条件 | 指定何种对话消息触发流程 |
| 关键词 | 仅在触发条件为「包含指定关键词」时生效 |
6.2 回复对话消息（Action）参数说明
| 参数 | 说明 |
|---|---|
| 聊天组件 id | 需要回复的 Chatbox 组件 ID |
| 聊天会话 id | 当前对话的 session id |
| 回复内容 | 返回给用户的消息内容 |
6.3 AI 生成模式
6.4 限制说明
七、节点输出说明
7.1 对话触发（Trigger）输出
{
"sessionId": "xxxxxx",
"userid": "xxxxxx",
"chatboxid": "xxxxx",
"type": "text | file",
"content": "用户输入内容",
"file_url": [],
"customparams": {}
}7.2 回复对话消息（Action）异常输出示例
{
"sessionId": "xxxxxx",
"userid": "xxxxxx",
"chatboxid": "xxxxx",
"status": "fail",
"description": "当前会话id已过期"
}7.3 默认状态提示
| 场景 | 默认提示 |
|---|---|
| 未关联流程 | 当前对话暂无关联流程 |
| 流程无输出 | 当前关联流程无内容输出 |
| 组件未启用 | 当前对话组件尚未启用 |
| 组件被删除 | 当前组件已被删除 |
八、组件集成（Chatbox）配置与生效逻辑
8.1 创建组件
8.2 组件配置项说明
| 配置项 | 说明 |
|---|---|
| 组件名称 | 用于展示在 Chatbox 顶部标题。 |
| 关联流程 | 1. 仅可选择「已上线」且触发节点为「对话触发」的流程2. 未关联流程的组件不允许启用 |
| 允许的输入类型 | - 文本输入- 语音输入- 文件上传 |
| 输入框引导文案 | 展示在输入框中的占位提示。 |
| 欢迎语 | 在用户开启新会话时自动发送。 |
| 会话过期时间 | 指定会话在无操作情况下的过期时间。 |
| 允许开启新会话 | 是否允许用户手动创建新的 session。 |
| 机器人头像 | 用于 Chatbox 中的机器人头像展示。 |
8.3 组件启用规则（非常重要）
九、Chatbox 组件嵌入说明
9.1 支持的嵌入方式
9.2 嵌入参数说明
| 参数 | 说明 |
|---|---|
| chatbox-id | 组件唯一标识（必填） |
| userid | 外部系统用户标识 |
| custom_params | 自定义参数（JSON） |
修改于 2026-05-07 01:44:57