即时通信 IM 标准任务流

本文档将介绍标准任务流各节点使用说明，帮助您解决配置过程中遇到的各类问题。
标准任务流节点
启动节点
启动节点用于配置任务流的触发条件。任务流支持意图识别、事件触发、自定义触发三类触发方式。
您可以在任务描述中描述触发此任务的意图和目的，以帮助 AI 进行意图识别和任务目标判断。若能结合具体场景举例说明，将有助于大模型更好地理解意图。
触发方式
说明
适用场景
意图识别
AI 识别用户输入的自然语言，与任务流进行匹配并执行。
用户主动发消息，说法不固定，如用户咨询某类问题。
事件触发
监听特定事件（如打开会话、每天固定时间点等），事件发生时自动触发任务流。依赖配置监听事件（需开发）
自动化响应外部变化或定时执行，如会话结束结束后一天一天后自动触发用户回访任务流。
自定义触发
您的业务系统主动配置该任务流 ID ，当业务系统内部条件满足时，通过 API 调用该任务流。该触发方式优先级最高。
需要您在管理端配置并启用和发布该任务流，将生成的任务流 ID 配置到业务系统中。
存在复杂业务规则、具备开发能力的场景，如 ERP 系统在订单状态变更时主动调用任务流。
说明：
建议添加多条问法，提高意图识别的准确性。每个任务可配置最多20个问法，每条问法不超过200个字符
添加补充描述可以进一步提高意图识别的准确性，补充描述不超过1000个字符。
触发任务流时，支持传入自定义参数。例如：
ERP 系统在订单状态变更时主动调用任务流，可同时传入 order_id、status 等业务信息，供任务流内部使用。
参数限制：
Key 长度限制：512 字节。
Value 长度限制：128 KB。
注意：
自定义触发时，可带入自定义参数，该参数必须在管理端「启动节点」下预先添加，否则将会影响画布中后续节点的使用。
﻿
回复消息
回复消息节点用于配置机器人的回复内容，支持添加纯文本消息和富文本消息。
﻿
分支选项
分支选项节点用于对用户不同的选择进行分流。每个分支节点可配置最多20个选项，每条选项不超过200个字符。
管理端配置
用户端示例
﻿
﻿
﻿
﻿
﻿
﻿
信息收集
信息收集节点用于向用户收集信息。机器人发送问题表单，用户点击“提交”后，进入下一个节点；如用户未提交表单，流程将自动结束。
管理端配置
用户端示例
﻿
﻿
﻿
﻿
﻿
﻿
配置项
说明
引导话术
必填，展示在表单的标题位置，最长填写200字符。
信息配置
必填，用于添加表单收集的信息，每个表单最多支持收集10条信息。
添加到变量
选填，用于将用户填写的信息保存到自定义变量。保存到变量后，可以配合 条件判断、接口调用 使用。
收集方式
每条信息需选择以下一种收集方式：
选项：单选，最多添加20个选项，每个选项不超过200字符。
输入：文本输入框。
条件判断
条件判断节点用于根据用户的账号信息或提供的信息，依次判断所有条件组，当其中一个条件组满足时，进入对应子流程。
条件判断节点最多连接10个条件组。每个条件组最多由10个条件构成，条件组内支持两种方式添加条件：
并且：条件组内的所有条件同时满足。
或者：条件组内的条件任意一个满足。
﻿
接口调用
接口调用节点用于将用户的账号信息或提供的信息回调到开发者后台，进行查询或存储等操作。
应用场景
登录/注册时，通过调用登录/注册接口，完成个人信息注册。
通过调用订单相关接口，查询最新的订单、物流状态。
通过调用退货退款接口，完成订单的退货退款功能等。
操作说明
举例：在会话中，用户发送消息：“帮我查一下订单12345的状态。”。此时配置订单物流查询接口方法如下：
配置项
说明
举例
URL
API 接口的地址，以 https 或 http 开头。	
配置 API 地址。例如：http://101.33.201.195:8081/xxxx
输入参数
接口调用时需要传入的参数详情。有以下类型：
系统变量：本次会话的固有变量。如用户 ID、会话 ID 等。查看系统变量。﻿
自定义变量：客户业务逻辑中的变量。如订单 ID、商品 ID 等。
固定值：常量，可自行定义。
查询订单状态，需提供：SystemClientUserID、OrderID、请求来源（有必要时可配置）。
选择系统变量传入 SystemClientUserID。
选择自定义变量传入 OrderID。
添加固定值 ，例如设置为type="1"标记调用接口场景。
输出参数
接口调用结束后返回的自定义变量。可在后续接口调用、条件判断节点中使用。
接口需输出订单状态。
设置输出参数为 OrderStatus。
异常处理
开启后，接口调用节点将新增异常处理分支。若调用失败，任务流自动进入该分支。
需要时可打开此开关。
﻿
接口调用的请求和响应，可参考接口调用。
﻿系统变量说明
：
系统变量
说明
SystemSessionID
当前会话 ID。
SystemClientUserID
当前会话咨询的用户 ID。
SystemCustomerServiceID
客户号 ID。
SystemChannelType
渠道的类型。类型有：网站渠道、IM 渠道。
SystemFlowTriggerRewriteQuery
触发当前任务流的用户 Query。
SystemFlowID
当前任务流 ID。
转人工
转人工节点用于将机器人进行中的会话转接给人工客服。支持两种转人工方式：直接转人工、转至指定客服分组。
直接转人工：选择该方式，当任务流进入到转人工节点，将按照 会话设置 中配置的分配策略，分配给空闲的客服。
转至指定客服分组：创建客服分组 后，可在此处选择分配给指定分组的客服接待。
﻿
﻿

配置项	说明	举例
URL	API 接口的地址，以 https 或 http 开头。	配置 API 地址。例如：`http://101.33.201.195:8081/xxxx`
输入参数	接口调用时需要传入的参数详情。有以下类型：系统变量：本次会话的固有变量。如用户 ID、会话 ID 等。查看系统变量。自定义变量：客户业务逻辑中的变量。如订单 ID、商品 ID 等。固定值：常量，可自行定义。	查询订单状态，需提供：SystemClientUserID、OrderID、请求来源（有必要时可配置）。选择系统变量传入 SystemClientUserID。选择自定义变量传入 OrderID。添加固定值，例如设置为`type="1"`标记调用接口场景。
输出参数	接口调用结束后返回的自定义变量。可在后续接口调用、条件判断节点中使用。	接口需输出订单状态。设置输出参数为 `OrderStatus`。
异常处理	开启后，接口调用节点将新增异常处理分支。若调用失败，任务流自动进入该分支。	需要时可打开此开关。

触发方式	说明	适用场景
意图识别	AI 识别用户输入的自然语言，与任务流进行匹配并执行。	用户主动发消息，说法不固定，如用户咨询某类问题。
事件触发	监听特定事件（如打开会话、每天固定时间点等），事件发生时自动触发任务流。依赖配置监听事件（需开发）	自动化响应外部变化或定时执行，如会话结束结束后一天一天后自动触发用户回访任务流。
自定义触发	您的业务系统主动配置该任务流 ID ，当业务系统内部条件满足时，通过 API 调用该任务流。该触发方式优先级最高。需要您在管理端配置并启用和发布该任务流，将生成的任务流 ID 配置到业务系统中。	存在复杂业务规则、具备开发能力的场景，如 ERP 系统在订单状态变更时主动调用任务流。

配置项	说明
引导话术	必填，展示在表单的标题位置，最长填写200字符。
信息配置	必填，用于添加表单收集的信息，每个表单最多支持收集10条信息。
添加到变量	选填，用于将用户填写的信息保存到自定义变量。保存到变量后，可以配合条件判断、接口调用使用。
收集方式	每条信息需选择以下一种收集方式：选项：单选，最多添加20个选项，每个选项不超过200字符。输入：文本输入框。

系统变量	说明
SystemSessionID	当前会话 ID。
SystemClientUserID	当前会话咨询的用户 ID。
SystemCustomerServiceID	客户号 ID。
SystemChannelType	渠道的类型。类型有：网站渠道、IM 渠道。
SystemFlowTriggerRewriteQuery	触发当前任务流的用户 Query。
SystemFlowID	当前任务流 ID。

标准任务流

本页目录：

标准任务流节点

启动节点

回复消息

分支选项

信息收集

﻿﻿﻿

条件判断

接口调用

应用场景

操作说明

转人工