Skip to main content

ai.prompt

NameTypeDefaultDescription
promptRequiredobject-An object that accepts the prompt parameters.

prompt Parameters​

The prompt property accepts one of the following objects:

NameTypeDefaultDescription
textRequiredstring-The main identity prompt for the AI. This prompt will be used to outline the agent's personality, role, and other characteristics.
contextsOptionalobject-An object that defines the available contexts for the AI. Each context represents a set of steps that guide the flow of the conversation. The object must include a default key, which specifies the initial context used at the start of the conversation. Additional contexts can be added as other keys within the object. For more details, see the contexts technical reference.
temperatureOptionalnumber1.0Randomness setting. Float value between 0.0 and 1.5. Closer to 0 will make the output less random.
top_pOptionalnumber1.0Randomness setting. Alternative to temperature. Float value between 0.0 and 1.0. Closer to 0 will make the output less random.
confidenceOptionalnumber0.6Threshold to fire a speech-detect event at the end of the utterance. Float value between 0.0 and 1.0. Decreasing this value will reduce the pause after the user speaks, but may introduce false positives.
presence_penaltyOptionalnumber0Aversion to staying on topic. Float value between -2.0 and 2.0. Positive values increase the model's likelihood to talk about new topics.
frequency_penaltyOptionalnumber0Aversion to repeating lines. Float value between -2.0 and 2.0. Positive values decrease the model's likelihood to repeat the same line verbatim.

Variable Expansion​

Use the following syntax to expand variables into your prompt.

VariableDescription
%{call_direction}Inbound or outbound.
%{caller_id_number}The caller ID number.
%{local_date}The local date.
%{spoken_date}The spoken date.
%{local_time}The local time.
%{time_of_day}The time of day.
%{supported_languages}A list of supported languages.
%{default_language}The default language.