Struct SamplingOverrides 

pub struct SamplingOverrides {
    pub temperature: Option<f32>,
    pub top_p: Option<f32>,
    pub top_k: Option<i32>,
    pub presence_penalty: Option<f32>,
    pub frequency_penalty: Option<f32>,
    pub max_tokens: Option<u32>,
    pub reasoning_effort: Option<ReasoningEffortLevel>,
    pub suppresses_sampling: bool,
    pub profile_aware: bool,
}

Per-model sampling parameter overrides resolved from a custom provider profile. Every field defaults to None, meaning the agent loop’s global configuration value applies unchanged.

Fields

temperature: Option<f32>

Sampling temperature (0.0-2.0).

top_p: Option<f32>

Nucleus sampling mass (0.0-1.0).

top_k: Option<i32>

Top-k token cutoff (>= 0).

presence_penalty: Option<f32>

Presence penalty (-2.0-2.0).

frequency_penalty: Option<f32>

Frequency penalty (-2.0-2.0).

max_tokens: Option<u32>

Maximum output tokens (> 0).

reasoning_effort: Option<ReasoningEffortLevel>

Reasoning effort for models that accept it.

suppresses_sampling: bool

Whether this wire format rejects sampling parameters, as Anthropic Messages does under API version 2026-10-21, independent of reasoning.

profile_aware: bool

Set by providers that resolve overrides from an explicit user profile; callers use it to trust these values over name-based heuristics.

Implementations

impl SamplingOverrides

pub fn drops_sampling_params( &self, native_match: bool, reasoning_active: bool, ) -> bool

Whether sampling parameters must be dropped for this request.

Anthropic Messages routes reject temperature, top_p, and top_k under API version 2026-10-21 even at their default values, so the drop is unconditional for them: either the provider declares that its wire rejects sampling (suppresses_sampling), or it is a built-in Anthropic/MiniMax backend (native_match) that resolves no user profile. Reasoning state does not change the answer.

Trait Implementations

impl Clone for SamplingOverrides

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SamplingOverrides

impl Debug for SamplingOverrides

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

Formats the value using the given formatter.

impl Default for SamplingOverrides

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SamplingOverrides

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SamplingOverrides