从零开始构建你的第一个Skill：开发指南与避坑实践

2次阅读

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

开发语音技能的第一步是选择合适的平台。目前主流的语音平台包括 Alexa Skills Kit（ASK）、Google Actions 和百度 DuerOS。以下是它们的核心参数对比：

平台名称	开发复杂度	API 丰富度	部署流程	适用场景
Alexa Skills Kit	中等	高	复杂	亚马逊生态设备
Google Actions	低	中	简单	Google Assistant 生态
百度 DuerOS	中等	中	中等	中文场景优先

避免开放式提问：语音交互应当提供明确的选项，而不是让用户自由发挥。例如，不要问 ” 你想了解什么？”，而应该问 ” 你想了解天气、新闻还是交通？”
提供明确的调用语句：技能的调用语句（Invocation Name）应当简短易记，例如 ” 打开天气查询 ”。

对话状态管理是语音技能开发中的核心问题。推荐使用有限状态机（Finite State Machine）来管理对话流程。以下是一个简单的状态机示意图：

stateDiagram
    [*] --> 欢迎状态
    欢迎状态 --> 天气查询: 用户说 "查询天气"
    天气查询 --> 结果展示: 提供城市名称
    结果展示 --> 欢迎状态: 用户说 "谢谢"

下面是一个使用 Node.js 实现的天气查询 Skill 示例，基于 Alexa Skills Kit 开发。

const WeatherHandler = {canHandle(handlerInput) {
        return handlerInput.requestEnvelope.request.type === 'IntentRequest'
            && handlerInput.requestEnvelope.request.intent.name === 'WeatherIntent';
    },
    async handle(handlerInput) {
        // 获取用户输入的城市名称
        const citySlot = handlerInput.requestEnvelope.request.intent.slots.city;
        const cityName = citySlot && citySlot.value;

        if (!cityName) {
            return handlerInput.responseBuilder
                .speak('请问您想查询哪个城市的天气？')
                .reprompt('请告诉我城市名称，例如北京或上海')
                .getResponse();}

        // 调用天气 API
        const weatherData = await getWeatherData(cityName);

        return handlerInput.responseBuilder
            .speak(` 今天 ${cityName}的天气是 ${weatherData.condition}, 气温 ${weatherData.temperature}度。`)
            .withSimpleCard(`${cityName}天气 `, ` 天气状况: ${weatherData.condition}\n 温度: ${weatherData.temperature}℃`)
            .getResponse();}
};

const axios = require('axios');

async function getWeatherData(city) {
    try {
        // 这里应该替换为真实的天气 API
        const response = await axios.get(`https://api.weather.com/v1/city/${encodeURIComponent(city)}`);

        // 安全校验：验证 API 返回的数据结构
        if (!response.data || !response.data.condition || !response.data.temperature) {throw new Error('Invalid weather API response');
        }

        return {
            condition: response.data.condition,
            temperature: response.data.temperature
        };
    } catch (error) {console.error('Weather API error:', error);
        throw new Error('获取天气信息失败');
    }
}

在上面的代码示例中，我们使用了 withSimpleCard 方法来生成响应卡片。这是一个简单的卡片，包含城市名称和天气信息。对于更复杂的卡片，可以使用 withStandardCard 方法。