文档中心

Viking AI 搜索

配置 AI 搜索

搜索 API 提降、降权配置（V1）

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

功能概述

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

核心价值

减少手工维护成本，避免权重调整操作中的遗漏情况，赋能业务高效运行。

支持客户将加、降权逻辑与自有业务系统（如库存、营销、风控）集成，实现动态调整，提升业务响应速度。

支持用户粒度的加、降权配置，提升用户体验。

接口升级

为提升接口的扩展性与灵活性，本接口已于 2026 年 4 月 18 日发布 V2 参数格式，强烈建议新接入方直接使用 V2 格式。

平台将长期兼容旧版参数格式，且支持新旧格式在同一请求中混合使用；存量调用方可按需平滑迁移。

新格式详见：搜索 API 提权、降权配置（V2）

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<String> 格式数据
	没有属性，其他属性			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

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

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

Status

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

示例

示例 1 - 电商

示例 2 - 内容社区

示例 3 - 时间提权、降权

诉求：当用户搜索时，

提升热门牌子产品，商家的权重

降低无库存物品的权重

常见问题 (FAQ)

问: 若某一提、降权配置不合法，会发生什么情况？

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

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

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

说明

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

最近更新时间：2026.08.08 18:09:14

这个页面对您有帮助吗？

有用

无用