本文档将介绍智能任务流各节点使用说明，帮助您解决配置过程中遇到的各类问题。
智能任务流节点
启动节点
启动节点用于配置任务流的触发条件。任务流支持意图识别、事件触发、自定义触发三类触发方式。
您可以在任务描述中描述触发此任务的意图和目的，以帮助 AI 进行意图识别和任务目标判断。若能结合具体场景举例说明，将有助于大模型更好地理解意图。
触发方式 | 说明 | 适用场景 |
意图识别 | AI 识别用户输入的自然语言，与任务流进行匹配并执行。 | 用户主动发消息，说法不固定，例如用户咨询某类问题。 |
事件触发 | 监听特定事件（例如打开会话、每天固定时间点等），事件发生时自动触发任务流。依赖配置监听事件功能（需开发） | 自动化响应外部变化或定时执行，例如会话结束后一天后自动触发用户回访任务流。 |
自定义触发 | 您的业务系统主动配置该任务流的 ID ，当业务系统内部条件满足时，通过 API 调用该任务流。该触发方式优先级最高。 需要您在管理端配置并发布该任务流，将生成的任务流 ID 配置到业务系统中。 | 存在复杂业务规则、具备开发能力的场景，例如 ERP 系统在订单状态变更时主动调用任务流。 |
说明：
触发任务流时，支持传入自定义参数。例如：
ERP 系统在订单状态变更时主动调用任务流，可同时传入
order_id、status 等业务信息，供任务流内部使用。参数限制：
Key 长度限制：512 字节。
Value 长度限制：128 KB。
注意：
自定义触发时，可带入自定义参数，该参数必须在管理端「启动节点」下预先添加，否则将会影响画布中后续节点的使用。
信息收集
信息收集节点用于向用户收集信息，机器人通过上下文智能提取和追问的方式收集信息，收集到所有信息后，将进入下一个节点。
进入信息收集节点后，机器人会判断对话的上下文中是否包含此处需收集的信息，如未提取到信息，将向用户追问，支持两种询问方式：
询问方式 | 详细说明 | 示例 |
AI 智能询问 | 大模型将根据此处填写的信息及描述，结合对话的上下文，自动生成追问话术并发送给用户。 |  |
固定话术询问 | 按此处配置的固定话术向用户询问，支持添加用户快捷输入的选项。 |  |
配置说明
当「信息收集」节点所收集的信息，需作为「接口调用」节点的输入参数时，请注意以下配置要点：
事项 | 说明 | 示例 |
参数映射配置 | 须将“信息内容”配置为接口的对应参数变量。否则映射缺失或错误，将导致接口调用失败。 |  |
空值处理规范 | 若所收集的信息为非必填项，必须在信息描述中明确说明此情况。 | |
非必填项说明 | 系统收集的信息为字符串类型。当该项无内容时，其值应为空字符串。请在描述或配置中明确此规则，以避免变量处理逻辑出错。 | |
接口调用
接口调用节点用于将用户的账号信息或提供的信息回调到开发者后台，进行查询或存储等操作。
应用场景
登录/注册时，通过调用登录/注册接口，完成个人信息注册。
通过调用订单相关接口，查询最新的订单、物流状态。
通过调用退货退款接口，完成订单的退货退款功能等。
操作说明
举例：在会话中，用户发送消息：“帮我查一下订单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。 |
条件判断
条件判断节点可结合信息收集节点收集到的信息判断，依次判断所有条件，当其中一个条件满足时，进入对应子流程。
结束回复
结束回复节点仅可作为任务流的最后一个节点，可通过两种方式回复：
检索知识库回复：机器人将结合上下文和收集到的信息，检索知识库并生成回答。
固定回复：机器人将按此处配置的固定话术回复。
