循环次数节点

【循环次数节点】用于在工作流或对话流智能体中，重复执行一段逻辑流程，直到满足退出条件或达到设定的最大循环次数。
可理解为“带条件限制的重复执行器”，支持依赖上一次执行结果的多轮循环。

39a1849bcb9c4c6fb4a55206fb57007b

与循环数组节点的区别

类型	特点	适用场景
循环次数节点	每一轮的执行结果会影响下一轮输入（存在依赖关系）	优化、递归、增量生成类任务，如文本改写、逐步计算
循环数组节点	每一轮任务独立运行，互不依赖	批处理任务，如批量翻译、文件逐项处理

简而言之：

• 循环次数 → 依赖前一轮结果
• 循环数组 → 每轮相互独立

节点结构

循环次数节点包含以下关键配置项：

配置项/子节点	作用	示例
循环终止条件	定义循环结束的触发条件，当条件为真时停止循环	例：当变量 x < 50 时停止循环
最大循环次数	限制循环上限，防止死循环	例：最多执行 10 轮
循环变量	用于在不同轮次间传递和更新数据	例：sum 在每轮累加后传入下一轮
退出循环节点	循环体内强制终止循环的特殊节点	例：在满足特定逻辑时立即停止循环

注意

• 满足 任意终止条件（循环终止条件或退出循环节点）即会结束循环。
• 若未设置任何条件，则循环默认持续到达 最大次数 为止。

使用方法

1. 添加循环次数节点 在画布中添加节点，将上游输出（如输入变量或初始值）连接至循环次数节点。

2. 配置循环条件

• 设置 循环终止条件：
  使用逻辑表达式判断何时停止（如 x < 50、done == true）。
• 设置 最大循环次数：
  限制最大轮数（例如 5 或 10），避免无限循环。

3. 定义循环变量 在循环配置面板中，定义用于跨轮次传递的变量，例如：

变量名	初始值	用途
count	0	当前循环次数
result	""	累积生成内容
done	false	是否达到终止条件

循环体中的节点可引用和修改这些变量，供下一轮使用。

4. 编排循环体 循环次数节点内部可包含任意节点（LLM、条件分支、代码执行、变量赋值等）。
   这些节点将在每一轮循环中按顺序执行。

5. 结束与输出 循环结束后，循环变量的最终状态将输出给下游节点使用。

示例一：随机数循环

目标：生成 1–100 的随机数，直到生成结果小于 50 时停止。

流程：

1. 在循环次数节点中定义：
   • 终止条件：random < 50
   • 最大循环次数：10
2. 在循环体中添加：
   • 代码节点：生成随机数 random = random.randint(1,100)
   • 条件分支节点：判断是否 < 50
     • 若否 → 继续循环
     • 若是 → 输出并停止
3. 当满足条件或到达 10 次循环后，流程结束。

图片

群組1

示例二：文本逐步改进（依赖前轮结果）

目标：让 LLM 逐轮改写文本，提升流畅度，循环 4 次后自动停止。

配置步骤：

1. 循环变量：

   • round = 0（当前轮次）
   • text = "初始文本"

2. 循环体：

   • 条件分支节点：若 round >= 4 → 执行“退出循环节点”；否则继续。
   • LLM 节点：指令示例：

     你是一位文本润色助手。请改进以下句子：
     {{ text }}

   • 变量赋值节点：
     • round = round + 1
     • text = LLM 输出内容

3. 循环终止条件：

• 达到最大轮次 4 或执行“退出循环节点”。

4. 输出： 最终的 text 为改进后的版本。

退出循环节点

作用：在循环体内立即终止循环执行。
通常与 条件分支节点 配合使用：

若满足条件 → 执行退出循环节点
否则 → 继续循环

应用示例：

• 达到目标精度时提前结束计算；
• 检测到错误信号时强制中断；
• 达到人工审核通过条件时提前退出。

小结

循环次数节点让你在工作流中构建可自我优化、可依赖历史结果的任务逻辑。
它非常适合以下场景：

• 逐轮改写、优化或总结任务；
• 条件驱动的多步计算；
• 需要“直到成功”为止的流程控制。

通过合理配置终止条件与变量传递，你可以在 AI Center 中轻松实现复杂的“智能自迭代”逻辑。