Amazon Lex
This section describes how you can use the Amazon Lex NLP tool in Digital DNA Studio which acts as an interface to bots built using the AWS Lex service.
It does not implement any advanced state management functionality currently, but this may be expanded in the future.
Only bots built through the Lex V2 console are supported.
Refer to the AWS documentation for how to build a bot.
Fallbacks are triggered if an intent named “FallbackIntent” is matched.
lex v2 is currently supported.
lex v1 is currently not supported.
Amazon Lex NLP is supported on Digital People running on HumanOS 2.3+.
Creating AWS Role for Lex Bot Integration
Log into your AWS account where the Lex Bot is provisioned.
You will need to generate an External ID that our services will use to connect to your Lex Bot, the external ID is any unique string that should be a minimum of 16 characters alpha-numeric string.
Go into the IAM tab in the AWS Console and click Roles > Create Role at the top right corner.
In the role creation screen, click Custom trust policy entity type and copy the below code block into the policy field, make sure to replace <
Your External ID> with the string generated in step 3 and click Next.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::924390807111:role/SM_Lex_Origin_Role"
]
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "<Your External ID>"
}
}
}
]
}
5. In the Add Permissions screen, find the AmazonLexRunBotsOnly policy, select it and click Next.
6. Ensure to use the below value as the Role Name otherwise, the bot will not be reachable using this Role (this is a case sensitive value), and verify that all the other values (Aside from your external ID being different) match the code provided in step 4 and click Create Role.
SM_Lex_Access_Role
7. Once the role is created, navigate to the SM_Lex_Access_Role role under the Roles tab and you will be able to copy the Role ARN.
Connecting an AWS Lex Bot to your Digital Person
Choose Amazon Lex NLP from the Manage Conversations and Skills section of Digital DNA Studio. Refer to Creating a Project | 3. Connect conversation and add skills for detailed instructions on adding an NLP and skills to your project.
Field | Type | Description |
|---|---|---|
AWS ROLE ARN (required) | text | Enter the ARN from step 7 above. Format |
EXTERNAL ID (required) | text | Is the external ID generated in step 2 above. |
LEX BOT ID (required) | text | This is used to identify which bot to connect to. See section Lex Bot ID. |
LEX BOT ALIAS ID (required) | text | This is used to specify which version of your Lex bot you want to connect to. See section Lex Bot Alias ID. |
LEX BOT LOCALE (required) | text | This is set based on the language you want your bot to use. See this page for a list of language codes. |
LEX BOT SERVICE REGION (required) | text | AWS region code based on where your Lex bot resource has been created. See this page for a list of region codes. Note: Make sure to use the region code. For example, you should enter |
Lex Bot ID
This is used to identify which bot to connect to.
Lex Bot Alias ID
This is used to specify which version of your Lex bot you want to connect to.
Content Cards
To make use of SM Content Cards, use @showcards(card_name) in a message. Define the card data as a Custom payload response: