前言
本文介绍零代码上线一个地理小知识的语音技能应用,带你轻松理解AliGenie技能应用平台开发应用的全流程。
技能原理
开发流程
进入平台
1.我们创建一个技能应用,需要登录进入技能应用平台。
2.如果你是首次登录,那么就需要签署平台协议并完成实名认证,这些步骤并不难,跟随引导进行下一步即可。
新建技能
1.认证通过后进入技能应用平台,我们要创建一个语音技能,选中 语音技能分类:点击 创建技能。
2.填写技能基本信息
选中 语音技能 中的 自定义技能 填写必要的信息,其中:技能名称是展示在技能市场的技能名称,在公有域内需要是唯一的;技能调用词就是用户想要使用技能时对天猫精灵说的关键词。
基本信息填好后,后端服务部署方式选择阿里云云开发平台,选好后确认创建技能;技能创建成功后,自动进入技能基本信息页面点击后端服务子页面进行后端服务部署。我们需要绑定阿里云账号并授权相关资源。
如果你是第一次使用云开发平台那么你需要签署相关服务协议,这也并不难,根据提示操作下一步即可。云开发有一定的免费额度,普通上线测试基本无开销。
配置后端
AliGenie技能应用平台提供了多种后端服务部署方式:
- 阿里云云原生开发平台FAAS是阿里云的云开发平台,函数计算有个好处在于不用关心真实服务器,不仅基本上不要钱还可以在线开发部署,只需要编写自定义逻辑即可。
- 在线开发(应用托管)类似于阿里云云开发,是天猫精灵自有无需绑定阿里云账号,可适用于快速开发。
- 自建Web Serveice由开发者自行搭建后端服务,我们需要自己搭建Web服务用来响应天猫精灵(且自建服务器上需要上传天猫精灵的认证文件到指定路径下,用于天猫精灵的验权。)并绑定服务器部署地址到后端服务详情页,如下图所示:
我们在这里选择阿里云原生平台,点击创建技能应用按钮,我们就能进入应用创建界面。
选择开发语言和开发模板进行创建,本文以【地理小百科】模板应用为例。平台提供JAVA、NodeJS、Python三种开发语言和响应模板。点击创建应用就OK了。
保存刚才编辑完成的后端服务配置。
调试后端
点击前往开发,在新标签页进入到云阿里开发平台。
通常需要等待一会,云开发平台会自动生成模板应用的代码。当然如果你不满足于模板内容,我们可以自己在模板应用的基础上进行二次开发,当开发完成后记得git提交保存修改。
模板应用中代码已经配置无需更改代码,进入CloudIDE后直接选择部署环境,打开 CloudIDE 左侧的 部署调试插件,进入到部署面板,选择预发环境进行部署。
环境选择好之后,我们要检查路由、函数映射表,第一个字段是应用访问的路径,格式为:/skill-88888/entry,其中数字 88888 为智能应用平台上此应用的技能id,技能id显示在技能详情的分页-概览页中的基本信息表中的技能ID字段中,这个字段一般系统会默认自动填好。
所以我们在这里其实也没什么可以检查的。
第二个字段表示某个文件的函数入口,如果选择NodeJS语言或Python语言,此数据为:index.handler。我们选择的模板基于Java语言,此数据为:com.alibaba.ailabs.GenieEntry::handleRequest,表示当应用发布之后,天猫精灵这边的请求会发送到com.alibaba.ailabs.GenieEntry类的handleRequest方法,handleRequest是从AbstractEntry类中继承的方法,这个方法不能动。这个字段系统也会自动填充。
所以我们在这里其实也没什么可以检查的。
虽然在云开发平台以上三个字段是默认填充的,但是如果配置错误就无法正常运行函数,所以非常重要。
第三个字段表示请求的类型,这里只能是post类型,当然它也是默认填充的。
点击部署按钮进行部署,确认部署信息,点击下方的部署即可。
确认部署信息后我们可以在cloud Workbench看到部署实时详情。
技能测试
我们模板应用的意图已经创建完毕了,可以直接进行线上测试。在应用页面进入测试子页面,打开在线测试tab;
系统识别到意图名称并发送系统回复则表示技能部署成功。测试时输入的问题都是创建意图时配置好的语料,不可自主发挥,具体意图中有哪些语料可以在语音交互模型分页中,点击每个意图进行查看。
真机测试部分,打开真机测试,并开启真机测试开关;
初次使用需要添加天猫精灵设备,点击添加设备按钮,并按照引导输入语音验证码;
添加设备成功后,通过唤醒词“天猫精灵”来唤醒音箱,然后通过自定义的技能调用词进入技能,这里以教程中的调用词“地理助手”为例,音箱回复默认欢迎语,则语音技能测试完成。
技能发布
如果想把应用发布到公域让更多人使用可以进行技能发布操作;只是想要体验开发平台的话不需要进行发布操作,也可以在自己的设备上调试使用。
在技能发布前,需要先去Cloud IDE平台,将部署环境从预发环境改为线上环境,环境选择好之后,我们要检查路由、函数映射表等,检查无误后点击部署按钮开始部署;
我们可以在顶部进入应用管理在这里将之前部署的应用的预发环境下线;
技能重新部署后,进入发布页,点技能发布,点击编辑按钮,编辑技能信息;
进入编辑页面,编辑技能基本信息,填写带星的必填信息等信息,填写完成后,提交审核即可,若信息不全我们可以暂时保存;稍许等待几个工作日就能在公域看到你发布的应用了~