## Amazon Lex NLU Connector

The Amazon Lex NLU connector enables integration with [Amazon Lex](https://aws.amazon.com/lex/) to use its language understanding results for powering AI Agents in Cognigy.AI.

## Prerequisites

- Access to Amazon Lex.

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

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

- [All NLU Connectors](https://docs.cognigy.com/ai/platform-features/nlu/external/nlu-connector-reference/all-nlu-connectors)
- [Cognigy Help Center: Amazon Lex](https://support.cognigy.com/hc/en-us/articles/4408910240530-Amazon-Lex-External-NLU)