节点功能
腾讯云智能体开发平台工作流将从对话中提取的重要信息称为参数，参数可以是名词、地名、手机号码、医院名称等。
参数提取节点属于信息收集类节点，通过与用户进行多轮对话来收集参数，参数信息需要根据您的业务场景进行定义。工作流执行至该处会中断与用户进行交互，直到收集到必需的参数。
操作说明
输入变量
输入变量仅在该节点内部生效，不能跨节点使用。支持最多添加50个输入变量，满足多输入变量场景需要。点击添加，进行如下配置添加输入变量。
配置 | 说明 |
变量名称 | 该变量的名称，只能包含字母、数字或下划线，并且以字母或下划线开头，必填 |
变量描述 | 该变量的说明信息，非必填 |
数据来源 | 该变量的数据来源，支持“引用”“输入”两种选项。“引用”可选择前序所有节点的输出变量，“输入”可手动填入固定值，必填 |
变量类型 | 该变量的数据类型，不可选择，默认为“引用”的变量类型或“输入”的 string 类型 |
说明：
参数提取节点使用“本轮对话内容”、“对话历史”和“当前时间”三个系统变量进行参数提取，因此系统默认会传入这三个变量，无需您手动添加。
收集参数
模型
您可设置该节点所使用的大语言模型从与用户对话中提取所需参数，仅支持选择该账号具有权限的大模型。
参数信息
点击添加，进行如下配置，添加需要提取的参数信息。
配置 | 说明 |
参数名称 | 该参数的名称，建议使用具体的中文名称，便于模型识别理解，必填 |
参数类型 | 该参数的数据类型，必填。 参数类型为 object、array<object> 时，不支持设置“参数收集示例”和“固定询问话术”，可在节点的添加子级参数，于子级参数设置固定询问话术。 |
参数描述 | 该参数的说明信息，帮助模型精准识别理解参数，建议按照“概念定义+取值要求”进行填写，可使用 AI 一键优化调整内容，必填 |
参数收集示例 | 该参数期望的正确示例和错误示例，正确示例将用作提示大模型哪些参数值会被提取，而错误示例则表示哪些参数值一定不能被提取，可选 |
是否必填 | 该参数是否必填。如果参数必填，那么当用户对话中没有提供该参数信息时，系统将自动生成反问话术向用户提问；如果参数非必填，用户没有提供参数信息时，系统不会进行反问。必填 |
提示词
如果您对参数提取过程有特殊要求，可以配置“收集参数”中的提示词，引导大模型生成相应的反问澄清话术。典型场景包括：
1. 对话中未提取到参数，告知模型如何反问用户。
提示词示例："挂号ID"参数空缺时的追问回复话术：
如果无法提取到"挂号ID"的参数取值，请回复以下内容进行参数取值追问："请问您的挂号ID是什么？挂号ID可以在挂号单中找到，请准确提供该信息，否则无法完成挂号流程"。
2. 回复内容有特定的格式要求或偏好
提示词示例："订餐用户称呼"参数的回复话术：
如果提取到"订餐用户称呼"的参数取值，且取值为单个姓氏时，请按以下称谓格式回复用户："xx先生/xx女士"。比如："订餐用户称呼"取值为"李"、"姓李"需要礼貌地称对方为"李先生/女士"。
输出变量
经该节点处理后的输出变量，默认为用户配置的参数，以及运行时报错信息 Error（数据类型为 object，正常运行时该字段为空）。不支持用户手动新增。
节点示例
用户需要开发票时，使用参数提取节点收集必需的订单编号、会员卡 ID 和用户姓名参数信息。
参数提取节点配置如下：
参数模板
以下为参数提取节点常见的参数模板，您可以根据业务需求复用并调整参数模板内容。
时间类参数
日期
典型场景：挂号时获取用户挂号日期，有严格的格式要求（YYYY-MM-DD），需要用户明确提供年、月、日，而不能仅仅提供某日、某月某日等。
参数配置：
参数名称：挂号日期参数描述：用户提供预约挂号的日期，格式为YYYY-MM-DD。如2025-01-10表示2025年1月10日。如果用户提供的是模糊的日期描述，如仅仅为xx月xx日（缺乏年份）、或仅仅为xx日（缺乏年月），此时挂号日期不完整，需要将挂号日期参数取值设置为空""。
时间点
典型场景：挂号时获取用户的准确挂号时刻，有严格的格式要求，采用24小时制（hh:mm）。
参数配置：
参数名称：挂号时间参数描述：用户想要预约挂号的具体时刻，采用24小时制的时间格式（hh:mm），hh表示小时，mm表示分钟。如9:00表示为早上九点、15:30表示为下午三点半。
字符串类参数
手机号
典型场景：员工信息录入时获取录入的手机号码，格式为中国大陆的手机号，需要对手机号码进行校验。
参数配置：
参数名称：员工手机号码参数描述：用户输入的员工手机号码，需要对用户输入的手机号码进行校验：（1）中国手机号码校验：必须中国内地手机号码，如果提供员工手机号码不是中国内地手机号，此时为无效的手机号码格式，必须将员工手机号码取值设置为空""；（2）位数校验：员工手机号码必须为11位阿拉伯数字，如果提供的员工手机号码位数不是11位数字，此时为无效的手机号码格式，必须将员工手机号码取值设置为空""
身份证号
典型场景：员工信息录入时获取录入的员工身份证号，需进行格式校验。
参数配置：
参数名称：员工身份证号参数描述：用户输入的员工身份证号，合法的身份证号格式必须满足以下两个要求：（1）合法的身份证号总共有18位（2）合法的身份证号最后一位必须由阿拉伯数字，字母X或字母x组成如果用户提供的员工身份证号不满足这两个要求，为无效的身份证号码，必须将员工身份证号取值重置为空""
地点类参数
国家
典型场景：寄国际快递时获取用户提供的收件国家。要求为外国国家，且能根据城市自动转换对应国家（如果业务场景中存在小众城市，建议建立数据库直接查询）。
参数配置：
参数名称：收件国家参数描述：快递最终送达的外国国家，必须是具体的外国国家名称，如：美国、英国等。如果提取到的参数取值为外国收件城市时，必须自动转换为对应的国家名。
单位类参数
长度
典型场景：木材入库记录时获取木材长度，需要给出计量单位，保留小数点后一位。
参数配置：
参数名称：木材长度参数描述：用户提供的木材长度，格式为阿拉伯数字+中文长度单位，木材长度必须为大于0的数值，且需要保留小数点后一位。如1.0米，15.5厘米。如果用户提供长度等于0或者为负数，那么将木材长度取值设置为空""。如果用户仅仅提供数字而没有提供计量单位，或者仅仅提供计量单位而没有提供数字时，表示木材的长度信息空缺，应该将木材长度取值设置为空""。
常见问题
节点是否支持复制？
支持。如果您希望复制其他参数的配置信息，可以单击新增参数框右上角的“复制”图标，选择您需要的参数进行复制。
