## 背景在某些推荐场景中，用户会因为自身的喜好，对推荐的结果进行筛选，只看到筛选后的推荐结果。这时可以基于动态筛选的功能，在平台完成动态筛选的配置，在请求推荐服务接口时，回传筛选的属性值，完成动态筛选。本文将指导您完成动态推荐范围的配置，并通过API调用实现该功能。 ## 须知 :::warning 1. 系统不做互斥校验，需您在配置时保持筛选逻辑的正确性，若存在互斥条件，虽然系统不会报错，但将只返回空结果。 2. 如果某个物品缺少了指定的筛选字段，系统将自动忽略相关筛选条件。了解更多，请查看 [自动忽略逻辑](/docs/85296/1791113#545109f8)。 ::: ## 业务场景 |**行业** |**适用场景** | |---|---| |视频 |在用户浏览长视频时，对电影、电视剧等视频类型或者视频的地区等属性进行筛选。|\ | |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/5f9d2290a041459998ed8b0f4058af77 =2228x) | |电商 |在浏览电商网站时，对于某个品牌商品进行筛选，或根据用户的积分筛选对应价格区间的商品。|\ | |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/2eb3c67bdf7d4f07865ac0a7668fdca7 =2330x) |\ | | | ## 配置步骤 1. **创建或编辑筛选规则：** 在【推荐体验界面】\-【推荐策略】\-【推荐范围】中，创建新的过滤规则。您也可以编辑现有筛选规则，加上动态筛选条件。

2. **配置筛选字段：** 通过【规则配置】，配置您想筛选的字段。通过 AND/OR 逻辑组合基于物品字段的筛选条件，支持字段、操作符（包含/不包含/RANGE 等）及值的自定义配置。 |**配置项** |**说明** | |---|---| |逻辑运算符 |选择条件组合逻辑（AND 需全部满足，OR 满足任一即可）。 | |筛选字段 |选择物品数据集中的目标字段。|\ | |:::tip|\ | |筛选字段仅支持已设置为「可用于过滤」的字段|\ | ||\ | |:::| |条件类型 |选择匹配规则（如包含 (in)、不包含 (not in)、数值范围比较等）。 | |条件值 |输入匹配值（多值用英文逗号分隔，数字字段直接输入数值）。 | 3. 在条件值的输入框内，点击灰色的「动态参数」配置。平台支持选择多个物品属性进行动态筛选，多个物品属性之间可以配置 or/and 的关系。动态参数是一个“占位符”，无需在这里写具体值，每次实际请求时再动态传入。

4. 保存配置。 :::tip 动态筛选配置无法在平台体验，需要通过API接口传入动态参数值来体验动态筛选效果。 ::: 5. 若您想体验动态筛选的效果，选择配置并「同步配置至 API」来生效配置。您可以通过调用 API 接口，体验动态筛选的效果。

--- ## API 请求动态筛选依赖您在请求推荐接口时，将动态的参数值传入。如果配置了多个物品属性，在线传入的时候每个物品属性的参数值都需要传入。您可以在请求体中加入 `filter` 字段来传递动态参数。 :::tip 了解在线请求如何将参数值回传 API 服务，请参考 [Filter](/docs/85296/1788543#db3f2d55)。 ::: ### 请求示例以下是一个使用 cURL 发送动态筛选请求的完整示例 > 其中 `brand` 是您配置的动态参数名称，`selected_brand` 是实际需要筛选的品牌值。 ```Bash curl -X POST 'https://recommend.example.com/v1/recommend' \ -H 'Authorization: Bearer ' \ -H 'Content-Type: application/json' \ -d '{ "user_id": "12345", "scene": "homepage_feed", "filter": { "brand": "selected_brand" } }' ``` :::tip 请将 `` 替换为您真实的访问令牌（Access Token）。关于如何获取，请参见 [API鉴权机制说明](/docs/85296/1544950)。 ::: --- ## 动态筛选支持范围 :::tip **上新时间**字段和**时间戳**字段的动态筛选功能目前正处于公测阶段。如需试用，请联系火山引擎为您开通。 ::: |

|

|

|

|

|

|

|

|

|\ |条件类型

|String

|Integer

|Float

|Array

|Boolean

|上新时间字段

|时间戳字段

|Object

|\ | | | | | | | | | | |---|---|---|---|---|---|---|---|---| |

|

|

|

|

|

|

|

|

|\ |属于

|✅

|\-

|\-

|✅

|\-

|\-

|\-

|不支持

|\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |不属于

|✅

|\-

|\-

|✅

|\-

|\-

|\-

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |区间

|\-

|✅

|✅

|\-

|\-

|❌

|❌

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |少于 / 早于

|\-

|✅

|✅

|\-

|\-

|✅

|✅

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |少于等于

|\-

|✅

|\-

|\-

|\-

|\-

|\-

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |大于 / 晚于

|\-

|✅

|✅

|\-

|\-

|✅

|✅

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |大于等于

|\-

|✅

|\-

|\-

|\-

|\-

|\-

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |等于

|\-

|✅

|\-

|\-

|✅

|\-

|\-

| |\ | | | | | | | | | | |

|

|

|

|

|

|

|

|^^|\ |不等于

|\-

|✅

|\-

|\-

|✅

|\-

|\-

| |\ | | | | | | | | | | --- ## 常见问题当在线参数异常时，平台会自动处理并缩小影响范围。具体的筛选逻辑如下： |**场景** |**默认处理逻辑** | |---|---| |在线请求没有上传参数 |忽略受影响的动态筛选配置，其他筛选配置（静态和动态）继续生效|\ | |:::tip 例如|\ | |平台配置了（A 属于 B）AND（A 不属于 C），但请求时 B 没有传入|\ | ||\ | |* **A 属于 B**：动态筛选条件不生效。|\ | |* 不影响其他条件生效：（A 不属于 C）动态筛选条件生效。|\ | ||\ | |:::| |在线请求上传参数但是没有值 |同上 | |召回物品缺失字段 |筛选条件会**自动忽略**相关过滤条件，详情请查阅 [自动忽略逻辑](/docs/85296/1791113#545109f8)。 |

全域AI搜索