批处理节点

低代码工作流的批处理节点用于批量执行部分操作。

节点说明

工作流执行时，每个节点按顺序运行一次，如果需要一次性运行多次，例如一次性查询多个城市的天气，可以使用批处理节点提高工作流效率。批处理节点会批量运行除批处理和循环节点以外的任何节点，直到达到次数限制或者列表的最大长度。
批处理节点适用于大量数据并行处理的场景。相对于添加多个相同的节点执行任务，批处理节点的效率更高。例如批量生成根据故事生成绘本的场景，需要根据每个故事片段生成对应的图片，你可以使用批处理节点执行文生图的工作流，一次性生成多张图片。

配置批处理节点

批处理节点的处理对象为输入参数引用的数组结构，例如上游某个节点输出的多条数据结果。批处理节点会遍历数组中的每个元素，对所有元素同时执行一次性处理，直到所有元素处理完成，或达到指定的次数上限。

批处理设置

为避免并行运行数量过大导致性能风险，批处理节点是分批运行的，默认每批执行 10 次，最多运行 200 次。通过批处理设置，你可以调整每一批运行的最大次数，和多批处理的总次数上限。具体参数包括：

• 并行运行数量上限：每一批运行的最大次数。默认并行运行 10 次。此参数可指定为某个固定值，例如 5；也支持引用上游节点数值类型的的输出参数。

  说明

  并行运行数量参数的引用值如果大于 10，则设置为 10，如果小于 1，则设置为 1。

• 批处理次数上限：批处理执行总次数达到此上限时，此节点终止运行。默认批处理次数上限为 100，最大支持设置为 200。此节点的执行逻辑是处理数组中的元素，当批处理次数达到设置的上限时，即使节点未遍历数组中的每个元素，也会停止运行。

例如批处理的处理对象是一个长度为 50 的数组，设置并行运行数量上限为 10，设置批处理次数上限为 30，那么批处理节点只会执行 3 批，每一批同时运行 10 次，共计执行 30 次后就结束运行。

输入

输入参数指批处理体中要使用的参数。批处理节点通常需要批量处理数组中的所有元素，那么可以在批处理节点定义输入参数，引用前置节点 Array 类型的输出，批处理体中就可以引用批处理节点输入参数中的某个元素或索引，否则只能引用上游节点 Array 类型参数的整个数组结构。
批处理节点应最少设置一个输入参数，且只能引用上游节点的 Array 类型。

输出

输出参数是批处理完成后输出的内容，仅支持引用批处理体中节点的输出变量。输出参数格式为数组，自动整合批处理中每一次的执行结果。

批处理体

批处理体和循环体类似，每个批处理节点都会生成一个批处理体画布。开发者需要选中批处理体，通过拖拉拽的方式将待批处理的节点添加到批处理体中，并使用连接线依次将批处理体和各个节点顺序连接起来。你还需要在批处理节点和上下游节点之间添加连线，但无需调整批处理体和批处理节点之间的连线。

示例

例如通过视觉理解模型批量分析图片内容。添加一个批处理节点，其中只有一个大模型节点，用于批量分析多张图片。开始节点接收图片数组后传递给批处理节点，视觉模型会处理图片数组中每个图片元素。工作流的编排方式如下：

工作流核心节点如下：

常见问题

如何设置批处理次数

批处理节点会按照设定的并行数量分批运行批处理体，直到处理的数组中所有元素处理完成，或达到指定的次数上限。你可以调整待处理的数组长度，或者通过批处理次数上限来限制批处理节点的最大运行次数，后者最大值为 200。

批处理节点和循环节点有什么区别

• 应用场景：批处理节点通常用于批量执行一组数据或任务，目的是对整个数据集进行一次性并行处理，而不是逐个处理，运行效率更高。循环节点用于循环执行某个操作或任务，直到满足指定条件为止。循环节点的核心是“次序性”，每次循环处理一个数据子项或执行一次子任务，总耗时可能较长。
• 运行方式：批处理节点仅支持处理数组参数，运行次数默认为数组长度，处理完毕后自动结束运行；循环节点支持多种方式结束循环，例如设置固定的循环次数、数组长度、指定条件等等。