Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Implementations

impl AgentBuilder

pub fn new(client: Arc<dyn StreamClient>) -> AgentBuilder

pub fn with_multi_agent(self, config: MultiAgentConfig) -> AgentBuilder

Enable multi-agent support with the given configuration.

Also sets the tool factory to create the 6 multi-agent tools. Callers should use phi_kernel_tools::multi_agent::create_all_tools as the factory.

pub fn without_multi_agent(self) -> AgentBuilder

Disable multi-agent support.

Removes any previously set multi-agent configuration. No multi-agent tools will be registered and the system prompt will not mention multi-agent capabilities.

pub fn with_multi_agent_tool_factory( self, factory: Arc<dyn Fn(Arc<MultiAgentRuntime>) -> Vec<Arc<dyn Tool>> + Send + Sync>, ) -> AgentBuilder

Set a custom factory for creating multi-agent tools.

The factory receives the MultiAgentRuntime and returns the tools to register. If not set but multi-agent is enabled, no tools are registered (caller must set this for multi-agent to work).

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

pub fn enable_thought(self, enable: bool) -> AgentBuilder

pub fn reasoning(self, config: ReasoningConfig) -> AgentBuilder

pub fn enable_thinking(self, enable: bool) -> AgentBuilder

pub fn thinking_budget(self, budget: u64) -> AgentBuilder

pub fn tool_timeout(self, timeout_ms: u64) -> AgentBuilder

pub fn max_tool_output_chars(self, max_chars: usize) -> AgentBuilder

pub fn max_sessions(self, max: usize) -> AgentBuilder

pub fn max_turns_per_session(self, max: usize) -> AgentBuilder

pub fn execution_max_turns(self, max: u32) -> AgentBuilder

pub fn max_message_tokens(self, max: usize) -> AgentBuilder

pub fn register_tool(self, tool: impl Tool + 'static) -> AgentBuilder

pub fn register_tool_arc(self, tool: Arc<dyn Tool>) -> AgentBuilder

pub fn approval_handler(self, handler: Arc<dyn ApprovalHandler>) -> AgentBuilder

pub fn tool_policy(self, policy: Arc<dyn ToolPolicy>) -> AgentBuilder

pub fn middleware(self, mw: impl Middleware + 'static) -> AgentBuilder

pub fn guard(self, guard: impl ReactLoopGuard + 'static) -> AgentBuilder

pub fn context_window(self, max_tokens: usize) -> AgentBuilder

pub fn context_window_manager( self, manager: ContextWindowManager, ) -> AgentBuilder

pub fn response_format(self, format: ResponseFormat) -> AgentBuilder

pub fn llm_retry(self, retry: RetryConfig) -> AgentBuilder

pub fn session_store(self, store: Arc<dyn SessionStore>) -> AgentBuilder

pub fn error_recovery( self, recovery: Arc<dyn ToolErrorRecovery>, ) -> AgentBuilder

pub fn tool_error_retry_prompt(self, prompt: impl Into<String>) -> AgentBuilder

pub fn language(self, language: Language) -> AgentBuilder

pub fn event_bus_capacity(self, capacity: usize) -> AgentBuilder

pub fn session_id_generator( self, generator: Arc<dyn SessionIdGenerator>, ) -> AgentBuilder

pub fn apply_if<T>( self, value: Option<T>, f: impl FnOnce(AgentBuilder, T) -> AgentBuilder, ) -> AgentBuilder

Conditionally apply a transformation when value is Some.

This is a convenience for option-chaining builder patterns:

builder.apply_if(args.thinking_budget, |b, budget| b.thinking_budget(budget))

pub fn build(self) -> Result<AgentRuntime, AgentError>