部署服务
功能介绍
该接口用于部署推理服务。
请求消息
请求参数请参见表2。
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
service_name |
是 |
String |
服务名称,服务名称必须以res-开头,由数字、字母、下划线、中划线组成,不能以中划线结束,最大长度48字符。 |
service_type |
是 |
String |
服务类型, 可选值为infer、rank、nlp。 |
description |
否 |
String |
服务描述信息。 |
flows |
是 |
List |
流程列表,请参见表3。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
name |
是 |
String |
流程名称,由汉字、数字、字母、下划线、中划线、空格组成,最大长度60字符。 |
rules |
是 |
List |
每个Flow配置不同流量和候选集的规则,请参见表4。 |
backup_uuid |
否 |
String |
人工导入召回策略生成的uuid。 |
need_preferences |
否 |
Boolean |
是否开启优选项功能,需匹配global_features_info_path,profile_uuid和attr_weight。例如,在购物车场景,使用的召回候选集来自于离线计算基于物品的协同过滤生成的候选集,而为了尽可能保证推荐的匹配度,要求推荐出来的物品尽可能的与用户性别、体质和年龄等属性吻合,所以考虑基于用户性别、体质和年龄等属性用标签索引得到的满足条件物品列表item1, 对离线生成的items2进行如下处理:先从items2中取在item1中出现的物品,如果个数不够,再从item2中取其余的物品填补。 |
global_features_info_path |
是 |
String |
全局特征配置文件路径。 |
profile_uuid |
否 |
String |
特征工程初始用户画像-物品画像-标准宽表算子生成的uuid。
|
attr_weight |
否 |
List |
可用于属性权重排序或优选项搜索功能。请参见表11,属性权重列表。 |
filter_conf |
否 |
Object |
请参见表6,过滤配置列表。 |
rank_conf |
否 |
Object |
请参见表9,排序配置列表。 |
config |
是 |
JSON |
请参见表5。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
candidate_uuid |
是 |
String |
候选集ID。 |
rule_ratio |
是 |
Integer |
同优先级数据占比( 0-100 整数 同级别占比和为100)。 |
priority |
是 |
String |
优先级,1-10的整数(1优先级最高),最大长度32。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
model_name |
是 |
String |
模型名称。 |
model_version |
是 |
String |
模型版本。 |
weight |
是 |
Integer |
ABtest流量占比(0-100 整数 所有流程总和为100)。 |
specification |
是 |
String |
节点规格信息, 目前只支持c2.m8.g0。 |
instance_count |
是 |
Integer |
节点实例个数, 最大2个实例。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
filter_uuid |
否 |
String |
过滤规则生成的uuid。
|
duplicate_info |
否 |
Objcet |
请参见表7,去重相关的配置。 |
attribute_rules |
否 |
List |
请参见表8,属性过滤相关的配置。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
item_properties |
否 |
List |
要去重的属性列表,例如:填写product_color,则对候选集中相同产品颜色的物品进行去重,留下召回分数高的物品。 |
item_id_ignore_length |
否 |
String |
要忽略的物品ID末尾长度,例如:候选集中有两个物品为SKU_A000123和SKU_A000456,指定忽略长度为3,则对该物品去重,留下召回分数高的物品。。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
user_attributes |
是 |
List |
需过滤的用户的属性(现只支持string和numerical特征的属性),例如:一线城市用户,则属性名为city,属性值为一线城市。 |
item_attributes |
是 |
List |
需过滤的物品的属性(现只支持string和numerical特征的属性),例如:重量为0的物品,则属性名为weight,属性值为0.00。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
model_path |
否 |
String |
排序策略生成的模型在obs的文件路径。 |
etl_uuid |
否 |
String |
特征工程中生成排序训练样本生成的uuid。 |
is_attrWeight_rank |
否 |
Boolean |
是否配置属性排序。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
weight |
是 |
Integer |
设置当前模型版本的流量占比。 |
specification |
是 |
String |
计算节点规格。 |
instance_count |
是 |
Integer |
计算节点个数,即当前版本模型的实例个数。 |
image_id |
否 |
String |
镜像id,跟model_id互斥,二者只能取一。 |
model_id |
是 |
String |
模型id,跟image_id互斥,二者只能选一个。 |
示例
- 请求示例
{ "service_name": "res-service", "service_type": "infer", "description": "", "flows": [ { "name": "lc", "ratio": 100, "rules": [ { "rule_ratio": 100, "priority": "1", "candidate_uuid": "d7f23ad959bb409a89ec53b0e7346982" } ], "backup_uuid": "d7djdad959bb409a89ec53b0e7346982", "global_features_info_path": "<全局特征配置文件路径>", "profile_uuid": "593f1466661e40f58a7bda615b588d2e", "filter_conf": { "filter_uuid": "ca2b02b83338498da3b551b66d9654c3", "duplicate_info": { "item_properties": [ "product_name" ], "item_id_ignore_length": "" }, "attribute_rules": [ { "user_attributes": [ { "name": "gender", "value": "male" } ], "item_attributes": [ { "name": "color", "value": "red" } ] } ] }, "rank_conf": { "model_path": "<排序策略生成的模型在obs的文件路径>" }, "config": { "weight": 100, "specification": "modelarts.vm.cpu.2u", "instance_count": 1, "model_id": "5bbd6911-02d8-4109-80a1-e3dafc5a2cec" } } ] }
- 成功响应示例
{ "is_success": true, "service_id": "bf024976-5ade-49bf-83bf-5600191922db" }
- 失败响应示例
{ "is_success": false, "error_code": "res.1001", "error_msg": "The value of request parameter(service_name) is invalid." }
状态码
状态码请参见状态码。