更新时间:2024-10-30 GMT+08:00

预置预测分析模式

输入

系统预置预测分析输入输出模式,适用于预测分析的模型,使用该模式的模型将被标识为预测分析模型。预测请求路径“/”,请求协议为“HTTP”,请求方法为“POST”,调用方需采用“application/json”内容类型,发送预测请求,请求体以“JSON”格式表示,“JSON”字段说明请参见表1。选择该模式时需确保您的模型能处理符合该输入“JSON Schema”格式的输入数据。“JSON Schema”格式说明请参考官方指导

表1 JSON字段说明

字段名

类型

描述

data

Data结构

包含预测数据。“Data结构”说明请参见表2

表2 Data结构说明

字段名

类型

描述

req_data

ReqData结构数组

预测数据列表。

“ReqData”,是“Object”类型,表示预测数据,数据的具体组成结构由业务场景决定。使用该模式的模型,其自定义的推理代码中的预处理逻辑应能正确处理模式所定义的输入数据格式。

预测请求的“JSON Schema”表示如下:

{
	"type": "object",
	"properties": {
		"data": {
			"type": "object",
			"properties": {
				"req_data": {
					"items": [{
						"type": "object",
						"properties": {}
					}],
					"type": "array"
				}
			}
		}
	}
}

输出

预测结果以“JSON”格式返回,“JSON”字段说明请参见表3

表3 JSON字段说明

字段名

类型

描述

data

Data结构

包含预测数据。“Data结构”说明请参见表4

表4 Data结构说明

字段名

类型

描述

resp_data

RespData结构数组

预测结果列表。

“ReqData”一样,“RespData”也是“Object”类型,表示预测结果,其具体组成结构由业务场景决定。建议使用该模式的模型,其自定义的推理代码中的后处理逻辑应输出符合模式所定义的输出格式的数据。

预测结果的“JSON Schema”表示如下:

{
	"type": "object",
	"properties": {
		"data": {
			"type": "object",
			"properties": {
				"resp_data": {
					"type": "array",
					"items": [{
						"type": "object",
						"properties": {}
					}]
				}
			}
		}
	}
}

请求样例

该模式下的推理方式均为输入“JSON”格式的待预测数据,预测结果以“JSON”格式返回。示例如下:

  • 页面预测

    在服务详情的“预测”页签,输入预测代码,单击“预测”即可获取检测结果。

  • Postman调REST接口预测

    部署上线成功后,您可以从服务详情页的调用指南中获取预测接口地址,预测步骤如下:

    • 选择“Headers”设置请求头部,“Content-Type”的值设为“application/json”“X-Auth-Token”的值设为用户实际获取的token值。
      图1 预测设置请求头部
    • 选择“Body”设置请求体,编辑需要预测的数据,最后单击“send”,发送您的预测请求。