> 原文：<https://realpython.com/alexa-python-skill/>
Sign in to like and favorite skills
智能家庭扬声器仅仅在几年前还是一个新奇的想法。今天，它们已经成为许多人的家庭和办公室的核心部分，并且它们的采用预计只会增加。这些设备中最受欢迎的是由亚马逊 Alexa 控制的设备。在本教程中，通过部署自己的 Alexa skill，你将成为一名 Alexa Python 开发人员，这是一个用户将使用语音命令与亚马逊 Alexa 设备进行交互的应用程序。
在本教程中，您将学习:
ask_sdk_coreask_sdk_core免费奖励: 单击此处下载一个 Python 语音识别示例项目，该项目具有完整的源代码，您可以将其用作自己的语音识别应用程序的基础。
按照这个教程，你需要创建一个免费的 Alexa 开发者账户。在该页面上，您将采取以下步骤:
你还需要熟悉一些概念，比如 Python 中的列表和字典，以及 JavaScript 对象符号(JSON)。如果你是 JSON 新手，那么看看用 Python 处理 JSON 数据的。
我们开始吧！
一个 Alexa Python 开发者必须熟悉许多不同的 Alexa 技能组件，但是两个最重要的组件是接口和服务:
技能界面将是你 Alexa 技能的前端。在这里，您将定义执行特定功能的意图和调用短语。本质上，这是负责与用户互动的技能的一部分。
技能服务将是你的 Alexa 技能的后端。当用户触发特定意图时，它会将该信息作为请求发送给技能服务。这将包含要返回的业务逻辑以及有价值的信息，这些信息将最终传递给用户。
是时候开始建立你的第一个 Alexa Python 技能了！登录 Alexa 开发者控制台，点击创造技能按钮开始。在下一页，输入技能名称，将会是笑话机器人:
这将是你技能的调用短语。这是一个用户开始使用你的 Alexa 技能时会说的短语。如果你愿意，以后你可以把这个换成别的。此外，请注意，Alexa 技能可以用多种语言进行交互，这可以从默认语言下拉菜单中看到。现在，只需将其设置为英语(美国)。
接下来，你需要选择一个模型来增加你的技能。这些模型就像是亚马逊团队根据一些常见用例预先设计的模板，帮助你开始 Alexa Python 开发。对于本教程，您应该选择定制型号。
最后，你需要选择一种方法来托管你的 Alexa 技能的后端。该服务将包含您的应用程序的业务逻辑。
**注意:**如果你选择提供你自己的选项，那么你将不得不为你的 Alexa Python 项目托管你自己的后端。这可以是一个在你选择的平台上构建和托管的 API 。另一个选择是创建一个单独的 AWS Lambda 函数，并将其与您的 Alexa 技能相联系。你可以在他们的定价页面上了解更多关于 AWS Lambda 定价的信息。
现在，选择 Alexa 托管(Python) 作为你的 Alexa 技能的后台。这将自动在 AWS 免费层中为您提供一个托管的后端，因此您不必预先支付任何费用或立即设置一个复杂的后端。
最后，点击创造技能按钮继续。你可能会被要求在这里填写验证码，所以也要填写完整。大约一分钟后，您应该会被重定向到开发人员控制台的构建部分。
一旦你登录到 Alexa 开发者控制台并选择或创建了一个技能，你会看到构建部分。此部分为您提供了许多选项和控件来设置技能的交互模型。这个交互模型的组件允许您定义用户将如何与您的技能进行交互。这些属性可以通过左侧面板访问，如下所示:
作为一名 Alexa Python 开发者，你需要了解一些 Alexa 技能交互模型的组件。首先是调用。这是用户开始与你的 Alexa 技能互动时会说的话。例如，用户会说，“笑话机器人”，以调用您将在本教程中建立的 Alexa 技能。您可以在任何时候从调用部分对此进行更改。
另一个组件是 intent ，它代表了应用程序的核心功能。你的应用程序将有一套意图，代表你的技能可以执行什么样的动作。为了提供给定意图的上下文信息，您将使用一个槽，，它是话语短语中的一个变量。
考虑下面的例子。调用天气意图的示例话语可以是，“告诉我天气情况。”为了使该技能更有用，您可以将意图设置为“告诉我芝加哥的天气”，其中单词“芝加哥”将作为槽变量传递，这改善了用户体验。
最后，还有**插槽类型，**定义了如何处理和识别插槽中的数据。例如，亚马逊。DATE slot type 可以轻松地将表示日期的单词(如“今天”、“明天”等)转换为标准日期格式(如“2019-07-05”)。可以查看官方槽型参考页了解更多。
**注意:**要了解更多关于 Alexa 技能交互模型的信息，请查看官方文档。
此时，意图面板应该是打开的。如果不是，那么你可以从左边的工具条中选择意图来打开它。您会注意到默认情况下已经设置了五个意图:
意向面板包括一个hello world ent和五个内置意向。内置的意图是提醒你考虑一些对制作用户友好的机器人很重要的常见情况。这里有一个简单的概述:
默认情况下，没有指定的示例话语来触发这些意图，所以您也必须添加它们。把它当作你作为 Alexa Python 开发者培训的一部分。您可以在官方文档中了解更多关于这些内置意图的信息。
在本教程的后面，你将学习如何建立一个新的意图，但是现在，看一看你创造的每个新技能中的一些现有的意图是一个好主意。首先，单击hello world ent查看其属性:
您可以看到用户为了实现这一意图而说出的示例话语。当这个意图被调用时，这个信息被发送到你的 Alexa 技能的后端服务，然后它将执行所需的业务逻辑并返回一个响应。
在此之下，您可以选择设置对话框委托策略，这允许您委托您定义的特定对话框来实现特定目的。虽然你不会在本教程中涉及这一点，但你可以在官方文档中了解更多。
接下来，您可以选择为您打算收集的一些特定数据定义槽。例如，如果您要创建一个告知给定日期天气的意图，那么您将在这里有一个日期槽，它将收集日期信息并将其发送到您的后端服务。
**注意:**此外，当您在一个单独的意图中从用户那里收集大量不同的数据点，并且您想在发送给用户进行进一步处理之前提示用户时，意图确认选项会很有用。
每当您对意图进行更改时，您需要点击保存模型按钮来保存它。然后，你可以点击建立模型按钮继续测试你的 Alexa Python 技能。
知道一项技能的交互模型可以完全用一种 JSON 格式来表示是很有帮助的。要查看你的 Alexa 技能的当前结构，点击控制台左侧面板的 JSON 编辑器选项:
如果您直接使用 JSON 编辑器进行更改，那么这些更改也会反映在开发人员控制台 UI 中。为了测试这种行为，添加一个新的意图并点击保存模型。
一旦你对技能的交互模型做了所有必要的修改，你就可以打开开发者控制台的测试部分来测试你的技能。测试是成为 Alexa Python 开发者的重要一环，所以一定不要跳过这一步！单击开发人员控制台顶部导航栏中的测试按钮。默认情况下，测试将被禁用。从下拉菜单中选择开发开始测试:
在这里，你有很多方法可以测试你的 Alexa Python 技能。让我们做一个快速测试，这样你就可以了解你的 Alexa 技能将如何对话语做出反应。
从左侧面板选择 Alexa 模拟器选项，然后输入短语，“嘿 Alexa，打开笑话机器人。”你可以通过在输入框中输入或者使用麦克风选项来完成。几秒钟后，会有一个响应返回给您:
除了语音响应，你还可以看到发送到你的 Alexa 技能后端服务的 JSON 输入，以及接收回控制台的 JSON 输出:
以下是目前发生的情况:
**注:**你可以在官方文档中阅读关于 Alexa 技能的 JSON 请求-响应机制。
现在你已经对 Alexa 技能的不同组成部分以及信息如何从一个部分流向另一个部分有了一个概述，是时候开始构建你的笑话机器人了！在下一节中，您将通过创建一个新的意图来测试您的 Alexa Python 开发人员技能。
让我们从创建 JokeIntent 开始，它将从列表中向用户返回一个随机的笑话。打开你的 Alexa 开发者控制台的构建部分。然后，点击左侧面板中意图选项旁边的添加按钮:
选择创建自定义意图选项，将名称设置为 JokeIntent ，然后点击创建自定义意图按钮:
接下来，您需要添加示例话语，用户将说出这些话语来调用这个意图。这些短语可以是“给我讲个笑话”或“我想听个笑话”键入一个短语并单击加号(
+
您可以添加更多的示例话语，但是现在，这些已经足够了。最后，点击窗口左上角的保存模型按钮保存这些更改。
请记住，在测试之前，您需要构建您的模型。点击构建模型按钮，重新构建你的 Alexa Python 技能的交互模型。您会在浏览器窗口的右下角看到一个进度通知。一旦构建过程成功，您应该会看到另一个弹出通知，指示构建过程的状态。
您可以查看 JokeIntent 是否被成功触发。点击开发者控制台右上角的评估模型按钮。一个小窗口将从侧面弹出，允许你检查给定的输入话语将触发什么意图。键入任何示例话语，以确保成功调用了 JokeIntent 。
要摆脱评估弹出窗口，再次点击评估模型按钮。
**注意:**这里要记住的一件关键事情是，就作为示例话语短语一部分的关键字而言，该模型非常灵活。例如，以这句话为例，“这是某种玩笑吗？”甚至这个短语也会触发的玩笑。作为一名 Alexa Python 开发者，选择在你的技能中执行其他意图的概率较低的话语是很重要的。
既然您已经成功地创建了一个意图，那么是时候编写 Python 代码来处理这个意图并返回一个笑话作为响应了。
现在您已经创建了一个可以被用户触发的意图，您需要在技能后端添加功能来处理这个意图并返回有用的信息。打开 Alexa 开发者控制台的代码部分开始。
**注意:**由于你在设置过程中选择了 Alexa 托管的 Python 选项，你可以在开发者控制台中编写、测试、构建和部署你的 Alexa 技能的后端。
当您打开开发人员控制台的代码部分时，您可以看到一个在线代码编辑器，其中已经为您设置了一些文件。特别是，您将在 lambda 子目录中看到以下三个文件:
lambda_function.py现在，您将只对
lambda_function.py7import logging 8import ask_sdk_core.utils as ask_utils 9 10from ask_sdk_core.skill_builder import SkillBuilder 11from ask_sdk_core.dispatch_components import AbstractRequestHandler 12from ask_sdk_core.dispatch_components import AbstractExceptionHandler 13from ask_sdk_core.handler_input import HandlerInput 14 15from ask_sdk_model import Response 16 17logger = logging.getLogger(__name__) 18logger.setLevel(logging.INFO) 19 20 21class LaunchRequestHandler(AbstractRequestHandler): 22 """Handler for Skill Launch.""" 23 def can_handle(self, handler_input): 24 # type: (HandlerInput) -> bool 25 26 return ask_utils.is_request_type("LaunchRequest")(handler_input) 27 28 def handle(self, handler_input): 29 # type: (HandlerInput) -> Response 30 speak_output = "Welcome, you can say Hello or Help. " \ 31 "Which would you like to try?" 32 33 return ( 34 handler_input.response_builder 35 .speak(speak_output) 36 .ask(speak_output) 37 .response 38 ) 39...
首先，导入必要的工具，这些工具在
ask_sdk_corelambda_function.pyAbstractRequestHandlercan_handle()handle()lambda_function.pyLaunchRequestHandlerHelpIntentHandlerSkillBuilder.add_request_handler()SkillBuilder这是你经历
lambda_function.py现在，您已经大致了解了在后端处理一个意图需要做的各种事情，是时候编写代码来处理您在上一节中构建的 JokeIntent 了。
因为来自
ask_sdk_core接下来，您将创建一个新的意图处理器，它将处理来自 JokeIntent 的请求。在下面的代码片段中，意图处理程序将简单地返回一个示例短语。这表明对 JokeIntent 的响应是从后端接收的。将以下代码添加到
LaunchRequestHandler()lambda_function.py20class JokeIntentHandler(AbstractRequestHandler): 21 def can_handle(self, handler_input): 22 return ask_utils.is_intent_name("JokeIntent")(handler_input) 23 24 def handle(self, handler_input): 25 speak_output = "Here's a sample joke for you." 26 27 return ( 28 handler_input.response_builder 29 .speak(speak_output) 30 .ask(speak_output) 31 .response 32 )
让我们看看每个部分都做了什么。在第 20 行中，你为 JokeIntent 创建了一个新的 intent handler 类，它是
AbstractRequestHandlerJokeIntentHandler.can_handle()JokeIntentHandler.handle()在第 21 行你定义
。它接受.can_handle()
handler_inputdict()ask_utils.is_intent_name()ask_utils.is_request_type()您使用
.is_intent_name()handler_inputTrueSkillBuilderJokeIntentHandler.handle()**注意:**如果 JokeIntent 是从 Alexa skill 前端触发的，那么它将发送一个 JSON 对象，在
requesttypeJokeIntent这条语句随后调用
，你在行 24 中定义。该方法接收输入请求以及可能需要的任何其他重要信息。它包含成功处理特定意图所需的业务逻辑。在 JokeIntent 的情况下，这个方法需要将包含笑话的响应发送回 Alexa 前端。.handle()
speak_ouputspeak(speak_output)ask("Question to ask...")response_builder**注意:**如果
.handle()Sorry, I had trouble doing what you asked. Please try again.请注意，
speak_output下面是您的代码在编辑器中的样子:
一旦创建了意图处理程序类，就需要将其作为参数传递给
SkillBuilder.add_request_handlerlambda_function.pysb.add_request_handler(JokeIntentHandler())
这里需要注意的一点是，这一行的位置很重要，因为代码是从上到下处理的。因此，确保对自定义意图处理程序的调用在对
InstantReflectHandler()171sb = SkillBuilder() 172 173sb.add_request_handler(LaunchRequestHandler()) 174sb.add_request_handler(JokeIntentHandler()) 175sb.add_request_handler(HelloWorldIntentHandler()) 176sb.add_request_handler(HelpIntentHandler()) 177sb.add_request_handler(CancelOrStopIntentHandler()) 178sb.add_request_handler(SessionEndedRequestHandler()) 179 180# Make sure IntentReflectorHandler is last so it 181# Doesn't override your custom intent handlers 182sb.add_request_handler(IntentReflectorHandler()) 183 184sb.add_exception_handler(CatchAllExceptionHandler()) 185 186...
好了，是时候测试你的代码了！单击 Deploy 按钮保存更改并部署后端服务。你将从 Alexa 技能前端检查它是否会像预期的那样工作。
一旦部署过程成功，返回到开发人员控制台的测试部分并调用 JokeIntent 。请记住，输入话语短语来调用您的 Alexa Python 技能，然后输入短语来执行意图:
如果您得到类似于上图中的响应，那么这意味着您已经成功地为技能后端服务中的 JokeIntent 创建了一个意图处理程序。恭喜你！现在，剩下要做的就是将列表中的一个随机笑话返回给技能前端。
打开开发者控制台的代码部分。然后，在
lambda_function.pyjokes15from ask_sdk_model import Response 16 17logger = logging.getLogger(__name__) 18logger.setLevel(logging.INFO) 19 20jokes = [ 21 "Did you hear about the semi-colon that broke the law? He was given two consecutive sentences.", 22 "I ate a clock yesterday, it was very time-consuming.", 23 "I've just written a song about tortillas; actually, it's more of a rap.", 24 "I woke up this morning and forgot which side the sun rises from, then it dawned on me.", 25 "I recently decided to sell my vacuum cleaner as all it was doing was gathering dust.", 26 "If you shouldn't eat at night, why do they put a light in the fridge?", 27 ] 28 29class JokeIntentHandler(AbstractRequestHandler): 30...
这里，
jokeslist**注意:**因为这个列表只会被
JokeIntentHandler()接下来，您将添加
.handle()JokeIntentHandler.handle()29class JokeIntentHandler(AbstractRequestHandler): 30 def can_handle(self, handler_input): 31 return ask_utils.is_intent_name("JokeIntent")(handler_input) 32 33 def handle(self, handler_input): 34 speak_output = random.choice(jokes) 35 36 return ( 37 handler_input.response_builder 38 .speak(speak_output) 39 .ask(speak_output) 40 .response 41 )
在
.handle()random.choice()jokes最后，通过在
lambda_function.pyrandom15from ask_sdk_model import Response 16 17import random 18 19logger = logging.getLogger(__name__) 20logger.setLevel(logging.INFO) 21 22...
编辑应该这样看待这一点:
测试前还有最后一个改动。你需要允许 Alexa 给出一个确认技能已经被触发。为此，在
LaunchRequestHandler.handle()speak_output45class LaunchRequestHandler(AbstractRequestHandler): 46 """Handler for Skill Launch.""" 47 def can_handle(self, handler_input): 48 # type: (HandlerInput) -> bool 49 50 return ask_utils.is_request_type("LaunchRequest")(handler_input) 51 52 def handle(self, handler_input): 53 # type: (HandlerInput) -> Response 54 speak_output = "Hey there! I am a Joke Bot. You can ask me to tell you a random Joke that might just make your day better!" 55 56 return ( 57 handler_input.response_builder 58 .speak(speak_output) 59 .ask(speak_output) 60 .response 61 ) 62...
你的笑话机器人已经准备好进行最终测试了！单击 Deploy 按钮保存更改并返回到开发人员控制台的测试部分。这一次，当你的技能第一次被调用时，你会看到一个新的问候信息。然后，当你让机器人给你讲一个笑话时，它应该每次给你讲一个不同的笑话:
就是这样！你已经成功创建了你作为 Alexa Python 开发者的第一个技能！
祝贺你迈出了 Alexa Python 开发的第一步！你现在已经成功地建立了你自己的 Alexa Python 技能。您现在知道了如何创建新技能、创建意图、编写 Python 代码来处理这些意图，并将有价值的信息返回给用户。
尝试以下方法来提升你的技能:
可能性是无穷无尽的，所以勇往直前吧！要了解更多关于 Alexa Python 开发的信息，请查看官方文档。您还可以探索聊天机器人、 Tweepy 、 InstaPy 和 Discord 的可能性，以了解如何使用 Python 为不同平台制作机器人。*****