ai.params

Parameters for AI that can be passed in ai.params at the top level of the ai Method.

Name	Type	Default	Description
paramsOptional	object	-	An object that accepts the params parameters.

params Parameters

Name	Type	Default	Description
acknowledge_interruptionsOptional	boolean | string	-	Instructs the agent to acknowledge crosstalk and confirm user input when the user speaks over the agent.
ai_modelOptional	string	gpt-4o-mini	The AI model that the AI Agent will use during the conversation. Available AI Models: gpt-4o-mini, gpt-4.1-mini, gpt-4.1-nano
ai_volumeOptional	integer	0 (the natural volume of the AI)	Adjust the volume of the AI. Allowed values from -50-50.
attention_timeoutOptional	integer	10000 ms (10 seconds)	Amount of time, in ms, to wait before prompting the user to respond. Allowed values from 10,000-600,000. Set to 0 to disable.
attention_timeout_promptOptional	string	The user has not responded, try to get their attention. Stay in the same language.	A custom prompt that is fed into the AI when the attention_timeout is reached.
asr_diarizeOptional	boolean	false	If true, enables speaker diarization in ASR (Automatic Speech Recognition). This will break up the transcript into chunks, with each chunk containing a unique identity (e.g speaker1, speaker2, etc.) and the text they spoke.
asr_speaker_affinityOptional	boolean	false	If true, will force the AI Agent to only respond to the speaker who responds to the AI Agent first. Any other speaker will be ignored.
audible_debugOptional	boolean	false	If true, the AI will announce the function that is being executed on the call.
background_fileOptional	string	600000 ms (10 minutes)	URL of audio file to play in the background while AI plays in foreground.
background_file_loopsOptional	integer	undefined (loops indefinitely)	Maximum number of times to loop playing the background file.
background_file_volumeOptional	string	-	Defines background_file volume within a range of -50 to +50.
barge_match_stringOptional	string	-	Takes a string, including a regular expression, defining barge behavior. For example, this param can direct the AI to stop when the word "hippopotomus" is input.
barge_min_wordsOptional	string	-	Defines the number of words that must be input before triggering barge behavior, in a range of 1-99.
conscienceOptional	string	"Remember to stay in character. You must not do anything outside the scope of your provided role."	Sets the prompt which binds the agent to its purpose.
conversation_idOptional	string	-	Used by check_for_input and save_conversation to identify an individual conversation.
debug_webhook_levelOptional	integer	1 if url is set	Enables debugging to the set URL. Allowed values from 0 - 2.
debug_webhook_urlOptional	string	-	Each interaction between the AI and end user is posted in real time to the established URL. Authentication can also be set in the url in the format of username:password@url.
directionOptional	string	the natural direction of the call	Forces the direction of the call to the assistant. Valid values are inbound and outbound.
digit_terminatorsOptional	string	-	DTMF digit, as a string, to signal the end of input (ex: "#")
digit_timeoutOptional	integer	3000 ms	Time, in ms, at the end of digit input to detect end of input. Allowed values from 250-10,000.
eleven_labs_stabilityOptional	number	-	The stability slider determines how stable the voice is and the randomness between each generation. Lowering this slider introduces a broader emotional range for the voice. Valid values range from 0.01 to 1.0. Important: This will only works when elevenlabs is set in the ai.languages.voice as the engine id.
eleven_labs_similarityOptional	number	-	The similarity slider dictates how closely the AI should adhere to the original voice when attempting to replicate it. The higher the similarity, the closer the AI will sound to the original voice. Valid values range from 0.01 to 1.0. Important: This will only works when elevenlabs is set in the ai.languages.voice as the engine id.
end_of_speech_timeoutOptional	integer	2000 ms (2 seconds)	Amount of silence, in ms, at the end of an utterance to detect end of speech. Allowed values from 250-10,000.
enable_thinkingOptional	boolean	false	Enables thinking output for the AI Agent. When set to true, the AI Agent will be able to utilize thinking capabilities. Important: This may introduce a little bit of latency as the AI will use an additional turn in the conversation to think about the query.
enable_visionOptional	boolean	false	Enables visual input processing for the AI Agent. The image that will be used for visual processing will be gathered from the users camera if video is available on the call. When set to true, the AI Agent will be able to utilize visual processing capabilities, while leveraging the get_visual_input function.
energy_levelOptional	number	52	Amount of energy necessary for bot to hear you (in dB). Allowed values from 0.0-100.0.
function_wait_for_talkingOptional	boolean	false	If true, the AI will wait for any filler to finish playing before executing a function. If false, the AI will asynchronously execute a function while playing a filler.
hard_stop_promptOptional	string	-	A final prompt that is fed into the AI when the hard_stop_time is reached.
hard_stop_timeOptional	string	-	Specifies the maximum duration fopr the AI Agent to remain active before it exists the session. After the timeout, the AI will stop responding, and will proceed with the next SWML instruction. Time Format Seconds Format: 30s Minutes Format: 2m Hours Format: 1h Combined Format: 1h45m30s
hold_musicOptional	string	-	A URL for the hold music to play, accepting WAV, mp3, and FreeSWITCH tone_stream.
hold_on_processOptional	boolean	-	Enables hold music during SWAIG processing.
inactivity_timeoutOptional	integer	600000 ms (10 minutes)	Amount of time, in ms, to wait before exiting the app due to inactivity. Allowed values from 10,000-3,600,000.
initial_sleep_msOptional	integer	0	Amount of time, in ms, to wait before the AI Agent starts processing. Allowed values from 0-300,000.
input_poll_freqOptional	string	-	Check for input function with check_for_input. Example use case: Feeding an inbound SMS to AI on a voice call, eg., for collecting an email address or other complex information.
interrupt_on_noiseOptional	boolean	-	When enabled, barges agent upon any sound interruption longer than 1 second.
interrupt_promptOptional	string	-	Provide a prompt for the agent to handle crosstalk.
languages_enabledOptional	boolean	-	Allows multilingualism when true.
local_tzOptional	string	GMT	The local timezone setting for the AI. Value should use IANA TZ ID
llm_diarize_awareOptional	boolean	false	If true, the AI Agent will be involved with the diarization process. Users can state who they are at the start of the conversation and the AI Agent will be able to correctly identify them when they are speaking later in the conversation.
openai_asr_engineOptional	string	deepgram:nova-3	The OpenAI ASR (Automatic Speech Recognition) engine to use. Allowed values are deepgram:nova-2 and deepgram:nova-3.
outbound_attention_timeoutOptional	integer	-	Sets a time duration for the outbound call recipient to respond to the AI agent before timeout, in a range from 10000 to 600000.
save_conversationOptional	boolean	false	Send a summary of the conversation after the call ends. This requires a post_url to be set in the ai parameters and the conversation_id defined below. This eliminates the need for a post_prompt in the ai parameters.
static_greetingOptional	string	-	A static greeting to play at the start of the call.
static_greeting_no_bargeOptional	boolean	false	If true, the static greeting will not be interrupted by the user if they speak over the greeting. If false, the static greeting can be interrupted by the user if they speak over the greeting.
swaig_allow_settingsOptional	boolean	-	Allows tweaking any of the indicated settings, such as barge_match_string, using the returned SWML from the SWAIG function.
swaig_allow_swmlOptional	boolean	-	Allows your SWAIG to return SWML to be executed.
swaig_post_conversationOptional	boolean	-	Post entire conversation to any SWAIG call.
thinking_modelOptional	string	Value of ai_model	The AI model that the AI Agent will use when utilizing thinking capabilities. Available AI Models: gpt-4o-mini, gpt-4.1-mini, gpt-4.1-nano
transparent_bargeOptional	boolean	-	When enabled, the AI will not respond to the user's input when the user is speaking over the agent. The agent will wait for the user to finish speaking before responding. Additionally, any attempt the LLM makes to barge will be ignored and scraped from the conversation logs.
transfer_summaryOptional	boolean	-	Pass a summary of a conversation from one AI agent to another. For example, transfer a call summary between support agents in two departments.
tts_number_formatOptional	string	international	The format of the number the AI will reference the phone number. Valid Values: international(e.g. +12345678901) or national(e.g. (234) 567-8901).
verbose_logsOptional	boolean	-	Enable verbose logging.
video_listening_fileOptional	string	-	URL of a video file to play when AI is listening to the user speak. Only works for calls that support video.
video_idle_fileOptional	string	-	URL of a video file to play when AI is idle. Only works for calls that support video.
video_talking_fileOptional	string	-	URL of a video file to play when AI is talking. Only works for calls that support video.
vision_modelOptional	string	Value of ai_model	The AI model that the AI Agent will use when utilizing vision capabilities. Available AI Models: gpt-4o-mini, gpt-4.1-mini, gpt-4.1-nano
wait_for_userOptional	boolean	false	When false, AI agent will initialize dialogue after call is setup. When true, agent will wait for the user to speak first.