Struct arbiter_engine::agent::AgentBuilder

pub struct AgentBuilder {
    pub id: String,
    /* private fields */
}

AgentBuilder represents the intermediate state of agent creation before it is converted into a full on Agent

Fields

id: String

Identifier for this agent. Used for routing messages.

Implementations

impl AgentBuilder

pub fn with_behavior<E: DeserializeOwned + Serialize + Send + Sync + Debug + 'static>( self, behavior: impl Behavior<E> + Serialize + DeserializeOwned + 'static ) -> Self

Appends a behavior onto an AgentBuilder. Behaviors are initialized when the agent builder is added to the crate::world::World

pub fn build( self, client: Arc<ArbiterMiddleware>, messager: Messager ) -> Result<Agent, ArbiterEngineError>

Constructs and returns a new Agent instance using the provided client and messager.

This method finalizes the building process of an Agent by taking ownership of the builder, and attempting to construct an Agent with the accumulated configurations and the provided client and messager. The client is an Arc<RevmMiddleware> that represents the connection to the blockchain or environment, and messager is a communication layer for the agent.

Parameters

• client: A shared Arc<RevmMiddleware> instance that provides the agent with access to the blockchain or environment.
• messager: A Messager instance for the agent to communicate with other agents or systems.

Returns

Returns a Result that, on success, contains the newly created Agent instance. On failure, it returns an [AgentBuildError::MissingBehaviorEngines] error indicating that the agent was attempted to be built without any behavior engines configured.

Examples

let agent_builder = AgentBuilder::new("agent_id");
let client = Arc::new(RevmMiddleware::new(...));
let messager = Messager::new(...);
let agent = agent_builder.build(client, messager).expect("Failed to build agent");