节点功能
参数提取节点可以自动识别并收集用户在智能体应用内对话中的关键信息，并将其结构化保存为参数供后续节点使用。当用户信息不完整时，节点会主动发起追问，直到收集齐必需的参数。
让智能体像业务前台/客服一样，自动向用户要信息（姓名、电话、日期、订单号等），并整理成结构化数据，后续节点可以直接调用。
典型场景：
医疗：挂号信息收集（日期、时间、科室、患者姓名、证件号、手机号）。
电商：订单/开票信息收集（订单号、会员卡 ID、姓名、抬头）。
客服：问题受理（订单编号、问题类型、联系方式）。
预约：预约时间、地点、服务类型等信息收集。
示例用法
示例一：医院挂号信息提取
业务需求： 用户在对话中完成挂号，需要收集挂号日期、时间、科室、患者姓名、身份证号和手机号，并在信息完整后调用挂号接口。
工作流结构：
1. 开始节点：用户进入“在线挂号”流程。
2. 参数提取节点：收集挂号所需的全部参数。
3. 代码节点：调用医院挂号接口。
4. 结束节点：返回挂号结果（成功/失败原因）。
参数提取节点参数示例：
参数 | 类型 | 描述 |
挂号日期 | string | 用户提供预约挂号的日期，格式为 YYYY-MM-DD，如 2025-01-10。 |
挂号时间 | string | 挂号时刻，24 小时制 hh:mm，如 09:00、15:30。 |
科室名称 | string | 用户想要挂号的科室名称，如“心内科”“骨科门诊”。 |
患者姓名 | string | 挂号患者的真实姓名，2–4 个中文字符。 |
身份证号 | string | 18 位中国大陆身份证号，最后一位可以是数字或 X/x，不合法则设为空。 |
手机号码 | string | 11 位中国大陆手机号，必须是 11 位数字，不合法则设为空。 |
对话示例：
用户：我要挂号智能体：好的，请问您想预约哪一天？（例如 2025-01-10）用户：下周五，也就是 2025-01-10 吧智能体：收到，时间大概是几点？（例如 09:00 或 15:30）用户：上午九点智能体：好的，请问要挂哪个科室？用户：心内科智能体：请提供患者姓名用户：张三智能体：需要您的身份证号，用于就诊登记用户：110101199001011234智能体：最后确认一下您的手机号码用户：13800138000智能体：已为您预约 2025-01-10 09:00 的心内科门诊，就诊人张三。
示例二：订单信息提取与开票
业务需求： 用户申请开发票时，需要收集订单编号、会员卡 ID 和用户姓名，信息完整后调用开票接口。
工作流结构：
1. 开始节点：用户发起“我要开发票”。
2. 参数提取节点：收集订单编号、会员卡 ID、用户姓名。
3. 代码节点：调用开票接口。
4. 结束节点：返回开票结果（开票成功/失败原因）。
参数提取节点关键参数示例：
参数 | 类型 | 描述 |
订单编号 | string | 用户购买商品后生成的唯一订单标识，格式为 OH 开头 + 12 位数字，例如 OH202401150001。 |
会员卡 ID | string | 用户的会员卡唯一标识，格式为 VIP 开头 + 6–8 位数字。 |
用户姓名 | string | 开票所需的真实姓名，2–4 个中文字符。 |
对话示例：
用户：我要开发票智能体：好的，请先提供您的订单编号（例如 OH 开头的一串数字）用户：OH202401150001智能体：收到，请问您的会员卡 ID 是多少？用户：VIP888888智能体：最后确认一下发票抬头姓名用户：张三智能体：已为您受理订单 OH202401150001 的发票申请，抬头张三，会员卡 VIP888888。
操作说明
输入变量
输入变量仅在该节点内部生效，不能跨节点使用。支持最多添加 50 个输入变量，满足多输入变量场景需要。点击添加，进行如下配置以添加输入变量。
配置 | 说明 |
变量名称 | 该变量的名称，只能包含字母、数字或下划线，并且以字母或下划线开头，必填。 |
变量描述 | 该变量的说明信息，非必填。 |
数据来源 | 该变量的数据来源，支持“引用”“输入”两种选项。“引用”可选择前序所有节点的输出变量，“输入”可手动填入固定值，必填。 |
变量类型 | 该变量的数据类型，不可选择，默认为“引用”的变量类型或“输入”的 string 类型。 |
说明：
参数提取节点使用“本轮对话内容”、“对话历史”和“当前时间”三个系统变量进行参数提取，因此系统默认会传入这三个变量，无需您手动添加。
收集参数
模型选择
选择一个大语言模型用于参数提取。模型负责如下：
从用户对话中识别并提取参数值。
判断参数是否收集完整。
生成追问话术引导用户补充信息。
参数信息
点击添加，进行如下配置，添加需要提取的参数信息。
配置 | 说明 |
参数名称 | 该参数的名称，建议使用具体的中文名称，便于模型识别理解，必填。 |
参数类型 | 该参数的数据类型，必填。 参数类型为 object、array<object> 时，不支持设置“参数收集示例”和“固定询问话术”，可在节点中添加子级参数，于子级参数设置固定询问话术。 |
参数描述 | 该参数的说明信息，帮助模型精准识别理解参数，建议按照“概念定义+取值要求”进行填写，可使用 AI 一键优化调整内容，必填。 |
参数收集示例 | 该参数期望的正确示例和错误示例，正确示例将用作提示大模型哪些参数值会被提取，而错误示例则表示哪些参数值一定不能被提取，可选。 |
是否必填 | 该参数是否必填。如果参数必填，那么当用户对话中没有提供该参数信息时，系统将自动生成反问话术向用户提问；如果参数非必填，用户没有提供参数信息时，系统不会进行反问。必填。 |
提示词
如果您对参数提取过程有特殊要求，可以配置“收集参数”中的提示词，引导大模型生成相应的反问澄清话术。典型场景包括：
1. 对话中未提取到参数，告知模型如何反问用户。
提示词示例："挂号ID"参数空缺时的追问回复话术如下：
如果无法提取到"挂号ID"的参数取值，请回复以下内容进行参数取值追问："请问您的挂号ID是什么？挂号ID可以在挂号单中找到，请准确提供该信息，否则无法完成挂号流程"。
2. 回复内容有特定的格式要求或偏好
提示词示例："订餐用户称呼"参数的回复话术如下：
如果提取到"订餐用户称呼"的参数取值，且取值为单个姓氏时，请按以下称谓格式回复用户："xx先生/xx女士"。比如："订餐用户称呼"取值为"李"、"姓李"需要礼貌地称对方为"李先生/女士"。
提示词支持功能：
版本：支持将当前提示词草稿保存为一个版本，并填写版本说明。已保存的版本可以在查看版本记录里进行查看和复制，版本记录仅会展示当前所在提示词框下创建的版本。支持在内容对比中选择两个版本，查看它们的提示词内容差异。
模板：设定好的角色指令格式模板，建议按照模板填写，指令遵循效果更佳。编写指令后也可以点击模板 > 保存为模板将编写好的指令存为模板。
AI 一键优化：初步完成角色设定后，可单击一键优化对角色设定内容进行优化，模型将基于已输入的内容优化设定，能够使模型更好地完成对应的要求。
注意：
AI 一键优化功能将消耗用户的 tokens 资源。
输出变量
参数提取节点完成后，将输出以下变量供后续节点使用：
变量 | 说明 |
参数名（动态） | 您配置的每个参数都会作为一个输出变量，变量名即参数名称，例如配置“订单编号”参数后会有 订单编号 字段。 |
Error | 运行时错误信息（object），正常运行时为空，发生错误时包含错误详情。 |
引用方式示例：
{{参数提取.输出.订单编号}}{{参数提取.输出.用户手机号}}{{参数提取.输出.收货地址}}
参数模板
以下为参数提取节点常见的参数模板，您可以根据业务需求复用并调整参数模板内容。
时间类参数
日期
典型场景：挂号时获取用户挂号日期，有严格的格式要求（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或者为负数，那么将木材长度取值设置为空""。如果用户仅仅提供数字而没有提供计量单位，或者仅仅提供计量单位而没有提供数字时，表示木材的长度信息空缺，应该将木材长度取值设置为空""。
常见问题
节点是否支持复制？
支持。如果您希望复制其他参数的配置信息，可以单击新增参数框右上角的“复制”图标，选择您需要的参数进行复制。
