# 能力介绍个性化推荐结果对终端用户来说常常像一个"黑盒"：看到"猜你喜欢"却不知道为什么是这件商品，不感兴趣时直接划走，运营也很难在不做大范围 A/B 实验的前提下知道"某条推荐为什么被推、为什么没被点"。 **推荐原因**功能允许您按"召回通道"为每一路推荐结果配置一段不超过 20 字的短文案模板（例如"与您最近浏览的 XX 相似""近期热门 Top 3"），并随推荐接口同步返回。**终端用户可以直接看懂"为什么推荐这件商品"，运营团队也可以用可视化配置代替埋点做 A/B，实现精细化调优。** 本文介绍推荐原因的能力边界、配置步骤，以及接口返回格式。 ## 适用范围推荐原因基于已创建的推荐场景配置。开始前请确认： * 已完成 [前置配置](https://docs.volcengine.com/docs/85296/1856097) * 了解场景当前使用的召回通道 ## 名词解释 |

术语

|

说明

|

举例

| |---|---|---| |

召回通道

|

推荐系统在候选池中筛出物品所走的路径

|

高热召回、多模态召回、相似用户兴趣召回、用户画像召回、父商品召回、物品冷启动

| |

变量参数

|

插入到推荐原因模板中的占位符，发起请求时由系统自动替换为具体值

|

{{rank}}、{{category}}、{{item}}

| |

兜底文案

|

当某条推荐没有命中任何已配置模板，或对应模板为空时使用的通用文案

|

"为你推荐"

| --- # 界面配置系统会根据推荐场景所使用的召回通道，自动列出可配置的推荐原因项： * **首页推荐**：高热召回、多模态召回、相似用户兴趣召回、用户画像召回、物品冷启动 * **详情页推荐 / 购物车推荐**：父商品召回、高热召回、多模态召回、相似用户兴趣召回、用户画像召回、物品冷启动 |**场景类型** |**生效状态** | |---|---| |新建场景 |默认启用全部适用的召回通道，并使用系统内置的多语言模板

* 中/英/日/韩/印地语等，跟随应用语言自动切换 | |历史场景 |**不会自动生效，需要手动开启** | ## 召回通道 |

召回通道

|

recall_channel 参数

|

默认模板（中文）

|

可用变量

| |---|---|---|---| |

多模态召回

|

multimodal

|

和你互动过的物品相似

|

—

| |

用户画像召回

|

user_profile

|

符合你对「{{category}}」的兴趣

|

category

| |

相似用户兴趣召回

|

item_cf

|

与「{{item}}」有相似受众

|

item

| |

高热召回

|

hot_item

|

近期热门 Top {{rank}}

|

rank

| |

高热召回

|

hot_item_fallback

|

近期热门商品

|

—

| |

父商品召回

|

item_similarity

|

与「{{item}}」类似

|

item

| |

物品冷启动

|

cold_start

|

最近上线的物品

|

—

| |

—

|

（兜底）

|

为你推荐

|

—

| ## 配置步骤 1. 进入控制台 **体验配置 \> 推荐体验**，选择目标推荐场景，进入 **「推荐话术」** 页签。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/3983fd4776f240a8bb341d8f49b4bae4) 2. 在左侧「推荐原因」分组下，展开 **单个物品推荐原因**，点击 **添加原因**。 3. 弹窗会列出当前场景支持的召回通道，每个召回通道右侧带独立开关： 1. 默认全部开启，文本框内为系统预置模板文案。 2. 如需恢复为默认文案，点击文本框下方的 **使用模板**。 3. 如需自定义文案，直接在文本框中编辑（建议不超过 20 字，突出差异化卖点）。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/be1d44d8b662402888fa0971a5a15990) 4. 点击文本框右上角 **变量参数** 下的对应按钮插入变量，支持在同一模板中插入多个变量 * `+ {{rank}}`：自动获取推荐物品的热度排序 * `+{{category}}`：自动获取推荐物品的类型 * `+ {{item}}`：插入后点击该变量，从下拉列表中选择要引用的具体物品字段（如 `title`、`genre` 等），最终以 `item.{字段名}` 的形式生效

说明

不支持选择 array

Viking AI 搜索