如何遍历任意时刻被Batch聚合在一起的agents？

问题说明 #

仿真流程配置批处理（batching）、解批（unbatching）逻辑后，针对MyAgent种群做统计时会默认忽略被封装在Batch对象内的agents。核心原因是Batch是独立的特殊Agent实例，被封装进Batch的原始agent会暂时从原种群的常规遍历列表中隐藏，不会被默认统计逻辑捕获。

具体实现步骤 #

• 遍历所有当前活跃的Batch对象
  找到流程中使用的Batch模块（可替换为自定义命名的批处理模块实例名），调用其getBatches()方法即可拿到所有当前未被解批、处于活跃状态的Batch实例集合：

  // 遍历所有活跃批对象，示例中批处理模块实例名为batch，可按需替换
  for (Batch activeBatch : batch.getBatches()) {
      // 后续处理批内agent逻辑
  }
  

• 读取Batch内封装的所有原始agent
  每个Batch实例内置agents集合字段，按顺序存储了该批次下所有被封装的原始agent，直接遍历该集合即可访问到所有MyAgent实例，读取任意自定义属性：

  for (Batch activeBatch : batch.getBatches()) {
      // 遍历当前批次内的所有MyAgent
      for (MyAgent myAgent : (List<MyAgent>) activeBatch.agents) {
          // 此处可直接读取myAgent的任意属性，纳入统计计算逻辑
          // 统计总数量、累加属性值、状态筛选等操作和普通独立agent完全一致
      }
  }
  

• 全量统计补全规则
  要保证任意时刻统计数据不遗漏，统计逻辑必须同时覆盖两类agent：
  • 原MyAgent种群中未被封装、处于独立活跃状态的agents
  • 所有活跃Batch对象中封装的MyAgent实例

注意事项：解批（unbatching）动作完成后，对应的Batch实例会被立即销毁，内部存储的agents集合会被清空，必须在Batch处于活跃生命周期内（即从批处理模块输出后、进入解批模块完成解批前）查询，才能拿到完整的批内agent清单。

参考界面截图 #

内容的提问来源于stack exchange，提问作者dnyanesh ambhore