1. Home
  2. Kore.ai Conversational Platform
  3. Advanced Topics
  4. Multi-Lingual Bots
  5. Enabling an Additional Language

Enabling an Additional Language

Adding a supported language to a bot involves the following steps:

Step 1: Enable the new language

Follow these steps to enable a new language for the bot:

  1. Open the bot for which you want to enable other languages.
  2. Hover over the side navigation panel and click Settings > Language Management.
  3. Under Supported Languages, next to the language you want to enable, click Enable.

    Clicking Enable opens the Enable Language – <Language Name> dialog where you have two options to enable the selected language for the bot, as explained in Step 2 below.

Step 2: Create a language-specific version of the bot

You can enable a new language for the bot in following two ways:

Option 1: Duplicate the configurations of the default language

If you quickly want to enable new language for the bot and translate the bot elements incrementally, you can begin by copying the configuration of the default language for the new language. It replicates the bot definition for the enabled language but continues to have all the bot elements in the default language, which you should translate from the application UI.

Follow these steps to create a new bot version by copying over the default language configurations:

  1. On the Enable Language – <Language name> window, select Copy default language.
  2. On the top-right corner of the window, click Enable. After a successful import, a prompt appears notifying that the new language bot is enabled.

After completing the previous steps, the bot definition for the enabled language gets created for the newly enabled language but the bot elements remain in the default language. You can translate the bot elements from the UI.

Tip: Read the Translatable Bot Components article to view the complete list of bot elements for which you can add translations.

Option 2: Create a new language pack (JSON File) based on a base language pack

If you want to create a translated version of the bot elements at once, perhaps with help from a language expert, you can do so by creating a JSON language pack for the enabled language. The process involves downloading a JSON language pack of any of the already-enabled languages from the bot and then adding translations in the JSON file.

Follow these steps to create a JSON language pack for the enabled language:

  1. On the Enable Language – <Language name> window, in the Base Language Pack drop-down, select a language to download its language pack.
  2. Click Download JSON.

The downloaded JSON file consists of various bot elements for which you should provide the translations. Refer to the Translatable Bot Components article to learn more about these bot elements. To enter a translation for a bot element in the JSON file, replace the corresponding text with the translated text.

After customizing the downloaded JSON file for the new language, follow these steps to upload it to the bot:

  1. On the Enable Language window, select the Use <language-name> language configuration file.
    Example: If you are enabling German, the option becomes Use German language configuration file.
  2. In the Enabling language pack field, click Choose File and upload the new language pack.
  3. On the top-right corner of the window, click Enable. Upon successful import, the Import Successful window appears with the import results.
  4. Click OK. Sucess prompt appears on the top-right corner of your screen.
Notes:
  • After you enable a new language, the status of all the published tasks that are modified changes to Configured. To make the new language work in the bot, you must re-publish the bot. Until then, the bot continues to function with the previously published languages.
  • Support for Synonyms is restricted to only for English, French, Spanish and German languages. The respective sections in Natural Language, Entity Node will be in disabled state.

Verifying if the language is enabled

When the bot supports multiple languages, the top right corner of the bot window shows the default bot language followed by a drop-down to view the other supported languages. Check if the enabled language appears in the list.

Step 3: Add or edit translations

After enabling a new language for the bot, you might need to add or edit translations on an ongoing basis. You can make these edits from the application UI, which is particularly helpful if you have created the bot version by copying over the default bot configurations. Editing from the UI also helps when you want to make minor edits.

Note: If you need to make significant changes to the language pack, we recommend you to make the changes in the offline copy of the language pack and then upload it to the bot. Refer to Editing and Re-uploading a language pack to learn how to do it.

To add or edit translations to a bot element from the UI, follow these steps:

  1. On the top right corner of the bot window, click the current bot language.
  2. From the drop-down list, select the bot language in which you want to make the changes.
  3. Enter the language-specific text for the selected bot elements.
Note: Refer to the Translatable Bot Components article for the complete list of bot elements to which you can add or edit translations.

For example, if you want to add a bot synonym in the new language, follow these steps

  1. Hover over the bot’s side-navigation panel and click Natural Language > Synonyms.
  2. From the list of keywords and synonyms, click the keyword for which you want to add the synonym.
  3. In the synonyms box, type the synonym (in the enabled language) and press enter.

Editing and Re-uploading a language pack

If you need to make major changes to the language pack, the recommended practice is to make the changes in the offline copy of the language pack and re-upload it to the bot.

Note: Proceed with a full replacement of the language pack only if you are externally managing the language pack. The newly updated doesn’t just update the existing language pack but replaces it. If you are looking to make small changes that don’t warrant a full replacement, make them directly from the application UI.

To re-upload a language pack to a bot, follow these steps:

  1. On the top right corner of the bot window, click the current bot language.
  2. From the drop-down list, select the bot language in which you want to make the changes.
  3. Hover over the side navigation panel and click Settings > Language Management. The Language Management window opens displaying a Manage button next to the selected language.
  4. Click Manage and in the Manage Language window click Choose File and upload the updated language pack.

 

Was this article helpful to you? Yes No