参数收集节点

节点介绍

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

操作说明

• 节点名称：按照业务需求可以修改节点名称，系统展示默认值；

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

  说明

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

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

    参数	点击“添加参数”，选择已创建的参数进行添加。 参数的配置方法具体参考《参数》。
    参数描述	参数描述默认同步“知识库-API插件”中参数解释的内容。
    取值来源	API 参数的取值来源支持三种方式：固定值、引用、模型识别 固定值：参数值来源于固定的文本内容，通过直接设置文本和参数名完成赋值； 引用：支持从三种来源引用参数值： API 插件的输入/输出参数； 系统预设参数； 随路参数（即对话过程中传递的上下文参数）。 当使用随路参数传入与 API 参数同名的值时，系统将自动优先采用该传入值，不再通过对话流程获取； 说明 当当前节点为“参数收集”节点，且取值来源设置为“引用”时，系统将支持添加参数来源选项。此时，“参数”可选择当前流程收集的参数。 模型识别：由机器人通过自然语言交互的方式主动与用户对话，收集所需参数信息并填充至 API 请求中。
    是否必填	打勾参数，为必收集参数，此参数能够驱动后续操作执行。

    说明

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

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

    参数	点击“添加参数”，选择已创建的参数进行添加。 参数的配置方法具体参考《参数》。
    参数描述	参数描述默认同步“知识库-API插件”中参数解释的内容。
    取值来源	API 参数的取值来源支持三种方式：固定值、引用、模型识别 当取值来源为“固定值”时，参数值来源于固定的文本内容，通过直接设置文本和参数名完成赋值。 当取值来源为“引用”时，支持从三种来源引用参数值： API 插件的输入/输出参数； 系统预设参数； 随路参数（即对话过程中传递的上下文参数）。 当使用随路参数传入与 API 参数同名的值时，系统将自动优先采用该传入值，不再通过对话流程获取。 说明 当当前节点为“参数收集”节点，且取值来源设置为“引用”时，系统将支持添加参数来源选项。此时，“参数”可选择当前流程收集的参数。 当取值来源为“模型识别”的参数时，由机器人通过自然语言交互的方式主动与用户对话，收集所需参数信息并填充至 API 请求中。 配置项 说明 基础配置 参数名 当前需要收集的参数字段名称，用于标识该参数在请求中的含义。例如：Address、Phone、CarNumber。 参数描述 对参数含义和填写要求进行说明，帮助模型理解应收集什么信息，以及信息应满足什么业务标准。例如：需要用户提供详细收货地址，至少包含省、市、区、街道等信息。 参数收集方式 支持常规收集方式与互动式收集方式。常规参数方式适合一次性从用户输入中识别参数；互动式收集方式适合参数缺失、不完整或需要追问确认的场景，包含手机号、车牌号、地址三种信息的收集。 高级配置 最多询问次数 设置机器人针对同一参数最多可追问的次数。超过该次数后，系统不再继续追问，进入兜底处理。 超过最多询问次数后，自动将参数值设置为 当用户多次未提供有效信息时，系统自动填入的默认值。可配置为空值、默认值、固定文案或业务指定值，用于保障流程继续执行。 常规收集方式 配置项 说明 询问方式 支持 Prompt 和固定话术两种方式，用于配置机器人在参数缺失、参数不完整或参数需要确认时，如何向用户发起追问。 询问话术 当参数缺失或识别不完整时，机器人用于向用户提问的文案。 收集规则 定义参数收集的判断标准，包括必填要求、格式要求、信息完整度要求、是否允许模糊值等。机器人会根据规则判断用户回答是否满足收集条件。 选择指令 指令用于外部系统与机器人对话的集成，如：转人工指令。机器人在回复时，同时随路下发指令信息供外部业务系统进行集成。 参数二次确认 开启后，机器人主动与用户二次确认参数值是否正确。 互动式收集方式 配置项 说明 截图 手机号 手机号收集用于识别和补齐用户手机号。当用户只提供部分号码、分多次输入号码，或表达中夹杂无关内容时，机器人会继续追问剩余信息，并在收集完整后进行确认。 车牌号 车牌号收集用于识别车辆牌照信息。当用户只提供车牌主体、缺少省份简称，或机器人判断车牌信息不完整时，会主动询问缺失部分，并在获得完整车牌后进行确认。 地址 地址收集用于帮助机器人在自然对话中主动收集、补全和确认用户地址信息。当用户只提供了模糊地址、不完整地址，或地址不满足业务要求时，机器人会继续追问，直到获得符合规则的地址结果。地址校验有两种方式通过高德地图API或者您自己自定义API。 说明 高德API可参考《高德地图Web服务API》； 自定义API的方式可参考《互动参数收集-地址-自定义API》。
    是否必填	打勾参数，为必收集参数，此参数能够驱动后续操作执行。

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

应用示例

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

示例流程如下：