根本原因

工作流执行达到了 500 步 的上限，第 501 步时被系统直接中止。

底层机制

这个限制是怎么生效的？来拆解它的实现逻辑：

• 限制定义位置：在 init.py 的 WorkflowConfig 类里，默认值如下：

  WORKFLOW_MAX_EXECUTION_STEPS: PositiveInt = 500  # 默认值

• 执行层：graphon 包里的 ExecutionLimitsLayer 作为中间件，挂载到 GraphEngine 上（入口在 workflow_entry.py）。
• 计数逻辑：每次 NodeRunStartedEvent 被触发（每个节点开始执行），step_count 就加 1。节点执行完成（无论成功或失败）时，系统检查：

  def _reached_step_limitation(self) -> bool:
      return self.step_count > self.max_steps  # 501 > 500

• 中止流程：一旦超过限制，系统通过 AbortCommand 命令通道通知引擎“停下”。引擎随即发出 GraphRunAbortedEvent，最终被 WorkflowAppRunner 转成工作流失败事件。

常见触发场景

你的工作流到底哪里“跑超了”？典型情况有这几种：

• 迭代/循环节点循环次数太多，比如处理了大量数据批次，每批都算一步。
• Agent 节点反复调用工具，形成了很长的思考-行动链条，一步接一步。
• 多层嵌套的工作流调用，每层调用都计入步数，层层叠加。
• 工作流设计本身不够合理，存在不必要的重复执行，白白浪费步数。

如何解决

对症下药，无非三条路：要么放开限制，要么优化流程，要么改配置。下面这张表一目了然：

简单来说，如果只是临时需要跑一个复杂流程，放开步数限制只需修改环境变量。

如果这个错误频繁出现，那还是得从工作流设计上找原因，把循环和工具调用精简一下，才是长久之计。