Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Fluent assembly of one canonical Agent.

Registration failures are retained and returned by Self::build so Tool and child Agent calls remain chainable without silently replacing an existing name.

Implementations

impl AgentBuilder

pub fn new( name: impl Into<String>, model: Arc<dyn Model>, model_ref: ModelRef, ) -> Self

Creates a builder around the same execution path as Agent::new.

pub fn system(self, instruction: impl Into<String>) -> Self

Appends a system instruction.

pub fn tool<T>(self, tool: T) -> Self

where T: Tool + 'static,

Registers an owned Tool.

pub fn shared_tool(self, tool: Arc<dyn Tool>) -> Self

Registers a shared, type-erased Tool.

pub fn child( self, descriptor: AgentDescriptor, child: Arc<Agent>, capabilities: CapabilitySet, ) -> Self

Registers a child Agent route with explicit delegated capabilities.

pub fn gateway_layer(self, middleware: Arc<dyn GatewayMiddleware>) -> Self

Appends Gateway around-middleware.

pub fn max_delegation_depth(self, max_depth: u32) -> Self

Sets the maximum nested Agent delegation depth.

pub const fn max_turns(self, max_turns: u32) -> Self

Sets the local model-turn limit.

pub const fn tool_error_policy(self, policy: ToolErrorPolicy) -> Self

Sets Tool failure behavior.

pub const fn feature_policy(self, policy: FeaturePolicy) -> Self

Sets provider feature-degradation behavior.

pub fn output_format(self, output_format: OutputFormat) -> Self

Sets the desired terminal model-output format.

pub fn structured_output<T>(self, name: impl Into<String>) -> Self

where T: JsonSchema,

Requests strict structured output described by the Rust type T.

pub const fn config(self, config: AgentConfig) -> Self

Replaces all local Agent configuration.

pub fn effect_executor(self, effects: EffectExecutor) -> Self

Shares a write-ahead effect coordinator with this Agent.

pub const fn effect_recovery_policy(self, policy: EffectRecoveryPolicy) -> Self

Sets recovery behavior for ambiguous callable effects.

pub fn build(self) -> Result<Agent, AgentBuildError>

Validates registrations and returns the canonical Agent.

Errors

Returns AgentBuildError for blank identity, invalid turn bounds, duplicate registrations, or Tool/Agent name collisions.

pub fn build_structured<T>( self, name: impl Into<String>, ) -> Result<StructuredAgent<T>, AgentBuildError>

where T: JsonSchema,

Builds an Agent whose schema and local decoder are bound to T.

This is the preferred terminal builder operation for structured output because a different decode type cannot be selected later by mistake.

Errors

Returns AgentBuildError under the same validation rules as Self::build.

Trait Implementations

impl Debug for AgentBuilder

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.