Skip to content

Localization

Cognigy.AI offers a robust Localization feature for easy customization and content reuse.

With the localization view, you can configure multiple locales. If one locale doesn't have content configured, the system automatically falls back to another locale that does.

While you can add additional locales for content localization later on, note that once the primary locale is selected, it cannot be modified.

You can localize your Flow in two ways:

Standard Localization

Within standard localization, you manually localize Nodes and Intents without the use of machine translation.

Add a Locale to an Agent

Cognigy AI Agents use English as the default language. However, you can customize the language of your Flow to match your requirements when needed.

To create a locale, follow these steps:

  1. Open the Cognigy.AI interface.
  2. In the left-side menu, select a Project.
  3. In the left-side Project menu, select Manage > Localization.
  4. Click + Create new Locale.
  5. In the Name field, enter a unique name of the locale. This name will be displayed in the Flow.
  6. From the NLU Language list, select a language for your locale.
  7. From the Fallback Locale list, select a locale that will be used as default when a specific language is not available.
  8. Click Save & Build.

Localize a Flow

  1. Go to the existing Flow by selecting Build > Flows.
  2. In the upper-left corner of the Flow editor, select a locale that you recently created.

When switching localization, the Flow will change its appearance. Greyed-out Nodes indicate that they have not been localized yet.

Switching a Locale during a Conversation

You can change a locale of a Flow during a conversation by using the Switch Locale Node.

Now you need to localize each Node separately.

Add a Locale to a Node

To localize a Node manually, follow these steps:

  1. In the Flow editor, select a Node that you want to localize.
  2. If the Node is not localized yet, click Add Localization in the Node editor. If the Node was localized before, delete a previous localization by clicking vertical-ellipsis > Remove Localization.
  3. Select one of the following options:
    • Add Empty Localization — create a new locale for the selected Node without any content. It's useful when you want to provide a new translation or content for a specific Node.
    • Copy from — copy the content from an existing locale of the same Node or another source. It's useful when you want to reuse or duplicate content from a different locale.
  4. Fill in the corresponding fields with text that matches the selected locale.
  5. Click Save Node.

Add a Locale to an Intent

To localize an Intent, follow these steps:

  1. In the upper-right corner of the Flow editor, select NLU.
  2. On the Intents tab, select an Intent that you want to localize.
  3. On the Intent page, click Add Localization. If the Intent was localized before, delete a previous locale by clicking vertical-ellipsis > Remove Localization.
  4. Select one of the following options:
    • Add Empty Localization — create a new locale for the selected Intent without any content. It's useful when you want to provide a new translation or content for a specific Intent.
    • Copy from — copy the content from an existing locale of the same Intent or another source. It's useful when you want to reuse or duplicate content from a different locale.
  5. Click Build model.
  6. Click Save.

Add a Locale to Multiple Intents

To localize all Intents within your Flow, follow these steps:

  1. In the upper-right corner of the Flow editor, select NLU.
  2. On the Intents tab, on the right side of the + Create Intent button, click vertical-ellipsis > Add Localisations to all Intents.
  3. In the Add Localizations to all Intents window, select one of the following options:
    • Create empty — create a new locale for the selected Intent without any content. It's useful when you want to provide a new translation or content for Intents.
    • Copy from another locale — copy the content from an existing locale of the same Intent or another source. It's useful when you want to reuse or duplicate content from a different locale.
  4. (Optional) Activate the Overwrite already localized Intents setting to apply changes to all existing Intents within the current Flow locale.
  5. Click Build model.
  6. Click Save.

Copy the Local Reference ID

Reference IDs can be helpful if you want to edit Locales via API.

To copy the Reference ID of a Locale, do the following:

  1. Open the Cognigy.AI interface.
  2. In the left-side menu, select the Project you need.
  3. In the left-side menu of your Project, navigate to Manage > Localization.
  4. On the Localization page, click vertical-ellipsis on the right side next to the Locale you want to copy the reference ID.
  5. Select Copy Reference ID. The ID will be copied to the clipboard.

More Information