new labs

Author: Rob McCauley

aws/Amazon-DynamoDB/read/tests/webapp/magic.html

@@ -8,8 +8,8 @@
 
     <script>
 
-        const REGION         = 'eu-west-1';
-        var cognitoIdentityPoolId = 'eu-west-1:819bc82c-9b43-40fa-b216-a9d8e4b6d592';
+        const REGION         = 'us-east-1';
+        var cognitoIdentityPoolId = 'us-east-1:583dd84a-7792-49a6-9ce5-5624f80378e7';
 
         var docClient;
 

handling-responses/README.md

@@ -9,7 +9,9 @@ Alexa skill developers can take advantage of functions to prepare effective spee
  * [random-phrase](random-phrase#title), to generate a random phrase from a list
  * [say-array](say-array#title), to read a list of items with the word "and" or "or" before the last item
  * [ssml-audio](ssml-audio#title), to include sound clips and long pauses
-
+ * [ssml-speechcons](ssml-speechcons#title), to make Alexa speak with extra emphasis
+ * [slot-value-check](slot-value-check#title), to verify a user included a slot value in their utterance
+ * [dialog-directive-delegate](dialog-directive-delegate#title), to explore the new Skill Builder tool.
 
 
 <hr />

handling-responses/slot-value-check/README.md

@@ -0,0 +1,31 @@
+#### Ingredients
+## slot-value-check <a id="title"></a>
+<hr />
+
+
+#### What you will learn
+
+Users may not say everything you expect.  They may just say "my name is".
+We can use a function that returns either null, or the value of the slot.
+
+For example, if you had set slotName = "FirstName", you could check it via:
+
+```js
+var slotValue = isSlotValid(this.event.request, slotName); //slot value or false
+        if  (slotValue) {  } else {   }
+```
+
+#### Instructions for deploying this sample skill
+
+1. Create a new AWS Lambda function using the fact blueprint.
+1. Delete the code, replace with [index.js](index.js)
+1. Locate and Copy the AWS Lambda ARN for the new function.
+1. Create a skill with a slot called Item
+1. On the Configuration page, paste in your Lambda ARN as the endpoint.
+1. Test your skill, both with and without saying slot words.
+
+* Copy the ```isSlotValid()``` helper function to use in your code.
+
+<hr />
+
+

handling-responses/slot-value-check/index.js

@@ -0,0 +1,66 @@
+// alexa-cookbook sample code
+
+// There are three sections, Text Strings, Skill Code, and Helper Function(s).
+// You can copy and paste the entire file contents as the code for a new Lambda function,
+//  or copy & paste section #3, the helper function, to the bottom of your existing Lambda code.
+
+
+// 1. Text strings =====================================================================================================
+//    Modify these strings and messages to change the behavior of your Lambda function
+
+// from the lambda, choose Action > Configure Test Event > Alexa Intent - Recipe
+var slotName = "Item";
+
+
+// 2. Skill Code =======================================================================================================
+
+var Alexa = require('alexa-sdk');
+
+exports.handler = function(event, context, callback) {
+    var alexa = Alexa.handler(event, context);
+    // alexa.appId = 'amzn1.echo-sdk-ams.app.1234';
+    // alexa.dynamoDBTableName = 'YourTableName'; // creates new table for session.attributes
+    alexa.registerHandlers(handlers);
+    alexa.execute();
+};
+
+var handlers = {
+    'LaunchRequest': function () {
+        this.emit(':ask', "try saying an utterance with a slot value to test this.");
+    },
+    'Unhandled': function () {
+        var speechOutput;
+        var intent = this.event.request.intent.name;
+
+        var slotValue = isSlotValid(this.event.request, slotName); //slot value or false
+        if  (slotValue) {
+            //slot has a valid value
+            speechOutput="Intent " + intent + ", slot " + slotName + ", is " + slotValue;
+        } else {
+            //no valid slot
+            speechOutput="Intent " + intent + ", did not get a value for " + slotName;
+        }
+        this.emit(':tell', speechOutput);
+    }
+};
+
+
+//    END of Intent Handlers {} ========================================================================================
+// 3. Helper Function  =================================================================================================
+
+
+function isSlotValid(request, slotName){
+        var slot = request.intent.slots[slotName];
+        //console.log("request = "+JSON.stringify(request)); //uncomment if you want to see the request
+        var slotValue;
+
+        //if we have a slot, get the text and store it into speechOutput
+        if (slot && slot.value) {
+            //we have a value in the slot
+            slotValue = slot.value.toLowerCase();
+            return slotValue;
+        } else {
+            //we didn't get a value in the slot.
+            return false;
+        }
+}

handling-responses/ssml-speechcons/README.md

@@ -0,0 +1,32 @@
+#### Ingredients
+## ssml-speechcons <a id="title"></a>
+<hr />
+
+
+#### What you will learn
+This ingredient shows how to add special emphasis to key phrases within your speech output response.
+
+```js
+var speechOutput = "aha, this is a phrase with speechcons, well done.";
+
+console.log(addSpeehconSSML(speechOutput));  // includes ssml tags
+
+// <say-as interpret-as="interjection"> aha </say-as>
+
+```
+
+#### Instructions for deploying this sample skill
+
+1. Create a new AWS Lambda function using the fact blueprint.
+1. Delete the code, replace with [index.js](index.js)
+1. Locate and Copy the AWS Lambda ARN for the new function.
+1. Create a skill such as Hello World.
+1. On the Configuration page, paste in your Lambda ARN as the endpoint.
+1. Test your skill by listening for the ssml response.
+
+* Copy the ```addSpeehconSSML()``` helper function to use in your code.
+
+<hr />
+
+
+

handling-responses/ssml-speechcons/index.js

@@ -0,0 +1,76 @@
+// alexa-cookbook sample code
+
+// There are three sections, Text Strings, Skill Code, and Helper Function(s).
+// You can copy and paste the entire file contents as the code for a new Lambda function,
+//  or copy & paste section #3, the helper function, to the bottom of your existing Lambda code.
+
+
+// 1. Text strings =====================================================================================================
+//    Modify these strings and messages to change the behavior of your Lambda function
+
+var speechOutput = "aha, this is a phrase with speechcons, well done.";  // Array of items
+
+// 2. Skill Code =======================================================================================================
+
+
+var Alexa = require('alexa-sdk');
+
+exports.handler = function(event, context, callback) {
+    var alexa = Alexa.handler(event, context);
+    // alexa.appId = 'amzn1.echo-sdk-ams.app.1234';
+    // alexa.dynamoDBTableName = 'YourTableName'; // creates new table for session.attributes
+    alexa.registerHandlers(handlers);
+    alexa.execute();
+};
+
+var handlers = {
+    'LaunchRequest': function () {
+        //add SSML tags to any speechcons in the string
+        speechOutput=addSpeehconSSML(speechOutput);
+        this.emit(':tell', speechOutput);
+    },
+    'Unhandled': function () {
+        this.emit('LaunchRequest');
+    }
+};
+
+//    END of Intent Handlers {} ========================================================================================
+// 3. Helper Function  =================================================================================================
+
+
+function addSpeehconSSML (text) {
+    //if the text contains a speechcon, add the proper SMML around the speechcon
+    speechcons.forEach(function(element){
+      var elementWithSSML=',<say-as interpret-as="interjection">'+element+'</say-as>,';
+      text = text.replace(element,elementWithSSML);
+    });
+    console.log(text);
+    return text;
+}
+
+//list of valid speechcons
+var speechcons = ["abracadabra","achoo","aha","ahem","ahoy","all righty","aloha",
+"aooga","argh","arrivederci","as you wish","au revoir","aw man","baa",
+"bada bing bada boom","bah humbug","bam","bang","batter up","bazinga",
+"beep beep","bingo","blah","blarg","blast","boing","bon appetit","bonjour",
+"bon voyage","boo","boo hoo","boom","booya","bravo","bummer","caw","cha ching",
+"checkmate","cheerio","cheers","cheer up","chirp","choo choo","clank",
+"click clack","cock a doodle doo","coo","cowabunga","darn","ding dong","ditto",
+"d’oh","dot dot dot","duh","dum","dun dun dun","dynomite","eek","eep",
+"encore","en gard","eureka","fancy that","geronimo","giddy up","good grief",
+"good luck","good riddance","gotcha","great scott","heads up","hear hear",
+"hip hip hooray","hiss","honk","howdy","hurrah","hurray","huzzah","jeepers creepers",
+"jiminy cricket","jinx","just kidding","kaboom","kablam","kaching","kapow",
+"katchow","kazaam","kerbam","kerboom","kerching","kerchoo","kerflop",
+"kerplop","kerplunk","kerpow","kersplat","kerthump","knock knock","le sigh",
+"look out","mamma mia","man overboard","mazel tov","meow","merci","moo",
+"nanu nanu","neener neener","no way","now now","oh boy","oh brother","oh dear",
+"oh my","oh snap","oink","okey dokey","oof","ooh la la","open sesame","ouch",
+"oy","phew","phooey","ping","plop","poof","pop","pow","quack","read ‘em and weep",
+"ribbit","righto","roger","ruh roh","shucks","splash","spoiler alert","squee",
+"swish","swoosh","ta da","ta ta","tee hee","there there","thump","tick tick tick",
+"tick-tock","touche","tsk tsk","tweet","uh huh","uh oh","voila","vroom",
+"wahoo","wah wah","watch out","way to go","well done","well well","wham",
+"whammo","whee","whew","woof","whoops a daisy","whoosh","woo hoo","wow",
+"wowza","wowzer","yadda yadda yadda","yay","yikes","yippee","yoink","yoo hoo",
+"you bet","yowza","yowzer","yuck","yum","zap","zing","zoinks",];

labs/FactService/README.md

@@ -0,0 +1,156 @@
+#### Alexa Cookbook
+## Fact Service Tutorial <a id="title"></a>
+<hr />
+
+### Intro <a id="intro"></a>
+
+ This is a set of tutorial steps on how to add features to an Alexa skill.
+
+
+### Tutorial Steps
+ We will start by installing the most basic of skills and then follow the labs to learn how to extend the skill.
+ We will begin with a code template called ```alexa-skill-kit-sdk-factskill```,
+ however we will replace this code with our starting code so that we see how a fact skill can be created from the ground up.
+
+
+#### Code
+1. Login to AWS and verify the region at the top right is set to the **Ireland** or **N. Virginia** Region region.
+1. Click [Lambda](https://console.aws.amazon.com/lambda/home) and then **Create a Lambda function**  Do not select the default **Blank** blueprint.
+1. Locate and click on the ```alexa-skill-kit-sdk-factskill``` skill template (hint: search for **fact** )
+1. Click in the empty square and choose the trigger *Alexa Skills Kit* and click Next.
+1. Give your function the name *FactService*
+1. Paste in the source code from [src/index.js](./src/index.js) :
+
+```
+        var Alexa = require('alexa-sdk');
+
+        exports.handler = function(event, context, callback) {
+            var alexa = Alexa.handler(event, context);
+
+            // alexa.dynamoDBTableName = 'YourTableName'; // creates new table for userid:session.attributes
+
+            alexa.registerHandlers(handlers);
+            alexa.execute();
+        };
+
+        var handlers = {
+            'LaunchRequest': function () {
+                this.emit('MyIntent');
+            },
+
+            'GetNewFactIntent': function () {
+                this.emit(':tell', 'You can build new voice experiences with the Alexa Skills Kit!');
+            }
+        };
+```
+
+1. Just below the code editor, create or re-use an execution role, such as ```lambda_basic_execution```
+1. Click Next and create the function.
+1. Make note of the Lambda ARN, shown near the top right, such as
+ *  ``` arn:aws:lambda:us-east-1:333304287777:function:FactService ```
+
+
+#### Skill
+1. Login to [developer.amazon.com](https://developer.amazon.com) and click Alexa, then Alexa Skills Kit
+1. Create a new Skill called ```Fact Service``` with invocation name ```fact service```.
+1. Paste in the [IntentSchema.json](./speechAssets/IntentSchema.json) :
+
+```
+{
+  "intents": [
+    {
+      "intent": "GetNewFactIntent",  "slots":[]
+    },
+
+    {
+      "intent": "AMAZON.HelpIntent"
+    },
+    {
+      "intent": "AMAZON.StopIntent"
+    },
+    {
+      "intent": "AMAZON.CancelIntent"
+    }
+  ]
+}
+
+```
+
+1. Paste in the [SampleUtterances.txt](speechAssets/SampleUtterances.txt) :
+
+```
+GetNewFactIntent tell me a fact
+GetNewFactIntent give me a fact
+GetNewFactIntent tell me something
+```
+
+1. Configure the skill endpoint with the AWS Lambda ARN previously created.
+
+#### Test
+* Type or say "open fact service" and Alexa should reply with "You can build new voice experiences with the Alexa Skills Kit"
+* Modify code within the Lambda function editor to have Alexa say something besides this phrase.  Click the blue ```Save``` button.
+* Test and hear Alexa say the new response.
+
+
+# Labs <a id="labs"></a>
+
+## Lab 1 - Fact List
+
+This lab will show you how to define a list of facts instead of a single fact, and have Alexa pick a random fact to tell the user.
+
+Take a look at the ```// helper functions``` section of code at the bottom of your Lambda code:
+
+```javascript
+function getFact() {
+    var newFact = 'You can build new voice experiences with the Alexa Skills Kit';
+    return newFact;
+}
+
+```
+
+We will enhance our getFact() function with the following:
+1. Define an array of facts called **myFacts**.  An array is just a list of values, enclosed in square brackets [].
+1. Add add in a call to a new helper function called ```randomPhrase()``` to help us pick a random value from the array.
+
+#### Steps
+
+Delete the ```getFact()``` function and replace with the following two functions:
+
+```
+function getFact() {
+    var myFacts = ['Pandas live for about 20 years.','Pandas are native to China.','Pandas eat bamboo.']
+
+    var newFact = randomPhrase(myFacts);
+
+    return newFact;
+}
+
+function randomPhrase(array) {
+    // the argument is an array [] of words or phrases
+    var i = 0;
+    i = Math.floor(Math.random() * array.length);
+    return(array[i]);
+}
+```
+
+#### Test
+* Type or say "open fact service" and Alexa should reply with one of the facts in your array.
+* Modify code within the Lambda function editor to change the fact array to your own custom facts.  For example, you could define facts about your hometown.  Click the blue ```Save``` button.
+* Test and hear Alexa say one of your facts.
+
+## Lab 2 - Handle Help, Stop, Cancel
+
+Within your lambda code, *un-comment* out the three lines that handle the standard Alexa intents.
+Hint: locate the // characters and remove them.
+Review and modify the response messages for each intent, if desired.
+
+* AMAZON.HelpIntent
+* AMAZON.CancelIntent
+* AMAZON.StopIntent
+
+You can now submit your skill for publication!  See this [guide on the publishing process](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/publishing-an-alexa-skill).
+
+ <hr/>
+
+[Back](../../README.md#title) - [Cookbook Home Page](../../README.md#title)
+