参数收集节点

更新时间:
复制为 MD 格式

本文档介绍流程管理中参数收集节点的配置方法和应用示例。

节点介绍

参数收集节点定义了机器人需要收集的关键信息,并将内容存储到参数值中,在收集到参数后,后续流程可以直接用参数值进行条件判断,或者回复引用。

image.png

操作说明

  • 节点名称:按照业务需求可以修改节点名称,系统展示默认值;

  • 参数选择:有两种模式,分别是Prompt模式和自定义模式:

    说明

    当随路参数与要收集的参数同名时,会直接赋值,不再进行收集。

    • Prompt模式:通过Prompt定义机器人在该节点的收集要求;

      参数

      点击“添加参数”,选择已创建的参数进行添加。

      参数的配置方法具体参考《参数》。

      参数描述

      参数描述默认同步“知识库-API插件”中参数解释的内容。

      取值来源

      API 参数的取值来源支持三种方式:固定值、引用、模型识别

      • 固定值:参数值来源于固定的文本内容,通过直接设置文本和参数名完成赋值;image

      • 引用:支持从三种来源引用参数值:

        • API 插件的输入/输出参数;

        • 系统预设参数;

        • 随路参数(即对话过程中传递的上下文参数)。
          当使用随路参数传入与 API 参数同名的值时,系统将自动优先采用该传入值,不再通过对话流程获取;image

          说明

          当当前节点为“参数收集”节点,且取值来源设置为“引用”时,系统将支持添加参数来源选项。此时,“参数”可选择当前流程收集的参数。

          image

      • 模型识别:由机器人通过自然语言交互的方式主动与用户对话,收集所需参数信息并填充至 API 请求中。

      是否必填

      打勾参数,为必收集参数,此参数能够驱动后续操作执行。

      说明

      参数收集Prompt:当用户选择Prompt模式时,可以输入参数收集的对话示例,辅助机器人完成参数的收集。

    • 自定义模式:按照参数定义顺序,对取值来源为“文本”或“参数”时,直接进行使用并进行赋值,对取值来源为“对话识别”的参数进行逐个收集,可以配置参数的询问话术和二次确认话术;

      参数

      点击“添加参数”,选择已创建的参数进行添加。

      参数的配置方法具体参考《参数》。

      参数描述

      参数描述默认同步“知识库-API插件”中参数解释的内容。

      取值来源

      API 参数的取值来源支持三种方式:固定值、引用、模型识别

      • 当取值来源为“固定值”时,参数值来源于固定的文本内容,通过直接设置文本和参数名完成赋值。image

      • 当取值来源为“引用”时,支持从三种来源引用参数值:

        • API 插件的输入/输出参数;

        • 系统预设参数;

        • 随路参数(即对话过程中传递的上下文参数)。
          当使用随路参数传入与 API 参数同名的值时,系统将自动优先采用该传入值,不再通过对话流程获取。

        image

        说明

        当当前节点为“参数收集”节点,且取值来源设置为“引用”时,系统将支持添加参数来源选项。此时,“参数”可选择当前流程收集的参数。

        image

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

      说明

      询问方式:Prompt和固定话术两种方式;

      询问话术

      • Prompt:用户输入回复指令,可通过“/ ”的方式添加随路参数和系统参数;

      • 固定话术:机器人直接应用固定回复话术咨询用户;

      选择指令:指令用于外部系统与机器人对话的集成,如:转人工指令。机器人在回复时,同时随路下发指令信息供外部业务系统进行集成;

      参数二次确认:开启后,机器人主动与用户二次确认参数值是否正确。

      是否必填

      打勾参数,为必收集参数,此参数能够驱动后续操作执行。

  • 分支条件:打开开关,机器人将按顺序进行分支条件判断,满足分支条件后跳转到后续节点。

应用示例

场景:集成场景,单个流程包含多个节点的应用,包含机器人回复节点、参数收集节点、调用插件节点,当前流程主要是用户咨询上门维修,机器人收集用户手机号,并提交工单。

示例流程如下:

image.png

配置步骤

  1. 新建流程,进入流程画布界面;

  2. 输入意图边,当上门维修服务时,能触发此流程;

用户想要上门维修服务;
  1. 添加机器人回复节点,询问用户手机号;

机器人回复节点的配置方式可参考《机器人回复节点》;
  1. 添加“手机号码收集”的参数收集节点,选择“自定义模式”:

    1. 点击“添加参数”,选择“userPhone”进行添加;

    2. 选择取值来源为“对话识别”;

    3. 必填;image.png

    4. 点击“配置”,进行参数对话识别配置;

      1. 选择询问方式为“prompt”;

      2. 补充询问话术,如下图所示,并添加随路参数;

      3. 添加指令:系统_收号。机器人进行收集手机号时下发“收号”的指令,并唤起用户的手机键盘;

      4. 打开参数二次确认开关,对手机号进行二次确认。

      image.png

  2. 添加“手机号确认”的参数收集节点,参数选择的配置方式同上,然后进行添加分支条件:

    1. 手机号错误,用户修改手机号;image.png

    2. 手机号正确,用户确认手机号;image.png

    image.png

  3. 用户确认手机号后,添加调用插件节点创建工单,添加机器人回复节点结束流程。

调用插件节点的配置方法可参考《调用插件节点》,机器人回复节点的配置方法可参考《机器人回复节点》。

效果展示

image.png