AI语音技能云开发 - “我在，你说”

在上一节课中我们已经创建了一个语音技能，实现了“欢迎” -> “Hello World”

这一节课中，我们要创建一个查询天气的意图，实现“语音精灵”->“我在，你说，我可以帮你查询天气”。

一、配置语音交互模型
1.新建一个“意图”
编辑已经创建好的语音技能，选择“语音交互模块”，点击“创建意图”，创建一个“天气查询意图”

填写“意图名称”和“意图标识”

2.配置单轮对话的语料

• **语料：**是指当用户为了达到目的向音箱说出的语音指令。
• 单轮对话语料的含义是：当用户说这句话时，就可以确认用户就是希望使用这个意图的功能。
• **语料的泛化：**用户不可能只按照一句语料来说，所以相似的表达也应该配置成语料，这叫做语料的泛化。
  如：“杭州今天天气怎么样”，“杭州明天天气怎么样”，“杭州今天天气如何”，“北京天气怎么样”

配置“单轮对话表达”，输入表达语句，回车添加，添加完成后，提交

3.创建配置实体
我们在进行配置意图语料时，天气查询涉及到杭州(城市)、今天(时间)这两个参数，而我们在配置中又不可能将所有城市和时间穷举。这时，通过实体就可以帮助我们很好的解决这两个参数的配置。

创建一个自定义实体，填写实体名称和实体标识名，并添加实体值，如：北京、杭州、上海等，中间以空格分隔，回车保存



创建一个时间 公共实体 (sys.date)，点击引用公共实体，搜索sys.date回车，打开引用按钮


以下就是我们所配置的实体列表，一个城市自定义实体，一个日期公共实体

4.进行实体标注
编辑意图中的天气查询，选中“今天”，在弹框中选择我们实体中的sys.date。同理，选中“杭州”，在弹框中选择实体city


5.参数默认及参数追问
有时，我们会这么问“杭州天气怎么样”，相当于默认日期为“今天”，此时我们可以这样配置

有时，我们也会这么问“今天天气怎么样”，我们就不知道要查询的是哪个城市的天气，此时，我们就可以配置追问，在城市参数中点击编辑，添加追问语句，“您要查询哪个城市的天气”

6.配置多轮对话
有时，在问完，“杭州天气怎么样”之后，会接着问“那明天呢”，“那北京呢”等等，添加多轮对话编辑，并进行实体标注

二、开发部署后端服务
1.在后端服务模块，点击左侧服务部署，点击前往开发按钮前往CloudIDE平台开发技能

2.在CloudIDE平台进行代码修改

package com.alibaba.ailabs;

import com.alibaba.ailabs.common.AbstractEntry;
import com.alibaba.da.coin.ide.spi.meta.AskedInfoMsg;
import com.alibaba.da.coin.ide.spi.meta.ExecuteCode;
import com.alibaba.da.coin.ide.spi.meta.ResultType;
import com.alibaba.da.coin.ide.spi.standard.ResultModel;
import com.alibaba.da.coin.ide.spi.standard.TaskQuery;
import com.alibaba.da.coin.ide.spi.standard.TaskResult;
import com.alibaba.fastjson.JSON;
import com.aliyun.fc.runtime.Context;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;

/**
 * @Description 天猫精灵技能函数入口，FC
 *              handler：com.alibaba.ailabs.GenieEntry::handleRequest
 * @Version 1.0
 **/
public class GenieEntry extends AbstractEntry {

  @Override
    public ResultModel<TaskResult> execute(TaskQuery taskQuery, Context context) {
        context.getLogger().info("taskQuery: " + JSON.toJSONString(taskQuery));
        // ResultModel<TaskResult> res = new ResultModel<>();
        TaskResult taskResult = new TaskResult();
        // 从请求中获取意图参数以及参数值
        Map<String, String> paramMap = taskQuery.getSlotEntities().stream().collect(Collectors.toMap(slotItem -> slotItem.getIntentParameterName(), slotItem -> slotItem.getOriginalValue()));
         //处理名称为 welcome 的意图
        if ("welcome".equals(taskQuery.getIntentName())) {
             taskResult.setReply("我在,你说,我可以帮你查询天气");
            //处理名称为 weather 的意图
        } else if ("weather".equals(taskQuery.getIntentName())) {
            //weather 意图中 date 参数勾选了必选，请求数据中一定会携带 date 参数，只需要判断 city 参数有没有。
            if (paramMap.get("city") == null) {
                taskResult.setReply("您要查询哪个城市的天气？");
                return askReply(taskResult, "city", taskQuery.getIntentId());
            }
            //TODO 根据参数获取天气信息，这里使用假数据替代
           taskResult.setReply(paramMap.get("city") + paramMap.get("sys.date(公共实体)") + "天气 晴");

            //处理名称为 ari_quality 的意图
        }else {
            taskResult.setReply("请检查意图名称是否正确，或者新增的意图没有在代码里添加对应的处理分支。");
        }
        return reply(taskResult);
      }

    /**
     * 结束对话的回复，回复后音箱闭麦
     */
      private ResultModel<TaskResult> reply(TaskResult taskResult) {
        ResultModel<TaskResult> res = new ResultModel<>();
        taskResult.setExecuteCode(ExecuteCode.SUCCESS);
        taskResult.setResultType(ResultType.RESULT);
        res.setReturnCode("0");
        res.setReturnValue(taskResult);
        return res;
    }
    /**
     * 指定追问参数，音箱自动开麦，用户的回答优先匹配追问的参数
     */
      private ResultModel<TaskResult> askReply(TaskResult taskResult, String parameterName, Long intentId) {
        ResultModel<TaskResult> res = new ResultModel<>();
        taskResult.setExecuteCode(ExecuteCode.SUCCESS);
        taskResult.setResultType(ResultType.ASK_INF);
        AskedInfoMsg askedInfoMsg = new AskedInfoMsg();
        askedInfoMsg.setIntentId(intentId);
        askedInfoMsg.setParameterName(parameterName);
        List<AskedInfoMsg> askedInfos = new ArrayList<>();
        askedInfos.add(askedInfoMsg);
        taskResult.setAskedInfos(askedInfos);
        res.setReturnValue(taskResult);
        return res;
    }
}

3.完成代码修改后，提交到代码仓库保存，并部署“预发环境”


三、语音技能测试
1.进入在线测试进行测试

2.测试结果

四、在线测试完成后，要在云开发平台中我的应用及时将部署的应用下线，因为免费额度有限，不及时下线将会产生不必要的费用
一定要注意！！！
以上就是与“语音技能”的简单对话
下节课，我们将实现意图的切换，参数的传递

天猫技能应用平台官方文档：https://aligenie.com/doc/20255408/pvtgu9

文章暗号~ ~ ~
阿里云云开发平台名称以及网址workbench.aliyun.com