Skip to main content
In the Real-Time Translation Settings section, you can configure the Real-Time Translation feature. Before using this feature, you need to add a machine translation provider.

​
Add a Machine Translation Provider

  1. In the left-side menu of the Project, go to Manage > Settings.
  2. In the Translation settings section, select one of the following providers and configure the settings:
  • Microsoft Translator
  • Google Cloud Translation
  • DeepL Translate Pro
SettingDescription
Translation Provider API KeyEnter your unique API key provided by Microsoft Translator. It’s necessary for authentication and allows you to access translation services.
Request RetriesEnter how often Cognigy.AI should attempt to call the translation provider if an error occurs during the initial request. For example, if you set it to 3, Cognigy.AI tries three times before giving up on a translation request.
Request TimeoutEnter how long Cognigy.AI should wait for a response from the translation provider after making a request, in milliseconds. If the provider doesn’t respond within this time frame, it’s considered a timeout.
Sentence Cache Expiry TimeoutEnter how long translations should be kept in the cache before they are considered outdated and removed. The default value is 84,600 seconds, which corresponds to 1 day. For no caching, set it to 0.
Custom API Base URLThis setting is optional. If you have specific requirements or need to connect to a custom instance of the Microsoft Translator API different from the default one https://api.cognitive.microsofttranslator.com/, you can use this field to specify a custom base URL. It allows you to define the URL, including the protocol scheme, for example https://api-eur.cognitive.microsofttranslator.com, to tailor the API connection to your needs.
Custom Subscription RegionThis setting is optional. It represents the location or region of your Azure AI Translator resource. You may need to use this field when calling this API, especially if you have specified a specific region in your Azure account.
  1. Click Save.

​
Real-Time Translation Settings

Version badge
ParameterDescriptionProviders
Enable TranslationActivate real-time translation for the Endpoint.Microsoft, Google, DeepL Translate Pro
User Input LanguageSelect the language of the user input or the Auto-Detect option. This option detects the language of the user automatically in their first messages.Microsoft, Google, DeepL Translate Pro
Flow LanguageSelect the AI Agent’s language.Microsoft, Google, DeepL Translate Pro
Set user input language on execution countThis setting applies if you’ve selected the Auto-Detect option in the User Input Language list. Set the number of user inputs the AI Agent uses to determine the language of the user. After this number of user inputs, the AI Agent stops trying to detect the user language.Microsoft, Google, DeepL Translate Pro
Glossary ID OutputEnter the glossary ID for the AI Agent’s output translations. To ensure that the translations work correctly, the source and target languages of the glossary must match the selected language in the Flow Language and User Input Language fields.DeepL Translate Pro
Glossary ID InputEnter the glossary ID for user input translations. To ensure that the glossary works correctly, the source and target languages of the glossary must match the selected language in the Flow Language and User Input Language fields. If you’ve selected Auto-Detect in the User Input Language field, the glossary isn’t used for input translations.DeepL Translate Pro
FormalitySelect the level of formality for the translated text. This setting applies only to the following target languages:
  • DE (German)
  • FR (French)
  • IT (Italian)
  • ES (Spanish)
  • NL (Dutch)
  • PL (Polish)
  • PT-BR (Portuguese)
  • PT-PT (Portuguese)
  • JA (Japanese)
  • RU (Russian)
DeepL Translate Pro
No-Translation MarkerEnter the marker for excluding text segments from translation. Any text enclosed in the no-translation marker isn’t translated. By default, the no-translation marker is **. In this case, if you enter, for example, Willkommen, **Moin**! in the Text field of a Say Node and the detected user language is English, the AI Agent outputs Welcome, Moin! to the user. Moin isn’t translated as Good Morning. This setting can be useful, for example, to avoid translating product and brand names.Microsoft, Google, DeepL Translate Pro
Always remove No-Translation MarkersWhen you activate this setting, the AI Agent always removes the no-translation markers before outputting any text, even if you deactivate real-time translation.Microsoft, Google, DeepL Translate Pro
Prevent payloads from being translatedWhen you activate this setting, user inputs received via payload aren’t translated.Microsoft, Google, DeepL Translate Pro

​
More Information

⌘I