本文档介绍流程管理中参数收集节点的配置方法和应用示例。
节点介绍
参数收集节点定义了机器人需要收集的关键信息,并将内容存储到参数值中,在收集到参数后,后续流程可以直接用参数值进行条件判断,或者回复引用。

操作说明
节点名称:按照业务需求可以修改节点名称,系统展示默认值;
参数选择:有两种模式,分别是Prompt模式和自定义模式:
说明当随路参数与要收集的参数同名时,会直接赋值,不再进行收集。
Prompt模式:通过Prompt定义机器人在该节点的收集要求;
参数
点击“添加参数”,选择已创建的参数进行添加。
参数的配置方法具体参考《参数》。
参数描述
参数描述默认同步“知识库-API插件”中参数解释的内容。
取值来源
API 参数的取值来源支持三种方式:固定值、引用、模型识别
固定值:参数值来源于固定的文本内容,通过直接设置文本和参数名完成赋值;

引用:支持从三种来源引用参数值:
API 插件的输入/输出参数;
系统预设参数;
随路参数(即对话过程中传递的上下文参数)。
当使用随路参数传入与 API 参数同名的值时,系统将自动优先采用该传入值,不再通过对话流程获取;
说明当当前节点为“参数收集”节点,且取值来源设置为“引用”时,系统将支持添加参数来源选项。此时,“参数”可选择当前流程收集的参数。

模型识别:由机器人通过自然语言交互的方式主动与用户对话,收集所需参数信息并填充至 API 请求中。
是否必填
打勾参数,为必收集参数,此参数能够驱动后续操作执行。
说明参数收集Prompt:当用户选择Prompt模式时,可以输入参数收集的对话示例,辅助机器人完成参数的收集。
自定义模式:按照参数定义顺序,对取值来源为“文本”或“参数”时,直接进行使用并进行赋值,对取值来源为“对话识别”的参数进行逐个收集,可以配置参数的询问话术和二次确认话术;
参数
点击“添加参数”,选择已创建的参数进行添加。
参数的配置方法具体参考《参数》。
参数描述
参数描述默认同步“知识库-API插件”中参数解释的内容。
取值来源
API 参数的取值来源支持三种方式:固定值、引用、模型识别
当取值来源为“固定值”时,参数值来源于固定的文本内容,通过直接设置文本和参数名完成赋值。

当取值来源为“引用”时,支持从三种来源引用参数值:
API 插件的输入/输出参数;
系统预设参数;
随路参数(即对话过程中传递的上下文参数)。
当使用随路参数传入与 API 参数同名的值时,系统将自动优先采用该传入值,不再通过对话流程获取。
说明当当前节点为“参数收集”节点,且取值来源设置为“引用”时,系统将支持添加参数来源选项。此时,“参数”可选择当前流程收集的参数。

当取值来源为“模型识别”的参数时,由机器人通过自然语言交互的方式主动与用户对话,收集所需参数信息并填充至 API 请求中。支持进行询问当时、询问话术、选择指令、参数二次确认的配置。

说明询问方式:Prompt和固定话术两种方式;
询问话术:
Prompt:用户输入回复指令,可通过“/ ”的方式添加随路参数和系统参数;
固定话术:机器人直接应用固定回复话术咨询用户;
选择指令:指令用于外部系统与机器人对话的集成,如:转人工指令。机器人在回复时,同时随路下发指令信息供外部业务系统进行集成;
参数二次确认:开启后,机器人主动与用户二次确认参数值是否正确。
是否必填
打勾参数,为必收集参数,此参数能够驱动后续操作执行。
分支条件:打开开关,机器人将按顺序进行分支条件判断,满足分支条件后跳转到后续节点。
应用示例
场景:集成场景,单个流程包含多个节点的应用,包含机器人回复节点、参数收集节点、调用插件节点,当前流程主要是用户咨询上门维修,机器人收集用户手机号,并提交工单。
示例流程如下:

配置步骤
新建流程,进入流程画布界面;
输入意图边,当上门维修服务时,能触发此流程;
用户想要上门维修服务;
添加机器人回复节点,询问用户手机号;
机器人回复节点的配置方式可参考《机器人回复节点》;
添加“手机号码收集”的参数收集节点,选择“自定义模式”:
点击“添加参数”,选择“userPhone”进行添加;
选择取值来源为“对话识别”;
必填;

点击“配置”,进行参数对话识别配置;
选择询问方式为“prompt”;
补充询问话术,如下图所示,并添加随路参数;
添加指令:系统_收号。机器人进行收集手机号时下发“收号”的指令,并唤起用户的手机键盘;
打开参数二次确认开关,对手机号进行二次确认。

添加“手机号确认”的参数收集节点,参数选择的配置方式同上,然后进行添加分支条件:
手机号错误,用户修改手机号;

手机号正确,用户确认手机号;


用户确认手机号后,添加调用插件节点创建工单,添加机器人回复节点结束流程。
调用插件节点的配置方法可参考《调用插件节点》,机器人回复节点的配置方法可参考《机器人回复节点》。
效果展示






