Step 2b (Optional): Review the Details of the Typed Information Flow (Console)

User types: I would like to order some flowers

1. The client (console) sends the following PostText request to Amazon Lex:

   POST /bot/OrderFlowers/alias/$LATEST/user/4o9wwdhx6nlheferh6a73fujd3118f5w/text
   "Content-Type":"application/json"
   "Content-Encoding":"amz-1.0"
   
   {
       "inputText": "I would like to order some flowers",
       "sessionAttributes": {}
   }

   Both the request URI and the body provide information to Amazon Lex:

   • Request URI – Provides bot name (OrderFlowers), bot alias ($LATEST), and user name (a random string identifying the user). The trailing text indicates that it is a PostText API request (and not PostContent).

      

   • Request body – Includes the user input (inputText) and empty sessionAttributes. When the client makes the first request, there are no session attributes. The Lambda function initiates them later.

2. From the inputText, Amazon Lex detects the intent (OrderFlowers). This intent does not have any code hooks (that is, the Lambda functions) for initialization and validation of user input or fulfillment.

   Amazon Lex chooses one of the intent's slots (FlowerType) to elicit the value. It also selects one of the value-elicitation prompts for the slot (all part of the intent configuration), and then sends the following response back to the client. The console displays the message in the response to the user.

   

   The client displays the message in the response.

User types: roses

1. The client (console) sends the following PostText request to Amazon Lex:

   POST /bot/OrderFlowers/alias/$LATEST/user/4o9wwdhx6nlheferh6a73fujd3118f5w/text
   "Content-Type":"application/json"
   "Content-Encoding":"amz-1.0"
   
   {
       "inputText": "roses",
       "sessionAttributes": {}
   }

   The inputText in the request body provides user input. The sessionAttributes remains empty.

2. Amazon Lex first interprets the inputText in the context of the current intent—the service remembers that it had asked the specific user for information about the FlowerType slot. Amazon Lex first updates the slot value for the current intent and chooses another slot (PickupDate) along with one of its prompt messages—What day do you want the roses to be picked up?— for the slot.

   Then, Amazon Lex returns the following response:

   

   The client displays the message in the response.

User types: tomorrow

1. The client (console) sends the following PostText request to Amazon Lex:

   POST /bot/OrderFlowers/alias/$LATEST/user/4o9wwdhx6nlheferh6a73fujd3118f5w/text
   "Content-Type":"application/json"
   "Content-Encoding":"amz-1.0"
   
   {
       "inputText": "tomorrow",
       "sessionAttributes": {}
   }

   The inputText in the request body provides user input. The sessionAttributes remains empty.

2. Amazon Lex first interprets the inputText in the context of the current intent—the service remembers that it had asked the specific user for information about the PickupDate slot. Amazon Lex updates the slot (PickupDate) value for the current intent. It chooses another slot to elicit value for (PickupTime). It returns one of the value-elicitation prompts—Deliver the roses at what time on 2017-01-05?—to the client.

   Amazon Lex then returns the following response:

   

   The client displays the message in the response.

User types: 6 pm

1. The client (console) sends the following PostText request to Amazon Lex:

   POST /bot/OrderFlowers/alias/$LATEST/user/4o9wwdhx6nlheferh6a73fujd3118f5w/text
   "Content-Type":"application/json"
   "Content-Encoding":"amz-1.0"
   
   {
       "inputText": "6 pm",
       "sessionAttributes": {}
   }

   The inputText in the request body provides user input. The sessionAttributes remains empty.

2. Amazon Lex first interprets the inputText in the context of the current intent—the service remembers that it had asked the specific user for information about the PickupTime slot. Amazon Lex first updates the slot value for the current intent. Now Amazon Lex detects that it has information for all the slots.

   The OrderFlowers intent is configured with a confirmation message. Therefore, Amazon Lex needs an explicit confirmation from the user before it can proceed to fulfill the intent. Amazon Lex sends the following message to the client requesting confirmation before ordering the flowers:

   

   The client displays the message in the response.

User types: Yes

1. The client (console) sends the following PostText request to Amazon Lex:

   POST /bot/OrderFlowers/alias/$LATEST/user/4o9wwdhx6nlheferh6a73fujd3118f5w/text
   "Content-Type":"application/json"
   "Content-Encoding":"amz-1.0"
   
   {
       "inputText": "Yes",
       "sessionAttributes": {}
   }

   The inputText in the request body provides user input. The sessionAttributes remains empty.

2. Amazon Lex interprets the inputText in the context of confirming the current intent. It understands that the user want to proceed with the order. The OrderFlowers intent is configured with ReturnIntent as the fulfillment activity (there is no Lambda function to fulfill the intent). Therefore, Amazon Lex returns the following slot data to the client.

   

   Amazon Lex set the dialogState to ReadyForFulfillment. The client can then fulfill the intent.

Now test the bot again. To do that, you must choose the Clear link in the console to establish a new (user) context. Now as you provide data for the order flowers intent, try to provide invalid data. For example:

Notice that the bot accepts these values because you don't have any code to initialize/validate user data. In the next section, you add a Lambda function to do this. Note the following about the Lambda function: