针对创建成功的自定义场景,需要进行发布才可以运行作业获取推荐结果。通过执行 终止操作,停止运行当前场景。目前支持在自定义场景列表页面和自定义场景详情页 面进行操作。
发布或终止自定义场景默认对该场景下的所有作业执行发布或终止操作,包括召回策 略、过滤规则、排序策略和在线服务等作业。
前提条件
已存在创建成功的自定义场景。
发布自定义场景
1. 登录RES管理控制台,在左侧导航栏中选择“推荐业务” > “自定义场景”,进 入自定义场景列表页面。
2. 通过如下方式对场景进行发布。
– 在自定义场景列表页面发布:选择自定义场景列表中的目标场景,单击“操
3. 在“发布场景”页面确认自定义场景作业运行的配置规格单击“是”。
说明
● 修改自定义场景信息需要执行发布操作才可以同步数据。
● 发布场景会覆盖之前数据,请谨慎操作。
终止自定义场景
1. 登录RES管理控制台,在左侧导航栏中选择“推荐业务” > “自定义场景”,进 入自定义场景列表页面。
2. 通过如下方式对场景进行发布或终止。
– 在自定义场景列表页面终止:自定义场景列表中的目标场景,单击“操作”
列的“终止”。
– 在自定义场景详情页面发布或终止:单击自定义场景列表中的目标场景名 称,进入自定义场景详情页,单击页面右上角的“终止”。
3. 在“终止场景”页面确认自定义场景信息后单击“是”。
说明
终止之后该场景数据不可用。
5.6 获取推荐结果
在线服务创建完成,部署成功后,当服务状态会显示“运行中”,表示服务状态正 常。您可以通过在线预测功能测试推荐结果进一步调整作业参数,也可以通过预测接 口来调用API,获取推荐结果。
界面预测
1. 登录RES管理控制台,在左侧菜单栏中选择“推荐业务>自定义场景”,进入自定 义场景列表页面。
2. 单击“已完成”状态的目标服务名称进入自定义场景详情页面,单击“预测”页 签,包括两种预测方式。
– 代码:输入预测代码,单击“预测”后显示预测结果,如图5-9所示。输入用 户ID和推荐数量,或者物品项,根据您设置的策略返回用户的预测结果。如 果物品项有多个,需要用英文逗号隔开。
图5-9 代码预测
– 表单:输入“ID”和设置“最大推荐个数”,也可以设置“物品项”。其中 ID可以为用户ID或者物品ID,单击“预测”后显示预测结果,如图5-10所 示。如果物品项有多个,需要用英文逗号隔开。
图5-10 表单预测
获取预测接口
1. 登录RES管理控制台,在左侧菜单栏中选择“推荐业务>自定义场景”,进入自定 义场景列表页面。
2. 单击“已完成”状态的目标服务名称进入自定义场景详情页面,单击“预测”页 签,您可以获取该服务的“API接口地址”。单击 ,复制接口地址,调用服务。
图5-11 获取预测接口
调用接口
Mozilla、Google都为REST提供了图形化的浏览器插件,发送处理请求消息。
● 针对Firefox,请参见Firefox RESTClient。
● 针对Chrome,请参见Postman。
此处以Postman为例,指导您如何通过调用预测接口获取推荐结果。更多接口信息请 参见《推荐系统API参考》。
1. 下载Postman软件并安装,您也可以直接在Chrome浏览器添加Postman扩展程序
(也可使用其它支持发送post请求的软件)。
2. 打开Postman,如图5-12所示。
图5-12 Postman 界面
3. 在Postman界面填写参数。
– 选择POST任务,将通过获取预测接口获取的调用地址复制到POST后面的方 框。Headers页签的“KEY”值填写为“X-Auth-Token”,“VALUE”值为您 获取到的Token(关于如何获取token,请参考获取用户Token),如图5-13 所示。
说明
您也可以通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求,具体可 参见《RES API参考》中的"认证鉴权认证鉴权>AK/SK认证”。
图5-13 参数填写
4. 预测请求参数说明。
表5-23 参数说明
参数 子参数 说明
参数 子参数 说明
"dynamic-search" 候选集,为非必选项。
match_i
nfos 进行召回匹配的参数配置,即搜索的匹配信息。
● label:客体的属性名称(可为字符串或字符串数组类 型)。
● value:相应的属性值。
● weight:该属性值的匹配权重,多个匹配条件做加权 汇总后按分值从大到小给出候选集。
filter_inf
o 搜索的过滤信息。
● black_list:客体需要过滤的黑名单。
● range:选定一个数值型属性(label),输出的候选 集该值必须大于等于设定的值才不会被过滤掉。
● category:选定一个字符串或字符串数组类型属性
(label),输出的候选集该值必须包含或等于设定的 值才不会被过滤掉。
sort_info 搜索的排序信息。
● label:客体的属性名称。
● orde:排序规则,asc是升序排列,desc是降序排列。
profile_
query - 对用户画像进行字段查询,传入string数组进行查询。
5. 单纯用户推荐预测JSON请求体如下,仅针对用户进行个性化推荐。
"item1", "item2"
],
"search_info":{
"match_infos":[
"profile_query":[
"gender", "tag"
] }
7. 参数填写完成,点击“Send”发送请求,结果会在“Response”下的对话框里显 示。其中,“id”为推荐的itemId,“score”为该物品的得分。示例如下:
{
"flow_id": "movielens", "rec_num": 10,
{