AnyLogic中Agent to Fluid模块连接报错问题求助

问题背景 #

在构建流体混合系统时，流体批次来自原生流体源和Agent to Fluid模块转换的通用智能体。但将该模块直接连接到StorageTank或Sink时，模型加载失败并报错；移除模块后模型运行正常。未修改Java代码或智能体属性，尝试过重新添加模块、重启软件、重建模型及查阅官方教程，问题仍未解决。核心需求是实现通用智能体到流体批次的转换，并与其他流体混合。

报错信息 #

java.lang.RuntimeException: root:
tank239 (StorageTank) : This markup element is already connected with some data source:                    root.agentToFluid - AgentToFluid
in count = 0
out: Rate = 0 cubic meters / s
Amount passed = 0 cubic meters
Priority = -1
Desired output rate = 1 cubic meters / s
Contains fluid: 0 cubic meters
    at com.anylogic.engine.Engine.error(Unknown Source)
    at com.anylogic.engine.Agent.error(Unknown Source)
    at com.anylogic.engine.Utilities.error(Unknown Source)
    at com.anylogic.engine.markup.MarkupShape.h(Unknown Source)
    at com.anylogic.engine.markup.AbstractFluidMarkup.setDataSource(Unknown Source)
    at com.anylogic.libraries.fluid.AgentToFluid.onStartup(Unknown Source)
    at com.anylogic.engine.Agent.j(Unknown Source)
    at com.anylogic.engine.Agent.j(Unknown Source)
    at com.anylogic.engine.Agent.start(Unknown Source)
    at com.anylogic.engine.Engine.start(Unknown Source)
    at com.anylogic.engine.ExperimentSimulation.m(Unknown Source)
    at com.anylogic.engine.ExperimentSimulation.run(Unknown Source)
    at com.anylogic.engine.ExperimentSimulation.l(Unknown Source)
    at com.anylogic.engine.internal.b$b.run(Unknown Source)

解决步骤 #

• 修正连接方式：Agent to Fluid的输出需连接到储罐/出口的Fluid Port，而非直接拖拽模块到模块。直接连接会触发重复数据源绑定，通过端口传递可避免冲突。
• 配置智能体属性映射：在Agent to Fluid模块的属性面板中，正确设置「Fluid volume」和「Fluid type」的来源，确保转换的智能体包含对应属性（如agent.fluidVolume）。
• 解绑储罐残留数据源：右键点击报错的StorageTank，选择「Unbind Data Source」，清除之前的无效绑定后，重新通过端口连接Agent to Fluid。
• 添加中间管道过渡：在Agent to Fluid与储罐/出口之间插入Fluid Pipe，通过管道中转流体，消除直接连接导致的绑定异常。
• 重置模块实例：删除现有Agent to Fluid模块，重新从库中拖拽新模块到画布，避免旧模块的配置残留，再重新配置智能体输入和流体输出。

内容的提问来源于stack exchange，提问作者Intern of the month