Amazon Lex Chatbot Workshop

Amazon Lex is a service for building conversational interfaces into any application using voice and text. Amazon Lex provides the advanced deep learning functionalities of automatic speech recognition (ASR) for converting speech to text, and natural language understanding (NLU) to recognize the intent of the text, to enable you to build applications with highly engaging user experiences and lifelike conversational interactions. With Amazon Lex, the same deep learning technologies that power Amazon Alexa are now available to any developer, enabling you to quickly and easily build sophisticated, natural language, conversational bots ("chatbots").

This workshop walks through the steps of creating an interactive chatbot using the AWS Lex service.

CoffeeBot

CoffeeBot is a transactional chat bot that can help one order a coffee.

Consider this conversation:

User: May I have a mocha?

CoffeeBot: What size? small, medium, large?

User: small

CoffeeBot: Would you like that iced or hot?

User: hot

CoffeeBot: You'd like me to order a small mocha. Is that right?

User: Make it a large mocha

CoffeeBot: You'd like me to order a large mocha. Is that right?

User: yeah

CoffeeBot: Great! Your mocha will be available for pickup soon. Thanks for using CoffeeBot!

First, we'll create the Amazon Lex bot. Then, we'll add some Lambda Functions to bring it to life.

Amazon Lex bot

We will be creating a custom bot in the console and applying the necessary intents and custom slots in order to understand the coffee order.

Navigate to Lex in the AWS Console

Because of the large number of students in the class, we'll be sharing VPCx accounts for this lab. Refer to the excel sheet sent out for your sign in link, username, password, and region.

Once you are logged into your AWS account, you will be presented with a list of AWS services and a search box. Type "Lex" into the search box and choose the "Amazon Lex" service.

If you have not already done so. Select the region assigned to you in the speadsheet.

If this is your first time in the Amazon Lex console, you may be prompted with a welcome page. Choose "Get Started" and then "Cancel" so that you are at the Lex page with "Bots", "Intents", and "Slot Types" on the left hand navigation. If this isn't your first time, you will be brought directly to the Lex console.

Create bot

First, we'll create the bot.

1. From the Amazon Lex console, select "Bots" on the left and then choose "Create" and choose "Custom Bot". Create a Custom bot with these settings (you can see these in the "Settings" tab later)
   • Bot name: CoffeeBot
   • Output voice: Pick Any Voice
   • Session timeout: 5 min
   • IAM role: (accept the default) AWSServiceRoleForLexBots
   • COPPA: (our bot is not directed at children) No

Create Order Beverage Intent

From the left, add a new Intent called cafeOrderBeverageIntent with the following settings and click "Save Intent" to save the Intent.

Add the following options to your intent:

1. Sample Utterances: add these to the list of sample utterances so the bot recognizes similar phrases (each entry on a separate line)

I would like a {BeverageSize} {BeverageType}
Can I get a {BeverageType}
May I have a {BeverageSize} {Creamer} {BeverageType}
Can I get a {BeverageSize} {BeverageTemp} {Creamer} {BeverageType}
Let me get a {BeverageSize} {Creamer} {BeverageType}

2. Lambda initialization and validation (leave unchecked)
3. Fulfillment: choose "Return parameters to client" for now
4. Confirmation prompt: You'd like me to order a {BeverageSize} {BeverageType}. Is that right? to confirm and Okay. Nothing to order this time. See you next time! to cancel.

When everything is entered, choose "Save Intent" at the bottom.

Create Slot types

In the upper left hand corner, select the "+" next to "Slot Type" to add new slots to your account.

Add the following Slot types (each value should be a separate entry).

Note: Although they are saved with the AWS Account, Slot Types will only show up in the list on the left when they are associated in the next step. Keep creating slots until you've completed all in the following table:

Choose "Save Slot Type" when each one is completed.

Slot type name	Description	Values (each entry on a separate line)
cafeBeverageType		coffee; cappuccino; latte; mocha; chai; espresso; smoothie
cafeBeverageSize		kids; small; medium; large; extra large; six ounce; eight ounce; twelve ounce; sixteen ounce; twenty ounce
cafeCreamerType		two percent; skim milk; soy; almond; whole; skim; half and half
cafeBeverageTemp		hot; iced

Add Slots to the Intent

Navigate back to the intent page of your cafeOrderBeverageIntent, locate "Slots" midway down the page.

Add the following entries to the list of Slots, choosing the Slot Types created above. Click "Save Intent".

Required	Name	Slot type	Prompt
Yes	BeverageType	cafeBeverageType	What kind of beverage would you like? For example, mocha, chai, etc.
Yes	BeverageSize	cafeBeverageSize	What size? small, medium, large?
No (unchecked)	Creamer	cafeCreamerType	What kind of milk or creamer?
No (unchecked)	BeverageTemp	cafeBeverageTemp	Would you like that iced or hot?

Error Handling

1. Navigate to the the Error handling settings and set the following

• Prompts: (one prompt) Sorry, but I didn't understand that. Would you try again, please?
• Maximum number of retries: 2
• Hang-up phrase: (one phrase) Sorry, I could not understand. Goodbye.

Test

Click the build icon in the upper right hand corner to build the app. This can take a few minutes.

Once built, a new panel will appear on the right of the Amazon Lex Console where you can test some of the Utterances in the Test Bot dialog. For example, if you say May I have a coffee?, does Lex correctly map coffee to the BeverageType slot?

Lambda Function

Now that we've tested that our application works, let's add more logic to validate our choices and handle the processing of the order. We'll be using another service called AWS Lambda to do this. AWS Lambda lets you run code without provisioning or managing servers. You pay only for the compute time you consume.

Choose "Services" from the navigation bar at the top of the page, and search for "Lambda".

1. Select "Create function" in the upper right hand corner
2. Select "Author from scratch"
3. Function Name: cafeOrderCoffee
4. Leave NodeJS selected as the runtime.
5. Click the dropdown "Choose or create an execution role" and ensure "Create a new role with basic Lambda permissions" is checked
6. Create Function

1. Once created, you can scroll to the bottom of the page to edit the code for you function.
   • You can get the function source here
   • There is no need to set up a trigger; you can accept default values for most of the configuration

1. In the code block at the bottom, you'll notice that the function checks the bot name it receives (if (event.bot.name !== 'CoffeeBot')); You will need to change this value in the function and in the test event to match the name you used for your bot. Click "Save" at the top to save your Lambda function.

Now we'll configure a test event to ensure our Lambda function works.

1. At the top of the page, choose "Select a test event".
2. Configure the Test event and test to confirm the function works as expected
   • Event name: cafeOrderCoffeeTestEvent
   • You can get the event source here
   • After saving your test event, you can choose "test" in the console to ensure it works as expected.

Test the bot

Navigate back to the Amazon Lex console to reconfigure your bot to use the Lambda function for validation.

1. From the Lex Console, select the CoffeeBot bot and choose Latest from the version drop down to make changes
2. Modify the cafeOrderBeverageIntent Intent
   • Associate it with the new cafeOrderCoffee Lambda function (select "Lambda function" in the "Lambda initialization and validation" area)
     • When prompted, allow Amazon Lex to call your new function
   • Associate it with the new cafeOrderCoffee Lambda function for (select "Lambda function" in the "Fulfillment" area); remember to click "Save Intent"
     • The Lambda function overrides the "Goodbye message"
3. Build the bot
4. Test using the Amazon Lex Console; do you see any responses when you ask May I have a coffee?

Try to order a beverage like a coffee. You should see a message stating that it is not available. Now try to order a mocha or a chai and see the response. To understand why you're getting a different response than earlier, take look at the source code for the lambda validation.

Cleanup

When you have completed the lab, please delete the following resources from your account when complete.

• In the Lambda console
  • Lambda function cafeOrderCoffee
• In the Lex console (in this order)
  1. Bots
     • CoffeeBot
  2. Intents
     • cafeOrderBeverageIntent
  3. Slot Types
     • cafeBeverageSize
     • cafeBeverageTemp
     • cafeBeverageType
     • cafeCreamerType