Flows advanced configuration

The following table lists all advanced configuration parameters supported by Flows and references to relevant documentation sections.

Parameter name Description
active_listening Active listening mode
error_message Message to be played if LLM response couldn't be generated due to some error.
Refer to Error message for detailed description of similar AI Agent functionality.
empty_llm_response Empty LLM responses
gemini_api Selecting the model API — applied per conversation node
incomplete_turn Incomplete turn detection — applied to conversation nodes
init_conditions Init conditions
llm_logs Detailed LLM logs for troubleshooting
max_transitions Maximum transitions between nodes
max_turns_message Error message
no_user_input_repeat Handling user inactivity
openai_api Selecting the model API — applied per conversation node (flows use the stateless Responses API)
post_call_analysis Post call analysis
prompt_log Logging the agent prompt — the flow prompt is logged once: at the beginning of the conversation, or when the flow is handed the conversation
reasoning_effort Reasoning effort
remove_symbols STT error correction configuration
replace_words
start_delay Delaying the conversation start
tool_certs Custom tool certificates
tool_logs Detailed tool call logs
tts_stream TTS streaming

Maximum transitions between nodes

The maximum_transitions advanced configuration parameter configures maximum number of transitions between nodes. It may be used to limit total conversation length and prevents endless loops.

Parameter Type Description
maximum_transitions int Maximum number of transitions allowed in the flow.

Example

{
    "maximum_transitions": 30
}

Handling user inactivity

When user remains silent, NO-USER-INPUT events are generated, as described in Speech events. You can configure flow to repeat the last response upon one of these events via the no_user_input_repeat advanced configuration parameter.

Specify a list of numeric NO-USER-INPUT event occurrences that should trigger the repeat. For example, the following configures the flow to repeat last response upon the first inactivity event – NO-USER-INPUT-1:

{
  "no_user_input_repeat": [ 1 ]
}

If you specify multiple indexes, e.g. [1, 2], response will be repeated upon multiple inactivity event occurrences (NO-USER-INPUT-1 and NO-USER-INPUT-2 in the above example).

Parameter Type Description
no_user_input_repeat list[int] NO-USER-INPUT event occurrences which trigger repeating the last LLM response.

If you want to end or transfer the call upon user inactivity, create corresponding global node and use the following logical statement in global condition:

(user_utterance == "NO-USER-INPUT-2")

The above example uses second inactivity event (NO-USER-INPUT-2) as a trigger. Adjust the number based on your needs.

Delaying the conversation start

The start_delay advanced configuration parameter configures delay in milliseconds before the flow starts the conversation. It may be used to make sure the first response isn't played before the call is fully established.

Parameter Type Description
start_delay int Delay in milliseconds before the conversation starts.

Example

{
    "start_delay": 1500
}

This is the Flow counterpart of the AI Agent welcome_message_delay parameter.