Dify迭代器组件详解与实战指南
先给出几个关键认知。Dify 的迭代器组件本质上是数据流的“循环处理器”——喂入一组数据，它会逐个处理每个元素。这与编程中的 foreach 循环类似：输入为数组，输出同样为数组。它真正解决的是需要“批量执行、重复操作”的场景，从单个字母到完整单词，再到复杂的文本生成任务，均可胜任。
一个极简可用工作流：从字母到单词
来看一个最直观的示例。这个工作流要完成的任务很简单：将字母 a、b、c 分别转换为以该字母开头的英文单词，并按固定格式输出。整个流程分为四个阶段：初始化 → 合并列表 → 迭代处理 → 输出结果。
效果图如下：
点击运行后，你应当看到类似这样的输出：Loop 0:a->AppleLoop 1:b->BananaLoop 2:c->Cat
下面详细拆解这个工作流的搭建步骤。
工作流搭建：逐步操作
1. 初始化：用三个模板转换组件分别赋值
先拉三个模板转换组件，分别填入 a、b、c。这一步很简单，相当于为每个节点设定一个初始变量。
2. 合并列表：用一个代码节点将它们串联
接着添加一个代码执行节点，接收上述三个节点的输出，执行简单的合并操作。逻辑很直接：将三个字符串拼成一个 JSON 对象，键设为 result，值设为字符串数组。预期结果是 ["a", "b", "c"]。这一步是所有循环处理的基础——迭代器需要数组作为输入。
3. 迭代器组件：真正的核心处理单元
现在引入迭代器。它的任务是：按顺序提取列表中的每个元素，交给大模型生成单词，再通过格式处理节点标记溯源信息，便于后续分析。
迭代器的输入是数组（即上一步生成的 ["a","b","c"]），输出是字符串。运行时，每次迭代的结果会被缓存到一个新数组中，供后续节点使用。从功能上看，此次演示仅是一个极简版本，目的是帮你理解“循环”与“批处理”的逻辑。后续有机会，会复原官方提供的长篇小说生成案例——那才是它真正发挥实力的场景。
3.1 大模型生成单词
这一步只需一条提示词即可，例如：
“请生成一个以 {{input}} 开头的英文单词，只输出单词本身。”
3.2 定义输出模板
使用模板转换组件实现。这里我们设置输出模板：Loop {{arg2}}:{{arg1}}->{{arg3}}
——这样每次迭代的结果都能按统一格式呈现，清晰明了。
4. 结果输出：收集并展示
在结束节点中配置好输出变量，将迭代器的运行结果打印出来。整个工作流配置完成。
5. 测试运行
该工作流无需外部输入，直接点击运行即可。从实际效果看，每一轮迭代都按照预设模板 Loop {{arg2}}:{{arg1}}->{{arg3}} 正确输出。字母、序号、生成的单词一一对应，逻辑清晰。
补充说明：数据流的设计是迭代器组件的核心。只要掌握了“列表输入 → 逐元素处理 → 缓存输出”这一机制，后续处理更复杂的数组场景就不会吃力。从最简单的字母到单词，到结构化的长文本生成，底层逻辑完全相同。真正值得投入精力的，是你在提示词和模板中定义的处理逻辑——那才是决定输出质量的关键因素。