列表操作符

列表操作符节点通过筛选、排序和选择特定元素来处理数组。当你需要处理混合文件上传、大型数据集或任何需要在下游处理之前进行分离或组织的数组数据时，请使用它。

​

数组处理问题

大多数工作流节点期望单个值，而不是数组。当你在一个变量中有像 [image.png, document.pdf, audio.mp3] 这样的混合内容时，你需要将其分离成下游节点可以有效处理的专注流。 列表操作符充当智能路由器，使用过滤器分离混合数组并为专门处理做好准备。

​

支持的数据类型

该节点处理不同的数组类型，并提供相应的筛选选项： Array[string] - 文本列表、类别、名称或任何字符串集合 Array[number] - 数值数据、分数、测量值或计算结果 Array[file] - 具有丰富元数据筛选功能的混合文件上传

​

操作

​

筛选

根据属性提取特定项目。对于文件数组，可以按以下条件筛选：

​

排序

按任何属性组织筛选结果： 升序（ASC） - 从最小到最大值，A-Z 字母顺序 降序（DESC） - 从最大到最小值，Z-A 逆序

​

选择

从处理后的数组中选择特定元素： 取前 N 个 - 在筛选和排序后选择前 1-20 个项目 第一条记录 - 仅返回第一个匹配元素作为单个值 最后一条记录 - 仅返回最后一个匹配元素作为单个值

​

输出变量

result - 完整的筛选和排序数组，用于批量处理 first_record - 来自开头的单个元素，非常适合”主要”或”最新”项目选择 last_record - 来自末尾的单个元素，用于”最近”或”最终”选择

​

混合文件处理示例

处理用户同时上传文档和图像的工作流： 实施步骤：

1. 配置混合上传 - 启用文件上传功能以接受多种文件类型
2. 按类型分离 - 使用带有不同过滤器的独立列表操作符节点：
   • 筛选 type = "image" → 路由到具有视觉能力的大型语言模型
   • 筛选 type = "document" → 路由到文档提取器
3. 适当处理 - 图像被直接分析，文档进行文本提取
4. 合并结果 - 将处理后的输出合并为统一响应

这种模式自动将不同文，创建无缝的多模态用户体验。

​

常见用例

文件类型路由 - 根据内容类型将混合上传分离到专门的处理管道中。 数据筛选 - 根据特定条件从大型数据集中提取相关子集。 内容优先级排序 - 从集合中排序并选择最重要或最近的项目。 质量控制 - 在处理前筛选出无效、超大或不支持的内容。 批处理准备 - 将数据组织成可管理的块，用于下游迭代或并行处理。

​

最佳实践

规划筛选条件 - 根据下游处理要求定义清晰的筛选规则。 使用适当的输出类型 - 根据下游节点如何使用数据，选择完整数组、第一条记录或最后一条记录。 处理空结果 - 考虑筛选器返回无匹配时会发生什么，并规划适当的后备逻辑。 使用真实数据测试 - 使用实际用户上传验证筛选行为，确保在生产环境中可靠运行。