set_params
set_params
Set multiple AI parameters at once. Merges into any previously set parameters.
These parameters map to the SWML ai.params object.
See the SWML AI params reference for the full list of
supported fields.
Parameters
params
Dictionary of parameter name/value pairs.
Returns
AgentBase — Returns self for method chaining.
AI Parameter Reference
Parameters set via set_params() control the AI model, speech recognition, timing,
and agent behavior. The fields below list commonly used parameters by category.
Default values shown below are server-side defaults applied by the SignalWire platform. The SDK itself sends no defaults — only parameters you explicitly set are included in the SWML document.
LLM Parameters
temperature
Output randomness. Range: 0.0 — 2.0. Lower values produce more deterministic responses.
top_p
Nucleus sampling threshold. Range: 0.0 — 1.0. Alternative to temperature for controlling randomness.
frequency_penalty
Repetition penalty. Range: -2.0 — 2.0. Positive values reduce repetition of token sequences.
presence_penalty
Topic diversity. Range: -2.0 — 2.0. Positive values encourage the model to explore new topics.
max_tokens
Maximum response tokens. Range: 1 — 16385.
ai_model
AI model to use (e.g., "gpt-4o-mini", "gpt-4.1-mini", "nova-micro", "nova-lite").
Timing Parameters
end_of_speech_timeout
Silence duration in milliseconds to detect end of speech. Range: 250 — 10000.
attention_timeout
Idle delay in milliseconds before the AI re-prompts the caller. Range: 0 — 600000.
inactivity_timeout
Inactivity delay in milliseconds before the call is automatically disconnected. Range: 10000 — 3600000.
speech_timeout
Maximum speech duration in milliseconds before the input is finalized.
Behavior Parameters
wait_for_user
Wait for the caller to speak first before the AI begins talking.
conscience
Safety enforcement. When enabled, the AI applies content safety filters.
transparent_barge
Transparent barge-in mode. When enabled, caller speech interrupts the AI naturally without discarding context.
save_conversation
Persist the conversation summary after the call ends.
Audio Parameters
ai_volume
AI voice volume adjustment. Range: -50 — 50.
background_file
URL of an audio file to play as background audio during the conversation.
hold_music
URL of hold music or a tone string (e.g., "tone:440").
