Revision History

Rev.

Date

Prepared by

Affected Sections/ Pages

Description

0.1

17/03/2020

Manjunath HK

Document

Initial version

0.22/07/2020Manjunath HKDocumentmore details on intent creation and skill
0.37/16/2021Ganesh prasad SahuDocumentModified the product creation section and details about WWE request

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

Term

Meaning

Utterance

The words the customer says to Alexa to convey what they want to do, or to provide a response to a question Alexa asks

Intent

A representation of the action that fulfills a customer's spoken request.

Slot

An argument to an intent that gives Alexa more information about that request. For example, Alexa, ask History Buff what happened on June third. In this statement, …June third is the value of a date slot that refines the request

Skill

A set of actions or tasks that are accomplished by Alexa. Skills are like apps for Alexa, helping customers perform everyday tasks or engage with your content naturally with voice

custom skill

A skill that uses a custom interaction model. You define the requests your skill can handle

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

Register an AVS device with the Amazon developer portal.

When you are in the AVS Developer Console.
If we want the device  to go through certification process, you will need to create 2 products (for experimental purpose creating 2 products is not mandatory)

Creating the products – STEP 1 of 2 – Product Information

Creating the products – STEP 2 of 2 – LWA (Login With Amazon)

Select a Security Profile:

AVS recommends using a name that includes your company or product name

Review the information

Amazon AVS team will first enable features and certify your BETA product. Then once the product is certified using the BETA product information, all features and certification will be applied to your PRODUCTION product so it can be used with your customers in production.

Requesting a Wake Word Binary

For the devices that have a far field microphone and want to use amazon Wake Word Engine (WWE)

Custom skill creation

For creating a Video skill , please refer Integrating Alexa Video Skill Kit with RDK

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

Click Create skill.




Import Skill:

     

 

Continue with Template:

after creating the skill with example template (hello world) we will find the code section in the skill console where you will find the index.js file in that you replace the existing code with code provided then save and deploy.

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.

How to create a new custom intent

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.

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



if you have the json file of the already created intents then follow the steps to add same in to your skills

for more information on the json and other related information follow the link 

https://developer.amazon.com/en-US/docs/alexa/custom-skills/create-intents-utterances-and-slots.html#json-for-intents-and-utterances-interaction-model-schema

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.