Revision History

Introduction

This guideline document is intended to help developers want to integrate AVS with the device. Steps described in this page mainly covers the developer account creation and defining different rules to launch/control RDK APPs. These rules created in developers Alexa account will interact with the AVS SDK application ported to the devices to achieve desire tasks.

Glossary of Terms

Full list of terms can be referred from https://developer.amazon.com/en-US/docs/alexa/ask-overviews/alexa-skills-kit-glossary.html

Amazon Developer Account Creation

• Launch the https://developer.amazon.com/ in browser
• Click on the sign in button then create your Amazon Developer account by providing the below details

Register an AVS device with the Amazon developer portal.

• Follow the steps mentioned steps in the below link to register the device with developer account
• https://developer.amazon.com/en-US/docs/alexa/alexa-voice-service/register-a-product.html
• Download the config.json file from your developer account.
• Copy the file in to the RPI device to root directory.(/home/root) 

Custom skill creation

• Go to developer.amazon.com/alexa. 

• Click on the three dots on the right corner and select Alexa developer console.
• Click Your Alexa Consoles and then click Skills. This opens the developer console and displays any skills you have already created.

• Click Create Skill.

• Enter the skill name and default language
• Skill name: This is the name customers will see when you publish the skill. You can edit this name later on the Distribution page.
• Default language: You can add additional languages to the skill later.
• Choose a model to add to your skill (custom )

Choose a method to host your skill's backend resources (Alexa-Hosted (Node.js))

Click Create skill.

• Click the template you want to use and then click Choose. (Hello world skill template).

 Invocation Name

It is the name given to custom skill. Invocation of the skill is started by the invocation name followed by the intent.

Configure Your Invocation Name

Edit your skill in the developer console, then navigate to Build > Custom > Interaction Model > Invocation and enter or edit the Skill Invocation Name

Skill Code Modification  

In code section of the Alexa developer console, you will find the hello world example template code where you can add the your modification as shown below

Above code snippet is added to the custom skill to launch YouTube. Here if you give the lunch YouTube utterance to the device then skill will forward the command to SDK to launch the YouTube.

• Create the intent and slot for above code in the Alexa developer console as mentioned in the step 8.
• Save and build the model

How to create a new custom intent

• From the left-hand sidebar (Alexa developer console), click Add next to Custom > Intents Tab.
• Select the Create custom intent option.
• Enter the name of the new intent and click Create custom intent. This adds a new intent and opens its detail page, displaying the intent's sample utterances and slots.
• Enter a sample utterance in the edit box and click the plus sign or press Enter. Repeat this for a few representative utterances.

Be sure to include utterances that include words and phrases that will vary when users say the intent. In the example above, this includes words and phrases like "Friday," "san Francisco", "Seattle," and "next Thursday."

Sample utterances must be unique. You cannot have duplicate sample utterances mapped to different intents.

• Identify the slots in the utterances as described below link.

https://developer.amazon.com/en-US/docs/alexa/custom-skills/create-intents-utterances-and-slots.html

Test the custom skill

 Use the simulator provided on the Test page in the developer console. This gives you access to most Alexa Skills Kit features without a device. You can interact with Alexa using either voice or text.