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>> + Sync + Send>, ) -> 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 with_skill_detail_tool_factory( self, factory: Arc<dyn Fn(Vec<Arc<dyn Skill>>, String) -> Arc<dyn Tool> + Sync + Send>, ) -> AgentBuilder

Set a custom factory for creating the skill detail tool.

The factory receives the skill list and tool name, and returns the tool. If not set but skills are registered, no detail tool is added.

pub fn with_list_skills_tool_factory( self, factory: Arc<dyn Fn(Arc<SkillRegistry>) -> Arc<dyn Tool> + Sync + Send>, ) -> AgentBuilder

Set a custom factory for creating the list-skills tool.

The factory receives the SkillRegistry and returns the tool.

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 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 register_skill(self, skill: impl Skill + 'static) -> AgentBuilder

pub fn register_skills(self, skills: Vec<Arc<dyn Skill>>) -> AgentBuilder

pub fn skill_prompter(self, prompter: Arc<dyn SkillPrompter>) -> AgentBuilder

pub fn disable_skill_prompt_injection(self) -> AgentBuilder

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

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