# 功能概述该功能通过API接口实现动态提、降权配置功能，允许用户在请求中直接指定字段、操作符、值及权重强度（\-1 到 1之间），从而实时调整推荐结果的排序权重。其解决了此前仅能通过控制台手工进行权重调整的问题。 # 核心价值 1. 减少手工维护成本，避免权重调整操作中的遗漏情况，赋能业务高效运行。 2. 支持客户将提、降权逻辑与自有业务系统（如库存、营销、风控）集成，实现动态调整，提升业务响应速度。 3. 支持用户粒度的提、降权配置，增强个性化推荐能力，提升用户体验。 ## 使用场景 1. 电商平台：当用户点击某电子产品的主页时，下次推荐请求可通过 API 动态提升相关牌子产品的权重，使其优先推荐给用户。 2. 内容平台：当用户新关注某一作者，下次推荐请求平台可利用API提升同作者文章的权重，满足用户的短期阅读兴趣需求。 3. 营销场景：在促销活动期间，平台可通过API 动态提升促销商品的权重，提高其曝光度。本文将详细介绍如何通过API请求参数实现动态提、降权配置。 --- # API 配置 :::tip 前置条件需要已经成功集成 AI搜索引擎推荐接口能力，请参考 [Recommend - 个性化推荐](/docs/85296/1788543)。 ::: 在**推荐请求时**，在请求体（Request Body）中添加顶层字段 `conditional_boost`。平台会自动融合控制台和接口的提权、降权规则配置。 ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** | |---|---|---|---| |conditional_boost |Array <**Conds**\> |**`必选`** |见下： [Conds](/docs/85296/2123292#ca81d523) | ### Conds :::tip 自动止损能力如果某个配置不合法，服务将会自动忽略单一提权、降权规则，来确保其他合法规则照常生效。 ::: |**参数名** |**数据格式** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |conds |Array <**BoostConfig**\> |**`必选`** |见下： [BoostConfig](/docs/85296/2123292#38cf87d9) |**提权、降权配置**|\ | | | | |平台只针对符合条件的物品提权、降权。 | |boost |Float |**`必选`** |0.3、\-0.3 |**提权、降权强度**|\ | | | | |支持 \-1 到 1 区间的任何数值。 | #### BoostConfig |**参数名** |**数据格式** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |field |String |**`必选`** |"author" |**条件字段**|\ | | | | |提权、降权条件判断的字段。|\ | | | | |:::tip 嵌套字段|\ | | | | |可以利用`.`来配置，例如：`category.name`|\ | | | | ||\ | | | | |:::| |op |String |**`必选`** |"must" |**算子**|\ | | | | |每个字段类型所支持的算子，见下：[字段—算子—条件值配置](/docs/85296/2123292#6099735e) | |conds |根据 field 字段 |**`必选`** | |**条件值**|\ | | | | |提权、降权条件判断值的集合。每个字段类型和算子所支持的值，见下：[字段—算子—条件值配置](/docs/85296/2123292#6099735e) | ### **字段—算子—** 条件值**配置** |**字段类型 (field)** |**字段属性** |**支持算子 (op)** |**条件值输入 (conds)** | |---|---|---|---| |**Int32** |没有属性，其他属性 |* equal（等于）| Int32 格式数据 |\ | | |* not_equal（不等于）| |\ | | |* lte（小于等于）| |\ | | |* lt（小于）| |\ | | |* gte（大于等于）| |\ | | |* gt（大于） | | |**Int64** |没有属性，其他属性 |* equal（等于）| Int64 格式数据 |\ | | |* not_equal（不等于）| |\ | | |* lte（小于等于）| |\ | | |* lt（小于）| |\ | | |* gte（大于等于）| |\ | | |* gt（大于） | | |^^|时间戳|* before（早于）|UNIX 时间戳 |\ | |上新时间 \- UNIX 格式 |* after（晚于） | | |^^|^^|* within（在区间） |* `Xd`（X 天）|\ | | | |* `Xh`（X 小时）|\ | | | |* `Xm`（X 分钟） | |**Float** |不支持属性 |* lt（小于）|Float 格式数据 |\ | | |* gt（大于） | | |**String** |没有属性，其他属性 |* must（包含）|Array 格式数据 |\ | | |* must_not（不包含） | | |^^|^^|* equal（等于）|String 格式数据 |\ | | |* not_equal（不等于） | | |^^|上新时间 |* before（早于）|UNIX 时间戳 |\ | | |* after（晚于） | | |^^|^^|* within（在区间） |* `Xd`（X 天）|\ | | | |* `Xh`（X 小时）|\ | | | |* `Xm`（X 分钟） | |**Array(String)** |没有特殊属性 |* must（包含）|Array 格式数据 |\ | | |* must_not（不包含） | | |**Array(Int)** |没有特殊属性 |* must（包含）|Array 格式数据 |\ | | |* must_not（不包含） | | |**Array(Float)** |

|||\ | |暂时不支持

| | |\ | | | | | |**Array(Object)** |

|||\ | |暂时不支持

| | |\ | | | | | |**Boolean** |

|||\ | |暂时不支持

| | |\ | | | | | --- ## 返回参数系统会返回经过权重调整后的推荐排序结果，同时通过 `extra_info`字段，返回动态提、降权规则的执行状态。 ### ExtraInfo > 了解更多，请查看推荐接口： [ExtraInfo](/docs/85296/1788543#09fcad10) |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |boost_status |Array |`["success", "field not found", "invalid operator"]` |**提权、降权规则的执行状态**|\ | | | |状态含义，见下：[Status](/docs/85296/2123292#49cb8580)|\ | | | |:::tip|\ | | | |顺序**严格遵守 ** [Conds](/docs/85296/2123292#ca81d523) **参数内的 ** [BoostConfig](/docs/85296/2123292#38cf87d9) **顺序**；|\ | | | |例如：第一个 [BoostConfig](/docs/85296/2123292#38cf87d9) 配置执行成功，`boost_status`内的第一个状态会是 `"success"`|\ | | | ||\ | | | |:::| #### Status |**状态值** |**执行状态** |**含义** | |---|---|---| |success |✅ 成功 |**规则配置符合预期**|\ | | |提权、降权规则成功在当次请求中生效。 | |field not found |❌ 失败 |**字段（** **`field`** **）校验失败。** |\ | | |确保配置字段存在物品数据集中 | |invalid field type |❌ 失败 |**字段（** **`field`** **）数据格式不支持提、降权。** |\ | | |目前 Array 、Array 、Boolean 字段不支持提、降权规则。|\ | | |确保字段类型符合预期，详情见： [字段—算子—条件值配置](/docs/85296/2123292#6099735e) | |invalid date field |❌ 失败 |**字段（** **`field`** **）不是时间属性**|\ | | |条件值输入 (`conds`）利用了时间属性配置格式，但是字段（`field`）没有配置为「时间戳」或「上新时间」。 | |invalid operator |❌ 失败 |**字段（** **`field`** **）合法但是配置的算子（** **`op`** **)不合法。** |\ | | |确保算子配置符合预期，详情见： [字段—算子—条件值配置](/docs/85296/2123292#6099735e) | |invalid conds |❌ 失败 |**字段（** **`field`** **）和算子（** **`op`** **)合法，但是条件值输入(** **`conds`** **)不合法。** |\ | | |以下是可能原因： |\ | | ||\ | | |1. 数据格式错误|\ | | |2. 字段配置了「时间戳」或「上新时间」属性|\ | | ||\ | | |确保条件值输入符合预期，详情见： [字段—算子—条件值配置](/docs/85296/2123292#6099735e) | |invalid boost |❌ 失败 |**提权、降权强度配置不合法。** |\ | | |确保输入在 \-1 到 1 的区间内的数字。 | --- # 示例 ```mixin-react return ( ); ``` --- # 常见问题 (FAQ) **问: 若某一提、降权配置不合法，会发生什么情况？** 答：系统会自动忽略不合法的提、降权规则，其他合法规则照常生效。 **问: 用户如何知晓动态提、降权规则的执行效果？** 答: 系统会按照请求体参数中的动态提、降权规则顺序，返回其执行效果，包括成功、字段未找到、无效字段类型等信息。详情请查看 [Status](/docs/85296/2123292#49cb8580)。

全域AI搜索