对象提取

前提条件

已完成工作流搭建，如果未搭建工作流，请参考搭建工作流。

节点说明

通过使用“对象提取节点”，用户可以更高效地管理和维护工作流，提高工作效率，同时减少配置错误的可能性。

配置对象提取

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 在左侧导航栏选择“开发中心 > 应用管理 > 工作流应用”，单击您创建的工作流。
3. 单击“添加节点”并选择“对象提取”节点。
4. 通过单击该节点打开节点配置页面。
5. 参照表1，完成对象提取节点的配置。
   

   • 单击图标，可修改对象提取节点名称，修改完成后单击名称旁边的进行保存。
   • 单击图标，可重命名对象提取节点名称，复制对象提取节点或删除对象提取节点。
   • 单击图标，可对对象提取节点进行测试。

   表1 对象提取节点配置说明

   配置类型	参数名称		参数说明
   输入参数	输入参数		支持配置一个或多个输入参数，且输入参数可被后置节点引用。 当单击图标时，可新增输入参数。 参数名称：只允许输入字母、数字、下划线，且不能以数字开头。 类型、值：支持“引用”和“输入”两种类型。 引用：用户可以选择工作流中该节点的前置节点的输出变量及全局配置的记忆变量作为取值。 输入：支持用户自定义取值。
   上下文变量	上下文变量		上下文变量可被子工作流引用，并在整个会话内生效，作为本节点的输出参数。 当单击图标时，可新增上下文变量。 变量名称：只允许输入字母、数字、下划线，且不能以数字开头。 变量类型：支持String、Integer、Number、Boolean、Object、Array<String>、Array<Number>、Array<Integer>、Array<Boolean>、Array<Object>多种类型的变量。 新增上下文变量： 第一层级：变量类型默认为Object，支持修改为其他类型，修改后的类型不支持添加分支；其中Object类型参数最多支持5层嵌套。 分支：变量类型默认为String，支持修改为其他类型，不支持添加分支。 类型：支持“引用”和“输入”两种类型。 描述（可选）：对于该上下文变量的描述。 单击可删除已添加的上下文变量。 单击图标，可通过对象模板添加上下文变量，对象模版创建详见对象管理页面。
   领域对象	领域对象		领域对象可被子工作流引用，并在整个会话内生效。 当单击图标时，可新增领域对象。该参支持添加多个领域对象。 变量名称：只允许输入字母、数字、下划线，且不能以数字开头。 变量类型：支持String、Integer、Number、Boolean、Object、Array<String>、Array<Number>、Array<Integer>、Array<Boolean>、Array<Object>。 新增领域对象： 第一层级：变量类型默认为Object，支持修改为其他类型，修改后的类型不支持添加分支；其中Object类型参数最多支持5层嵌套。 分支：变量类型默认为String，支持修改为其他类型，不支持添加分支。 描述（可选）：对于该领域对象的描述。 单击可删除已添加的领域对象。 单击图标，可通过对象模板添加领域对象，对象模版创建详见对象管理页面。
   	对象处理流（可选）		模型在完成对象提取后，按定义顺序依次执行多个对象处理流，且执行时机晚于扩展工作流“模型提参后”。 当单击图标时，可新增对象处理流。一个领域对象支持添加多个工作流，支持根据业务执行顺序拖动工作流。 已添加的工作流如果有更新，支持在对象提取节点中进行升级并查看配置。 添加工作流后，单击可配置子工作流，设置允许用户配置工作流节点的进入条件。 输入参数：调用子工作流开始节点的参数，用户不支持选择。 参数名称：为子工作流开始节点的参数名称，不可编辑。 类型与子工作流的开始节点类型保持一致，值支持用户自定义取值；同时系统支持自动填入相同类型和名称的参数值。 输出参数：工作流节点的输出结构取决于子工作流定义的输出结构，不支持自定义设置。 上下文变量：变量名称、类型默认全部读取子工作流中的全局配置中的记忆变量参数，不支持修改和删除。上下文变量值支持用户自定义取值，也可不填参数值，同时系统支持自动填入相同类型和名称的参数值。 进入条件（可选）：进入本工作流条件，若不配置，默认进入。 由[判断参数 比较条件 比较参数]组成一个条件表达式。 判断参数：条件表达式左边部分，需要选择来自前序节点的输出参数。 比较条件：条件表达式中间部分，当前支持的比较条件有：长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。 比较参数：条件表达式右边部分，支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。 输入：支持用户自定义取值。 添加条件：单击，在当前条件分支中添加多个条件表达式，多个条件表达式之间通过“且”或“或”来连接。 单击“且”或“或”，可以切换该分支表达式的运算逻辑。 备注（可选）：描述子工作流节点功能。 单击进入工作流版本预览界面，可预览子工作流、节点配置及版本信息。 单击可删除已添加的子工作流。
   模型提参配置	选择配置	选择模型	选择已配置的大语言模型。
   		温度	当单击图标时，可进行该参数设置，推荐使用默认值。 用于控制生成结果的随机性。调高温度，会使得模型的输出更具多样性和创新性；降低温度，会使输出内容更加遵循指令要求，但同时也会减少模型输出的多样性。
   		核采样	当单击图标时，可进行该参数设置，推荐使用默认值。 模型在输出时会从概率最高的词汇开始选择，直到这些词汇的总概率累积达到核采样值，核采样值可以限制模型选择这些高概率的词汇，从而控制输出内容的多样性。建议不要与温度同时调整。
   		历史对话轮数	当单击图标时，可进行该参数设置，推荐使用默认值。 设置带入模型上下文的对话历史轮数。轮数越多，多轮对话的相关性越高，但消耗的Token也越多。
   		最大回复长度	当单击图标时，可进行该参数设置，推荐使用默认值。 控制模型输出的Tokens长度上限。通常100Tokens约等于150个中文汉字。
   		重复语句惩罚	当单击图标时，可进行该参数设置，推荐使用默认值。 当该值为正时，会阻止模型频繁使用相同的词汇和短语，从而增加输出内容的多样性。
   	参数提取配置		模型依据提示词和参数描述尝试进行对象提取，若未能提取，参数提取的变量名称为空。 当单击图标时，可新增一条参数。一个模型支持添加多个参数。 变量名称：与提取的参数名称保持一致，支持用户自定义填写。只允许输入字母、数字、下划线，且不能以数字开头。 变量类型：与提取的参数名称的类型保持一致，支持切换其他类型。支持String、Integer、Number、Boolean、Object、Array<String>、Array<Number>、Array<Integer>、Array<Boolean>、Array<Object>。 描述（可选）：描述变量功能。 单击可删除已添加的子工作流。
   	提示词配置		配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 当单击图标时，可对提示词进行智能优化。 当单击图标时，系统会弹出“提示词广场”窗口，可在“预置提示词”或“我的提示词”页签中进行选择。
   扩展工作流（可选）	扩展工作流		当单击图标时，可新增扩展工作流，支持添加多个工作流。已添加的工作流如果有更新，支持在对象提取节点中进行升级并查看配置。 添加工作流后，单击“执行时机”下拉框，配置子工作流的执行时机。 首次进入：进入节点后执行，且只执行一次。 模型提参后：大模型完成对象提取后执行。 退出条件判断前：退出条件判断前执行。 多个相同执行时机的扩展工作流按照定义先后顺序依次执行。 添加工作流后，单击可配置子工作流，设置允许用户配置工作流节点的进入条件。 输入参数：配置子工作流开始节点的输入参数，类型与子工作流的开始节点类型保持一致，值支持用户自定义取值，同时系统支持自动填入相同类型和名称的参数值。 输出参数：工作流节点的输出结构取决于子工作流定义的输出结构，不支持自定义设置。 上下文变量（可选）：支持将参数提取节点的领域对象、上下文变量传入子工作流，并可在子工作流内部通过变量赋值节点修改。同时需要先在子工作流全局变量中定义记忆变量，同时系统支持自动填入相同类型和名称的参数值。 进入条件（可选）：进入本工作流条件，若不配置，默认进入。 由[判断参数 比较条件 比较参数]组成一个条件表达式。 判断参数：条件表达式左边部分，需要选择来自前序节点的输出参数。 比较条件：条件表达式中间部分，当前支持的比较条件有：长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。 比较参数：条件表达式右边部分，支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。 输入：支持用户自定义取值。 添加条件：单击，在当前条件分支中添加多个条件表达式，多个条件表达式之间通过“且”或“或”来连接。 单击“且”或“或”，可以切换该分支表达式的运算逻辑。 备注（可选）：描述子工作流节点功能。 单击进入工作流版本预览界面，可预览子工作流、节点配置及版本信息。 单击可删除已添加的子工作流。
   条件配置（可选）	模型提参条件		使用模型对象提取的条件，若不配置，默认使用。 进入条件（可选）：进入本工作流条件，若不配置，默认进入。 由[判断参数 比较条件 比较参数]组成一个条件表达式。 判断参数：条件表达式左边部分，需要选择来自前序节点的输出参数。 比较条件：条件表达式中间部分，当前支持的比较条件有：长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。 比较参数：条件表达式右边部分，支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。 输入：支持用户自定义取值。 添加条件：单击，在当前条件分支中添加多个条件表达式，多个条件表达式之间通过“且”或“或”来连接。 单击“且”或“或”，可以切换该分支表达式的运算逻辑。
   	节点退出条件		节点退出条件：退出本节点的条件，若不配置，执行一轮后退出。 进入条件（可选）：进入本工作流条件，若不配置，默认进入。 由[判断参数 比较条件 比较参数]组成一个条件表达式。 判断参数：条件表达式左边部分，需要选择来自前序节点的输出参数。 比较条件：条件表达式中间部分，当前支持的比较条件有：长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。 比较参数：条件表达式右边部分，支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。 输入：支持用户自定义取值。 添加条件：单击，在当前条件分支中添加多个条件表达式，多个条件表达式之间通过“且”或“或”来连接。 单击“且”或“或”，可以切换该分支表达式的运算逻辑。
   	节点异常条件		进入异常分支条件，若不配置，无异常分支。添加节点异常条件后需要在对象提取参数后设置异常处理分支。 进入条件（可选）：进入本工作流条件，若不配置，默认进入。 由[判断参数 比较条件 比较参数]组成一个条件表达式。 判断参数：条件表达式左边部分，需要选择来自前序节点的输出参数。 比较条件：条件表达式中间部分，当前支持的比较条件有：长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。 比较参数：条件表达式右边部分，支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。 输入：支持用户自定义取值。 添加条件：单击，在当前条件分支中添加多个条件表达式，多个条件表达式之间通过“且”或“或”来连接。 单击“且”或“或”，可以切换该分支表达式的运算逻辑。
   备注（可选）	备注		用于描述对象提取节点实现的功能，可在画布中的节点内展示，支持多种数据类型，长度0~512个字。

   图1 对象提取节点配置示例
   

6. 节点配置完成后，单击“确定”。
7. 连接对象提取节点和其他节点。