文档中心

Viking AI 搜索

去除重复推荐物品（去重）

去除已曝光的物品

Viking AI 搜索是一款基于生成式 AI 的企业级 AI 搜索产品，基于大模型的多模态语义表征和理解能力，结合字节跳动信息检索领域多年最佳实践，为客户提供开箱即用的 AI 搜索搭建平台服务，帮助客户轻松搭建和集成端到端的多模态图文搜索和推荐能力。

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

能力介绍

平台提供了一套灵活的曝光去重（Exposure Deduplication) 能力。通过两项可在控制台独立调整的规则，您无需编写任何代码即可搭建稳健的去重体系：

已曝光物品去重：基于用户真实曝光行为，过滤用户已看过的物品；

已下发物品去重：在曝光回传存在短暂延迟的窗口内作为兜底，避免同一物品被重复推荐。

该能力适用于首页推荐、信息流推荐等需要避免内容重复的场景。

核心价值

真实去重：仅过滤用户实际看过的物品，已缓存但未下发到端的高质量物品不会被误伤。

跨渠道扩展：支持通过接口写入自定义去重物品，例如「已购买物品」「其他渠道已互动物品」，在多推荐场景间灵活复用。

操作指南

*说明

2026 年 1 月 6 日之后创建的推荐场景默认启用曝光去重；该日期之前创建的场景仍保留原有「下发去重」能力，如需启用曝光去重请参考升级历史场景。

配置曝光去重

进入体验配置 → 推荐体验，在左侧「推荐策略」中展开「关联行为发生场景」。展开「关联行为发生场景」进入行为发生界面的配置功能区。

在「关联行为发生场景」设置项中，从下拉列表选择对应的界面。这个配置会影响曝光数据的自动抽取任务，最终影响曝光物品的更新，请确保配置准确并符合预期。

*注意

更改或去除「行为发生场景」不会触发曝光数据回溯，配置只会增量生效。

在「推荐策略」中展开「去除重复推荐」，根据业务需要同时配置以下两条规则。两条规则必须均正确配置方可达到预期效果。

规则	配置项	输入限制	能力解释
去除已曝光物品	时间窗口	最小：1 小时最大：无限	平台自动获取窗口内最新曝光物品并在推荐结果中剔除。窗口内曝光物品超过上限时，按曝光时间从新到旧截取。曝光物品数据来源见曝光物品数据来源。说明若窗口内曝光物品数量小于上限，则按全量曝光物品去重若「物品上限」大于场景内可推荐物品数量，推荐可能返空。
去除已曝光物品		物品数量上限		最小： 0 个最大：10000 个
去除刚推荐物品	时间窗口	最小：1 分钟最大：无限	兜底规则，规避曝光回传延迟导致的短时重复下发。建议取值 ≥ 行为数据上报延迟。说明建议将时间窗口设置为大于等于行为数据上传延迟。
去除刚推荐物品		物品数量上限		最小： 0 个最大：30000 个

新规则在下一次推荐请求中于「推荐体验」页面即时生效。

确认无误后点击页面右上角「更新配置」，线上 API 同步采用新规则。

曝光物品数据来源

每个用户的曝光数据支持双来源：自动抽取 + 接口手动上传。平台在处理请求时按曝光时间融合两份数据。

方案 1 —— 行为数据自动抽取【建议】

若您已通过行为数据集上报曝光行为，平台会按以下规则自动增量抽取近 7 天内的曝光数据，无需任何改造：

按推荐场景所配置的「行为发生界面」实时写入曝光物品列表；

下次请求自动将列表内物品排除。

说明

行为数据的接收、处理、抽取与更新均存在毫秒级延迟。为确保去重可靠性，每个推荐场景应配置至少 1 分钟的「去除刚推荐物品」规则。

方案 2 —— 去重接口手动上传

若您尚未上报曝光行为，或需跨「行为发生界面」实现复杂去重逻辑，可调用去重接口主动写入去重物品列表。接口详情见 Deduplicate - 去重物品接口。

注意

调用接口前必须先在对应推荐策略中配置「关联行为发生场景」，否则接口将返回错误。

配置详情，请查看去除已曝光的物品。

升级历史场景

历史场景默认保留「下发去重」，可通过控制台一键升级至「曝光去重」。

进入体验配置 → 推荐体验，左侧「推荐策略」中未升级的场景会展示「可升级能力」提示。

点击「可升级能力」，弹窗内会对比「下发去重」与「曝光去重」的差异，并要求配置本场景的「行为发生界面」。

配置项	说明
选择关联的页面/模块	推荐场景对应的「行为发生界面」这个配置会影响曝光数据的自动抽取任务，最终影响曝光物品的更新，请确保配置准确并符合预期。

点击「升级」后，

原「下发去重」规则自动保留为新的「已下发物品去重」；

新「已曝光物品去重」规则按默认值创建，您可随后调整。

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

最近更新时间：2026.08.09 01:06:07

这个页面对您有帮助吗？

有用

无用