从零开始构建高效skill教程：新手入门指南与最佳实践

5次阅读

没有评论

共计 2424 个字符，预计需要花费 7 分钟才能阅读完成。

作为一个刚接触 skill 开发的新手，我最初遇到的最大问题是概念太多太杂，完全不知道从哪里下手。后来发现很多同学和我一样，主要面临以下困难：

概念混淆：不明白 intent、utterance、slot 这些术语的具体含义和关系
API 文档难懂：官方文档过于技术化，缺少具体应用场景说明
调试困难：不清楚如何测试和验证 skill 的行为是否符合预期
代码组织混乱：功能多了之后代码变得难以维护

在开始写代码前，我们需要先理解几个关键概念：

Intent（意图）：用户想要做什么。比如 ” 播放音乐 ”、” 查询天气 ” 都是一个意图
Utterance（话语）：用户表达意图的具体说法。同一个意图可以有多种表达方式
Slot（槽位）：意图中的关键参数。比如 ” 播放周杰伦的歌 ” 中 ” 周杰伦 ” 就是歌曲作者槽位的值
Dialog（对话管理）：控制多轮对话的逻辑流程

可以这样简单理解：用户说的话 (utterance) 被识别成某个意图(intent)，然后我们从这句话中提取关键信息(slot)，最后根据这些信息完成相应操作。

下面我们通过一个实际的天气查询 skill 示例，分步骤讲解开发流程。这里以 Python 为例，使用 ASK SDK。

首先需要安装必要的工具：

安装 Python 3.7+
安装 ASK CLI：pip install ask-cli
配置 AWS 凭证：ask configure

运行以下命令创建新项目：

ask new --skill-name WeatherSkill --template hello-world

修改 lambda_function.py 文件，添加天气查询功能：

from ask_sdk_core.skill_builder import SkillBuilder
from ask_sdk_core.dispatch_components import AbstractRequestHandler
from ask_sdk_core.utils import is_request_type, is_intent_name
from ask_sdk_model import Response

# 天气查询意图处理器
class WeatherIntentHandler(AbstractRequestHandler):
    def can_handle(self, handler_input):
        return is_intent_name("WeatherIntent")(handler_input)

    def handle(self, handler_input):
        # 获取城市槽位值
        slots = handler_input.request_envelope.request.intent.slots
        city = slots["city"].value if "city" in slots else "北京"

        # 这里应该调用真实天气 API，示例直接返回固定响应
        speech_text = f"{city}的天气是晴天，25 摄氏度"

        return handler_input.response_builder.speak(speech_text).response

# 注册处理器
sb = SkillBuilder()
sb.add_request_handler(WeatherIntentHandler())

lambda_handler = sb.lambda_handler()

在 models 目录下的 en-US.json 中定义交互模型：

{
  "interactionModel": {
    "languageModel": {
      "intents": [
        {
          "name": "WeatherIntent",
          "slots": [
            {
              "name": "city",
              "type": "AMAZON.US_CITY"
            }
          ],
          "samples": ["{city}的天气怎么样",
            "查询 {city} 的天气",
            "{city}今天天气如何"
          ]
        }
      ]
    }
  }
}

可以使用以下几种方式测试：