更新时间:2025-07-02 GMT+08:00

变量聚合节点

变量聚合节点能够对多个分支的输出进行聚合处理,方便后置节点统一配置。

如果工作流中设计了多个分支,往往需要一个节点来汇总所有分支的输出结果。在这种场景下,你可以使用变量聚合节点聚合多路分支的输出变量,变量聚合节点会读取多路分支中第一个不为空的值,供流程下游的节点使用和操作,不用额外处理未运行分支的输出结果,简化了数据流的管理。

变量聚合节点为可选节点,若无需配置,可跳过该步骤。

变量聚合节点配置步骤如下:

  1. 拖动左侧“变量聚合”节点至画布中,单击该节点以打开节点配置页面。
  2. 参照表1,完成变量聚合节点的配置。
    表1 变量聚合节点配置说明

    配置类型

    参数名称

    参数说明

    配置示例(按场景写)

    参数配置

    输出参数

    • 参数名称:固定为 Group1,如果有多个分组则根据分组数量递增为 Group2、Group3 等。
    • 参数类型:取决于对应聚合分组的变量数据类型。

    /

    聚合策略

    -

    通过指定策略对每个分组中的所有变量进行聚合处理,同一组内的变量实施相对应的聚合策略。

    目前聚合策略仅支持设置为“返回每个分组中第一个非空值”,支持拖动变量、调整变量位置。例如组内按顺序设置三个变量 output1、output2 和 output3,将其聚合为一个变量 Group1,如果 ouput1 不为空,则用 output1 的值为 Group1 赋值;如果 ouput1 为空,则取 ouput2 的值,依次类推。

    目前聚合策略仅支持设置为“返回每个分组中第一个非空值”。

    聚合分组

    -

    默认只有一个分组 Group1,对应一个输出变量 Group1。分组中所有变量类型相同。如果需要输出多个变量,可以添加多个分组,依次递增为 Group2、Group3等。

    /

    聚合变量

    -

    在聚合分组中选择需要聚合的变量,每个分组只能聚合一种数据类型的变量。例如将多个 String 类型的变量聚合为一个 String 变量、将多个 Integer 类型的变量聚合为一个 Integer 变量。

    例如判断节点或意图识别节点会将工作流拆分为多路分支,每次执行时,工作流会根据判断条件或用户意图决定运行其中某一个分支,此时未执行的其他分支输出变量为空。你可以将多路分支都连接到变量聚合节点,并设置一个输出变量。无论哪条分支被执行,其结果都能通过这个变量被引用与访问,避免了下游节点对相同语义输出变量的重复定义。

    图1 变量聚合节点配置示例

  3. 节点配置完成后,单击“确定”。
  4. 连接变量聚合节点和其他节点。