开发文档

1、概述

AIUI开放平台,针对互联网移动终端,即将推出全新的AIUI人机交互接口,提供丰富的特性和能力,开发者可以通过集成AIUI SDK即可接入使用。

为了让已使用语义开放平台的用户(MSC接口)能使用AIUI开放平台语义,AIUI开放平台进行了兼容升级,开发者可以继续通过MSC进行接入,但是部分配置无法生效,某些特性体验不到,所以欢迎开发者升级使用AIUI SDK接入使用以达到更好的体验效果。

AIUI SDK包含最新的人机交互接口,开发者通过集成该SDK,能够体验到AIUI丰富的特性和能力。

集成大致步骤:

  (1)创建应用

  (2)下载AIUI SDK

  (3)在AIUI开放平台配置流程以及流程参数

  (4)应用集成使用

2、应用配置

AIUI管理后台支持丰富的配置,可以配置服务调用流程以及各个流程相关参数。

2.1 情景模式配置

情景模式是为满足同一应用需要在不同场景下使用提供的,在不同的情景模式下,可以配置识别参数,语义下勾选不同的技能以满足应用在不同场景下的需要。

情景模式下的各项配置均在云端保存,AIUI SDK只需传入情景模式,云端会自动加载对应情景模式对应的各项参数。

开发者定义的多个情景模式,可以通过AIUI SDK动态配置切换使用。

平台会为应用自动创建名字为main的情景模式,如需新增创建其他情景模式,可以通过如下方式:

2.2 流程配置

AIUI目前从客户端到服务端的处理流程如下:

在平台打开对应的流程,应用就可以收到对应流程的处理结果,默认情况下识别打开,所以应用默认可以收到听写及语义的结果。

如果需要对AIUI的识别或者语义结果需要进行自定义的处理,可以打开后处理选项,这样AIUI云服务会将识别或者语义的结果回调到开发者服务器上,具体流程参考下面后处理的介绍。

2.3 语义

进入应用配置页面,点击“语义”,具体参考语义协议

2.4 识别

进入应用配置页面,点击“识别”,进入识别参数设置:

识别目前支持设置四项:

语言 目前仅支持简体中文,未来会支持英语等多种语言
方言 目前仅支持普通话,未来会支持例如粤语等各省份方言
维度 目前仅支持通用领域,未来会支持特定领域的维度,例如车载、电视等领域
热词 通过热词,对于某些识别不准的字句,可以提升其识别效果

2.5 后处理

打开并且配置该选项,可以将AIUI识别或者语义结果回调接入到开发者自定义服务器,具体可查看文档协议。

2.6 AIUI SDK集成开发

请参考AIUI SDK开发文档。

3、MSC接入指南

通过原MSC接口也能接入使用AIUI开放平台语义的功能,只需通过设置特定参数即可实现。

集成流程与上面描述的AIUI SDK大体类似,但是有如下需要注意的地方:

3.1 平台配置

采用MSC接入平台设置只能配置情景模式以及语义,其他配置在平台上受限制不能使用。

支持列表如下:

配置项 是否支持
情景模式配置 支持
语义配置 支持
其他配置(识别和后处理) 不支持

注:这里的平台页面配置的识别对MSC接口不生效,如需使用MSC如果想设置识别相关参数,请参考SDK开发包中的开发文档《MSC Develop Manual》。

3.2 MSC集成开发

通过设置指定的nlp_version和scene参数值可以升级到AIUI开放平台语义,具体设置接口参考SDK开发包中的开发文档《MSC Develop Manual》。

参数名称 参数 是否必须设置 参数值
语义版本号 nlp_version 必须设置 nlp_version=3.0
情景模式 scene 建议设置 默认为scene=main,可以设置为已创建的情景模式