文档中心

Viking AI 搜索

干预推荐物品排序（重排）

用户地理位置提权与降权

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

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

功能概述

用户地理位置提权与降权是一项基于 LBS 的人工干预能力。平台以用户位置与物品位置之间的实际距离为条件，调整物品在推荐结果中的排序，帮助您实现新品推广、库存清理、负面物品打压或区域化投放等业务目标。

关键特性

提权：提升命中规则的物品权重，使其更容易被展示。

降权：降低命中规则的物品权重，使其更不容易被展示，可结合距离阈值触发。

权重因子：取值 -100% ~ 100% 的整数。绝对值越大，效果越明显。

距离维度：支持基于用户位置与物品位置的实际距离配置权重，实现区域化的提权 / 降权。

典型使用场景

远距离物品降权：对跨区域库存、配送受限的商品降权，提升推荐的地域相关性与履约体验。

近距离物品提权：对用户附近商家或仓库的商品提权，提高转化率与及时性。

前置操作

推荐场景所使用的物品数据集已配置经度（longitude）与纬度（latitude）字段属性；否则规则配置页不会出现「用户与物品距离」选项。

配置步骤

添加新地理位置规则

说明

规则之间无优先级。当同一物品命中多条规则时，平台会累加所有规则的权重因子得到最终值。

例：物品 A 同时命中「提权 50%」与「降权 30%」，最终生效为「提权 20%」。

进入体验配置 → 推荐体验 → 推荐策略，点击「提权、降权」进入配置区。

在规则配置页面填写以下信息

配置项	说明
规则名称	配置一个简单易懂的名称，便于后续维护与识别
配置生效范围	导航到「计算字段」，选择「用户与物品距离」在条件设置部分，从下拉菜单中选择‘大于’或‘小于’，在输入框中填写距离数值（如 20），并选择单位。当一个物品有多个坐标，怎么办？如果一个物品存在了多组「经度」和「纬度」坐标，平台在计算与用户的距离时，会自动选择离用户最近的那组坐标。
提权 / 降权配置	权重因子，取值 -100% ~ 100% 的整数

点击「确定」。新规则在下一次推荐请求中于体验界面生效。建议先按体验地理位置规则，验证配置效果。

验证无误后点击「同步配置」，线上 API 开始使用新规则。

API 请求

线上 API 请求的 context 对象必须包含 location 字段，否则规则无法命中。字段说明详见 Context。

体验地理位置规则

前提条件

您必须已完成「添加新地理位置规则」

进入体验配置 → 推荐体验，选择目标推荐场景（如首页推荐、商品列表页）。

在右侧「测试用户」区域，通过以下方式指定测试坐标：

能力	能力说明
获取我的位置	调用浏览器定位获取当前位置，需授予浏览器位置权限说明若点击「获取我的位置」后未能获取到坐标，请按以下顺序排查：电脑系统是否已开启定位服务；浏览器是否被禁止访问位置权限；如曾经拒绝过权限，需重启电脑以重置权限限制。
指定用户位置	手动输入经纬度，例如经度：116.4°、纬度：39.9°

查看推荐结果变化

点击「刷新推荐结果」，平台会基于模拟坐标与物品经纬度计算距离，并应用当前规则。例如：

近距离提权：规则距离用户 5 km 以内提权 50% → 该范围内的物品排序靠前。

远距离降权：规则距离用户 20 km 以外降权 80% → 超出该范围的物品排序靠后或减少曝光。

常见问题

Q1：为什么体验界面的推荐结果和线上有差异？

A：体验界面使用您手动指定的测试坐标进行预览；线上用户则基于其真实地理位置触发规则，因此会存在差异。

Q2：为什么配置了规则但没看到效果？

A：请按以下顺序排查：

物品数据集是否正确配置经度，纬度字段；

规则中的距离条件是否与测试坐标匹配；

权重因子是否设置得足够大；

是否已点击「同步配置」将体验界面配置推送到线上。

Q3：为什么找不到「用户与物品距离」选项？

A：请检查当前推荐场景所使用的物品数据集是否已配置经度与纬度字段属性。如需更新字段属性，请联系火山引擎技术团队。