检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念 API版本选择建议
各服务的计费请参见：产品价格详情。 开通计算引擎DLI、ModelArts DLI用于推荐系统的离线计算和近线计算。排序策略所使用的计算资源由Modelarts服务提供并收费。在使用推荐系统之前，您需要开通数据湖探索（Data Lake Insight，简称DLI）来创建集群。 DLI服务
和在线服务配置行为过滤。当数据源部分开启近线行为实时接入之后，并且用户通过上传实时行为数据，系统才具备根据实时行为进行曝光过滤的功能，该部分可参考上传实时数据进行配置和对接。 本实践的基本流程如下： 准备工作 创建数据源 配置在线服务参数 获取推荐结果 准备工作 已注册华为云帐号，并且账号为可用状态。
源、场景规格等关键信息，详情请参见表1。 基本信息配置完成后单击“创建并下一步：召回策略”。 图1 自定义场景基本信息 表1 自定义场景基本信息参数说明 参数名称 子参数 说明 基本信息 场景名称 自定义场景的名称。只能包含数字、大小写字母、下划线和中划线，长度不能超过64位且不能为空。
操作请参见推荐系统用户指南>数据源质量管理，完成数据探索并生成数据质量报告，此步骤完成后创建的数据源才可用。 步骤3：创建自定义场景 在RES管理控制台，在左侧导航栏中选择“推荐业务 > 自定义场景”，然后单击“创建”进行场景的配置。 在“基本信息”页面，配置“基本信息”、“数据
在调用接口的时候，部分URL中需要填入项目编号，所以需要获取到项目编号。项目编号获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“基本信息”。 在“基本信息”页面单击“管理我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。 图1 查看项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。
Json 用户基本属性值。其中字段的值只能是数值型，字符串或字符串数组。 否 TAGS Json 用户的兴趣标签。其中字段的值只能是Map类型。 可传入不同类型的标签信息（如人工标签，关键词标签等）。 此标签体系需与物品标签体系相同。如果无历史兴趣标签，则无需传入此字段。推荐系统将会根据特定行为匹配的标签进行计算并完成更新。
推荐系统OBS文件夹规范 使用推荐系统时，需要在OBS创建桶并导入离线数据，同时作业所产生的数据也会保存在OBS中。为了方便您快速定位文件路径，建议您按照如下结构准备数据创建文件夹，并上传至OBS桶。 OBS文件夹示例 自定义OBS桶名 │ obs-offline-data
查询作业详情 通过调用API查询作业详情 通过DLF进行作业监控及任务异常重新启动 父主题： 作业相关API
近线作业 近线作业简介 近线作业为推荐系统提供实时计算能力。近线作业以数据接入服务DIS中的数据为数据源，实时计算并更新用户画像、物品画像和推荐候选集等数据。使用近线作业，用户需先将业务系统埋点日志转换成实时日志指定格式，并实时写入DIS相应通道。近线作业具体实现请参见图1。 图1
在页面上方单击“创建”进入“创建在线服务”，在页面填写相关参数。 填写基本信息并选择服务类型。您可以根据实际情况填写“名称”、“场景”和“描述”信息。其中“场景”信息可选择您在全局配置页面创建的场景。 图1 基本信息 根据业务需求选择服务类型。包括“推荐引擎”、“排序”和“文本标签”。
用户推荐系统的数据。从用户特征表、物品特征表以及用户行为表中提取用户、物品特征和用户行为，并生成json数据，即内部通用格式。 通用格式时间：用户行为数据时间范围，可只有起始时间、结束时间或为空。 策略参数设置完成后，单击“确定”。 您可以前往过滤规则列表，查看作业的基本情况。在
用户属性表 物品类数据 物品属性表 行为类数据 用户操作行为表 用户需要自己手工创建整理这些表并存储到OBS上。 每张表的表结构必须符合推荐系统的要求，列名和字段类型需要和规范中保持一致（参考下面的表结构说明）。 每张表中填充的数据，必须符合推荐引擎的要求。 对于业务数据中无法提供的字段可以填NULL。
单击“确认”，完成修改。 删除数据源 前提条件 已存在创建成功的数据源。 注意事项 数据源中的数据结构、数据导入或数据探索有任务在运行，该数据源不支持删除。 被智能场景或自定义场景使用的数据源不支持删除。 操作步骤 登录RES管理控制台，在左侧菜单栏中选择“数据源”，进入数据源列表页面。 单击目标数据源“操作”的“删除”，删除离线数据源。
Query参数 参数 是否必选 参数类型 描述 category 是 String 场景类型： customize，自定义推荐 intelligent，智能场景 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 内容类型，取值为application/json。
附录 错误码 状态码 获取项目ID 获取账号ID
如表1所示，包括了RES的所有系统权限。 表1 RES系统策略 系统策略名称 描述 类别 RES FullAccess 推荐系统服务管理员权限，拥有该权限的用户可以操作并使用所有推荐系统服务。 系统策略 RES ReadOnlyAccess 推荐系统服务只读权限，拥有该权限的用户仅能查看推荐系统服务数据。
推荐结果多样性打散 本实践针对用户的单次推荐预测请求，在返回的物品列表中，对规定的属性进行打散，避免推荐结果出现同一属性物品扎堆出现的现象。 本实践的基本流程如下： 准备工作 创建数据源 配置在线服务参数 获取推荐结果 准备工作 已注册华为云帐号，并且账号为可用状态。 确保用户选择的属性在物
通过DLF重新执行作业 推荐系统提供了重新执行作业的API，用来将任务以相同的配置重新执行一次，实现对离线任务生成结果的更新。以固定的周期定时调用此API，可保持结果处于一个较新的状态，以获得更好的推荐结果。 以上功能，我们也可以使用数据治理中心 DataArts Studio，
调度 执行作业 执行场景 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
