阿里Skill新手入门指南：从零搭建你的第一个技能服务

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

1. 阿里 Skill 平台核心概念

阿里 Skill是阿里云提供的智能语音交互开发平台，允许开发者创建可接入天猫精灵等设备的语音技能。它的核心运行机制包含三个关键部分：

• 技能类型：分为自定义技能（完全自主开发）和模板技能（基于预设场景快速配置）
• 触发方式 ：通过特定 唤醒词（如 ” 天猫精灵 ”）+” 技能调用名称 ” 激活
• 生命周期：包含初始化→用户交互→结束会话三个阶段，每次交互以 JSON 格式传递请求 / 响应

架构流程可简化为：用户语音输入→天猫精灵服务端解析→转发至开发者配置的 API→返回处理结果→转换为语音输出。

2. 开发环境准备

基础工具安装

1. 安装 Node.js 14+（推荐使用 LTS 版本）
2. 通过 npm 安装阿里云 SDK：

   npm install @alicloud/skills-sdk

权限配置

1. 登录 阿里云控制台 ，开通 智能语音交互 服务
2. 在 RAM 访问控制中创建子账号，并授予 AliyunVoiceInteractionFullAccess 权限
3. 获取 AccessKey ID/Secret，保存为 ~/.alicloud/credentials 文件：

   [default]
   access_key_id = your_id
   access_key_secret = your_secret

3. 创建 Hello World 技能

项目初始化

mkdir my-skill && cd my-skill
npm init -y

核心代码实现

创建 index.js 文件：

const {Skill} = require('@alicloud/skills-sdk');

// 初始化技能实例
const skill = new Skill({
  appKey: 'your_app_key',
  handler: async (context) => {
    // 核心处理逻辑
    const intentName = context.request.intent.name;

    if (intentName === 'HelloIntent') {
      return {
        text: '你好，欢迎使用我的第一个阿里 Skill！',
        shouldEndSession: false
      };
    }

    // 默认回复
    return {
      text: '抱歉，我没有听懂您的意思',
      shouldEndSession: true
    };
  }
});

// 启动本地服务
skill.listen(3000, () => {console.log('Skill 服务已启动，端口：3000');
});

Manifest 配置

创建manifest.json：

{
  "skill": {
    "name": "我的测试技能",
    "invocationName": "测试技能",
    "version": "1.0.0",
    "interfaces": ["VOICE_INTERFACE"]
  },
  "apis": [{
    "type": "custom",
    "intents": [{
      "name": "HelloIntent",
      "utterances": ["打个招呼", "说你好"]
    }]
  }]
}

4. 测试与调试

本地测试

1. 启动服务：node index.js
2. 使用 Postman 发送模拟请求：

   {
     "version": "1.0",
     "session": {},
     "request": {
       "type": "IntentRequest",
       "intent": {"name": "HelloIntent"}
     }
   }

云端调试

1. 在 技能控制台 创建新技能
2. 开发阶段选择 ” 测试模式 ”，填写本地服务地址（需配置内网穿透）
3. 通过天猫精灵设备或模拟器测试语音交互

5. 发布与版本管理

发布流程

1. 完成测试后，在控制台提交审核
2. 需准备：技能图标（512×512 PNG）、详细描述、隐私政策链接
3. 通过审核后会自动发布到正式环境

版本控制要点

• 使用 Git 管理代码，每个大版本创建独立分支
• 在 manifest.json 中明确版本号（遵循语义化版本规范）
• 回滚操作需重新提交审核

6. 生产环境最佳实践

错误处理

try {// 业务逻辑} catch (err) {console.error('处理失败:', err);
  return {
    text: '服务暂时不可用，请稍后再试',
    shouldEndSession: true
  };
}

日志监控

1. 集成阿里云 SLS 日志服务
2. 关键指标监控：请求量、响应时间、错误率
3. 建议日志字段包含：sessionId、intentName、timestamp

性能优化

• 使用连接池处理数据库 /API 调用
• 对耗时操作实现缓存机制
• 保持单个请求处理时间 <800ms

实践任务：扩展天气查询功能

实现思路：

1. 新增 WeatherIntent 意图，示例语句：” 今天天气怎么样 ”
2. 集成第三方天气 API（如心知天气）
3. 实现多轮对话：

   if (context.session.city) {// 已获取城市信息，直接查询} else {
     // 提示用户指定城市
     return {
       text: '请问您想查询哪个城市的天气？',
       shouldEndSession: false
     };
   }

4. 返回结构化天气信息（温度、天气状况、建议）

提示：记得在 manifest.json 中补充新意图的 utterances 配置，并处理用户可能的中断操作。