从零开始：如何将现有项目快速转化为Alexa Skill的实战指南

2次阅读

没有评论

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

将现有项目转化为 Alexa Skill 可以极大扩展应用场景，让用户通过语音交互使用服务。典型场景包括：

智能家居控制（如灯光、温度调节）
信息查询（天气、新闻、交通）
娱乐互动（游戏、故事播报）
企业服务（订单查询、预约系统）

语音交互正在成为重要的人机交互方式，通过 Alexa 平台可以快速触达数百万 Echo 设备用户。

在开始前需要准备以下工具和账号：

开发工具
Node.js（建议 v14+）
Alexa 开发者控制台（developer.amazon.com/alexa）
AWS 账号（aws.amazon.com）
技能类型选择
自定义技能（Custom Skill）：适合大多数项目
智能家居技能（Smart Home Skill）：专用于设备控制
视频技能（Video Skill）：用于视频内容交互

技能清单是定义技能元数据的 JSON 文件，包含以下关键部分：

{
  "manifest": {
    "publishingInformation": {
      "locales": {
        "en-US": {
          "name": "My Skill",
          "summary": "A brief description",
          "description": "Detailed description",
          "examplePhrases": [
            "Alexa, open My Skill",
            "Alexa, ask My Skill for help"
          ]
        }
      }
    },
    "apis": {"custom": {}
    }
  }
}

交互模型定义用户如何与技能对话，主要包含：

意图(Intents)：用户可能表达的请求
话语样本(Utterances)：触发意图的具体说法
槽位(Slots)：意图中的可变参数

示例交互模型：

{
  "interactionModel": {
    "languageModel": {
      "intents": [
        {
          "name": "GetWeatherIntent",
          "slots": [
            {
              "name": "city",
              "type": "AMAZON.US_CITY"
            }
          ],
          "samples": ["what's the weather in {city}","how's weather in {city}"
          ]
        }
      ]
    }
  }
}

以下是处理天气查询意图的 Node.js 示例：

const Alexa = require('ask-sdk-core');

const GetWeatherHandler = {canHandle(handlerInput) {return Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest'
      && Alexa.getIntentName(handlerInput.requestEnvelope) === 'GetWeatherIntent';
  },
  async handle(handlerInput) {const city = Alexa.getSlotValue(handlerInput.requestEnvelope, 'city');

    // 这里调用实际天气 API
    const weatherData = await getWeatherFromAPI(city);

    const speakOutput = `The weather in ${city} is ${weatherData.description} ` +
      `with a temperature of ${weatherData.temp} degrees.`;

    return handlerInput.responseBuilder
      .speak(speakOutput)
      .getResponse();}
};

创建 Lambda 函数
登录 AWS 控制台
选择 ”Lambda” 服务
点击 ” 创建函数 ”
选择 ” 从头开始创作 ”
运行时选择 Node.js
上传代码
将处理程序代码打包为 ZIP
通过 Lambda 控制台上传
设置处理程序为index.handler
配置触发器
添加 ”Alexa Skills Kit” 触发器
复制 ARN 以备后续在 Alexa 开发者控制台使用

开发者控制台测试
使用 ” 测试 ” 选项卡
输入语音文本或直接说话（需麦克风）
查看请求 / 响应 JSON
设备测试
将技能添加到开发设备
实际语音交互测试

隐私政策缺失（必需公开访问的 URL）
技能图标不符合规范（512×512 PNG）
响应时间超过 8 秒
未处理所有必填意图
帮助 / 取消 / 停止意图实现不完整

错误：技能无响应
检查 Lambda ARN 是否正确配置
确认 Lambda 执行角色有足够权限
错误：”Sorry, I don’t know that”
检查意图名称是否匹配
确认话语样本覆盖足够多表达方式
错误：槽位值获取失败
检查槽位类型是否正确
确认在代码中正确解析槽位值
错误：认证被拒绝
确保所有必填信息完整
检查隐私政策 URL 可访问
错误：响应超时
优化后端 API 响应时间
考虑使用 Lambda 预预热

[用户语音] → [Alexa 设备] → [Alexa 服务] → [你的 Lambda] → [你的 API]
                                     ↑               ↓
                                     ← 语音响应  ←