You need to enable JavaScript to run this app.
全域AI搜索

全域AI搜索

请输入
  • 文档首页
    • 全域AI搜索AI搜索引擎用户手册用户指南配置个性化推荐干预推荐物品排序（重排）API 提降、降权规则配置
复制全文
我的收藏
干预推荐物品排序（重排）
API 提降、降权规则配置
复制全文
我的收藏
API 提降、降权规则配置

功能概述

该功能通过API接口实现动态加、降权配置功能，允许用户在请求中直接指定字段、操作符、值及权重强度（-1到1之间），从而实时调整推荐或搜索结果的排序权重。其解决了此前仅能通过控制台手工进行权重调整的问题。

核心价值
  1. 减少手工维护成本，避免权重调整操作中的遗漏情况，赋能业务高效运行
  2. 支持客户将加、降权逻辑与自有业务系统（如库存、营销、风控）集成，实现动态调整，提升业务响应速度
  3. 支持用户粒度的加、降权配置，增强个性化推荐能力，提升用户体验

使用场景

  1. 电商平台：当用户点击某一电子产品的主页时，下次推荐请求可通过 API 动态提升相关牌子产品的权重，使其优先推荐给用户。
  2. 内容平台：当用户新关注某一作者，下次推荐请求平台可利用API提升同作者文章的权重，满足用户的短期阅读兴趣需求。
  3. 营销场景：在促销活动期间，平台可通过API 动态提升促销商品的权重，提高其曝光度。

API 配置

说明

需要已经成功集成 AI 搜索引擎 推荐接口能力，请参考 Recommend - 个性化推荐。

在推荐请求时，添加相关的加、降权参数。平台会自动融合控制台和接口的提权、降权规则配置。

请求参数

参数

类型

是否必选

示例值

conditional_boost

Array <Conds>

是

见下： Conds

Conds

说明

如果某个配置不合法，服务将会自动忽略单一提权、降权规则，来确保其他合法规则照常生效。

参数名

数据格式

是否必选

示例值

描述

conds

Array <BoostConfig>

是

提权、降权配置，平台只针对符合条件的物品提权、降权。
见下： BoostConfig

boost

Float

是

0.3、-0.3

提权、降权强度。支持 -1 到 1 区间的任何数值。

BoostConfig

参数名

数据格式

是否必选

示例值

描述

field

String

是

"author"

条件字段
提权、降权条件判断的字段，字段必须配置为「可搜索字段」

说明

嵌套字段可以利用.来配置；
例如：category.name

op

String

是

"must"

算子
每个字段类型所支持的算子，见下：字段—算子—条件值配置

conds

根据 field 字段

是

条件值
提权、降权条件判断值的集合。每个字段类型和算子所支持的值，见下：字段—算子—条件值配置

字段—算子—​条件值配置

字段类型 (field)

字段属性

支持算子 (op)

条件值输入 (conds)

Int32

没有属性，其他属性

  • equal（等于）
  • not_equal（不等于）
  • lte（小于等于）
  • lt（小于）
  • gte（大于等于）
  • gt（大于）

Int32 格式数据

Int64

没有属性，其他属性

  • equal（等于）
  • not_equal（不等于）
  • lte（小于等于）
  • lt（小于）
  • gte（大于等于）
  • gt（大于）

Int64 格式数据

时间戳
上新时间 - UNIX 格式

  • before（早于）
  • after（晚于）

UNIX 时间戳

  • within（在区间）
  • Xd（X 天）
  • Xh（X 小时）
  • Xm（X 分钟）

Float

不支持属性

  • lt（小于）
  • gt（大于）

Float 格式数据

String

没有属性，其他属性

  • must（包含）
  • must_not（不包含）

Array 格式数据

  • equal（等于）
  • not_equal（不等于）

String 格式数据

上新时间

  • before（早于）
  • after（晚于）

UNIX 时间戳

  • within（在区间）
  • Xd（X 天）
  • Xh（X 小时）
  • Xm（X 分钟）

Array <String>

没有特殊属性

  • must（包含）
  • must_not（不包含）

Array <String> 格式数据

Array <Int>

没有特殊属性

  • must（包含）
  • must_not（不包含）

Array <Int> 格式数据

Array <Float>

暂时不支持

Array <Object>

暂时不支持

Boolean

暂时不支持

返回参数

系统会返回经过权重调整后的推荐排结果，同时通过 extra_info字段，返回动态提、降权规则的执行状态。

ExtraInfo

了解更多，请查看推荐接口： ExtraInfo

参数

类型

示例值

描述

boost_status

Array <String>

["success", "field not found", "invalid operator"]

提权、降权规则的执行状态。 状态含义，见下：Status

说明

顺序严格遵守conds参数内的 BoostConfig顺序；
例如：第一个 BoostConfig配置执行成功，boost_status内的第一个状态会是 "Success"

Status

状态值

执行状态

含义

success

✅ 成功

提权、降权规则配置符合预期，规则成功在当次请求中生效。

field not found

❌ 失败

字段 （field）校验失败。 以下是可能的失败原因：

  1. 字段在物品数据集中不存在
  2. 字段没有配置为「用于搜索」

invalid field type

❌ 失败

数据格式不支持加权、降权。
目前 Array 、Array 、Boolean 字段不支持加权、降权规则。
确保字段类型符合预期，详情见： 字段—算子—条件值配置

invalid date field

❌ 失败

条件值输入 (conds）利用了时间属性配置格式，但是字段（field）没有配置为「时间戳」或「上新时间」

invalid operator

❌ 失败

字段（field ）合法但是配置的算子 （op）不合法。
确保算子配置符合预期，详情见： 字段—算子—条件值配置

invalid conds

❌ 失败

字段（field ）和算子 （op）合法，但是条件值输入 (conds）不合法。以下是可能的失败原因：

  1. 数据格式错误
  2. 字段配置了「时间戳」或「上新时间」属性

确保条件值输入符合预期，详情见： 字段—算子—条件值配置

invalid boost

❌ 失败

提权、降权强度配置不合法。确保输入在 -1 到 1 的区间内。

示例

诉求： 当用户点击某一电子产品的主页时，下次推荐请求：

  1. 提升相关牌子产品，商家的权重
  2. 降低无库存物品的权重
"conditional_boost": [
    {
        "conds": [
            {
                "field": "brand",
                "op":"must",
                "conds":["apple", "samsung", "huawei"],
            }
         ],
        "boost": 0.8
     },
     {
        "conds": [
            {
                "field": "seller_id",
                "op":"must",
                "conds":["123"],
            }
         ],
        "boost": 0.5
     },
     {
        "conds": [
            {
                "field": "available_qty",
                "op":"lte",
                "conds":0,
            }
         ],
        "boost": -0.8
     }
 ]

常见问题 (FAQ)
  1. 问: 若某一加、降权配置不合法，会发生什么情况？

答：系统会自动忽略该不合法的单一加、降权规则，其他合法规则照常生效

  1. 问: 用户如何知晓动态加、降权规则的执行效果？

答: 系统会按照请求体参数中的动态加、降权规则顺序，返回其执行效果，包括成功、字段未找到、无效字段类型等信息

最近更新时间：2025.12.17 16:42:16
这个页面对您有帮助吗？
有用
有用
无用
无用