本文介绍如何根据 excel 数据动态生成指定数量的相同流程图模块（如 seperateflowchart），并通过 enter/exit 块串联它们，使主流程中的智能体依次通过全部模块。

在 AnyLogic 中，若需按外部数据（如 Excel）动态构建重复性流程逻辑（例如并行或串行部署多个功能一致的子流程），不推荐直接复制粘贴多个流程图块到主流程中——这会导致模型僵化、难以维护且无法参数化。正确做法是采用“模块化代理 + 动态实例化”设计范式。

✅ 推荐架构：封装为独立 Agent 类型

1. 新建 Agent 类型（如 SeperateFlowchartUnit）

   • 在该 Agent 内部嵌入完整的子流程图（含您原有的逻辑，如 Service、Delay、SelectOutput 等）；
   • 必须添加 Enter 和 Exit 块：Enter 作为入口点接收来自外部的智能体，Exit 作为出口点将智能体传递给下一个环节；
   • 可选：为 Enter 设置 on enter 动作以记录日志或触发事件，增强可观测性。

2. 在 Main 模型中读取 Excel 数据并批量实例化
   假设 Excel 表格 config.xlsx 的 Sheet1 中 A1 单元格存储数量 n = 10，可在 Main 的 on startup 动作中编写：

// 读取 Excel 中指定单元格的整数值
int n = (int) excelFile.getCellNumericValue("Sheet1", 0, 0); // 行0列0 → A1

// 动态创建 n 个 SeperateFlowchartUnit 实例，并自动添加到 Main 的嵌入式 agent 图表中
for (int i = 0; i < n; i++) {
    SeperateFlowchartUnit unit = add_seperateFlowchartUnit(); // 使用 AnyLogic 自动生成的 add_ 方法
    unit.setName("flowUnit_" + i);

    // 可选：设置位置（便于可视化布局）
    unit.setXY(200 + i * 180, 300);
}

3. 连接主流程与子模块链

   • 主流程中：Source → Enter（第一个 SeperateFlowchartUnit）
   • 子模块间：每个 SeperateFlowchartUnit.exit → 下一个 SeperateFlowchartUnit.enter
   • 末尾：最后一个 SeperateFlowchartUnit.exit → Sink

   ? 提示：可通过循环自动连线（使用 connect() 方法），或在初始化后手动拖拽连线（适合调试阶段）。

4. 确保智能体流动逻辑正确

   • 所有 SeperateFlowchartUnit 必须启用 Allow multiple agents（在 Enter 属性中勾选），否则会阻塞；
   • 若子流程需保持状态隔离（如不同单元处理不同任务），请确认 SeperateFlowchartUnit 中的变量/资源未被全局共享；
   • 建议为每个 SeperateFlowchartUnit 添加唯一 ID（如 unitId = i），便于日志追踪和调试。

⚠️ 注意事项

• Enter/Exit 块是实现跨 Agent 流程衔接的核心——它们提供标准化的输入输出接口，替代了传统流程图中“硬连线”的耦合方式；
• 动态创建的 Agent 实例默认属于 Main 的嵌入式 agent 集合，其生命周期由 Main 管理，无需手动销毁；
• 若 Excel 数据变更需热重载，可封装为函数并在实验参数中绑定，配合 reset() 触发重建（适用于迭代调试）。

通过该方法，您不仅实现了“读 Excel 控制流程长度”的需求，更构建出高内聚、低耦合、可复用、易扩展的 AnyLogic 工程化建模结构。