Azure Translate

Overview

The Azure Translate Book integrates with Azure Translate, allowing you to automate language translation in your processes.

Prerequisites

1. Learning the Translator Book

In order to work with these operations, you must first learn the Translator Book in Kognitos. To do so:

1. In the left sidebar, click on Books.

2. In the search bar, search for Translator.

3. Click on + Book. A pop-up window will appear asking to Add New Book. Click Add.

2. Azure Setup

These are prerequisite steps for configuration within Azure.

Create an Azure Storage Account

1. Open the Azure Portal and go to Storage accounts from the menu.

2. Click Create.

3. Provide the necessary details, including:

   1. Subscription

   2. Resource Group

   3. Storage Account Name

   4. Region

4. Under Performance, select Standard.

5. For Redundancy, choose LRS (Locally Redundant Storage).

6. In the Advanced tab, enable:

   1. Secure transfer

   2. Anonymous access to individual containers

   3. Storage account key access

7. Review your settings, then click Review + Create to finalize.

Create a Container in Azure

1. Navigate to your new storage account in the Azure Portal.

2. In the left menu of the storage account, scroll to the Data storage section and select Containers.

3. Click on + Container.

4. Provide a name for your container.

5. Set the level of anonymous access for the containers and blobs.

Create a Translator in Azure

1. Open the portal menu and go to All Services.

2. Search for "Translators". Select Translator under Azure AI services.

3. Click on Create Translator.

4. Fill in the Project Details and Instance Details for your translator.

5. Click on Review + create.

6. After your translator has been created, you will need to retrieve your translator key from Keys and Endpoint.

3. Connecting to the Translator in Kognitos

After the Book is learned and the translator infrastructure is set up in Azure, you’ll need to connect to the translator within the Kognitos platform. Add the following lines to your Playground or Processes to establish the connection.

Syntax

the department's translation engine is "azure"
connect to translator with
    the translator name is "{translator name}"
    the translator key is "translator key}"
    the storage account name is "{storage account name}"
    the storage account key is "{storage account key}"
    the container name is "{container name}"

Parameters

1. translator name: The name of the Azure translator.

2. translator key: The key for the Azure translator.

3. storage account name: The name of the Azure storage account.

4. storage account key: The key for the Azure storage account.

5. container name: The name of the Azure container.

Kognitos will attempt to connect to the translation service using the provided credentials. If the connection is successful, you can proceed with translation operations. Otherwise, please verify your credentials and try again.