# 背景 **物品池**是应用中可被搜索、推荐、智能对话搜索使用的有效物品集合。通过为应用配置前置过滤条件，您可以将物品数据集中符合业务规则的物品圈定为物品池，未命中条件的物品不会进入索引与召回链路。本文介绍物品池的概念、配置方法，以及在配置和更新过程中的注意事项。 --- # 功能概述 ## 基本概念在 Viking AI 搜索中，物品池与物品数据集的关系如下： * **物品数据集**：您导入平台的全量物品数据。 * **前置过滤条件**：您在应用层配置的一组筛选规则。 * **物品池**：物品数据集中命中前置过滤条件的子集。只有物品池内的物品会参与向量化、索引构建与召回计算。 ## 适用场景以下场景适合使用物品池： * **垂直内容分发**：当目标物品在数据集中占比较低时（例如仅向用户推荐带有特定标签的内容），使用物品池可减少召回返空。 * **状态感知的可见性控制**：仅向用户展示上架、库存充足、审核通过的物品。 * **时间窗口限制**：仅在版权有效期内、上线时间窗口内展示物品。 * **合规与安全**：排除不可对外展示的物品，使其不进入索引。 ## 生效范围物品池对应用内以下链路统一生效：搜索、对话搜索、个性化推荐。 --- # 配置步骤 ## 前置准备在配置物品池之前，请确认以下条件已满足： 1. 已创建应用并**完成**物品数据集。参见[创建应用并关联物品数据集](/docs/85296/1544946)， [关联已有物品数据集](/docs/85296/2375482) ## 前置过滤与请求级过滤差别物品池的前置过滤与搜索、推荐接口中的 `filter` 参数（请求级过滤）可同时使用，二者按逻辑 `AND` 组合生效。 |**对比维度** |**物品池（前置过滤）** |**请求级过滤（后置过滤）** | |---|---|---| |生效位置 |索引构建与召回计算阶段 |查询阶段 | |配置方式 |在控制台配置，应用级生效 |每次 API 请求携带 | |资源消耗 |未命中物品不产生索引与计算开销 |全量物品均参与索引 | |典型用途 |长期、稳定的可见性规则 |请求级或用户级的动态条件 | :::tip 建议建议将稳定的业务规则配置为物品池，将动态条件通过请求级过滤实现。 ::: --- ## 更改物品范围配置 ### 步骤 1：物品范围入口 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/2493a29321a646788e06a70d327033a8 =800x) ### 步骤 2：变更物品范围条件更改物品范围条件的配置。你可以使用 `AND` 或 `OR` 逻辑运算符组合多个条件。平台支持一层嵌套逻辑。 :::tip \*说明仅支持配置已标记为 ”用于过滤“ 的字段。**控制台不会对过滤条件进行校验，确保物品池有满足过滤条件的物品。** ::: ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/0da6efba14b8434d839bad995df115fe =800x) ### 步骤 3：预览物品范围完成表达式编写后，点击 **"预览有效数据“ ** 来预览物品数据集内，满足物品池条件的物品。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/8ead04d82ced4e8da5d3eb2915af31cb =2940x) 若命中数量为 0，控制台将提示“该筛选项暂无有效数据，请变更筛选条件”。

有满足过滤条件的物品

![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/d153830a85de45118b58605b2bffe9aa =2940x)

没有满足过滤条件的物品

![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/996cddb3c21e4fa08bce37cfb9079907 =2940x) ### 步骤 4：确认变更 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/04e91cd9a50e40908e2b7999e0af414e =800x) --- # 计费说明 1. 平台**仅对满足前置过滤条件的物品处理费用**。 2. 如果物品字段变更，若满足了物品范围条件，平台会自动添加到物品池。**不产生额外接口调用成本**，但是会**收取物品处理费用**。 3. 更改物品范围配置会触发**数据回溯**，回溯处理的数据会按**新满足物品范围条件数量**收取物品数据处理费用。 :::tip 详细计费项请参见 [AI 搜索引擎（标准版）计费说明](/docs/85296/1544954) ::: --- # 常见问题 1. **为什么预览数量与实际索引数量不一致？** 预览数量为命中前置过滤条件的物品数量，实际索引数量可能因单条物品处理失败或异常导致数量偏低。悬停数据量旁的提示图标可查看具体原因。 2. **物品池与请求中的 filter 参数如何共同生效？** 二者按逻辑 `AND` 组合生效。请求最终返回的物品必须同时命中物品池和请求级过滤条件。 3. **删除或替换数据集后，物品池配置是否保留？** 物品池配置绑定在「应用与数据集」的关联关系上。解除关联后配置失效，重新关联后需要重新配置。 4. **是否可以对未标记为「用于过滤」的字段配置物品池？** 不可以。请先在数据集中将目标字段标记为「用于过滤」后，再配置物品池。 --- ***相关文档*** * [创建应用并关联物品数据集](/docs/85296/1544946) * [已有数据集添加新字段](/docs/85296/2275019) * [在搜索时过滤](/docs/85296/1873488) * [静态推荐范围配置](/docs/85296/1791113) * [动态推荐范围配置](/docs/85296/1863360) * [为什么推荐没有返回物品？](/docs/85296/2124616)