How to connect to Amazon Lex

This guide steps through the specifics of the 'out of the box' Amazon Lex Skill (integration). This Skill lets you connect to content written in or generated by an AWS Lex service. Your Soul Machines Studio Project relies on connections like this to understand the User's intent and provide a response for the Digital Person to present. This Skill can be used alongside other Skills and conversation providers.

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

Creating AWS Role for Lex Bot Integration

1. Log into your AWS account where the Lex Bot is provisioned.

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

3. Go into the IAM tab in the AWS Console and click Roles > Create Role at the top right corner.

4. 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 Soul Machines Studio. Refer to Creating a Project | 3. Connect conversation and add skills for detailed instructions on adding an NLP and skills to your project.