Struct RealtimeConfig 

pub struct RealtimeConfig {

    pub model: Option<String>,
    pub instruction: Option<String>,
    pub voice: Option<String>,
    pub modalities: Option<Vec<String>>,
    pub input_audio_format: Option<AudioEncoding>,
    pub output_audio_format: Option<AudioEncoding>,
    pub turn_detection: Option<VadConfig>,
    pub tools: Option<Vec<ToolDefinition>>,
    pub tool_choice: Option<String>,
    pub input_audio_transcription: Option<TranscriptionConfig>,
    pub temperature: Option<f32>,
    pub max_response_output_tokens: Option<u32>,
    pub cached_content: Option<String>,
    pub interruption_detection: Option<InterruptionDetection>,
    pub extra: Option<Value>,
}

Configuration for a realtime session.

Fields

model: Option<String>

Model to use (provider-specific).

instruction: Option<String>

System instruction for the agent.

voice: Option<String>

Voice to use for audio output.

modalities: Option<Vec<String>>

Output modalities: [“text”], [“audio”], or [“text”, “audio”].

input_audio_format: Option<AudioEncoding>

Input audio format.

output_audio_format: Option<AudioEncoding>

Output audio format.

turn_detection: Option<VadConfig>

VAD configuration.

tools: Option<Vec<ToolDefinition>>

Available tools/functions.

tool_choice: Option<String>

Tool selection mode: “auto”, “none”, “required”.

input_audio_transcription: Option<TranscriptionConfig>

Whether to include input audio transcription.

temperature: Option<f32>

Temperature for response generation.

max_response_output_tokens: Option<u32>

Maximum output tokens.

cached_content: Option<String>

Cached content resource name (e.g. cachedContents/1234).

interruption_detection: Option<InterruptionDetection>

Interruption detection mode for voice sessions.

Controls whether the session automatically detects user speech to cancel agent audio output, or relies on explicit API calls. Defaults to Manual when None.

extra: Option<Value>

Provider-specific options.

Implementations

impl RealtimeConfig

pub fn new() -> Self

Create a new empty configuration.

pub fn builder() -> RealtimeConfigBuilder

Create a builder for RealtimeConfig.

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

Set the model.

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

Set the system instruction.

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

Set the voice.

pub fn with_modalities(self, modalities: Vec<String>) -> Self

Set output modalities.

pub fn with_text_and_audio(self) -> Self

Enable text and audio output.

pub fn with_audio_only(self) -> Self

Enable audio-only output.

pub fn with_vad(self, vad: VadConfig) -> Self

Set VAD configuration.

pub fn with_server_vad(self) -> Self

Enable server-side VAD with default settings.

pub fn without_vad(self) -> Self

Disable VAD (manual turn management).

pub fn with_tool(self, tool: ToolDefinition) -> Self

Add a tool definition.

pub fn with_tools(self, tools: Vec<ToolDefinition>) -> Self

Set multiple tools.

pub fn with_transcription(self) -> Self

Enable input audio transcription.

pub fn with_temperature(self, temp: f32) -> Self

Set temperature.

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

Set cached content resource.

pub fn with_interruption_detection(self, mode: InterruptionDetection) -> Self

Set the interruption detection mode.

See InterruptionDetection for details on each variant.

pub fn with_automatic_interruption(self) -> Self

Enable automatic interruption detection.

The session will detect user speech onset and cancel the current agent audio output automatically.

Trait Implementations

impl Clone for RealtimeConfig

fn clone(&self) -> RealtimeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RealtimeConfig

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

Formats the value using the given formatter.

impl Default for RealtimeConfig

fn default() -> RealtimeConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RealtimeConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<RealtimeConfig> for SessionUpdateConfig

fn from(config: RealtimeConfig) -> Self

Converts to this type from the input type.

impl PartialEq for RealtimeConfig

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RealtimeConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RealtimeConfig