检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取推荐结果 在线服务创建完成，部署成功后，当服务状态会显示“运行中”，表示服务状态正常。您可以通过在线预测功能测试推荐结果进一步调整作业参数，也可以通过预测接口来调用API，获取推荐结果。 界面预测 登录RES管理控制台，在左侧菜单栏中选择“推荐业务>自定义场景”，进入自定义场景列表页面
提交特征工程作业 功能介绍 该接口用于特征工程处理，包含数据预处理，特征提取和排序训练样本生成等。 URI POST /v1/{project_id}/etl-job 参数说明请参见表1。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号
获取推荐结果 智能创建完成，运行成功后，当服务状态会显示“运行中”，表示状态正常。您可以通过预测功能测试推荐结果进一步调整作业参数，也可以通过预测接口来调用API，获取推荐结果。 如果近线数据源有更新，需要重新调度召回策略，才会有对应的推荐结果。 预测 登录RES管理控制台，在左侧菜单栏中选择
概述 欢迎使用推荐系统（Recommender System，简称RES） 。基于华为大数据和人工智能技术，提供推荐平台和算法服务，并帮助企业构建个性化推荐应用，助力提升网站/APP的点击率、留存率和用户体验。 您可以使用本文档提供推荐系统服务API的描述、语法、参数说明及样例等内容
开启公共终端节点 功能介绍 该接口用于开启公共终端节点。 URI POST /v1/{project_id}/apig 参数说明请参见表1-URI参数说明。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号，用于资源隔离。获取方法请参见获取项目
创建OBS桶 RES使用对象存储服务（Object Storage Service，简称OBS）进行数据源以及黑白名单和用户数据的存储。因此，在使用RES之前您需要开通OBS服务并创建桶，然后在OBS桶中上传用户数据用于推荐作业的计算。 需要存放在OBS桶中的数据包括： 离线数据源
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 Token的有效期为24小时，需要使用一个
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 推荐系统的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 推荐系统的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四
获取项目ID 调用API获取项目ID 项目ID还用通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权
自定义场景（热度推荐） RES提供了推荐算法，让用户能够根据场景自定义推荐策略，可以基于RES提供的多种召回、排序算法等进行自定义的推荐场景创建。 本章节介绍热度推荐场景的搭建样例，该场景常见于电商或者视频网站首页的排行榜或者畅销榜等。 上述推荐场景在RES的自定义场景通过简单配置和计算
计费说明 计费项 RES服务根据用户使用的不同资源分别进行收费。 计费支持区域：华北-北京四。 由于RES使用的离线数据需存储在OBS中，数据存储产生的费用，请参见《OBS价格说明》。 表1 推荐系统计费项说明 计费项 说明 存储资源 应用于物品画像和用户画像的存储计费，对用户和物品的总条目数统计进行收费
准备离线数据源 在使用RES创建数据源时，您需要准备以下的3种基础数据包并上传至OBS。如果使用近线流程，需先将业务系统埋点日志转换成推荐系统指定格式，并实时写入DIS相应通道。本章节介绍了RES当前离线数据源和近线数据源的数据格式，您可以参考本章节说明，准备相应的数据。 目前数据源只支持
召回策略 召回是指对大量的物品做初选，为每一个用户形成个性化侯选集。召回策略中内置了多种召回方式，用户可根据自己场景选择。召回策略对应流程请参见图1。 图1 召回策略 推荐系统支持的召回方式有： 基于特定行为热度推荐 基于综合行为热度推荐 基于物品的协同过滤推荐 基于用户的协同过滤推荐
购买套餐包 套餐包说明 RES服务支持按需和购买套餐包，根据用户选择使用的资源进行收费。一个完整的推荐场景需要下面三种资源，均为必选项。套餐的数量可以根据实际业务按需购买。 计算资源：用于推荐作业的计算规格。涉及计费功能包含：数据源、自定义场景、智能场景中的离线计算和模型训练。 存储资源
获取访问密钥并添加RES全局配置 由于使用RES时，用户上传数据、进行离线计算等需要依赖其他服务，如果没有添加访问密钥则无法使用其他服务。因此，在使用RES前，您需要获取访问密钥并在RES管理控制台完成添加访问密钥的配置。 获取访问密钥 登录华为云，鼠标移动至页面右上方用户名，在下拉列表中选择
排序策略-离线排序模型 排序策略简介 排序策略用于训练排序模型，该模型将被用于对召回策略召回的候选集进行排序，以将推荐物品顺序调整到最优。 Logistic Regression (LR) LR算法是一种广义的线性回归分析模型，常用于数据挖掘、疾病自动诊断、经济预测等领域。LR算法通过在线性回归的基础上叠加一个
获取访问密钥（AK/SK） 由于使用RES时，上传数据、进行计算等需要依赖其他服务，若没有添加访问密钥则无法使用其他服务。 获取访问密钥 登录华为云，在页面右上方单击“控制台”，进入华为云管理控制台。 图1 控制台入口 在控制台右上角的帐户名下方，单击“我的凭证”，进入“我的凭证”
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 RES.1001 Basic Error 请求参数（{0}）的值无效 请检查是否有非法的参数值输入。 400 RES.1002 Basic
查询镜像列表 功能介绍 该接口用于查询镜像列表。 URI GET /v1/{project_id}/image?type={type} 参数说明请参见表1。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号，用于资源隔离。获取方法请参见获取项目
删除作业 功能介绍 该接口用于删除作业以及作业产生的数据。 URI DELETE /v1/{project_id}/del-job 参数说明请参见表1。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号，用于资源隔离。获取方法请参见获取项目
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
