Struct ConfigurableAgentBuilder

pub struct ConfigurableAgentBuilder { /* private fields */ }

Builder API to assemble a DeepAgent in a single fluent flow, mirroring the Python create_configurable_agent experience. Prefer this for ergonomic construction.

Implementations

impl ConfigurableAgentBuilder

pub fn new(instructions: impl Into<String>) -> ConfigurableAgentBuilder

pub fn with_model( self, model: Arc<dyn LanguageModel>, ) -> ConfigurableAgentBuilder

Set the language model for the agent (mirrors Python’s model parameter)

pub fn with_planner( self, planner: Arc<dyn PlannerHandle>, ) -> ConfigurableAgentBuilder

Low-level planner API (for advanced use cases)

pub fn with_openai_chat( self, config: OpenAiConfig, ) -> Result<ConfigurableAgentBuilder, Error>

Convenience method for OpenAI models (equivalent to model=OpenAiChatModel)

pub fn with_anthropic_messages( self, config: AnthropicConfig, ) -> Result<ConfigurableAgentBuilder, Error>

Convenience method for Anthropic models (equivalent to model=AnthropicMessagesModel)

pub fn with_gemini_chat( self, config: GeminiConfig, ) -> Result<ConfigurableAgentBuilder, Error>

Convenience method for Gemini models (equivalent to model=GeminiChatModel)

pub fn with_tool(self, tool: Arc<dyn Tool>) -> ConfigurableAgentBuilder

Add a tool to the agent

pub fn with_tools<I>(self, tools: I) -> ConfigurableAgentBuilder

where I: IntoIterator<Item = Arc<dyn Tool>>,

Add multiple tools

pub fn with_subagent_config<I>(self, cfgs: I) -> ConfigurableAgentBuilder

where I: IntoIterator<Item = SubAgentConfig>,

pub fn with_subagent_tools<I>(self, tools: I) -> ConfigurableAgentBuilder

where I: IntoIterator<Item = Arc<dyn Tool>>,

Convenience method: automatically create subagents from a list of tools. Each tool becomes a specialized subagent with that single tool.

pub fn with_summarization( self, config: SummarizationConfig, ) -> ConfigurableAgentBuilder

pub fn with_tool_interrupt( self, tool_name: impl Into<String>, policy: HitlPolicy, ) -> ConfigurableAgentBuilder

pub fn with_builtin_tools<I, S>(self, names: I) -> ConfigurableAgentBuilder

where I: IntoIterator<Item = S>, S: Into<String>,

pub fn with_auto_general_purpose( self, enabled: bool, ) -> ConfigurableAgentBuilder

pub fn with_prompt_caching(self, enabled: bool) -> ConfigurableAgentBuilder

pub fn with_checkpointer( self, checkpointer: Arc<dyn Checkpointer>, ) -> ConfigurableAgentBuilder

pub fn build(self) -> Result<DeepAgent, Error>

pub fn build_async(self) -> Result<DeepAgent, Error>

Build an agent using the async constructor alias. This mirrors the Python async_create_deep_agent entry point, while reusing the same runtime internals.