文档中心

Viking AI 搜索

常见问题排查手册

为什么推荐没有返回物品？

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

本文档适用于在集成或运维AI搜索引擎推荐服务时，遇到推荐结果为空问题的开发人员或管理员。AI 搜索引擎的推荐服务会尽量返回物品，通过多路召回和兜底策略，我们尽量确保每次推荐请求都能够返回个性化的物品。典型的应用场景如电商网站的商品推荐、新闻应用的内容流等。但是在某些场景下，推荐系统无法返回个性化内容，这里会导致「推荐接口」和「推荐体验」空返回。由于可能的原因比较多，您可以按照以下的排查路径来明确出问题点：

每次请求无推荐物品

如果每次「推荐接口」请求或「推荐体验」界面刷新都不会返回物品，大概率是您上传的数据不符合预期，您可以检查以下配置：

行为数据问题

检查点	问题	影响	修复方案
上传行为数据量	太少	历史数据不足，无法用于学习用户画像	上传更多历史行为数据，至少几千条行为数据。需要存在除了曝光以外的行为。
物品数据集与用户行为数据集中，物品ID的匹配率	低	无法获取用户互动物品的属性	上传缺失的物品。
行为发生时间	早于 14 天	无法抽取画像	上传 14 天内的用户行为数据。
行为类型分布	只有曝光行为	曝光不是“正向行为”，无法提取用户喜好	上传更多“正向行为”，例如：点击、观看、关注。

场景配置问题

检查点	问题	影响	修复方案
过滤条件	不符合预期	召回的物品都被过滤条件滤除	在控制台的‘场景配置’页面，找到‘过滤条件’设置项进行检查，确保有物品能符合过滤条件。
兜底高热配置	时间窗口、行为类型	如果配置不符合实际业务情况，无法通过高热物品召回冷启动新用户。	在确保符合业务情况下，可尝试拉长时间窗口（例如，从‘24小时’调整为‘72小时’）或更改行为类型。参考：个性化推荐功能预览

部分请求无推荐物品

如果只有部分「推荐接口」请求或「推荐体验」界面刷新不会返回物品，大概率是因为业务规则导致可推荐物品为空，您可以检查以下配置：

检查点	问题	影响	修复方案
「去除重复物品」配置	时间窗口太大	所有可以被推荐的物品都被返回给用户，平台无法获取满足返回条件的物品	在确保配置符合业务情况，可适当缩短时间窗口（例如，从‘7天’缩短为‘3天’）。参考：个性化推荐功能预览
「去除重复物品」配置	「去除重复物品」配置	所有可以被推荐的物品都被返回给用户，平台无法获取满足返回条件的物品	物品数量太大	在确保配置符合业务情况，可适当减少去重物品数量（例如，从 500 减少到 200）。参考：个性化推荐功能预览
过滤条件	不符合预期	没有物品符合过滤条件	在控制台的‘场景配置’页面，找到‘过滤条件’设置项进行检查，确保物品能符合过滤条件。
过滤条件	设置过严	召回的物品都被过滤条件滤除	在确保符合业务情况下，放松过滤条件

说明

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

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

这个页面对您有帮助吗？

有用

无用