能力版本创建

准备工作

创建版本前，需要您提前做如下准备：

1. 完成创建一个AI能力；
2. 完成解码器开发，开发说明详见：解码器编写；
3. 完成解码器及模型上传，并生成S3地址，上传说明详见：解码器&模型上传
4. 完成部署资源申请，申请说明详见：资源申请；

步骤一：准备内容确认&基本信息填写

1. 登录引擎托管平台（以下简称ASE）控制台，并选择一个AI能力，进入版本管理页；

2. 点击“新建版本”，进入版本创建页；

3. 当该AI能力未被发布过时，每次进入版本创建页时，需对创建版本所需的内容进行已完成确认，以确保创建版本时，可以流畅完成；

4. 针对已完成的内容进行勾选，未完成的内容请根据后方提示完成，其中模型上传为非必选项。所有准备工作已确认完成后，点击“开始创建”进入第一步：基本信息填写；

   

5. 根据实际情况，按需填写版本信息。其中，能力版本号需按照国际通用版本管理标准：版本格式：主版本号.次版本号.修订号。当AI能力已上架时，如存在不兼容更新时，则需另外创建一个AI能力；

   版本号递增规则如下：

   主版本号：有不兼容的更新时

   次版本号：有向下兼容的功能性新增

   修订号：有向下兼容的问题修正

   

步骤二：接口定义

接口定义共需定义5个内容，详细说明如下：

• 接口协议基本信息：

• 功能定义：

功能定义用以描述控制功能调用时的参数名称，AI能力使用者可通过传参数及其取值，从而调用引擎提供的功能，点击“添加自定义参数”，在自定义参数浮框中填写对应内容。

• 请求数据定义：

请求数据描述该AI能力的请求数据个数及各请求数据的类型，如【语音合成】的请求数据仅1个，请求数据类型为文本类型，【语音转写】的请求数据个数为1个，请求数据类型为音频类型，ASE提炼出业界通用的标准请求数据类型以供开发者选择。基于不同的接口类型，请求数据的内容及取值范围有一定差别。

生成的请求数据：

• 响应数据定义：

请求数据描述该AI能力的请求数据个数及各请求数据的类型，如【语音转写】的响应数据仅1个，响应数据类型为文本类型，ASE提炼出业界通用的标准请求数据类型以供开发者选择。基于不同的接口类型，响应数据的内容及取值范围有一定差别。

​ 生成的响应数据：

​

若响应结果为json时，需编辑format，给出json样例以及字段说明

• 错误码定义：

错误码定义即调用AI能力失败时，引擎侧返回的错误代码，以帮助用户进行错误区分并根据提供的处理策略进行修正。点击“添加错误码”，在弹框中填写对应信息，即可新增错误码。

步骤三：测试用例

填写完接口协议后，基于接口协议中填写的功能参数，平台会自动生成基础测试用例，您也可以添加自定义测试用例

步骤四：资源上传

开发者需先完成解码器开发，并通过本地S3工具上传解码器及模型（可选）。

解码器为加载器、深度学习算法计算模块及连接加载器与计算模块的中间件的集合，解码器编写详见： 解码器编写

上传说明详见：解码器&模型上传

解码器上传字段说明：

模型上传说明：

注：如引擎中未使用到模型，则此项可不填。

步骤五：相关配置

相关配置用来描述引擎部署的环境及引擎支持的并发情况

步骤六：部署规格

不同的AI算法引擎需要不同的计算资源，通常情况下，计算量越大的引擎，所需的资源规格越高。ASE当前提供8种资源规格，包含4种CPU资源、4种GPU资源。在选择部署规格时，需提前申请资源。申请说明详见：服务器资源申请

步骤七：完成创建版本

版本创建完成后，可选择直接进行版本验证，或前往版本详情页。

版本提交验证后，将会拉取用户提交的解码器及模型，在测试环境进行部署，并使用开发者编写的测试用例进行在线验证。验证时间将受解码器及模型大小、测试用例条数影响。

能力版本验证通过后，可对该AI能力进行发布上架等操作。

下一步：能力发布&上架