Skip to main content

Overview

The Language Switch Prompt enables your AI agent to dynamically identify and respond when a user explicitly or implicitly requests a switch in language. This functionality is critical for agents that support multilingual conversations, especially over voice where real-time language adaptation enhances usability and reach.

Purpose

When multilingual agents are enabled, this prompt instructs the system to:
  1. Detect whether the user is requesting a language change.
  2. If detected, identify the specific target language.
  3. Return the correct output so that downstream logic can route accordingly.

Where It Lives

Location:
Manage Agents → Overview → Language Switch Prompt
Whenever you add or remove a language, the system prompts you to update this field to ensure alignment between what the agent supports and what it can detect. A pre-filled reference prompt is provided. You are expected to customize it based on the languages added to your agent and their corresponding trigger phrases.

Why It’s Important

Language switching relies on both system configuration and prompt logic. If a language is added to the agent configuration but not reflected in the prompt (or vice versa), switching will fail at runtime. The prompt becomes the source of truth for how language detection is handled across STT engine outputs. 

Prompt Template (To Customize)

Below is the reference structure you should adapt based on your agent’s supported languages and expected phrases.

Trigger Workflow

When a new language is added to the agent via the UI:
  1. A confirmation dialog is shown instructing you to update the Language Switch Prompt.
  2. Navigate to Agent Overview → Language Switch Prompt.
  3. Modify the reference prompt to include:
    1. Any new language added
    2. Detection examples/phrases (if required)
  4. Save and deploy.
Failure to update this prompt will result in language switching not working, even if the language has been configured elsewhere.

Best Practices