背景
- 虽然天猫精灵目前功能已很丰富，但还有些定制化高的服务无法满足，比如查询学校课表，考研信息，公交状态，特定网站状态等。不过天猫精灵提供了开放平台能力，使得我们可以轻松给天猫精灵添加这些自定义能力。
- 本文做个简单示例，和天猫精灵说小爱同学，天猫精灵回复"小爱同学，我是天猫精灵" 来展示一下如何通过天猫精灵调用我们的自定义服务。
- 查阅文档，可知要实现这个功能，关键有两步，一是让天猫精灵识别，二是搭建自定义服务进行回复
实现
注册技能
- 天猫精灵接入还是比较简单的，注册完成开发者后，就直接在平台添加自定义技能就可以了。open.aligenie.com/console
1. 添加自定义技能『小爱同学』
2. 在侧边栏"意图" tab 中添加意图
- 因为我们只做一个简单的呼唤，所以就用个简单的默认意图就好了，注意默认意图并不是兜底意图，而是当只说 调用词 时触发的意图
- 如果有多种功能，可以使用例句来教会天猫精灵怎么区分不同意图，文档链接
3. 在侧边栏"回复逻辑"中配置回调
- 可以看到此处需要填写 webhook url，也就是我们实际自定义服务的地址.目前还没搭建，下面我们将用 faas 搭建
- 需要注意的是这边有个校验文件，开放平台为了验证服务的有权性，会要检验服务根目录下有没有这个文件。我们先把文件下载下来，后续使用 文档链接
服务搭建
- 服务搭建的方式有很多，此处我们选择采用 aliyun 的 faas 服务, 也就是函数计算进行搭建。函数计算有个好处在于不用关心真实服务器，只需要编写自定义逻辑即可。而且关键每月还有100万次的免费调用额度，约等于不要钱 . fc.console.aliyun.com
- 函数计算为三层结构 1个服务 -> n个函数-> m个触发器。每个服务可以有多个函数；每个函数为一个工程，里面有一个入口函数；然后由触发器去调用这个函数, 常用的有 http 触发器，定时触发器等
- 可见我们需要的就是创建一个服务，然后两个函数，一个用于应答天猫精灵，一个用于天猫精灵的验权。
- 新建一个服务，名字随意
- 新建两个函数，分别叫 xiaoai 和 auth ，对应的触发器名字分别为 xiaoai_http, auth_http，用于应答和校验
应答服务
- 应答服务很简单，就是返回 "小爱同学，我是天猫精灵"
- 因此我们只需要收到请求直接返回就好，代码如下, 复制到代码执行的在线编辑器中，点击保存即可
var getjsonBody = require('div/json');
exports.handler = (req, resp, context) => {
getJsonBody(req, function (err, data) {
if (!data || !data.utterance) {
resp.send("post div wrong! " data);
}
resp.setStatusCode(200);
resp.setHeader('content-type', 'application/json');
resp.send(JSON.stringify(
{
"returnCode": "0",
"returnErrorSolution": "",
"returnMessage": "",
"returnValue": {
"reply": `小爱同学，我是天猫精灵`,
"resultType": "RESULT",
"executeCode": "SUCCESS",
"msgInfo": ""
}
}));
});
}
- 在下方的测试中，便可以输入上面的 div，测试一下结果
- 至此，应答服务完成
校验服务
- 校验服务就更简单了，就是模仿一个文件读取，返回文件内容即可.
- 因此打开上面下载的校验文件，将文件内容替换到下面的 xxx 中, 粘贴到代码执行的编辑框中，点击保存即可。
exports.handler = (req, resp, context) => {
resp.setHeader('content-type', 'text/plain');
resp.send("xxx")
}
- 在下方的测试验证处直接 get 便可看到返回 div 即为上面的 xxx
路径注册
- 完成了上面两个服务后，虽然可以直接用各个函数的触发器对应的网址直接访问，但是由于验权文件必须要在根目录的 /aligenie/ 下，因此还需通过 自定义域名 来统一域名
- 打开自定义域名，可以看到有一个默认域名，我们就直接编辑这个域名, 添加两个路径，一个为 /aligenie/aaa.txt, 将 aaa 替换为上面下载的验权文件的文件名, 一个为 /xiaoai/*
大功告成
- 获得地址后，将天猫精灵 webhook 地址改成我们上面的自定义域名即可
- 在测试验证便可进行测试了，打开真机测试则可在 taobao 账号绑定的天猫精灵上进行测试
Tips
- 本文仅演示了简单的 faas 服务，因此采用了直接页面编辑的方式，对于复杂的业务逻辑，比如要安装依赖包，debug 的测试的，建议是用 aliyun 的 funcraft 提供了一种在本地可以测试服务和快速发布的方法。 不过需要注意的是其 template.yml 生成的配置一般不含日志部分，日志部分手工配置比较难写，建议通过导出功能，直接导出在界面上配置好的参数
- 对于线上运行情况可以通过 函数计算 的日志查询进行查看, 首次配置需要开通下 aliyun 的日志服务。
参考资料
- 天猫精灵文档
- 函数计算
