变量处理节点-大模型服务平台百炼(Model Studio)-阿里云帮助中心

当工作流中需要为输出添加统一格式、将数据组装成JSON对象、或汇总多分支结果避免空值报错时，变量处理节点通过格式化、组合和聚合功能，使数据按期望形式流转到下游节点。

接入节点

点击输出模式下拉框，可选择目标模式。变量处理节点支持三种输出模式。

在编辑框中直接输入待处理的内容，或通过输入“/”插入前置节点或会话变量，例如：

简单变量引用：插入变量开始节点/query，输出用户输入的内容
格式化输出：在变量前后添加文本，例如您好！您的问题是：{{开始节点/query}}，我会尽快为您解答。
多变量组合：组合多个变量和文本，例如用户{{开始节点/name}}的问题{{开始节点/query}}已处理完成，结果：{{大模型节点/result}}。

输出格式化的JSON类型，将输入的变量转换为JSON格式。

列名	类型	必填	说明
变量名	String	是	JSON对象的键名，用于标识输出JSON中的字段。支持字母、数字、下划线，不能为空，不能包含特殊字符。建议使用有意义的名称（如name、question、answer）。
引用方式	选项	是	输入：可在变量值中直接输入文本内容。引用：可在变量值中引用上游节点的输出变量或内置变量。
值	String	是	引用方式为输入时直接输入文本内容；引用方式为引用时输入 `/` 触发变量选择菜单，选择要引用的变量。

聚合分组模式用于从多个变量中选择一个有效值输出。节点会按照预设的策略，从分组内的多个变量中选择一个非空的值输出。

选项	说明	示例
返回每个分组中第一个非空的值	默认选项，按变量顺序返回第一个有值的变量。适用于条件判断节点多分支聚合场景，无论哪个分支执行都能获取到有效的变量值。	分组中有var1（空）、var2（“值2”）、var3（“值3”），输出“值2”。
返回每个分组中最后一个非空的值	按变量顺序返回最后一个有值的变量。适用于需要获取最新值的场景。	分组中有var1（“值1”）、var2（空）、var3（“值3”），输出“值2”。

默认关闭。仅在API调用应用时生效，用于决定是否输出本节点内容。该功能即将下线。

本节点的输出结果存储在输出变量中，可作为变量被后续节点引用。

文本输出模式下，输出变量名为result，类型为String，值为模板内容处理后的文本结果。

变量名	类型	说明
result	String	模板内容处理后的文本结果，包含变量引用和静态文本的组合内容。

变量名	类型	说明
result	Object	包含整个JSON对象，结构为 `{"变量名1":"值1","变量名2":"值2",...}`。
变量名	String	输出变量名与配置的变量名一致，值为该变量的实际值。

聚合分组模式下，每个分组对应一个输出变量，变量名与分组名对应（如Group1、Group2等），类型为String，值为分组策略选择的有效值。

变量名	类型	说明
Group1	String	第一个分组的输出变量，值为分组策略选择的有效值（第一个或最后一个非空值）。
Group2	String	第二个分组的输出变量（当存在多个分组时），值为分组策略选择的有效值。

配合节点	输出模式	常见用法
大模型节点 → 变量处理节点	文本输出	格式化大模型输出内容，为回复添加前缀、后缀或组合多个变量。
大模型节点 → 变量处理节点 → API节点	JSON输出	将大模型提取的多个字段打包成JSON对象，供API节点调用。适用于需要结构化数据传递的场景。
变量处理节点 → HTTP节点	JSON输出	将多个变量格式化为JSON格式，传递给HTTP接口进行外部系统集成或数据存储。
条件判断节点 → 变量处理节点	聚合分组	在条件判断节点的多个分支后使用聚合分组模式，自动选择执行分支产生的有效值输出，避免下游节点接收到空值导致报错。
意图分类节点 → 变量处理节点	聚合分组	在意图分类节点的多个分支后使用聚合分组模式，将不同意图处理结果统一聚合后传递给下游节点，确保工作流正常执行。

不可以。JSON输出模式生成的是单层键值对结构，所有值的类型均为String。如果需要嵌套结构（如包含数组或子对象的JSON），建议在下游节点中进行二次处理。