在前两课的基础上,创建两个意图,实现意图间的参数传递,实现一个多意图关联的语音技能,在线测试将对话界面进行截图。
我们实现了一个简单的查询天气的功能,这节课我们来创建一个空气质量查询的意图,并学习一下如何将空气质量意图与上节课创建的天气查询意图进行关联,了解两个意图间如何进行参数传递,实现意图间的切换。可以为跨意图的对话提供更加流畅的效果。
配置天气质量查询意图
创建一个空气质量 意图。
可选:
和天气查询意图一样,为了防止用户在日常语音交互过程中很有可能没有说出想要查询 的城市或者日期,导致语音交互识别过程中缺少必要的参数,我们要为空气质量查询意图设置参数追问来补全一些必要的信息,以便技能为用户提供精确的服务;
在系统默认实体值字段中,为时间参数配置默认参数为今天,为城市参数配置精灵追问为“您要查询哪个城市的空气质量?”。
配置多轮对话语料,并把明天和北京分别进行标注,明天标注为时间实体,北京标注为城市实体。
配置前置意图
这样配置完后,我们一个最简单的意图关联和参数传递就完成了。简单来说,空气质量查询的意图可以用我们天气查询意图的city参数放到空气质量查询的city参数中。
保存意图:
开发部署后端服务
示例代码:
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(公共实体)") + "天气 晴");
//处理名称为 queryAirQuality 的意图
}else if ("queryAirQuality".equals(taskQuery.getIntentName())) {
//queryAirQuality 意图中 date 参数勾选了必选,请求数据中一定会携带 date 参数,只需要判断 city 参数有没有。
taskResult.setReply("您要查询哪个城市的空气质量?");
//TODO 根据参数获取空气质量信息,这里使用假数据替代
taskResult.setReply(paramMap.get("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) {
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);
}
完成代码编写后,要把代码提交到仓库中,不然再进来就没有了,提交步骤:点击源代码管理,然后点击提交按钮;提交完成后要选择部署环境,打开 CloudIDE 左侧的 部署调试插件,进入到部署面板,选择预发环境进行部署。
测试
参考文档:
https://aligenie.com/doc/20255408/ugw88c