文档中心

Viking AI 搜索

推荐范围配置（过滤）

动态推荐范围配置

说明

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

背景

在某些推荐场景中，用户会因为自身的喜好，对推荐的结果进行筛选，只看到筛选后的推荐结果。这时可以基于动态筛选的功能，在平台完成动态筛选的配置，在请求推荐服务接口时，回传筛选的属性值，完成动态筛选。本文将指导您完成动态推荐范围的配置，并通过API调用实现该功能。

须知

注意

业务场景

行业	适用场景
视频	在用户浏览长视频时，对电影、电视剧等视频类型或者视频的地区等属性进行筛选。
电商	在浏览电商网站时，对于某个品牌商品进行筛选，或根据用户的积分筛选对应价格区间的商品。

配置步骤

配置筛选字段：通过【规则配置】，配置您想筛选的字段。通过 AND/OR 逻辑组合基于物品字段的筛选条件，支持字段、操作符（包含/不包含/RANGE 等）及值的自定义配置。

配置项	说明
逻辑运算符	选择条件组合逻辑（AND 需全部满足，OR 满足任一即可）。
筛选字段	选择物品数据集中的目标字段。说明筛选字段仅支持已设置为「可用于过滤」的字段
条件类型	选择匹配规则（如包含 (in)、不包含 (not in)、数值范围比较等）。
条件值	输入匹配值（多值用英文逗号分隔，数字字段直接输入数值）。

在条件值的输入框内，点击灰色的「动态参数」配置。平台支持选择多个物品属性进行动态筛选，多个物品属性之间可以配置 or/and 的关系。动态参数是一个“占位符”，无需在这里写具体值，每次实际请求时再动态传入。

说明

动态筛选配置无法在平台体验，需要通过API接口传入动态参数值来体验动态筛选效果。

API 请求

动态筛选依赖您在请求推荐接口时，将动态的参数值传入。如果配置了多个物品属性，在线传入的时候每个物品属性的参数值都需要传入。您可以在请求体中加入 filter 字段来传递动态参数。

说明

了解在线请求如何将参数值回传 API 服务，请参考 Filter。

请求示例

以下是一个使用 cURL 发送动态筛选请求的完整示例

其中 `brand` 是您配置的动态参数名称，`selected_brand` 是实际需要筛选的品牌值。

说明

请将 `<YOUR_ACCESS_TOKEN>` 替换为您真实的访问令牌（Access Token）。关于如何获取，请参见 API鉴权机制说明。

动态筛选支持范围

说明

上新时间字段和时间戳字段的动态筛选功能目前正处于公测阶段。如需试用，请联系火山引擎为您开通。

常见问题

当在线参数异常时，平台会自动处理并缩小影响范围。具体的筛选逻辑如下：

场景	默认处理逻辑
在线请求没有上传参数	忽略受影响的动态筛选配置，其他筛选配置（静态和动态）继续生效例如平台配置了（A 属于 B）AND（A 不属于 C），但请求时 B 没有传入 A 属于 B：动态筛选条件不生效。不影响其他条件生效：（A 不属于 C）动态筛选条件生效。
在线请求上传参数但是没有值	同上
召回物品缺失字段	筛选条件会自动忽略相关过滤条件，详情请查阅自动降级。

说明

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

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

这个页面对您有帮助吗？

有用

无用