Amazon Lex - Cognigy Documentation

Amazon Lex NLU Connector

The Amazon Lex NLU connector enables integration with Amazon Lex to use its language understanding results for powering AI Agents in Cognigy.AI.

Prerequisites

Configuration on the NLU Provider Side

  1. Log in to the AWS Console, then go to the Lex Start page to create a new bot.
  2. Make sure to configure the languages that the bot will support, based on the Locale in Cognigy.AI. This step is important for proper integration.
  3. After configuring the bot, save your changes and build the bot. Ensure all languages are built, especially if you intend to use multiple languages in Cognigy.AI.
  4. In the Lex Console, navigate to Bot versions and create a new version for your bot.
  5. Create a Bot Alias and associate it with the new version. Copy the Bot ID and Bot Alias ID from the URL for later use in Cognigy.AI.
  6. Create a new IAM user in the AWS IAM Console, ensuring the user has the appropriate permissions. Make sure the AWS user has the following permissions:
// List of permissions:
iam:CreateUser
 iam:CreatePolicy
 iam:AttachUserPolicy
 lex:ListBotAliases
 lex:ListBotLocales
 lex:ListBots
 lex:ListBotVersions
 lex:ListBuiltInIntents
 lex:ListBuiltInSlotTypes
 lex:ListSlots
 lex:ListSlotTypes
 lex:DescribeBot
 lex:DescribeBotAlias
 lex:DescribeBotLocale
 lex:DescribeBotVersion
 lex:DescribeSlot
 lex:DescribeSlotType
 lex:CreateBot
 lex:CreateBotAlias
 lex:CreateBotLocale
 lex:CreateBotVersion
 lex:CreateIntent
 lex:CreateSlot
 lex:RecognizeText
 lex:StartConversation
  1. Once the user is created, retrieve the Access Key ID and Secret Access Key.

Configuration on the Cognigy.AI Side

  1. In Cognigy.AI, go to Build > NLU Connectors and create an Amazon Lex NLU connector.
  2. (Optional) Toggle Reparse Lex Slots if you want to use reparse Lex Slots.
  3. Enter the retrieved credentials.
Parameter Description & How to Find
Access Key The Access Key ID you retrieved when creating the IAM user.
Secret Access Key The Secret Access Key you retrieved when creating the IAM user.
AWS Region The AWS region in which your Lex bot was created (for example, us-east-1).
Bot ID The Bot ID copied from the URL in the Lex Console.
Bot Alias ID The Bot Alias ID copied from the URL in the Lex Console.

Test your NLU Connector

By default, the Cognigy NLU connector is used in the Interaction Panel for testing purposes. To change this behavior, open the Settings tab in the Interaction Panel, then select the configured connector from the NLU Connector list.

Add your NLU Connector to Endpoint Settings

By default, the Cognigy NLU connector is used in the Endpoint. To change this behavior, follow these steps:

  1. Go to Deploy > Endpoints.
  2. Select the desired Endpoint and open the Endpoint Settings.
  3. Go to Natural Language Understanding > NLU Connector and select the configured connector.

More Information