# 应用接入
AIUI应用接入的流程如下:
# 创建应用
进入AIUI开放平台 (opens new window),登录您的账号,选择应用接入->进入应用
在我的应用页,点击创建应用,进入创建应用页。
在创建应用页,输入应用名称,如“测试应用”,在应用分类中选择应用分类,如“应用-教育学习-其他”,点击确定创建后,便创建好应用了。
# 应用信息
应用创建完成后,进去应用。在应用信息里查看应用的APPID和APPKEY。
# 开发资料下载
针对Android、Ios、Linux、Windows平台,AIUI开放平台提供了对应SDK。当开发者完成应用创建后,可进入开发工具页面,下载对应SDK。
通过服务器接入或者只具备HTTP调用能力的设备,可在开发工具页面进行WebSocket API接口调试以及白名单设置。
# 应用配置
# 基本信息
进入应用可以查看应有信息,这里展示你的创建应用时填写的应用信息,可以查看赢得APPID和APPKEY。
# 情景模式
开发一个产品可能拥有多个使用情景模式,例如面对粤语用户和普通话用户,或者一台便携式音箱,在汽车和在家中需要不同的技能,此时开发者可以创建多个情景模式,通过代码动态切换,满足业务需求。
创建情景模式如下图,点击“+”号新增情景模式。情景模式分为语义情景模式和翻译情景模式。您可以为每个语义情景模式配置不同的识别、语义、后处理,也可以创建翻译情景模式。
情景模式配置完成,需要保存修改,保存成后测试环境(情景模式后加“_box”)可以体验。点击更新发布,发布成功后正式环境才能生效。
注意:
- AIUI 应用默认配置了一个语义情景模式main。
- 目前 AIUI 一个应用支持配置最多10个情景模式。
# 语音识别
AIUI 目前默认为 Windows、Linux、Android、iOS、WebSocket API 应用配置了近场识别引擎,对智能硬件配置了远场识别引擎。同时支持配置方言。
识别基础配置为中文通用领域近场普通话,如需使用其他语种、远场识别引擎、其他专属领域识别引擎,如下图、可以在识别模块选择配置。识别高级设置,支持设置个性化识别。
- 识别结果优先阿拉伯数字
勾选后,识别结果优先返回阿拉伯数字。例如:系统会更倾向识别出“我今年12岁”,而不是“我今年十二岁”
- progressive 流式识别
progressive 流式识别简称 pgs,在关闭该选项时,云端 VAD 会在用户说完一句话时返回一次识别结果。 打开该选项时,云端会在识别一句话的过程中,返回多次识别结果,并不断自动修正,开发者如果希望在界面上实时展示修正结果以提高用户体验,可以打开该选项。
- 识别结果优先阿拉伯数字
勾选后,识别结果优先返回阿拉伯数字。
- 所见即可说
开启之后,端上传界面里的文本信息,提高识别准确率从而提升语义效果。
- 上传识别热词
当你的设备专属领域词汇识别不准时,你可以上传热词,来提升识别的准确率。
热词模板中,热词后可以加“,weight:4.0”来增加词的激励权重。如“科大讯飞,weight:4.0”。使用英文的逗号冒号,数字范围[0-4.0](大概率生效)。
- 识别敏感词过滤 识别敏感词过滤,当识别结果里出现涉黄、涉暴、涉政、涉恐或者儿童不宜的词汇时,将会被过滤掉,不展示给用户。
敏感词过滤当前未默认开放,如需使用,可以联系AIUI运营开启。
# 语义理解
- 关键词过滤
在识别文本送给AIUI理解之前,你可以设置关键词过滤。过滤掉识别文本开头和结尾一些关键词。例如:用户说法中经常带有设备的唤醒词。
比如:唤醒词是“小飞小飞”
过滤前: “小飞小飞今天天气怎么样“,“今天天气怎么样啊小飞”
过滤后:“今天天气怎么样“,“今天天气怎么样啊”
- 语义敏感词过滤
语义敏感词过滤,当回复语里出现涉黄、涉暴、涉政、涉恐或者儿童不宜的词汇时,将会被过滤掉,不展示给用户。
敏感词过滤当前未默认开放,如需使用,可以联系AIUI运营开启。
- 语义技能设置与优先级
您可以进入应用-应用配置-语义理解里添加
“自己开发的技能”,“AIUI官方技能”,您的应用仅会理解你选中的技能中的语料。当这些选中技能中的语料冲突时,AIUI 引擎的优先返回顺序是:自定义技能>自定义问答>设备人设>商店技能>关键词问答。
# 兜底
AIUI 语义在某些语境下不能覆盖用户的所有问答,因此推出了兜底业务,AIUI 目前的兜底业务包括讯飞闲聊、图灵机器人、视频搜索、无回复兜底。
如下图,你可以点击拖动名称右侧的图标对兜底技能进行排序,设置回复的优先级顺序。技能开启后,可以点击设置图标,设置兜底技能的回复范围。
- 讯飞闲聊
讯飞闲聊风格有通用版和儿童版,内容包含「讯飞知识图谱」、「精选问答」和「闲聊」。
- 讯飞知识图谱
讯飞知识图谱主要用于回答用户知识类的问答,这类问题没有固定的句式,例如:“中国在位时间最短的皇帝是谁","中国目前有多少人口","邓超的毕业院校"等问题。
- 精选问答
精选问答是AIUI梳理的常见的闲聊问题,可以提问的内容包括:“你叫什么名字”、“你今年多大了”,“不想上学”、“不想上学”,“不想理你了”,“官宣是什么意思”等问题。
- 闲聊
该部分闲聊,无论用户说什么,系统都可以“生成”和问法相关的回复,用于兜住用户的问法,提升产品体验。
- 无回复兜底
当以上任意技能或兜底业务均无法响应用户的请求时,开发者可以在平台配置兜底回复,例如:“我现在还小,听不懂你在说什么,等我长大了再来告诉你”。
# 后处理
当您希望客户端的业务逻辑尽可能少,将大部分逻辑代码写在云端时,可以打开后处理开关。后处理的详细文档请参阅后处理章节。
# 合成
平台提供了适合不同场景、不同年龄段的普通话、方言、英语在内的多种发音人,可以在线试听,同时可以调节发音人的语速和音量以满足您的应用需求。
# 虚拟人交互
如果需要使用AIUI进行虚拟人交互,首先需要在应用配置中打开语义理解及语音合成的开关;
然后打开应用配置中虚拟人交互的开关;
默认展示的为下发视频流的云端虚拟人,你可以在下拉框中选择虚拟人形象;
最后,你无需再重复下载AIUI交互的SDK,只需要下载集成一个虚拟人交互SDK即可在端侧驱动虚拟人;
提示:下拉框中展示出来的虚拟人是该应用中有权限的虚拟人,若没有想要的虚拟人,可以去往虚拟人生产平台进行定制;
提示:部分发音人不支持虚拟人驱动,若提醒该发音人不支持虚拟人驱动则需要重新选择发音人;
提示:支持本地虚拟人已在AIUI的演进计划中,敬请期待。
# 模拟测试
应用配置完成,保存后可以在平台上进行模拟测试。你可以看到AIUI应用的回复,查看JSON信息。
# 应用上线
新创建的应用,只有测试环境(情景模式默认main_box),应用审核通过的应用才可以获得生产环境,进行后续的更新发布、版本管理等操作。
点击导航栏“审核上线”,在打开的审核上线页中如实填写应用的相关信息,并提交申请。
注意:
应用上线申请,AIUI会在一个工作日完成应用审核。如紧急,可线下联系AIUI技术支持加急处理。
# 应用数据统计
AIUI提供交互服务量、设备装机量、装机量明细和设备交互记录的在线查看功能。
# 服务统计
服务统计是对已创建应用交互服务量的统计,支持在线查询已使用交互次数及剩余交互次数。支持最近一个月,SDK或者WebSocket API的不同的端的调用次数。
# 设备统计
AIUI统计设备装机量按照开发者设备自定义上传的SN来统计,平台支持按设备维度进行统计,包含以下4个核心指标:
日新增设备:每天新增加的设备数,按UID统计。默认显示前一天的数据。
日活跃设备:每天活跃的设备数,按UID统计,计算当日会话UID去重后的总和。默认显示前一天的数据。
累计设备:该应用下有过会话的UID去重后总和
剩余台数:已购买还未使用的授权装机量总和
# 在线设备明细
支持开发者按照设备码,时间段,设备类型 查询设备是否注册及注册时间。
当输入设备码时,时间段和设备类型不生效。当设备码未输入时,按选择时间段和设备类型进行搜索。