文档中心

Viking AI 搜索

推荐体验

个性化推荐功能预览

个性化推荐服务能够基于用户行为数据，为用户提供精准的物品推荐，旨在提升用户参与度和转化率。该功能广泛适用于电商首页的“猜你喜欢”、内容详情页的“相关推荐”等业务场景。本文将引导您完成个性化推荐服务的初始化配置和功能使用。想要体验更多 Viking AI 搜索能力，点击前往：Viking AI 搜索引擎，企业搜推问一体化智能引擎

个性化推荐服务通过分析用户行为数据，为用户提供精准的商品或内容推荐，旨在提升用户参与度与转化率。该功能广泛应用于电商首页的"猜你喜欢"及内容详情页的"相关推荐"等业务场景。本文介绍如何初始化并使用个性化推荐服务。

前置条件

开始配置前，请确保已完成必要的前提条件，以确保用户行为数据集已关联并处于激活状态。若未关联用户行为数据集，将无法创建推荐场景。如需了解如何关联并激活用户行为数据集，请参阅前置配置。

创建推荐场景

登录控制台：进入体验配置 > 推荐体验功能模块。

若当前无已有场景，点击创建推荐配置以新建场景。

说明

首个用户行为数据集初始化完成后，平台将自动创建两个推荐配置。您可随时点击创建配置继续添加更多推荐配置。

配置基本信息

基础讯息	说明
场景名称	自定义推荐场景名称（最长 50 字符，建议包含业务场景关键词便于管理）。默认创建的场景已经提前配置了此讯息。
场景类型	选择推荐场景类型首页推荐：基于用户画像的个性化推荐详情页推荐：基于商品关联性与用户画像的推荐默认创建的场景已经提前配置了此讯息。
选择关联的页面/模块	用于标识该场景对应的"交互界面" 此设置将驱动自动曝光数据提取任务，用于追踪用户已浏览过的商品，请确保配置准确。了解更多，请查看去除已曝光的物品。无选项 / 缺少选项系统会从用户事件数据集中「行为发生场景」属性标签的字段自动提取该配置，请确保用户事件数据中该字段填写正确。
选择推荐的物品集	推荐所用的商品来源数据集关联指定商品数据集后，将限定可被推荐的商品范围。在"商品数据集"下拉菜单中，选择一个已激活的商品数据集。
推荐结果物品维度	选择推荐结果返回的商品粒度（二选一）子商品：按具体规格商品（variant）粒度返回推荐结果，使用标准召回通道。父商品：按商品聚合维度（parent，即 SPU 粒度）返回推荐结果，使用父商品召回通道，避免同款商品不同规格重复展示。说明：仅当关联的物品数据集中配置了「商品类型」和「父商品 ID」属性时，该选项才会展示；配置支持随时更改，更改后需重新发布配置。

完成推荐场景创建后，系统将自动跳转至推荐体验页面。

体验中心

界面说明

界面由以下两个主要部分组成：

左侧：召回与业务策略、推荐理由、推荐助手（原「推荐理由 / 推荐话术」）

中部：推荐结果与输入

推荐策略

1. 推荐范围

核心功能	功能描述	了解更多
关联用户事件场景	用于标识该场景对应的"交互界面" 此设置将驱动自动曝光数据提取任务，用于追踪用户已浏览过的商品，请确保配置准确。无选项 / 缺少选项系统会从用户行为数据集中「行为发生场景」属性标签的字段自动提取该配置，请确保用户事件数据中该字段填写正确。	去除已曝光的物品
筛选推荐物品	配置物品过滤规则，确保物品返回符合业务诉求。	静态推荐范围配置动态推荐范围配置
推荐结果物品维度	配置推荐结果返回的商品粒度。选择「子商品」时，按具体规格商品返回选择「父商品」时，按商品聚合维度返回，系统自动匹配对应的父商品召回通道。该配置在创建推荐场景时设定，可在推荐范围区域查看当前选择。仅当关联的物品数据集中配置了「商品类型」和「父商品 ID」属性时，该选项才会展示。

2. 推荐数量

核心功能	功能描述	了解更多
推荐数量上限	每次推荐返回的商品数量上限。默认值：10 件；最大值：400 件。

3. 召回

核心功能	功能描述	了解更多
新物品冷启动召回	物品冷启动召回为新品提供专属召回通道，确保其获得基础曝光量，并能持续积累用户行为数据，逐步成长为成熟商品。	新物品冷启动召回
热门物品召回	针对无用户画像的新用户配置兜底策略。平台将基于用户交互行为自动计算热门商品，用于冷启动场景。	热门物品召回（新用户冷启动，兜底）
召回融合策略	配置多路召回的融合权重，决定不同召回通道的物品在最终推荐结果中的占比，针对不同业务场景进行精细化策略调优。	配置和调整召回融合策略

4. 排序

核心功能	功能描述	了解更多
提权、降权	通过配置提权与降权规则，调整特定商品在推荐结果中的权重，实现业务驱动的排序效果。	物品属性提权与降权用户地理位置提权与降权时间对比提权与降权
去除已推荐物品	当个性化推荐召回相同商品时，自动移除已展示过的商品。	去除已曝光的物品
推荐多样性	通过多样性规则控制相似商品在推荐结果中的分布密度，避免结果过度同质化，提升结果丰富度与用户浏览体验。	多样性规则配置
置顶物品	根据置顶商品列表配置，将指定商品强制展示在最终返回结果的对应位置。	置顶推荐物品

推荐理由

说明

两种模式可并存

单物品推荐原因随推荐主接口返回（每个物品一条短原因）

推荐助手在商品卡片渲染后，由客户端按需异步调用流式接口获取整批推荐的分析与追问。

核心功能	功能描述	了解更多
单物品推荐原因	根据召回通道返回一段简短推荐原因，说明每个物品"为什么被推荐"，文案随推荐接口同步返回，不产生额外调用、不影响接口延迟、不额外计费。	单物品推荐原因
推荐助手	原「推荐话术」配置升级为「推荐助手」新增「触发推荐助手」开关，默认关闭，开启时控制台会提示该能力将返回推荐理由分析并按次收取对话费用；角色配置拆分为助手身份、回答风格、追问倾向三部分，均可编辑并提供系统默认值开启后，终端在推荐结果页看到「智能分析用户喜好」分析卡片，内容由大模型基于推荐物品、召回信息、用户画像与角色配置流式生成，并附带 3 条递进式追问分析内容通过新的独立的流式接口返回，不阻塞推荐商品返回。推荐助手开关关闭时，不会发起流式接口调用，不产生任何对话费用，终端不展示「智能分析用户喜好」卡片。	推荐助手

推荐结果与输入

推荐结果

核心功能	功能描述
推荐物品	展示推荐结果，支持预览推荐效果。
推荐理由	由可解释性推荐：利用大语言模型（LLM）能力，基于推荐商品、用户画像及角色设置，推断并生成推荐理由。

推荐输入

核心功能	功能描述	了解更多
测试用户	指定用户：通过自定义用户 ID，并基于此画像生成推荐随机用户：默认由系统随机选取一个用户 ID，并基于此画像生成推荐，用于快速测试召回效果	配置测试用户
测试物品	仅在详情页推荐指定物品：通过自定义物品 ID，并基于此生成关联推荐随机物品：默认由系统随机选取一个物品 ID，并基于此生成关联推荐，用于快速测试召回效果	配置测试物品
配置用户位置	只有配置了「用户与物品距离」提权、降权条件，才会展示指定用户位置：手动输入经纬度坐标（如经度：39.9°、纬度：116.4°）获取我的位置：获取您当前的位置来模拟测试用户，此操作需要您授予浏览器位置权限。注意如果点击了「获取我的位置」后，平台不自动获取经纬度，请检查：电脑是否开启了位置能力电脑、浏览器是否限制了浏览器位置获取的权限若之前禁止浏览器位置获取的权限，必须重启电脑，重置权限限制。	体验地理位置规则

业务需求与功能映射

产品支持多个业务配置，支持您配置业务逻辑，包括：推荐数量上限、去除重复推荐物品、过滤逻辑深度配置、高热商品计算逻辑。

业务需求	相关功能	了解更多
配置单次返回物品数量	配置推荐场景，物品数量上限通过 API 请求，自定义 page_size 参数	Recommend - 个性化推荐
确保用户多次请求不返回相同物品	配置去除重复推荐物品规则	去除已曝光的物品
确保推荐物品符合业务需求	根据业务需求，配置「静态」或「动态」推荐范围规则	静态推荐范围配置动态推荐范围配置
不同用户请求会有不一样的过滤条件	根据业务需求，配置「动态」推荐范围规则	动态推荐范围配置
不同用户请求会有不一样的加权条件	根据业务需求，配置「动态」提权、降权规则	API 提权、降权配置（V2）
新用户、冷启动用户处理逻辑	兜底展示热门物品	热门物品召回（新用户冷启动，兜底）
个性化推荐出现异常处理逻辑	兜底展示热门物品	热门物品召回（新用户冷启动，兜底）	个性化推荐异常兜底

说明

想要体验更多 Viking AI 搜索能力，点击前往：Viking AI 搜索引擎，企业搜推问一体化智能引擎

最近更新时间：2026.09.16 02:28:32

这个页面对您有帮助吗？

有用

无用