天猫精灵语音开发-第二天

前言

在第一天的教程《天猫精灵语音开发-第一天》里我们已经尝试开发出了一个hello world
今天这一节课中，我们要创建一个查询天气的意图，实现“小莫同学”->“主人我在，我可以帮你查询天气”。

流程

前台配置流程
- 创建天气意图和实体
- 配置单轮对话和追问
- 配置多轮对话
后台开发流程
- 解析请求意图并返回预期值
- 提交代码并部署上线
语音测试
项目下线

前台配置流程

创建天气意图和实体

配置单轮对话和进行语料标记

注意事项：

针对所有城市的天气状况可以使用模板进行创建：@{city}@{sys.date(公共实体)}天气怎么样
当用户直接询问“天气怎么样”时，即不知道城市名也不知道所问天气的日期是多少时，我们可以做以下操作：
- 不知道查询哪个城市的天气时，可以在参数中，添加追问语句，如“请问是哪个城市的天气呢？”；
- 不知道所问天气的日期是哪天时，可以关闭“精灵追问”，设置“系统默认实体值”为“今天”。

配置多轮对话

后台开发

登录阿里云云开发平台（网址：workbench.aliyun.com）开发后台代码，进入详情请看第一天教程

解析请求意图并返回预期值

全部代码如下：

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.alibaba.fastjson.JSONObject;
import com.aliyun.fc.runtime.Context;

import org.apache.commons.lang3.StringUtils;

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.getStandardValue()));
        
        String intentName = taskQuery.getIntentName();

        if("gclm-hi".equals(intentName)){
            taskResult.setReply("主人我在，我可以帮你查询天气");
        } else if("wether".equals(intentName)){
             String city = paramMap.get("city");
             //意图中 date 参数勾选了必选，请求数据中一定会携带 date 参数，因此只需要判断 city 参数有没有
             if(StringUtils.isBlank(city)) {
                   taskResult.setReply("主人，你要查询那个城市的天气啊！！！");
             }
            // 这是使用假数据
            taskResult.setReply("主人，"+city + paramMap.get("sys.date(公共实体)") + "天气 晴");
        } 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;
    }
}

提交代码并部署上线

使用Git提交代码
选择预发环境部署上线，详情请看第一天教程

语音测试

进入在线测试进行测试

项目下线

在线测试完成后，要在云开发平台中我的应用及时将部署的应用下线，因为免费额度有限，不及时下线将会产生不必要的费用

昨天就忘记下线了。多跑了一定的流量