Struct LLMSessionConfig 

pub struct LLMSessionConfig {

    pub provider: LLMProvider,
    pub api_key: String,
    pub model: String,
    pub base_url: Option<String>,
    pub max_tokens: Option<u32>,
    pub system_prompt: Option<String>,
    pub temperature: Option<f32>,
    pub streaming: bool,
    pub context_limit: i32,
    pub compaction: Option<CompactorType>,
    pub azure_resource: Option<String>,
    pub azure_deployment: Option<String>,
    pub azure_api_version: Option<String>,
    pub bedrock_region: Option<String>,
    pub bedrock_access_key_id: Option<String>,
    pub bedrock_secret_access_key: Option<String>,
    pub bedrock_session_token: Option<String>,
}

Configuration for creating an LLM session

Fields

provider: LLMProvider

The LLM provider to use

api_key: String

API key for the provider

model: String

Model to use (e.g., “claude-3-sonnet-20240229”, “gpt-4”)

base_url: Option<String>

Custom base URL for OpenAI-compatible providers. Only used when provider is OpenAI. If None, uses default OpenAI endpoint.

max_tokens: Option<u32>

Default maximum tokens for responses

system_prompt: Option<String>

Default system prompt

temperature: Option<f32>

Default temperature

streaming: bool

Enable streaming responses

context_limit: i32

Model’s context window size (for compaction decisions)

compaction: Option<CompactorType>

Compaction configuration (None to disable compaction)

azure_resource: Option<String>

Azure OpenAI resource name (e.g., “my-resource”). When set, the provider uses Azure OpenAI instead of standard OpenAI.

azure_deployment: Option<String>

Azure OpenAI deployment name (e.g., “gpt-4-deployment”).

azure_api_version: Option<String>

Azure OpenAI API version (e.g., “2024-10-21”).

bedrock_region: Option<String>

AWS region for Bedrock (e.g., “us-east-1”).

bedrock_access_key_id: Option<String>

AWS access key ID for Bedrock.

bedrock_secret_access_key: Option<String>

AWS secret access key for Bedrock.

bedrock_session_token: Option<String>

AWS session token for Bedrock (optional, for temporary credentials).

Implementations

impl LLMSessionConfig

pub fn anthropic( api_key: impl Into<String>, model: impl Into<String>, ) -> LLMSessionConfig

Creates a new Anthropic session config

pub fn openai( api_key: impl Into<String>, model: impl Into<String>, ) -> LLMSessionConfig

Creates a new OpenAI session config

pub fn openai_compatible( api_key: impl Into<String>, model: impl Into<String>, base_url: impl Into<String>, context_limit: i32, ) -> LLMSessionConfig

Creates a new OpenAI-compatible session config with a custom base URL.

Use this for providers like Groq, Together, Fireworks, etc. that have OpenAI-compatible APIs.

pub fn google( api_key: impl Into<String>, model: impl Into<String>, ) -> LLMSessionConfig

Creates a new Google (Gemini) session config

pub fn azure_openai( api_key: impl Into<String>, resource: impl Into<String>, deployment: impl Into<String>, ) -> LLMSessionConfig

Creates a new Azure OpenAI session config.

Azure OpenAI uses a different URL format and authentication method. The endpoint is: https://{resource}.openai.azure.com/openai/deployments/{deployment}/chat/completions?api-version={version}

Arguments

• api_key - Azure OpenAI API key
• resource - Azure resource name (e.g., “my-openai-resource”)
• deployment - Deployment name (e.g., “gpt-4-deployment”)

pub fn with_azure_api_version( self, version: impl Into<String>, ) -> LLMSessionConfig

Sets the Azure API version.

pub fn cohere( api_key: impl Into<String>, model: impl Into<String>, ) -> LLMSessionConfig

Creates a new Cohere session config

pub fn bedrock( access_key_id: impl Into<String>, secret_access_key: impl Into<String>, region: impl Into<String>, model: impl Into<String>, ) -> LLMSessionConfig

Creates a new Amazon Bedrock session config.

Arguments

• access_key_id - AWS access key ID
• secret_access_key - AWS secret access key
• region - AWS region (e.g., “us-east-1”)
• model - Bedrock model ID (e.g., “anthropic.claude-3-sonnet-20240229-v1:0”)

pub fn with_bedrock_session_token( self, token: impl Into<String>, ) -> LLMSessionConfig

Sets the Bedrock session token for temporary credentials.

pub fn with_streaming(self, streaming: bool) -> LLMSessionConfig

Enable or disable streaming

pub fn with_max_tokens(self, max_tokens: u32) -> LLMSessionConfig

Sets the default max tokens

pub fn with_system_prompt(self, prompt: impl Into<String>) -> LLMSessionConfig

Sets the default system prompt

pub fn with_temperature(self, temperature: f32) -> LLMSessionConfig

Sets the default temperature

pub fn with_context_limit(self, context_limit: i32) -> LLMSessionConfig

Sets the model’s context window size

pub fn with_base_url(self, base_url: impl Into<String>) -> LLMSessionConfig

Sets a custom base URL for OpenAI-compatible providers

pub fn with_threshold_compaction( self, config: CompactionConfig, ) -> LLMSessionConfig

Enables threshold compaction with custom configuration

pub fn with_llm_compaction(self, config: LLMCompactorConfig) -> LLMSessionConfig

Enables LLM-based compaction with custom configuration

pub fn with_compaction(self, compactor_type: CompactorType) -> LLMSessionConfig

Enables compaction with the specified compactor type

pub fn without_compaction(self) -> LLMSessionConfig

Disables compaction

Trait Implementations

impl Clone for LLMSessionConfig

fn clone(&self) -> LLMSessionConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LLMSessionConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.