Scroll to the top under Designer where the graph is. You'll see that Alexa Skills Kit is selected. Select your function name to configure the code.
Once that loads, you'll see the Function Code section. We don't need to change anything here, but just for reference, the handler is the entry point, or the main function that we have to call. It's filled in with lambda_function.lambda_handler, which is made up of two things:
Here's the sample code we'll be using to start our project. It's written in Python 3.6 and based off of the blueprint found in Alexa.
"""
This sample demonstrates a simple skill built with the Amazon Alexa Skills Kit.
The Intent Schema, Custom Slots, and Sample Utterances for this skill, as well
as testing instructions are located at http://amzn.to/1LzFrj6
"""
import urllib.request
POKEDEX_LOC = 'https://s3.amazonaws.com/alexa-skills-pokemon-workshop/pokemonList'
POKEMON_SLOT_NAME = 'PokedexNumber'
# --------------- Helpers that build all of the responses ----------------------
def build_speechlet_response(title, output, reprompt_text, should_end_session):
return {
'outputSpeech': {
'type': 'PlainText',
'text': output
},
'card': {
'type': 'Simple',
'title': "SessionSpeechlet - " + title,
'content': "SessionSpeechlet - " + output
},
'reprompt': {
'outputSpeech': {
'type': 'PlainText',
'text': reprompt_text
}
},
'shouldEndSession': should_end_session
}
def build_response(session_attributes, speechlet_response):
return {
'version': '1.0',
'sessionAttributes': session_attributes,
'response': speechlet_response
}
# --------------- Functions that control the skill's behavior ------------------
def get_welcome_response():
"""
If we wanted to initialize the session to have some attributes we could
add those here
"""
session_attributes = {}
card_title = "Welcome"
speech_output = "Welcome to the Echomon skill. "
# If the user either does not reply to the welcome message or says something
# that is not understood, they will be prompted again with this text.
#TODO: Give a welcome response.
reprompt_text = "Please try asking for a pokemon's name by, "
return build_response(session_attributes, build_speechlet_response(
card_title, speech_output, reprompt_text, should_end_session))
def get_fallback_response():
card_title = "Sorry"
speech_output = "I haven't heard of that Pokemon before. Try again."
return build_response({}, build_speechlet_response)
def handle_session_end_request():
card_title = "Session Ended"
speech_output = "Thank you for trying the Pokemon Info skill. " \
"Have a nice day! "
# Setting this to true ends the session and exits the skill.
should_end_session = True
return build_response({}, build_speechlet_response(
card_title, speech_output, None, should_end_session))
def get_pokemon_name(intent, session):
session_attributes = {}
reprompt_text = None
#TODO: Get the pokemon's name
return build_response(session_attributes, build_speechlet_response(
intent['name'], speech_output, reprompt_text, should_end_session))
# --------------- Events ------------------
def on_launch(launch_request, session):
"""
Called when the user launches the skill without specifying what they
want
"""
print("on_launch requestId=" + launch_request['requestId'] +
", sessionId=" + session['sessionId'])
# Dispatch to your skill's launch
return get_welcome_response()
def on_intent(intent_request, session):
"""
Called when the user specifies an intent for this skill
"""
print("on_intent requestId=" + intent_request['requestId'] +
", sessionId=" + session['sessionId'])
intent = intent_request['intent']
intent_name = intent_request['intent']['name']
# TODO: Dispatch to your skill's intent handlers
if intent_name == "":
return get_pokemon_name(intent, session)
elif intent_name == "AMAZON.FallbackIntent":
return get_fallback_response()
elif intent_name == "AMAZON.HelpIntent":
return get_welcome_response()
elif intent_name == "AMAZON.CancelIntent" or intent_name == "AMAZON.StopIntent":
return handle_session_end_request()
else:
raise ValueError("Invalid intent")
# --------------- Main handler ------------------
def lambda_handler(event, context):
"""
Route the incoming request based on type (LaunchRequest, IntentRequest,
etc.) The JSON body of the request is provided in the event parameter.
"""
print("event.session.application.applicationId=" +
event['session']['application']['applicationId'])
"""
Uncomment this if statement and populate with your skill's application ID to
prevent someone else from configuring a skill that sends requests to this
function.
"""
# if (event['session']['application']['applicationId'] !=
# "amzn1.echo-sdk-ams.app.[unique-value-here]"):
# raise ValueError("Invalid Application ID")
if event['request']['type'] == "LaunchRequest":
return on_launch(event['request'], event['session'])
elif event['request']['type'] == "IntentRequest":
return on_intent(event['request'], event['session'])
# --------------- Read Pokemon Data ----------------------
POKEMON_DICT = {}
POKEMON_PARSED = False
def parse_pokemon():
"""
Parse pokemon information from the S3 store
"""
with urllib.request.urlopen(POKEDEX_LOC) as pokedex:
for pokemon in pokedex.readlines():
index, name = pokemon.decode('utf-8')[:-1].split(',')
POKEMON_DICT[index] = name
POKEMON_PARSED = True
def get_pokemon(index):
"""
Given a pokemon index, return the pokemon name.
"""
if not POKEMON_PARSED:
parse_pokemon()
return POKEMON_DICT[str(index)]
Before we dive into what code we'll be changing, we need to point out a couple of variables we've defined for you.
POKEDEX_LOC = 'https://s3-us-west-2.amazonaws.com/uci-workshop-pokemon/pokemonList' POKEMON_SLOT_NAME = 'PokedexNumber'
POKEDEX_LOC is an S3 file that we have prepared. It lists the first 151 Pokemon that you can refer to.
POKEMON_SLOT_NAME is what we've defined as our slot name while we were configuring our interaction model. Make sure that what we have in our interaction model matches what we have in this code.
First, we'll focus on the on_intent function. This is the function that will be called when the request that comes into the lambda function is made. From this request, we're going to grab the intent_name, which we defined in the interaction model. In our case, we'll use GetPokemonIntent. This is to help Alexa figure out what action to invoke based on the user's intent. We'll insert our intent name into the if statement.
Your on_intent function should now look like the following:
def on_intent(intent_request, session):
""" Called when the user specifies an intent for this skill """
print("on_intent requestId=" + intent_request['requestId'] +
", sessionId=" + session['sessionId'])
intent = intent_request['intent']
intent_name = intent_request['intent']['name']
# TODO: Dispatch to your skill's intent handlers
if intent_name == "GetPokemonIntent":
return get_pokemon_name(intent, session)
elif intent_name == "AMAZON.FallbackIntent":
return get_fallback_response()
elif intent_name == "AMAZON.HelpIntent":
return get_welcome_response()
elif intent_name == "AMAZON.CancelIntent" or intent_name == "AMAZON.StopIntent":
return handle_session_end_request()
else:
raise ValueError("Invalid intent")
In the code segment above, you can see that if the intent called is "GetPokemonIntent", then it'll return the result of a function called get_pokemon_name. We'll get into this a little more later, but you'll simply follow this pattern if your skill requires more than one intent, adding more and more into this if statement.
Also in the code segment, you'll see four other intents: the AMAZON.FallbackIntent, which we explained earlier, and the AMAZON.HelpIntent, the AMAZON.CancelIntent, and the AMAZON.StopIntent. These three are required by Amazon, and should you want to submit your skill, your skill will not be approved without these three.