## 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

| Setting                          | Description                                                                                                                                     |
|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| Translation Provider API Key     | Enter your unique API key provided by Microsoft Translator. It’s necessary for authentication and allows you to access translation services.   |
| Request Retries                  | Enter how often Cognigy.AI should attempt to call the translation provider if an error occurs during the initial request.                       |
| Request Timeout                   | Enter how long Cognigy.AI should wait for a response from the translation provider after making a request, in milliseconds.                    |
| Sentence Cache Expiry Timeout     | Enter how long translations should be kept in the cache before they are considered outdated and removed. The default value is `84,600` seconds.|
| Custom API Base URL              | This setting is optional. Specify a custom base URL for the Microsoft Translator API if needed.                                               |
| Custom Subscription Region        | This setting is optional. Represents the location or region of your Azure AI Translator resource.                                                |

| Setting                          | Description                                                                                                                                     |
|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| Translation Provider API Key     | Enter your unique API key provided by Google Cloud Translation. It’s necessary for authentication and allows you to access translation services.   |
| Request Retries                  | Enter how often Cognigy.AI should attempt to call the translation provider if an error occurs during the initial request.                       |
| Request Timeout                   | Enter how long Cognigy.AI should wait for a response from the translation provider after making a request, in milliseconds.                    |
| Sentence Cache Expiry Timeout     | Enter how long translations should be kept in the cache before they are considered outdated and removed. The default value is `84,600` seconds.|

| Setting                          | Description                                                                                                                                     |
|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| Translation Provider API Key     | Enter your unique API key provided by DeepL Translate Pro. It’s necessary for authentication and allows you to access translation services.   |
| Request Retries                  | Enter how often Cognigy.AI should attempt to call the translation provider if an error occurs during the initial request.                       |
| Request Timeout                   | Enter how long Cognigy.AI should wait for a response from the translation provider after making a request, in milliseconds.                    |
| Sentence Cache Expiry Timeout     | Enter how long translations should be kept in the cache before they are considered outdated and removed. The default value is `84,600` seconds.|
| Custom API Base URL              | This setting is optional. Specify a custom base URL for the DeepL Translate Pro API if needed.                                              |

3. Click **Save**.

## Real-Time Translation Settings

| Parameter                                             | Description                                                                                         | Providers                                |
|------------------------------------------------------|-----------------------------------------------------------------------------------------------------|------------------------------------------|
| Enable Translation                                    | Activate real-time translation for the Endpoint.                                                   | Microsoft, Google, DeepL Translate Pro  |
| User Input Language                                   | Select the language of the user input or the **Auto-Detect** option.                                | Microsoft, Google, DeepL Translate Pro  |
| Flow Language                                        | Select the AI Agent’s language.                                                                    | Microsoft, Google, DeepL Translate Pro  |
| Set user input language on execution count           | Setting for determining user language after a specified number of inputs.                          | Microsoft, Google, DeepL Translate Pro  |
| Glossary ID Output                                   | Enter the glossary ID for the AI Agent’s output translations.                                      | DeepL Translate Pro                       |
| Glossary ID Input                                    | Enter the glossary ID for user input translations.                                                 | DeepL Translate Pro                       |
| Formality                                           | Select the level of formality for the translated text.                                            | DeepL Translate Pro                       |
| No-Translation Marker                                | Enter the marker for excluding text segments from translation.                                     | Microsoft, Google, DeepL Translate Pro  |
| Always remove No-Translation Markers                 | Setting that removes no-translation markers even if real-time translation is deactivated.          | Microsoft, Google, DeepL Translate Pro  |
| Prevent payloads from being translated                | Setting that prevents translation of user inputs received via payload.                             | Microsoft, Google, DeepL Translate Pro  |

## More Information

- [Real-Time Translation](https://docs.cognigy.com/ai/platform-features/translation-and-localization/real-time-translation)
- [Automatic Translation](https://docs.cognigy.com/ai/platform-features/translation-and-localization/auto-translation)