搜索 API 提降、降权规则配置--全域AI搜索-火山引擎

文档中心

立即注册

全域AI搜索

配置 AI 搜索

搜索 API 提降、降权规则配置

功能概述

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

核心价值

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

API 配置

说明

需要已经成功集成 AI 搜索引擎搜索接口能力，请参考 Search - 搜索。

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

请求参数

参数	类型	是否必选	示例值
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 时间戳
	时间戳上新时间 - 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 格式数据
Array(Int)	没有特殊属性	must（包含） must_not（不包含）	Array 格式数据
Array(Float)	暂时不支持
Array(Object)	暂时不支持
Boolean	暂时不支持

返回参数

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

ExtraInfo

了解更多，请查看搜索接口： Search - 搜索

参数	类型	示例值	描述
boost_status	Array	`["success", "field not found", "invalid operator"]`	提权、降权规则的执行状态。状态含义，见下：Status 说明严格遵守 Conds 参数内的 BoostConfig 顺序；例如：第一个 BoostConfig 配置执行成功，`boost_status`内的第一个状态会是 `"success"`

Status

状态值	执行状态	含义
success	✅ 成功	规则配置符合预期提权、降权规则成功在当次请求中生效。
field not found	❌ 失败	字段（`field`）校验失败确保配置字段存在物品数据集中。
invalid field type	❌ 失败	字段（`field`）数据格式不支持提权、降权目前 Array 、Array
invalid date field	❌ 失败	字段（`field`）不是时间属性条件值输入 (`conds`）利用了时间属性配置格式，但是字段（`field`）没有配置为「时间戳」或「上新时间」
invalid operator	❌ 失败	字段（`field` ）合法但是配置的算子（`op`）不合法确保算子配置符合预期，详情见：字段—算子—条件值配置
invalid conds	❌ 失败	字段（`field` ）和算子（`op`）合法，但是条件值输入 (`conds`）不合法以下是可能原因：数据格式错误字段配置了「时间戳」或「上新时间」属性确保条件值输入符合预期，详情见：字段—算子—条件值配置
invalid boost	❌ 失败	提权、降权强度配置不合法确保输入在 -1 到 1 的区间内的数字。

示例

示例 1 - 电商

示例 2 - 内容社区

示例 3 - 时间提权、降权

诉求： 当用户搜索时，

提升热门牌子产品，商家的权重
降低无库存物品的权重

"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
     }
 ]

诉求：当用户搜索时，

提升热门作者文章和话题的权重

"conditional_boost": [
    {
        "conds": [
            {
                "field": "author",
                "op":"must",
                "conds":["author_1","author_2"],
            }
         ],
        "boost": 0.3
     },
     {
        "conds": [
            {
                "field": "tags",
                "op":"must",
                "conds":["topic_1"],
            }
         ],
        "boost": 0.8
     }
 ]

诉求：当用户搜索时，

提升 7 天内发布物品的权重
降低早于 30 天发布物品的权重

"conditional_boost": [
    {
        "conds": [
            {
                "field": "pub_time",
                "op":"within",
                "conds":"7d",
            }
         ],
        "boost": 0.8
     },
     {
        "conds": [
            {
                "field": "pub_time",
                "op":"before",
                "conds":1764886800,
            }
         ],
        "boost": -0.8
     }
 ]

常见问题 (FAQ)

问: 若某一提、降权配置不合法，会发生什么情况？
答：系统会自动忽略不合法的提、降权规则，其他合法规则照常生效。

问: 用户如何知晓动态提、降权规则的执行效果？
答: 系统会按照请求体参数中的动态提、降权规则顺序，返回其执行效果，包括成功、字段未找到、无效字段类型等信息。详情请查看 Status。

最近更新时间：2026.01.14 14:03:44

这个页面对您有帮助吗？

有用

无用

全域AI搜索

请求参数 #

Conds #

BoostConfig #

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

返回参数 #

ExtraInfo #