3 |
4 | [](./1-voice-user-interface.md)[](./2-lambda-function.md)[](./3-connect-vui-to-code.md)[](./4-testing.md)[](./5-customization.md)[](./6-publication.md)
5 |
6 | ## Setting up Your Alexa Skill in the Developer Console
7 |
8 | 1. **Go to the [Alexa Developer Console](http://developer.amazon.com/alexa?&sc_category=Owned&sc_channel=RD&sc_campaign=Evangelism2018&sc_publisher=github&sc_content=Survey&sc_detail=quiz-game-python-V2_GUI-1&sc_funnel=Convert&sc_country=WW&sc_medium=Owned_RD_Evangelism2018_github_Survey_quiz-game-python-V2_GUI-1_Convert_WW_beginnersdevs&sc_segment=beginnersdevs). In the top-right corner of the screen, click the "Sign In" button.**
9 | (If you don't already have an account, you will be able to create a new one for free.)
10 |
11 | 1. Once you have signed in, select the **Developer Console** link and then **Alexa Skills Kit**.
12 |
13 | 1. From the **Alexa Developer Console** select the **Create Skill** button near the top-right of the list of your Alexa Skills.
14 |
15 | 1. Give your new skill a **Name**, for example, 'Pet Match'. This is the name that will be shown in the Alexa Skills Store, and the name your users will refer to.
16 |
17 | 1. Select the Default Language. This tutorial will presume you have selected 'English (US)'.
18 |
19 | 1. Select the **Custom** model under the *'Choose a model to add to your skill'* section. Click the **Create Skill** button at the top right.
20 |
21 | 1. Choose **Start from scratch** from the *Choose a template* section and click the **Choose** button on the top right.
22 |
23 | 1. **Build the Interaction Model for your skill**
24 | 1. On the left hand navigation panel, select the **JSON Editor** tab under **Interaction Model**. In the textfield provided, replace any existing code with the code provided in the [Interaction Model](../models/en-US.json). Click **Save Model**.
25 | 2. If you want to change the skill invocation name, select the **Invocation** tab. Enter a **Skill Invocation Name**. This is the name that your users will need to say to start your skill. In this case, it's preconfigured to be 'pet match'.
26 | 3. Click "Build Model".
27 |
28 | **Note:** You should notice that **Intents** and **Slot Types** will auto populate based on the JSON Interaction Model that you have now applied to your skill. Feel free to explore the changes here, to learn about **Intents**, **Slots**, and **Utterances** open our [technical documentation in a new tab](https://developer.amazon.com/docs/custom-skills/create-intents-utterances-and-slots.html?&sc_category=Owned&sc_channel=RD&sc_campaign=Evangelism2018&sc_publisher=github&sc_content=Survey&sc_detail=quiz-game-python-V2_GUI-1&sc_funnel=Convert&sc_country=WW&sc_medium=Owned_RD_Evangelism2018_github_Survey_quiz-game-python-V2_GUI-1_Convert_WW_beginnersdevs&sc_segment=beginnersdevs).
29 |
30 | 7. **Optional:** Select an intent by expanding the **Intents** from the left side navigation panel. Add some more sample utterances for your newly generated intents. Think of all the different ways that a user could request to make a specific intent happen. A few examples are provided. Be sure to click **Save Model** and **Build Model** after you're done making changes here.
31 |
32 | 8. If your interaction model builds successfully, proceed to the next step. If not, you should see an error. Try to resolve the errors. In our next step of this guide, we will be creating our Lambda function in the AWS developer console, but keep this browser tab open, because we will be returning here on [Page #3: Connect VUI to Code](./3-connect-vui-to-code.md).
33 |
34 | If you get an error from your interaction model, check through this list:
35 |
36 | * **Did you copy & paste the provided code correctly?**
37 | * **Did you accidentally add any characters to the Interaction Model?**
38 |
39 | [](./2-lambda-function.md)
40 |
--------------------------------------------------------------------------------
/instructions/2-lambda-function.md:
--------------------------------------------------------------------------------
1 | # Build An Alexa Pet Match Skill in Python using ASK Python SDK
2 |
3 |
4 | [](./1-voice-user-interface.md)[](./2-lambda-function.md)[](./3-connect-vui-to-code.md)[](./4-testing.md)[](./5-customization.md)[](./6-publication.md)
5 |
6 | ## Setting Up A Lambda Function Using Amazon Web Services
7 |
8 | In the [first step of this guide](1-voice-user-interface.md), we built the Voice User Interface (VUI) for our Alexa skill. On this page, we will be creating a Lambda function using [Amazon Web Services](http://aws.amazon.com). You can [read more about what a Lambda function is](http://aws.amazon.com/lambda), but for the purposes of this guide, what you need to know is that Lambda is where our code lives. When a user asks Alexa to use our skill, it is our Lambda function that interprets the appropriate interaction, and provides the conversation back to the user.
9 |
10 | 1. **Go to http://aws.amazon.com and sign in to the console.** If you don't already have an account, you will need to create one. [Check out this quick walkthrough for setting up a new AWS account](https://github.com/alexa/alexa-cookbook/blob/master/aws/set-up-aws.md).
11 |
12 | [](https://console.aws.amazon.com/console/home)
13 |
14 | 2. **Choose "Services" at the top of the screen, and type "Lambda" in the search box.** You can also find it in the list of services. It is in the "Compute" section.
15 |
16 | [](https://console.aws.amazon.com/lambda/home)
17 |
18 | 3. **Check your AWS region.** Lambda only works with the Alexa Skills Kit in four regions: US East (N. Virginia), EU (Ireland), US West (Oregon) and Asia Pacific (Tokyo). Make sure you choose the region closest to your customers.
19 |
20 | 
21 |
22 | 4. **Click the "Create a Lambda function" button.** It should be near the top of your screen.
23 |
24 | 
25 |
26 | 5. **Click on "Author from scratch".** We will configure our Lambda function next.
27 | 1. These values will only ever be visible to you, but make sure that you name your function something meaningful. "samplePythonPetMatch" is sufficient if you don't have another idea for a name.
28 |
29 | 2. From the "Runtime" dropdown select the python version your system supports. This tutorial and sample code works with either Python 2.7 or 3.6. To check the python version, try the following command in a terminal
30 | ```
31 | $ python --version
32 | Python 2.7.10
33 | ```
34 |
35 | 3. **Set up your Lambda function role.** If you haven't done this before, we have a [detailed walkthrough for setting up your first role for Lambda](https://github.com/alexa/alexa-cookbook/blob/master/guides/aws-security-and-setup/lambda-role.md). If you have done this before, you only need to select the **Existing role**.
36 |
37 | 4. Click **Create function**.
38 |
39 | 6. **Configure your trigger.** There are many different AWS services that can trigger a Lambda function, but for the purposes of this guide, we need to select "Alexa Skills Kit." from the left hand side.
40 |
41 | Once you have selected Alexa Skills Kit, scroll down and find the Skill ID verification section. Although you will want to paste your skill's ID in the Skill ID field, however for this tutorial, click Disable. Click the **Add** button in the lower right. Click the orange **Save** button in the top right corner.
42 |
43 | 7. **Finish configuring your function**. Click on your function's name (you'll find it in the middle) and scroll to the bottom of the page, you'll see a Cloud9 code editor.
44 |
45 | We have provided the code for this skill [here](../lambda/py). To properly upload this code to Lambda, you'll need to perform the following:
46 |
47 | 1. This skill uses the [ASK SDK for Python](https://github.com/alexa/alexa-skills-kit-sdk-for-python) for development. The skill code is provided in the [lambda_function.py](../lambda/py/lambda_function.py), and the dependencies are mentioned in [requirements.txt](../lambda/py/requirements.txt). Download the contents of the [lambda/py](../lambda/py) folder.
48 | 2. On your system, navigate to the lambda folder and install the dependencies in a new folder called “skill_env” using the following command:
49 |
50 | ```
51 | pip install -r py/requirements.txt -t skill_env
52 | ```
53 |
54 | 3. Copy the contents of the `lambda/py` folder into the `skill_env` folder.
55 |
56 | ```
57 | cp -r py/* skill_env/
58 | ```
59 |
60 | 4. Zip the contents of the `skill_env` folder. Remember to zip the **contents** of the folder and **NOT** the folder itself.
61 | 5. On the AWS Lambda console, change the **code entry type** drop-down to **Upload a .ZIP file**, upload the zip created in the previous step and click on **Save**.
62 |
63 | *(Optional)* Follow the ASK Python SDK [Getting Started](https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/GETTING_STARTED.html#adding-the-ask-sdk-for-python-to-your-project) documentation, to check alternative ways of installing the sdk and deploying to AWS Lambda console.
64 |
65 | 8. (Optional) Click the **Configure test events** dropdown menu on the top of the page.
66 | 1. Select 'Alexa Start Session' from the 'Event Template' dropdown.
67 | 2. Type `LaunchRequest` into the 'Event Name' field.
68 | 3. Click the orange 'Create' button at the bottom of the page
69 | 4. Click the **Test** button at the top of the page.
70 | 1. You should see a light green box with the message: *Execution result: succeeded* at the top of the page.
71 |
72 | 9. **As a final step, copy the ARN value from the top right corner of the screen.** You will need this value in the next section of this guide.
73 |
74 | [](3-connect-vui-to-code.md)
75 |
--------------------------------------------------------------------------------
/instructions/3-connect-vui-to-code.md:
--------------------------------------------------------------------------------
1 | # Build An Alexa Pet Match Skill in Python using ASK Python SDK
2 |
3 |
4 | [](./1-voice-user-interface.md)[](./2-lambda-function.md)[](./3-connect-vui-to-code.md)[](./4-testing.md)[](./5-customization.md)[](./6-publication.md)
5 |
6 | ## Connecting Your Voice User Interface To Your Lambda Function
7 |
8 | On [page #1](./1-voice-user-interface.md) of this guide, we created a voice user interface for the intents and utterances we expect from our users. On [page #2](./2-lambda-function.md), we created a Lambda function that contains all of our logic for the skill. On this page, we need to connect those two pieces together.
9 |
10 | 1. **Go back to the [Amazon Developer Portal](https://developer.amazon.com/edw/home.html#/skills/list) and select your skill from the list.** You may still have a browser tab open if you started at the beginning of this tutorial.
11 |
12 | 2. Select the **Endpoint** tab on the left side navigation panel.
13 |
14 | 3. **Select the "AWS Lambda ARN" option for your endpoint.** You have the ability to host your code anywhere that you would like, but for the purposes of simplicity and frugality, we are using AWS Lambda. ([Read more about Hosting Your Own Custom Skill Web Service](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-web-service).) With the AWS Free Tier, you get 1,000,000 free requests per month, up to 3.2 million seconds of compute time per month. Learn more at https://aws.amazon.com/free/. In addition, Amazon now offers [AWS Promotional Credits for developers who have live Alexa skills that incur costs on AWS related to those skills](https://developer.amazon.com/alexa-skills-kit/alexa-aws-credits).
15 |
16 | 4. Paste your Lambda's ARN (Amazon Resource Name) into the textbox provided for **Default Region**.
17 |
18 | 5. Click the **Save Endpoints** button at the top of the main panel.
19 |
20 | 6. **Click the "Next" button to continue to page #4 of this guide.**
21 |
22 | 23 |
24 |
--------------------------------------------------------------------------------
/instructions/4-testing.md:
--------------------------------------------------------------------------------
1 | # Build An Alexa Pet Match Skill in Python using ASK Python SDK
2 |
3 |
4 | [](./1-voice-user-interface.md)[](./2-lambda-function.md)[](./3-connect-vui-to-code.md)[](./4-testing.md)[](./5-customization.md)[](./6-publication.md)
5 |
6 | ## Testing Your Alexa Skill
7 |
8 | So far, we have [created a Voice User Interface](./1-voice-user-interface.md) and [a Lambda function](./2-lambda-function.md), and [connected the two together](./3-connect-vui-to-code.md). Your skill is now ready to test.
9 |
10 | 1. **Go back to the [Amazon Developer Portal](https://developer.amazon.com/edw/home.html#/skills/list) and select your skill from the list.** You may still have a browser tab open if you started at the beginning of this tutorial.
11 |
12 | 2. Open the **Test** Pane, by selecting the **Test** link from the top navigation menu.
13 |
14 | 3. Enable Testing by activating the **Test is enabled for this skill** slider. It should be underneath the top navigation menu.
15 |
16 | 4. To validate that your skill is working as expected, invoke your skill from the **Alexa Simulator**. You can either type or click and hold the mic from the input box to use your voice.
17 | 1. **Type** "Open" followed by the invocation name you gave your skill in [Step 1](./1-voice-user-interface.md). For example, "Open Pet Match".
18 | 2. **Use your voice** by clicking and holding the mic on the side panel and saying "Open" followed by the invocation name you gave your skill.
19 | 3. **If you've forgotten the invocation name** for your skill, revisit the **Build** panel on the top navigation menu and select Invocation from the sidebar to review it.
20 |
21 | 5. Ensure your skill works the way that you designed it to.
22 | * After you interact with the Alexa Simulator, you should see the Skill I/O **JSON Input** and **JSON Output** boxes get populated with JSON data. You can also view the **Device Log** to trace your steps.
23 | * If it's not working as expected, you can dig into the JSON to see exactly what Alexa is sending and receiving from the endpoint. If something is broken, AWS Lambda offers an additional testing tool to help you troubleshoot your skill.
24 |
25 | 6. **Configure a test event in AWS Lambda.** Now that you are familiar with the **request** and **response** boxes in the Service Simulator, it's important for you to know that you can use your **requests** to directly test your Lambda function every time you update it. To do this:
26 | 1. Enter an utterance in the service simulator, and copy the generated Lambda Request for the next step.
27 |
28 | 2. **Open your Lambda function in AWS, open the Actions menu, and select "Configure test events."**
29 |
30 | 
31 |
32 | 3. **Select "Create New Test Event". Choose "Alexa Start Session" as the Event Template from the dropdown list.** You can choose any test event in the list, as they are just templated event requests, but using "Alexa Start Session" is an easy one to remember.
33 |
34 | 
35 |
36 | 4. **Type in an Event Name into the Event Name Dialog box. Delete the contents of the code editor, and paste the Lambda request you copied above into the code editor.** The Event Name is only visible to you. Name your test event something descriptive and memorable. For our example, we entered an event name as "startSession". Additionally, by copying and pasting your Lambda Request from the service simulator, you can test different utterances and skill events beyond the pre-populated templates in Lambda.
37 |
38 | 
39 |
40 | 5. **Click the "Create" button.** This will save your test event and bring you back to the main configuration for your lambda function.
41 |
42 | 6. **Click the "Test" button to execute the "startSession" test event.**
43 |
44 | 
45 |
46 | This gives you visibility into four things:
47 |
48 | * **Your response, listed in the "Execution Result."**
49 |
50 | 
51 |
52 | * **A Summary of the statistics for your request.** This includes things like duration, resources, and memory used.
53 |
54 | 
55 |
56 | * **Log output.** By effectively using print() or python logger statements in your Lambda code, you can track what is happening inside your function, and help to figure out what is happening when something goes wrong. You will find the log to be incredibly valuable as you move into more advanced skills.
57 |
58 | 
59 |
60 | * **A link to your [CloudWatch](https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:) logs for this function.** This will show you **all** of the responses and log statements from every user interaction. This is very useful, especially when you are testing your skill from a device with your voice. (It is the "[Click here](https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:)" link in the Log Output description.)
61 |
62 | 7. **Other testing methods to consider:**
63 |
64 | * [Echosim.io](https://echosim.io) - a browser-based Alexa skill testing tool that makes it easy to test your skills without carrying a physical device everywhere you go.
65 | * [Unit Testing with Alexa](https://github.com/alexa/alexa-cookbook/tree/master/testing/postman/README.md) - a modern approach to unit testing your Alexa skills with [Postman](http://getpostman.com) and [Amazon API Gateway](http://aws.amazon.com/apigateway).
66 |
67 | 8. **If your sample skill is working properly, you can now customize your skill.**
68 |
69 | 
70 |
--------------------------------------------------------------------------------
/instructions/5-customization.md:
--------------------------------------------------------------------------------
1 | # Build An Alexa Pet Match Skill in Python using ASK Python SDK
2 |
3 |
4 | [](./1-voice-user-interface.md)[](./2-lambda-function.md)[](./3-connect-vui-to-code.md)[](./4-testing.md)[](./5-customization.md)[](./6-publication.md)
5 |
6 | ## Customize the Skill to be Yours
7 |
8 | At this point, you should have a working copy of our Pet Match skill. In order to make it your own, you will need to customize it with data and responses that you create. Here are the things you will need to change:
9 |
10 | 1. **New sentences to respond to your users.** There are several sentences and responses that you will want to customize for your skill.
11 |
12 | 1. **Open a copy of ``lambda_function.py``.** If you haven't already downloaded the code for this project, [you can find a copy of lambda_function.py here](../lambda/py/lambda_function.py). You can use a simple, lightweight code editor like [Atom](http://atom.io), [Sublime Text](http://sublimetext.com), or [VSCode](http://code.visualstudio.com).
13 |
14 | 2. **Look for lines like this: speech = ('Welcome to pet match...'** These are strings that hold phrases for Alexa to respond with. Customize them to make it as varied and conversational as time allows.
15 |
16 | 3. **Continue through ``lambda_function.py`` until you reach the bottom of the file.** This will ensure that you cover each of the Alexa responses that you need to update.
17 |
18 | 4. **When you have replaced the data in `lambda_function.py`, you need to upload the latest data into Lambda.** Copy the updated contents into the ``skill_env`` folder, zip the contents of the ``skill_env`` folder and upload it to AWS Lambda as discussed in the "**Finish configuring your function**" step in [Lambda setup documentation](./2-lambda-function.md). Test your skill through the Alexa Simulator on the developer portal, with the updated changes.
19 |
20 | 2. **New API.** The sample skill uses a custom API to get pet matches. Update it with your API, for better customization and handling.
21 |
22 | 1. **Go back to your copy of [lambda_function.py](../lambda/py/lambda_function.py).**
23 |
24 | 2. **Look for pet_match_api** This is the API used to get pet matches. Change it according to your API call.
25 |
26 | 3. **When you have replaced the api details in `lambda_function.py`, you need to upload the latest data into Lambda.** Copy the updated contents into the ``skill_env`` folder, zip the contents of the ``skill_env`` folder and upload it to AWS Lambda as discussed in the "**Finish configuring your function**" step in [Lambda setup documentation](./2-lambda-function.md). Test your skill through the Alexa Simulator on the developer portal, with the updated changes.
27 |
28 | 3. **New language.** If you are creating this skill for another language other than English, you will need to make sure Alexa's responses are also in that language.
29 |
30 | * For example, if you are creating your skill in German, every single response that Alexa makes has to be in German. You can't use English responses or your skill will fail certification.
31 |
32 | 4. **Once you have made the updates listed on this page, you can click "Launch" in the top navigation of Alexa developer console, to move on to Publishing and Certification of your skill.**
33 |
34 |
35 | [](6-publication.md)
36 |
--------------------------------------------------------------------------------
/instructions/6-publication.md:
--------------------------------------------------------------------------------
1 | # Build An Alexa Pet Match Skill in Python using ASK Python SDK
2 |
3 |
4 | [](./1-voice-user-interface.md)[](./2-lambda-function.md)[](./3-connect-vui-to-code.md)[](./4-testing.md)[](./5-customization.md)[](./6-publication.md)
5 | ## Get Your Skill Certified and Published
6 |
7 | We are almost done! The last step is to add the metadata that your skill will use in the [Skill Store](http://amazon.com/skills). This page will walk you through the remaining steps to launch your skill!
8 |
9 | 1. Select the **Launch** link from the top navigation menu.
10 |
11 | 2. Fill out the form fields per the guidance on the screen. Hover over the question mark icons for details regarding each respective field. **Fields marked with an Asterisk, are required!**
12 | * Take the time to get these right so that your skill will pass certification!
13 |
14 | 3. **Write your skill descriptions.**
15 |
16 | * **Spend some time coming up with an enticing, succinct description.** This is one of the few places you have an opportunity to attract new users, so make the most of it! These descriptions show up in the list of skills available in the [Alexa app](http://alexa.amazon.com/spa/index.html#skills) and the [skills store](http://www.amazon.com/skills).
17 |
18 | 4. For your example phrases, **come up with the three most exciting ways** a user can talk to your skill.
19 |
20 | * Make sure that each of your example phrases are a **perfect match with one of your Sample Utterances.** Incorrect example phrases are one of the most common reasons that skills fail certification, so we have provided a short list of things to consider as you write your example phrases:
21 |
22 | | Common Failure Points for Example Phrases |
23 | | ----------------------------------------- |
24 | | Example phrases **must** adhere to the [supported phrases](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/supported-phrases-to-begin-a-conversation?&sc_category=Owned&sc_channel=RD&sc_campaign=Evangelism2018&sc_publisher=github&sc_content=Survey&sc_detail=petmatch-nodejs-V2_GUI-6&sc_funnel=Convert&sc_country=WW&sc_medium=Owned_RD_Evangelism2018_github_Survey_petmatch-nodejs-V2_GUI-6_Convert_WW_beginnersdevs&sc_segment=beginnersdevs). |
25 | | Example phrases **must** be based on sample utterances specified in your Intent Schema. |
26 | | Your first example phrase **must** include a wake word and your invocation name. |
27 | | Example phrases **must** provide a contextual response. |
28 |
29 | * **Choose three example phrases that are likely to be the most common ways that users will attempt to interact with your skill.** Make sure that each of them works well, and provides an excellent user experience.
30 |
31 | 5. **Create your skill's icons.** You need two sizes of your icon: 108x108px and 512x512px.
32 |
33 | * **Make sure you have the rights to the icons you create.** Please don't violate any trademarks or copyrights.
34 | * **You can use the Alexa skill icon builder [tool](https://developer.amazon.com/docs/tools/icon-builder.html).**
35 | * **If you don't have software to make icons, try one of these free options:**
36 |
37 | * [GIMP](https://www.gimp.org/) (Windows/Mac/Linux)
38 | * [Canva](https://www.canva.com/) (Web)
39 | * [Paint.NET](http://www.getpaint.net/index.html) (Windows)
40 | * [Inkscape](http://inkscape.org) (Windows/Mac/Linux)
41 | * [Iconion](http://iconion.com/) (Windows/Mac)
42 |
43 | * To make it easier to get started, we've created blank versions of these icons in both sizes for many formats:
44 |
45 | * [PSD](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/psd._TTH_.zip)
46 | * [PNG](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/png._TTH_.zip)
47 | * [GIF](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/gif._TTH_.zip)
48 | * [PDF](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/pdf._TTH_.zip)
49 | * [JPG](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/jpg._TTH_.zip)
50 | * [SVG](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/svg._TTH_.zip)
51 | * [PDN](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/pdn._TTH_.zip) - for [Paint.NET](http://www.getpaint.net/index.html)
52 | * [XCF](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/tutorials/general/icon-templates/xcf._TTH_.zip) - for [GIMP](https://www.gimp.org/)
53 |
54 | 6. Choose the most appropriate category for your skill.
55 |
56 | 7. **Provide a comprehensive list of keywords for users that are searching for new skills.** This is an optional field, and searching the [Alexa app](http://alexa.amazon.com) or the [skill store](http://www.amazon.com/skills) will also find the words in your Skill Name and descriptions, so you don't need to overdo it. That being said, if there are words that you want users to find your skill with, you should include them here. Separate the keywords with commas.
57 |
58 | 8. **Privacy Policy URL.** This is an optional field, and should not be required for this Pet Match skill sample. You can leave it blank.
59 |
60 | 9. **Terms of Use URL.** This is also optional, and you can leave it blank.
61 |
62 | 10. When you're ready, click **Save and Continue** at the bottom of the screen to move onto **Privacy & Compliance**
63 |
64 | 11. * **Does this skill allow users to make purchases or spend real money?** For this pet match skill, the answer is no. For future skills, make sure you answer this appropriately.
65 |
66 | * **Does this Alexa skill collect users' personal information?** Again, for this pet match skill, the answer is no. If you do collect information about a user, such as names, email addresses, phone numbers, and so forth, ensure that you answer Yes to this question.
67 | * Answering "yes" to this question will also require you to provide a link to your Privacy Policy at the bottom of the page.
68 |
69 | * **Is your skill directed to children under the age of 13?** Because you customized this skill with data you provided, it is possible that you created a skill that targets children under the age of 13. For this pet match skill, the answer is **no** because it doesn't target a specific age group.
70 | * Factors to consider in determining if this skill is directed to children under 13 include:
71 | * Subject matter of the skill
72 | * Presence of child-oriented activities and incentives
73 | * Type of language used in the skill
74 | * Music and other audio content in the skill
75 | * How the skill is described and marketed
76 | * Intended audience for the skill
77 |
78 | If you're not sure, please see the [FTC's COPPA Guidance and FAQ](https://www.ftc.gov/tips-advice/business-center/guidance/complying-coppa-frequently-asked-questions) for more information.
79 |
80 | 12. **Export Compliance.** Be certain that you agree with all of the conditions. If you do, make sure to check this box, as Amazon requires this permission to distribute your skill around the globe.
81 |
82 | 13. **Provide testing instructions.** Testing instructions give you an opportunity to explain your skill, and any special or possibly confusing features, to the certification team. A value is required in this box.
83 |
84 | * Since you are using our Sample, make sure to add a sentence to your Testing Instructions referencing the Sample you used. For example:
85 |
86 | ```
87 | This was built using the Pet Match Sample.
88 | ```
89 |
90 | This will let the testing team understand what you're providing them, and should decrease the testing time required.
91 |
92 | **Note:** More details on certification are [available here.](https://alexa.design/certification)
93 |
94 | 14. If you feel that your skill is ready for certification, click the **Save and Continue** button at the bottom of the page.
95 |
96 |
97 | 15. **You're done with your submission!** Here are a few things you might need to know:
98 |
99 | * **Certification can take several days to complete.** Please be patient. It takes time because we want to get it right.
100 |
101 | * **Did something go wrong?** Our team of evangelists run [online office hours every Tuesday from 1-2pm Pacific Time](https://register.gotowebinar.com/rt/8924773651242797059). They can help answer any questions you might have.
102 |
103 | * **Want the coolest t-shirt you've ever seen?** Every month, we create a brand-new Alexa Developer t-shirt or hoodie, and send them out to developers that published a skill that month. [You can get yours here if you live in the US](https://developer.amazon.com/alexa-skills-kit/alexa-developer-skill-promotion?&sc_category=Owned&sc_channel=RD&sc_campaign=Evangelism2018&sc_publisher=github&sc_content=Survey&sc_detail=petmatch-nodejs-V2_GUI-6&sc_funnel=Convert&sc_country=WW&sc_medium=Owned_RD_Evangelism2018_github_Survey_petmatch-nodejs-V2_GUI-6_Convert_WW_beginnersdevs&sc_segment=beginnersdevs), [here for the UK](https://developer.amazon.com/en-gb/alexa-skills-kit/alexa-developer-skill-promotion?&sc_category=Owned&sc_channel=RD&sc_campaign=Evangelism2018&sc_publisher=github&sc_content=Survey&sc_detail=petmatch-nodejs-V2_GUI-6&sc_funnel=Convert&sc_country=WW&sc_medium=Owned_RD_Evangelism2018_github_Survey_petmatch-nodejs-V2_GUI-6_Convert_WW_beginnersdevs&sc_segment=beginnersdevs), and [here for Germany](https://developer.amazon.com/de-de/alexa-skills-kit/alexa-developer-skill-promotion?&sc_category=Owned&sc_channel=RD&sc_campaign=Evangelism2018&sc_publisher=github&sc_content=Survey&sc_detail=petmatch-nodejs-V2_GUI-6&sc_funnel=Convert&sc_country=WW&sc_medium=Owned_RD_Evangelism2018_github_Survey_petmatch-nodejs-V2_GUI-6_Convert_WW_beginnersdevs&sc_segment=beginnersdevs).
104 |
--------------------------------------------------------------------------------
/lambda/py/lambda_function.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 |
3 | import logging
4 | import requests
5 | import six
6 | import random
7 |
8 | from ask_sdk_core.skill_builder import SkillBuilder
9 | from ask_sdk_core.handler_input import HandlerInput
10 | from ask_sdk_core.dispatch_components import (
11 | AbstractRequestHandler, AbstractExceptionHandler,
12 | AbstractResponseInterceptor, AbstractRequestInterceptor)
13 | from ask_sdk_core.utils import is_intent_name, is_request_type
14 |
15 | from typing import Union, Dict, Any, List
16 | from ask_sdk_model.dialog import (
17 | ElicitSlotDirective, DelegateDirective)
18 | from ask_sdk_model import (
19 | Response, IntentRequest, DialogState, SlotConfirmationStatus, Slot)
20 | from ask_sdk_model.slu.entityresolution import StatusCode
21 |
22 | logger = logging.getLogger(__name__)
23 | logger.setLevel(logging.INFO)
24 |
25 |
26 | # Request Handler classes
27 | class LaunchRequestHandler(AbstractRequestHandler):
28 | """Handler for skill launch."""
29 | def can_handle(self, handler_input):
30 | # type: (HandlerInput) -> bool
31 | return is_request_type("LaunchRequest")(handler_input)
32 |
33 | def handle(self, handler_input):
34 | # type: (HandlerInput) -> Response
35 | logger.info("In LaunchRequestHandler")
36 | speech = ('Welcome to pet match. I can help you find the best dog '
37 | 'for you. What are two things you are looking for in a '
38 | 'dog?')
39 | reprompt = "What size and temperament are you looking for in a dog?"
40 | handler_input.response_builder.speak(speech).ask(reprompt)
41 | return handler_input.response_builder.response
42 |
43 |
44 | class MythicalCreaturesHandler(AbstractRequestHandler):
45 | """Handler for MythicalCreatures."""
46 | def can_handle(self, handler_input):
47 | # type: (HandlerInput) -> bool
48 | if not is_intent_name("PetMatchIntent")(handler_input):
49 | return False
50 |
51 | is_mythical_creature = False
52 | resolved_value = get_resolved_value(
53 | handler_input.request_envelope.request, "pet")
54 | if (resolved_value is not None and
55 | resolved_value == "mythical_creatures"):
56 | is_mythical_creature = True
57 | handler_input.attributes_manager.session_attributes["mythical_creature"] = handler_input.request_envelope.request.intent.slots["pet"].value
58 | return is_mythical_creature
59 |
60 | def handle(self, handler_input):
61 | # type: (HandlerInput) -> Response
62 | logger.info("In MythicalCreaturesHandler")
63 | session_attr = handler_input.attributes_manager.session_attributes
64 | speech = random_phrase(slots_meta["pet"]["invalid_responses"]).format(
65 | session_attr["mythical_creature"])
66 |
67 | return handler_input.response_builder.speak(speech).response
68 |
69 |
70 | class InProgressPetMatchIntent(AbstractRequestHandler):
71 | def can_handle(self, handler_input):
72 | # type: (HandlerInput) -> bool
73 | return (is_intent_name("PetMatchIntent")(handler_input)
74 | and handler_input.request_envelope.request.dialog_state != DialogState.COMPLETED)
75 |
76 | def handle(self, handler_input):
77 | # type: (HandlerInput) -> Response
78 | logger.info("In InProgressPetMatchIntent")
79 | current_intent = handler_input.request_envelope.request.intent
80 | prompt = ""
81 |
82 | for slot_name, current_slot in six.iteritems(
83 | current_intent.slots):
84 | if slot_name not in ["article", "at_the", "I_Want"]:
85 | if (current_slot.confirmation_status != SlotConfirmationStatus.CONFIRMED
86 | and current_slot.resolutions
87 | and current_slot.resolutions.resolutions_per_authority[0]):
88 | if current_slot.resolutions.resolutions_per_authority[0].status.code == StatusCode.ER_SUCCESS_MATCH:
89 | if len(current_slot.resolutions.resolutions_per_authority[0].values) > 1:
90 | prompt = "Which would you like "
91 |
92 | values = " or ".join([e.value.name for e in current_slot.resolutions.resolutions_per_authority[0].values])
93 | prompt += values + " ?"
94 | return handler_input.response_builder.speak(
95 | prompt).ask(prompt).add_directive(
96 | ElicitSlotDirective(slot_to_elicit=current_slot.name)
97 | ).response
98 | elif current_slot.resolutions.resolutions_per_authority[0].status.code == StatusCode.ER_SUCCESS_NO_MATCH:
99 | if current_slot.name in required_slots:
100 | prompt = "What {} are you looking for?".format(current_slot.name)
101 |
102 | return handler_input.response_builder.speak(
103 | prompt).ask(prompt).add_directive(
104 | ElicitSlotDirective(
105 | slot_to_elicit=current_slot.name
106 | )).response
107 |
108 | return handler_input.response_builder.add_directive(
109 | DelegateDirective(
110 | updated_intent=current_intent
111 | )).response
112 |
113 |
114 | class CompletedPetMatchIntent(AbstractRequestHandler):
115 | def can_handle(self, handler_input):
116 | # type: (HandlerInput) -> bool
117 | return (is_intent_name("PetMatchIntent")(handler_input)
118 | and handler_input.request_envelope.request.dialog_state == DialogState.COMPLETED)
119 |
120 | def handle(self, handler_input):
121 | # type: (HandlerInput) -> Response
122 | logger.info("In CompletedPetMatchIntent")
123 | filled_slots = handler_input.request_envelope.request.intent.slots
124 | slot_values = get_slot_values(filled_slots)
125 | pet_match_options = build_pet_match_options(
126 | host_name=pet_match_api["host_name"], path=pet_match_api["pets"],
127 | port=pet_match_api["port"], slot_values=slot_values)
128 |
129 | try:
130 | response = http_get(pet_match_options)
131 |
132 | if response["result"]:
133 | speech = ("So a {} "
134 | "{} "
135 | "{} "
136 | "energy dog sounds good for you. Consider a "
137 | "{}".format(
138 | slot_values["size"]["resolved"],
139 | slot_values["temperament"]["resolved"],
140 | slot_values["energy"]["resolved"],
141 | response["result"][0]["breed"])
142 | )
143 | else:
144 | speech = ("I am sorry I could not find a match for a "
145 | "{} "
146 | "{} "
147 | "{} energy dog".format(
148 | slot_values["size"]["resolved"],
149 | slot_values["temperament"]["resolved"],
150 | slot_values["energy"]["resolved"])
151 | )
152 | except Exception as e:
153 | speech = ("I am really sorry. I am unable to access part of my "
154 | "memory. Please try again later")
155 | logger.info("Intent: {}: message: {}".format(
156 | handler_input.request_envelope.request.intent.name, str(e)))
157 |
158 | return handler_input.response_builder.speak(speech).response
159 |
160 |
161 | class FallbackIntentHandler(AbstractRequestHandler):
162 | """Handler for handling fallback intent.
163 |
164 | 2018-May-01: AMAZON.FallackIntent is only currently available in
165 | en-US locale. This handler will not be triggered except in that
166 | locale, so it can be safely deployed for any locale."""
167 | def can_handle(self, handler_input):
168 | # type: (HandlerInput) -> bool
169 | return is_intent_name("AMAZON.FallbackIntent")(handler_input)
170 |
171 | def handle(self, handler_input):
172 | # type: (HandlerInput) -> Response
173 | logger.info("In FallbackIntentHandler")
174 | speech = ("I'm sorry Pet Match can't help you with that. I can help "
175 | "find the perfect dog for you. What are two things you're "
176 | "looking for in a dog?")
177 | reprompt = "What size and temperament are you looking for in a dog?"
178 | handler_input.response_builder.speak(speech).ask(reprompt)
179 | return handler_input.response_builder.response
180 |
181 |
182 | class HelpIntentHandler(AbstractRequestHandler):
183 | """Handler for help intent."""
184 | def can_handle(self, handler_input):
185 | # type: (HandlerInput) -> bool
186 | return is_intent_name("AMAZON.HelpIntent")(handler_input)
187 |
188 | def handle(self, handler_input):
189 | # type: (HandlerInput) -> Response
190 | logger.info("In HelpIntentHandler")
191 | speech = ("This is pet match. I can help you find the perfect pet "
192 | "for you. You can say, I want a dog.")
193 | reprompt = "What size and temperament are you looking for in a dog?"
194 |
195 | handler_input.response_builder.speak(speech).ask(reprompt)
196 | return handler_input.response_builder.response
197 |
198 |
199 | class ExitIntentHandler(AbstractRequestHandler):
200 | """Single Handler for Cancel, Stop and Pause intents."""
201 | def can_handle(self, handler_input):
202 | # type: (HandlerInput) -> bool
203 | return (is_intent_name("AMAZON.CancelIntent")(handler_input) or
204 | is_intent_name("AMAZON.StopIntent")(handler_input))
205 |
206 | def handle(self, handler_input):
207 | # type: (HandlerInput) -> Response
208 | logger.info("In ExitIntentHandler")
209 | handler_input.response_builder.speak("Bye").set_should_end_session(
210 | True)
211 | return handler_input.response_builder.response
212 |
213 |
214 | class SessionEndedRequestHandler(AbstractRequestHandler):
215 | """Handler for skill session end."""
216 | def can_handle(self, handler_input):
217 | # type: (HandlerInput) -> bool
218 | return is_request_type("SessionEndedRequest")(handler_input)
219 |
220 | def handle(self, handler_input):
221 | # type: (HandlerInput) -> Response
222 | logger.info("In SessionEndedRequestHandler")
223 | logger.info("Session ended with reason: {}".format(
224 | handler_input.request_envelope.request.reason))
225 | return handler_input.response_builder.response
226 |
227 | # Exception Handler classes
228 | class CatchAllExceptionHandler(AbstractExceptionHandler):
229 | """Catch All Exception handler.
230 |
231 | This handler catches all kinds of exceptions and prints
232 | the stack trace on AWS Cloudwatch with the request envelope."""
233 | def can_handle(self, handler_input, exception):
234 | # type: (HandlerInput, Exception) -> bool
235 | return True
236 |
237 | def handle(self, handler_input, exception):
238 | # type: (HandlerInput, Exception) -> Response
239 | logger.error(exception, exc_info=True)
240 |
241 | speech = "Sorry, I can't understand the command. Please say again."
242 | handler_input.response_builder.speak(speech).ask(speech)
243 | return handler_input.response_builder.response
244 |
245 |
246 | # Request and Response Loggers
247 | class RequestLogger(AbstractRequestInterceptor):
248 | """Log the request envelope."""
249 | def process(self, handler_input):
250 | # type: (HandlerInput) -> None
251 | logger.info("Request Envelope: {}".format(
252 | handler_input.request_envelope))
253 |
254 |
255 | class ResponseLogger(AbstractResponseInterceptor):
256 | """Log the response envelope."""
257 | def process(self, handler_input, response):
258 | # type: (HandlerInput, Response) -> None
259 | logger.info("Response: {}".format(response))
260 |
261 |
262 | # Data
263 | required_slots = ["energy", "size", "temperament"]
264 |
265 | slots_meta = {
266 | "pet": {
267 | "invalid_responses": [
268 | "I'm sorry, but I'm not qualified to match you with {}s.",
269 | "Ah yes, {}s are splendid creatures, but unfortunately owning one as a pet is outlawed.",
270 | "I'm sorry I can't match you with {}s."
271 | ]
272 | },
273 | "error_default": "I'm sorry I can't match you with {}s."
274 | }
275 |
276 | pet_match_api = {
277 | "host_name": "e4v7rdwl7l.execute-api.us-east-1.amazonaws.com",
278 | "pets": "/Test",
279 | "port": 443
280 | }
281 |
282 |
283 | # Utility functions
284 | def get_resolved_value(request, slot_name):
285 | """Resolve the slot name from the request using resolutions."""
286 | # type: (IntentRequest, str) -> Union[str, None]
287 | try:
288 | return (request.intent.slots[slot_name].resolutions.
289 | resolutions_per_authority[0].values[0].value.name)
290 | except (AttributeError, ValueError, KeyError, IndexError, TypeError) as e:
291 | logger.info("Couldn't resolve {} for request: {}".format(slot_name, request))
292 | logger.info(str(e))
293 | return None
294 |
295 | def get_slot_values(filled_slots):
296 | """Return slot values with additional info."""
297 | # type: (Dict[str, Slot]) -> Dict[str, Any]
298 | slot_values = {}
299 | logger.info("Filled slots: {}".format(filled_slots))
300 |
301 | for key, slot_item in six.iteritems(filled_slots):
302 | name = slot_item.name
303 | try:
304 | status_code = slot_item.resolutions.resolutions_per_authority[0].status.code
305 |
306 | if status_code == StatusCode.ER_SUCCESS_MATCH:
307 | slot_values[name] = {
308 | "synonym": slot_item.value,
309 | "resolved": slot_item.resolutions.resolutions_per_authority[0].values[0].value.name,
310 | "is_validated": True,
311 | }
312 | elif status_code == StatusCode.ER_SUCCESS_NO_MATCH:
313 | slot_values[name] = {
314 | "synonym": slot_item.value,
315 | "resolved": slot_item.value,
316 | "is_validated": False,
317 | }
318 | else:
319 | pass
320 | except (AttributeError, ValueError, KeyError, IndexError, TypeError) as e:
321 | logger.info("Couldn't resolve status_code for slot item: {}".format(slot_item))
322 | logger.info(e)
323 | slot_values[name] = {
324 | "synonym": slot_item.value,
325 | "resolved": slot_item.value,
326 | "is_validated": False,
327 | }
328 | return slot_values
329 |
330 | def random_phrase(str_list):
331 | """Return random element from list."""
332 | # type: List[str] -> str
333 | return random.choice(str_list)
334 |
335 | def build_pet_match_options(host_name, path, port, slot_values):
336 | """Return options for HTTP Get call."""
337 | # type: (str, str, int, Dict[str, Any]) -> Dict
338 | path_params = {
339 | "SSET": "canine-{}-{}-{}".format(
340 | slot_values["energy"]["resolved"],
341 | slot_values["size"]["resolved"],
342 | slot_values["temperament"]["resolved"])
343 | }
344 | if host_name[:4] != "http":
345 | host_name = "https://{}".format(host_name)
346 | url = "{}:{}{}".format(host_name, str(port), path)
347 | return {
348 | "url": url,
349 | "path_params": path_params
350 | }
351 |
352 | def http_get(http_options):
353 | url = http_options["url"]
354 | params = http_options["path_params"]
355 | response = requests.get(url=url, params=params)
356 |
357 | if response.status_code < 200 or response.status_code >= 300:
358 | response.raise_for_status()
359 |
360 | return response.json()
361 |
362 |
363 | # Skill Builder object
364 | sb = SkillBuilder()
365 |
366 | # Add all request handlers to the skill.
367 | sb.add_request_handler(LaunchRequestHandler())
368 | sb.add_request_handler(MythicalCreaturesHandler())
369 | sb.add_request_handler(InProgressPetMatchIntent())
370 | sb.add_request_handler(CompletedPetMatchIntent())
371 | sb.add_request_handler(HelpIntentHandler())
372 | sb.add_request_handler(FallbackIntentHandler())
373 | sb.add_request_handler(ExitIntentHandler())
374 | sb.add_request_handler(SessionEndedRequestHandler())
375 |
376 | # Add exception handler to the skill.
377 | sb.add_exception_handler(CatchAllExceptionHandler())
378 |
379 | # Add response interceptor to the skill.
380 | sb.add_global_request_interceptor(RequestLogger())
381 | sb.add_global_response_interceptor(ResponseLogger())
382 |
383 | # Expose the lambda handler to register in AWS Lambda.
384 | lambda_handler = sb.lambda_handler()
385 |
--------------------------------------------------------------------------------
/lambda/py/requirements.txt:
--------------------------------------------------------------------------------
1 | ask-sdk-core
2 |
--------------------------------------------------------------------------------
/models/en-US.json:
--------------------------------------------------------------------------------
1 | {
2 | "interactionModel": {
3 | "languageModel": {
4 | "invocationName": "pet match",
5 | "intents": [
6 | {
7 | "name": "AMAZON.CancelIntent",
8 | "samples": []
9 | },
10 | {
11 | "name": "AMAZON.HelpIntent",
12 | "samples": []
13 | },
14 | {
15 | "name": "AMAZON.StopIntent",
16 | "samples": []
17 | },
18 | {
19 | "name": "PetMatchIntent",
20 | "slots": [
21 | {
22 | "name": "pet",
23 | "type": "AMAZON.Animal"
24 | },
25 | {
26 | "name": "size",
27 | "type": "sizeType",
28 | "samples": [
29 | "{I_Want} {article} {size} {pet}",
30 | "{I_Want} {size}",
31 | "the {size}",
32 | "Something i can {size}",
33 | "{size} size",
34 | "{I_Want} {article} {size} {pet} that {energy}",
35 | "{I_Want} {article} {size} {temperament} {pet}",
36 | "{I_Want} {article} {size} {temperament} to {energy}",
37 | " {temperament} {pet}",
38 | "{energy} energy",
39 | "{size}"
40 | ]
41 | },
42 | {
43 | "name": "temperament",
44 | "type": "temperamentType",
45 | "samples": [
46 | "{temperament} {pet}"
47 | ]
48 | },
49 | {
50 | "name": "I_Want",
51 | "type": "IWantType"
52 | },
53 | {
54 | "name": "energy",
55 | "type": "energyType",
56 | "samples": [
57 | "{energy} energy",
58 | "{I_Want} to {energy}"
59 | ]
60 | },
61 | {
62 | "name": "article",
63 | "type": "articleType"
64 | },
65 | {
66 | "name": "at_the",
67 | "type": "atTheType"
68 | }
69 | ],
70 | "samples": [
71 | "{I_Want} {article} {pet}",
72 | "{I_Want} {article} {size} {temperament} dog",
73 | "find a pet",
74 | "match me",
75 | "{size} {pet}",
76 | "for a {pet}",
77 | "{I_Want} {article} {pet} that is {temperament} and {energy}",
78 | "{energy} {pet}",
79 | "{I_Want} {article} {energy} {pet}",
80 | "{I_Want} {article} {temperament} dog that is {energy} energy"
81 | ]
82 | },
83 | {
84 | "name": "AMAZON.FallbackIntent",
85 | "samples": []
86 | }
87 | ],
88 | "types": [
89 | {
90 | "name": "articleType",
91 | "values": [
92 | {
93 | "name": {
94 | "value": "a"
95 | }
96 | },
97 | {
98 | "name": {
99 | "value": "an"
100 | }
101 | },
102 | {
103 | "name": {
104 | "value": "the"
105 | }
106 | }
107 | ]
108 | },
109 | {
110 | "name": "atTheType",
111 | "values": [
112 | {
113 | "name": {
114 | "value": "at the"
115 | }
116 | },
117 | {
118 | "name": {
119 | "value": "on the"
120 | }
121 | },
122 | {
123 | "name": {
124 | "value": "around the"
125 | }
126 | },
127 | {
128 | "name": {
129 | "value": "in the"
130 | }
131 | }
132 | ]
133 | },
134 | {
135 | "name": "energyType",
136 | "values": [
137 | {
138 | "name": {
139 | "value": "low",
140 | "synonyms": [
141 | "low energy",
142 | "to cuddle with",
143 | "to watch netflix with",
144 | "lazy"
145 | ]
146 | }
147 | },
148 | {
149 | "name": {
150 | "value": "medium",
151 | "synonyms": [
152 | "medium energy",
153 | "for my apartment",
154 | "fun to play with",
155 | "tug of war",
156 | "plays tug of war"
157 | ]
158 | }
159 | },
160 | {
161 | "name": {
162 | "value": "high",
163 | "synonyms": [
164 | "that I can run with",
165 | "play frisbee",
166 | "run",
167 | "hike",
168 | "go hiking",
169 | "play fetch",
170 | "energetic",
171 | "high energy"
172 | ]
173 | }
174 | }
175 | ]
176 | },
177 | {
178 | "name": "IWantType",
179 | "values": [
180 | {
181 | "name": {
182 | "value": "my favorite is"
183 | }
184 | },
185 | {
186 | "name": {
187 | "value": "I prefer"
188 | }
189 | },
190 | {
191 | "name": {
192 | "value": "let's find"
193 | }
194 | },
195 | {
196 | "name": {
197 | "value": "we like"
198 | }
199 | },
200 | {
201 | "name": {
202 | "value": "we would like"
203 | }
204 | },
205 | {
206 | "name": {
207 | "value": "how about"
208 | }
209 | },
210 | {
211 | "name": {
212 | "value": "I want"
213 | }
214 | },
215 | {
216 | "name": {
217 | "value": "I like"
218 | }
219 | }
220 | ]
221 | },
222 | {
223 | "name": "sizeType",
224 | "values": [
225 | {
226 | "name": {
227 | "value": "large",
228 | "synonyms": [
229 | "large size",
230 | "huge",
231 | "truck",
232 | "gigantic",
233 | "eat me out of house",
234 | "scary big",
235 | "ginormous",
236 | "ride",
237 | "waist height"
238 | ]
239 | }
240 | },
241 | {
242 | "name": {
243 | "value": "medium",
244 | "synonyms": [
245 | "medium size",
246 | "bigger than a cat",
247 | "on the bed",
248 | "up to my knees",
249 | "average"
250 | ]
251 | }
252 | },
253 | {
254 | "name": {
255 | "value": "small",
256 | "synonyms": [
257 | "small size",
258 | "little",
259 | "take on an airplane"
260 | ]
261 | }
262 | },
263 | {
264 | "name": {
265 | "value": "tiny",
266 | "synonyms": [
267 | "tiny size",
268 | "cheap to feed",
269 | "teacup",
270 | "pocket",
271 | "yippy",
272 | "carry in my purse",
273 | "put in my pocket",
274 | "itty bitty"
275 | ]
276 | }
277 | }
278 | ]
279 | },
280 | {
281 | "name": "temperamentType",
282 | "values": [
283 | {
284 | "name": {
285 | "value": "watch",
286 | "synonyms": [
287 | "adult",
288 | "barks at people"
289 | ]
290 | }
291 | },
292 | {
293 | "name": {
294 | "value": "guard",
295 | "synonyms": [
296 | "to protect me",
297 | "protective"
298 | ]
299 | }
300 | },
301 | {
302 | "name": {
303 | "value": "family",
304 | "synonyms": [
305 | "hang out",
306 | "hang out with kids",
307 | "is kid friendly",
308 | "good with kids",
309 | "family friends",
310 | "gentle with kids"
311 | ]
312 | }
313 | }
314 | ]
315 | },
316 | {
317 | "name": "AMAZON.Animal",
318 | "values": [
319 | {
320 | "name": {
321 | "value": "mythical_creatures",
322 | "synonyms": [
323 | "unicorn",
324 | "chimera",
325 | "dragon"
326 | ]
327 | }
328 | }
329 | ]
330 | }
331 | ]
332 | },
333 | "dialog": {
334 | "intents": [
335 | {
336 | "name": "PetMatchIntent",
337 | "confirmationRequired": false,
338 | "prompts": {},
339 | "slots": [
340 | {
341 | "name": "pet",
342 | "type": "AMAZON.Animal",
343 | "confirmationRequired": false,
344 | "elicitationRequired": false,
345 | "prompts": {}
346 | },
347 | {
348 | "name": "size",
349 | "type": "sizeType",
350 | "confirmationRequired": false,
351 | "elicitationRequired": true,
352 | "prompts": {
353 | "elicitation": "Elicit.Intent-PetMatchIntent.IntentSlot-size"
354 | }
355 | },
356 | {
357 | "name": "temperament",
358 | "type": "temperamentType",
359 | "confirmationRequired": false,
360 | "elicitationRequired": true,
361 | "prompts": {
362 | "elicitation": "Elicit.Intent-PetMatchIntent.IntentSlot-temperament"
363 | }
364 | },
365 | {
366 | "name": "I_Want",
367 | "type": "IWantType",
368 | "confirmationRequired": false,
369 | "elicitationRequired": false,
370 | "prompts": {}
371 | },
372 | {
373 | "name": "energy",
374 | "type": "energyType",
375 | "confirmationRequired": false,
376 | "elicitationRequired": true,
377 | "prompts": {
378 | "elicitation": "Elicit.Intent-PetMatchIntent.IntentSlot-energy"
379 | }
380 | },
381 | {
382 | "name": "article",
383 | "type": "articleType",
384 | "confirmationRequired": false,
385 | "elicitationRequired": false,
386 | "prompts": {}
387 | },
388 | {
389 | "name": "at_the",
390 | "type": "atTheType",
391 | "confirmationRequired": false,
392 | "elicitationRequired": false,
393 | "prompts": {}
394 | }
395 | ]
396 | }
397 | ]
398 | },
399 | "prompts": [
400 | {
401 | "id": "Elicit.Intent-PetMatchIntent.IntentSlot-size",
402 | "variations": [
403 | {
404 | "type": "PlainText",
405 | "value": "There are dogs that are tiny, small, medium, and large. Which would you like?"
406 | },
407 | {
408 | "type": "PlainText",
409 | "value": "What size of a dog would you like?"
410 | }
411 | ]
412 | },
413 | {
414 | "id": "Elicit.Intent-PetMatchIntent.IntentSlot-temperament",
415 | "variations": [
416 | {
417 | "type": "PlainText",
418 | "value": "Are you looking for more of a family dog or a guard dog?"
419 | },
420 | {
421 | "type": "PlainText",
422 | "value": "Would you prefer a dog to hang out with kids or to protect you?"
423 | }
424 | ]
425 | },
426 | {
427 | "id": "Elicit.Intent-PetMatchIntent.IntentSlot-energy",
428 | "variations": [
429 | {
430 | "type": "PlainText",
431 | "value": "Do you prefer high energy or low energy dogs?"
432 | }
433 | ]
434 | }
435 | ]
436 | }
437 | }
--------------------------------------------------------------------------------
/skill.json:
--------------------------------------------------------------------------------
1 | {
2 | "manifest": {
3 | "publishingInformation": {
4 | "locales": {
5 | "en-US": {
6 | "summary": "Find the pet that is just right for you.",
7 | "examplePhrases": [
8 | "Alexa open pet match",
9 | "Alexa ask pet match for a recommendation",
10 | "Alexa tell pet match that I want a big fluffy dog"
11 | ],
12 | "name": "Pet Match",
13 | "description": "Do you want a pet, but aren't sure what pet would be right for you? Pet Match will find the right pet for you by asking you a series of questions."
14 | }
15 | },
16 | "isAvailableWorldwide": true,
17 | "testingInstructions": "Sample Testing Instructions.",
18 | "distributionCountries": []
19 | },
20 | "apis": {
21 | "custom": {
22 | "endpoint": {
23 | "sourceDir": "lambda/py",
24 | "uri": "ask-custom-petmatch-default"
25 | }
26 | }
27 | },
28 | "manifestVersion": "1.0"
29 | }
30 | }
31 |
--------------------------------------------------------------------------------