Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Implementations

impl AgentBuilder

pub fn new(client: Arc<dyn LlmClient>) -> Self

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

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) -> Self

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: MultiAgentToolFactory, ) -> Self

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>) -> Self

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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) -> AgentResult<AgentRuntime>