数据集合节点

本文介绍 AI FLOW 中「数据集合」应用的使用方法，帮助流程开发者实现循环结果的低成本汇总。

概述

「数据集合」应用提供可视化的循环结果汇总能力。在循环（Loop）中逐条处理数据时，可将每次处理结果追加到数据集合中，循环结束后一次性获取所有结果，无需编写自定义脚本。

✅

核心价值：替代手动编写「创建变量 + JS append 逻辑」的繁琐做法，通过可视化节点实现循环数据汇总。

前提条件

已拥有 AI FLOW 流程编辑权限

已了解循环（Loop）节点的基本用法

应用节点概览

创建数据集合

创建一个空的临时数据集合，获取唯一集合 ID

添加数据至指定集合

将数据追加到指定集合中，通常在循环内使用

获取指定数据集合记录

查询集合的全部数据，用于循环结束后获取汇总结果

操作步骤

步骤 1：添加「创建数据集合」节点

在循环节点之前，添加「数据集合」应用的「创建数据集合」节点。

参数	说明
集合 ID	系统自动生成的唯一标识，不可编辑

节点输出：{"id": "key-xxxxxxx"}

说明：集合 ID 将在后续节点中用于指定目标集合，请记住该节点的位置以便引用。

步骤 2：在循环内添加「添加数据至指定集合」节点

在循环（Loop）节点内部，添加「添加数据至指定集合」节点。

参数	类型	说明
添加方式	下拉选择	列表模式（默认）/ 字段模式，详见下方「添加方式说明」
设置数据	key-value	配置每次循环要追加的数据结构
集合 ID	文本	填入目标集合的 ID

步骤 3：添加「获取指定数据集合记录」节点

在循环节点之后，添加「获取指定数据集合记录」节点。

参数	说明
集合 ID	填入要查询的集合 ID

节点输出：返回该集合的全部数据（列表模式为数组，字段模式为对象）。

添加方式说明

列表模式（默认）

每次循环作为一条记录加入集合。

输出示例：[{"name": "张三"}, {"name": "李四"}]

字段模式

把同一字段的多个值整理到同一个数组里。

输出示例：{"name": ["张三", "李四"]}

典型使用流程

典型场景示例

分页接口查询汇总

多次 API 提取字段

AI 多轮推理汇总

流程结构：创建集合 → Loop（分页次数）→ 调用 API 获取本页数据 → 添加至集合（列表模式）→ 获取集合数据 → 输出全部列表

输出结果：

[
  {"id": 1, "name": "张三"},
  {"id": 2, "name": "李四"}
]

边界情况与限制

情况	处理方式
多个「添加数据」节点关联相同集合 ID 但数据结构不一致	以第一个节点的数据结构为准，后续不一致时报错：「当前添加数据与当前集合数据结构不一致」
添加的数据本身是数组	正常执行 append 逻辑
循环次数过大	流程日志仅展示前 100 条，实际运行使用全量数据
单个集合数据量限制	最大支持 20MB
集合 ID 不存在	执行报错：「当前节点 id 不存在」
字段值不存在	自动为缺失字段补齐 null 值

注意

单个集合最大支持 20MB 数据量。如果循环次数极大且每条数据较大，请注意监控集合容量。

常见问题

Q：列表模式和字段模式应该如何选择？

Q：集合 ID 如何在后续节点中引用？

Q：为什么流程日志中只显示了部分数据？

概述#

前提条件#

应用节点概览#

操作步骤#

添加方式说明#

典型使用流程#

典型场景示例#

边界情况与限制#

常见问题#

概述

前提条件

应用节点概览

操作步骤

添加方式说明

典型使用流程

典型场景示例

边界情况与限制

常见问题