Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Builder for creating Agent instances.

Implementations

impl AgentBuilder

pub fn new() -> Self

pub fn model(self, model: impl Model + 'static) -> Self

Sets the model for the agent.

pub fn model_arc(self, model: Arc<dyn Model>) -> Self

Sets the model using an Arc.

pub fn messages(self, messages: Messages) -> Self

Sets the initial messages.

pub fn system_prompt(self, prompt: impl Into<String>) -> Self

Sets the system prompt.

pub fn tool(self, tool: impl AgentTool + 'static) -> Result<Self>

Adds a tool to the agent.

pub fn tools( self, tools: impl IntoIterator<Item = impl AgentTool + 'static>, ) -> Result<Self>

Adds multiple tools to the agent.

pub fn tool_registry(self, registry: ToolRegistry) -> Self

Sets the tool registry.

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

Sets the agent name.

pub fn agent_id(self, id: impl Into<String>) -> Self

Sets the agent ID.

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

Sets the agent description.

pub fn state(self, state: AgentState) -> Self

Sets the agent state.

pub fn hooks(self, hooks: HookRegistry) -> Self

Sets the hook registry.

pub fn conversation_manager( self, manager: impl ConversationManager + 'static, ) -> Self

Sets the conversation manager.

pub fn record_direct_tool_call(self, record: bool) -> Self

Sets whether to record direct tool calls in message history.

pub fn trace_attribute( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Sets a trace attribute.

pub fn trace_attributes(self, attrs: HashMap<String, String>) -> Self

Sets multiple trace attributes.

pub fn max_tool_calls(self, max: usize) -> Self

Sets the maximum number of tool calls per cycle.

pub fn structured_output_model<T: JsonSchema + DeserializeOwned + 'static>( self, ) -> Self

Sets the structured output model type.

This configures the agent to enforce responses matching the schema of type T. The structured output tool will be dynamically registered at invocation time and cleaned up afterward.

Example

use schemars::JsonSchema;
use serde::Deserialize;

#[derive(JsonSchema, Deserialize)]
struct MyOutput {
    name: String,
    count: i32,
}

let agent = Agent::builder()
    .model(model)
    .structured_output_model::<MyOutput>()
    .build()?;

pub fn structured_output_context(self, context: StructuredOutputContext) -> Self

Sets a custom structured output context.

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

Builds the agent.

Trait Implementations

impl Default for AgentBuilder

fn default() -> Self

Returns the “default value” for a type.