Struct AgentRuntimeBuilder 

pub struct AgentRuntimeBuilder { /* private fields */ }

Builds an AgentRuntime.

let runtime = AgentRuntime::<DeepSeekProvider>::builder()
    .api_key(std::env::var("DEEPSEEK_API_KEY")?)
    .model("deepseek-v4-flash")
    .build()?;

Implementations

impl AgentRuntimeBuilder

pub fn new() -> Self

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

OpenAI API key. Falls back to OPENAI_API_KEY env var.

pub fn base_url(self, url: Option<String>) -> Self

Custom base URL (proxy, compatible API, etc.). Pass e.g. std::env::var("OPENAI_BASE_URL").ok().

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

LLM model name. Falls back to OPENAI_MODEL env var, then "gpt-4o".

pub fn client(self, client: Client<OpenAIConfig>) -> Self

Directly provide an OpenAI client (overrides api_key + base_url).

pub fn max_iterations(self, n: usize) -> Self

Maximum number of ReAct iterations per call (default 10).

pub fn channel_buffer(self, n: usize) -> Self

Internal channel buffer size (default 32).

pub fn with_tool<T: Tool + Default + 'static>(self) -> Self

Register a tool by its type (requires Tool + Default).

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

Register a pre-constructed tool.

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

Build the runtime with the default DeepSeek provider.

pub fn build_with<P: ChatProvider>( self, ) -> Result<AgentRuntime<P>, OrchestrateError>

Build the runtime with a custom LLM provider.

let rt = AgentRuntime::<DeepSeekProvider>::builder().api_key(std::env::var("DEEPSEEK_API_KEY")?).model("deepseek-v4-flash").build_with::<DeepSeekProvider>()?;

Trait Implementations

impl Default for AgentRuntimeBuilder

fn default() -> Self

Returns the “default value” for a type.