#Sample AWS Lambda function for Alexa A simple AWS Lambda function that demonstrates how to write a skill for the Amazon Echo using the Alexa SDK.

Concepts

This sample shows how to create a Lambda function for handling Alexa Skill requests that:

• Web service: communicate with an external web service to get events for specified days in history (Wikipedia API)
• Pagination: after obtaining a list of events, read a small subset of events and wait for user prompt to read the next subset of events by maintaining session state
• Dialog and Session state: Handles two models, both a one-shot ask and tell model, and a multi-turn dialog model.
• SSML: Using SSML tags to control how Alexa renders the text-to-speech.

Setup

To run this example skill you need to do two things. The first is to deploy the example code in lambda, and the second is to configure the Alexa skill to use Lambda.

AWS Lambda Setup

1. Go to the AWS Console and click on the Lambda link. Note: ensure you are in us-east or you won't be able to use Alexa with Lambda.
2. Click on the Create a Lambda Function or Get Started Now button.
3. Skip the blueprint
4. Name the Lambda Function "History-Buff-Example-Skill".
5. Select the runtime as Node.js
6. Go to the the src directory, select all files and then create a zip file, make sure the zip file does not contain the src directory itself, otherwise Lambda function will not work.
7. Select Code entry type as "Upload a .ZIP file" and then upload the .zip file to the Lambda
8. Keep the Handler as index.handler (this refers to the main js file in the zip).
9. Create a basic execution role and click create.
10. Leave the Advanced settings as the defaults.
11. Click "Next" and review the settings then click "Create Function"
12. Click the "Event Sources" tab and select "Add event source"
13. Set the Event Source type as Alexa Skills kit and Enable it now. Click Submit.
14. Copy the ARN from the top right to be used later in the Alexa Skill Setup

Alexa Skill Setup

1. Go to the Alexa Console and click Add a New Skill.
2. Set "History Buff" for the skill name and "history buff" as the invocation name, this is what is used to activate your skill. For example you would say: "Alexa, Ask History Buff what happened on August thirtieth."
3. Select the Lambda ARN for the skill Endpoint and paste the ARN copied from above. Click Next.
4. Copy the Intent Schema from the included IntentSchema.json.
5. Copy the Sample Utterances from the included SampleUtterances.txt. Click Next.
6. [optional] go back to the skill Information tab and copy the appId. Paste the appId into the index.js file for the variable APP_ID, then update the lambda source zip file with this change and upload to lambda again, this step makes sure the lambda function only serves request from authorized source.
7. You are now able to start testing your sample skill! You should be able to go to the Echo webpage and see your skill enabled.
8. In order to test it, try to say some of the Sample Utterances from the Examples section below.
9. Your skill is now saved and once you are finished testing you can continue to publish your skill.

Examples

Example user interactions:

One-shot model:

User: "Alexa, ask History Buff what happened on August thirtieth." Alexa: "For August thirtieth, in 2003, [...] . Wanna go deeper in history?" User: "No." Alexa: "Good bye!"

Dialog model:

User: "Alexa, open History Buff" Alexa: "History Buff. What day do you want events for?" User: "August thirtieth." Alexa: "For August thirtieth, in 2003, [...] . Wanna go deeper in history?" User: "Yes." Alexa: "In 1995, Bosnian war [...] . Wanna go deeper in history?" User: "No." Alexa: "Good bye!"

Dialog model:

User: "Alexa, tell Health Story Lines that I had a seizure" Alexa: "I'm so sorry to hear that. Would you like to add it to your story line?" User: "No" Alexa: "Feel better"

Dialog model:

User: "Alexa, tell Health Story Lines that I had a seizure" Alexa: "I'm so sorry to hear that. Would you like to add it to your story line?" User: "Yes" Alexa: "How long did the seizure last?" User: "About 60 seconds" Alexa: "Could you describe the seizure?" User: "I had limbs jerking and then I blanked out for a bit" Alexa: "Do you know what triggered the seizure?" User: "Yes, it was flashing bright lights" Alexa: "Ok, I have added the seizure to your story line. You can check the Health Story lines app. Hope you have a good day and feel better"