Struct OxiBuilder 

pub struct OxiBuilder { /* private fields */ }

Builder for creating an Oxi instance.

Implementations

impl OxiBuilder

pub fn new() -> OxiBuilder

Create a new empty builder (no builtins, no providers, no models).

pub fn with_builtins(self) -> OxiBuilder

Register all built-in models and enable built-in provider creation.

This loads 50+ model definitions from the oxi-ai static database and enables create_builtin_provider() fallback in Oxi::create_provider.

pub fn provider(self, name: &str, p: impl Provider + 'static) -> OxiBuilder

Register a custom provider.

pub fn tool(self, tool: impl AgentTool + 'static) -> OxiBuilder

Register a custom tool in the shared tool registry.

pub fn provider_factory( self, name: &str, factory: impl Fn() -> Result<Arc<dyn Provider>, Error> + Send + Sync + 'static, ) -> OxiBuilder

Register a provider factory — a closure that lazily creates a provider.

Unlike Self::provider(), which takes an already-constructed instance, this stores a factory closure. The factory is invoked the first time Oxi::create_provider(name) is called, and the resulting provider is cached for subsequent calls.

This is useful when provider construction requires credential resolution or network configuration that should happen at first use, not at build time.

Example

let oxi = OxiBuilder::new()
    .with_builtins()
    .provider_factory("zai", || {
        let api_key = resolve_key("zai");
        let base_url = env::var("ZAI_BASE_URL").unwrap_or_default();
        Ok(Arc::new(OpenAiProvider::with_base_url_and_key(&base_url, api_key)))
    })
    .build();

pub fn model(self, model: Model) -> OxiBuilder

Register a custom model.

pub fn enable_routing(self, config: RoutingConfig) -> OxiBuilder

Enable multi-provider routing with automatic complexity-based model selection.

This registers a [MultiProvider] that routes requests based on task complexity, with configurable fallback chains and circuit breaker protection.

Arguments

• config - Routing configuration (use RoutingConfig::new() for defaults)

Example

use oxi_sdk::{RoutingConfig, create_builtin_provider};

let oxi = OxiBuilder::new()
    .with_builtins()
    .enable_routing(RoutingConfig::new().prefer_cost_efficient(true))
    .build();

pub fn build(self) -> Oxi

Build the Oxi engine instance.

Trait Implementations

impl Default for OxiBuilder

fn default() -> OxiBuilder

Returns the “default value” for a type.