Viking AI 搜索
Viking AI 搜索
文档指南
请输入
- 文档首页
Viking AI 搜索AI搜索引擎用户手册用户指南关联数据 / 物品池初次配置应用物品范围（前置过滤）
复制全文
下载 pdf初次配置应用物品范围（前置过滤）
文档反馈
问问助手背景
物品池是应用中可被搜索、推荐、智能对话搜索使用的有效物品集合。通过为应用配置前置过滤条件，您可以将物品数据集中符合业务规则的物品圈定为物品池，未命中条件的物品不会进入索引与召回链路。
本文介绍物品池的概念、配置方法，以及在配置和更新过程中的注意事项。
功能概述
基本概念
在 Viking AI 搜索中，物品池与物品数据集的关系如下：
- 物品数据集：您导入平台的全量物品数据。
- 前置过滤条件：您在应用层配置的一组筛选规则。
- 物品池：物品数据集中命中前置过滤条件的子集。只有物品池内的物品会参与向量化、索引构建与召回计算。
适用场景
以下场景适合使用物品池：
- 垂直内容分发：当目标物品在数据集中占比较低时（例如仅向用户推荐带有特定标签的内容），使用物品池可减少召回返空。
- 状态感知的可见性控制：仅向用户展示上架、库存充足、审核通过的物品。
- 时间窗口限制：仅在版权有效期内、上线时间窗口内展示物品。
- 合规与安全：排除不可对外展示的物品，使其不进入索引。
生效范围
物品池对应用内以下链路统一生效：搜索、对话搜索、个性化推荐。
配置步骤
前置准备
在配置物品池之前，请确认以下条件已满足：
- 已创建应用并开始关联物品数据集流程。参见创建和关联物品数据集
前置过滤与请求级过滤差别
物品池的前置过滤与搜索、推荐接口中的 filter 参数（请求级过滤）可同时使用，二者按逻辑 AND 组合生效。
建议
建议将稳定的业务规则配置为物品池，将动态条件通过请求级过滤实现。
初次配置物品范围
步骤 1：应用创建
步骤 2：关联物品数据集
步骤 3：配置物品范围筛选条件
点击“添加”，开始配置你的前置过滤规则。你可以使用 AND 或 OR 逻辑运算符组合多个条件。平台支持一层嵌套逻辑。
说明
仅支持配置已标记为 ”用于过滤“ 的字段。控制台不会对过滤条件进行校验，确保物品池有满足过滤条件的物品。
步骤 4：预览物品范围
完成表达式编写后，点击 “预览有效数据” 来预览物品数据集内，满足物品池条件的物品。
若命中数量为 0，控制台将提示“该筛选项暂无有效数据，请变更筛选条件”。
有满足过滤条件的物品
没有满足过滤条件的物品
说明
若在物品预览前，物品数据集未建立，在点击 ”预览有效数据“ 后，平台会提示您创建数据集。在点击前，请确认字段名称、类型与属性，这些信息在数据集创建后将无法修改。
创建完成后，系统约在 20 秒后自动刷新预览结果；若仍无命中，可点击重新统计。
步骤 5：生效数据集
点击完成后，平台会关联并生效物品数据。平台数据回溯阶段完成以下处理：
- 不满足过滤条件的物品不进行向量化，不写入索引（不收取物品数据处理费用）
- 不满足过滤条件的物品标识为不可搜索，不可搜推荐。
更改物品范围配置
计费说明
- 平台仅对满足前置过滤条件的物品处理费用。
- 如果物品字段变更，若满足了物品范围条件，平台会自动添加到物品池。不产生额外接口调用成本，但是会收取物品数据处理费用。
- 更改物品范围配置会触发数据回溯，回溯处理的数据会按新满足物品范围条件数量收取物品数据处理费用。
说明
常见问题
- 更改物品池期间，线上请求是否会受到影响？
不会。回溯期间线上请求仍使用原物品池，回溯完成后平台自动切换至新配置。
- 为什么预览数量与实际索引数量不一致？
预览数量为命中前置过滤条件的物品数量，实际索引数量可能因单条物品处理失败或异常导致数量偏低。悬停数据量旁的提示图标可查看具体原因。
- 物品池与请求中的 filter 参数如何共同生效？
二者按逻辑 AND 组合生效。请求最终返回的物品必须同时命中物品池和请求级过滤条件。
- 删除或替换数据集后，物品池配置是否保留？
物品池配置绑定在「应用与数据集」的关联关系上。解除关联后配置失效，重新关联后需要重新配置。
- 是否可以对未标记为「用于过滤」的字段配置物品池？
不可以。请先在数据集中将目标字段标记为「用于过滤」后，再配置物品范围。
相关文档
最近更新时间：2026.08.09 01:17:36
这个页面对您有帮助吗？
有用
有用
无用
无用