重排序
面向企业搜索应用的开发者和算法工程师:在电商搜索、信息检索等场景中,传统文本检索系统在"召回"阶段为兼顾效率,返回结果可能不够精准。使用文本排序(重排序)模型对召回文档进行二次排序,并创建重排序API提供灵活的数据项排序功能,可确保最相关结果优先展示,从而提升用户体验与应用准确率。
面向企业搜索应用的开发者、算法工程师,以及问答系统、推荐系统等场景的建设者:在电商搜索、信息检索、智能问答等场景中,传统文本检索系统在"召回"阶段为兼顾效率,返回结果可能不够精准。使用文本排序(重排序)模型对召回文档进行二次排序,可显著改善以下场景的效果:
| 应用场景 | 重排序的作用 |
|---|---|
| 智能问答系统(RAG) | 对检索出的知识库片段二次排序,优先呈现最相关上下文,提升回答的准确性与可信度 |
| 电商搜索 | 将最符合用户需求的商品置顶,提高点击率、转化率与购物体验 |
| 推荐系统 | 对候选物品按用户意图与上下文重新打分排序,让推荐结果更贴合当前需求 |
| 信息检索/知识库检索 | 在海量召回结果中精准定位相关资料,减少无关干扰 |
| 企业文档/工单检索 | 快速定位相关政策、方案或历史工单,提升办公与运维效率 |
同时,创建重排序API提供灵活的数据项排序功能,可确保最相关结果优先展示,从而提升用户体验与应用准确率。
前提条件
- 已在页签开通预置服务。详情请见开通预置服务。
- (可选)如果需要控制服务调用流量,可提前创建自定义接入点,详情请参见创建自定义接入点。
- 已获取API Key。详情请见管理 API Key。
- 已获取模型服务的model参数值。详情请见重排序。
支持模型
重排序支持的模型请见重排序。
| model参数(模型 ID) | 支持能力 | 输入输出限制 | 默认限流 |
|---|---|---|---|
| bge-reranker-v2-m3 | 重排序 | 单个列表元素最大输入限制:8192 Token 支持输入类型:文本 支持输出类型:文本 最大输入长度:8K |
|
API说明
模型调用的完整参数列表请见创建重排序。
快速开始
此处以使用BGE-Reranker-V2-M3模型通过Python脚本和Curl命令对文档进行重排序为例,展示重排序模型的基础用法。
import requests
import json
if __name__ == '__main__':
url = "https://api.modelarts-maas.com/v1/rerank" # API地址
api_key = "MAAS_API_KEY" # 把MAAS_API_KEY替换成已获取的API Key
# Send request.
headers = {
'Content-Type': 'application/json',
'Authorization': f'Bearer {api_key}'
}
data = {
"model": "bge-reranker-v2-m3",
"query": "如何冲泡一杯好喝的咖啡?", # input类型可为string或string[]。
"documents": [
"咖啡豆的产地主要分布在赤道附近,被称为‘咖啡带’。",
"法压壶的步骤:1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。",
"意式浓缩咖啡需要一台高压机器,在9个大气压下快速萃取。",
"挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。",
"手冲咖啡的技巧:控制水流速度、均匀注水和合适的水温(90-96°C)是关键。"
]
}
response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)
# Print result.
print(response.status_code)
print(response.text) 效果展示:
手冲咖啡的技巧:控制水流速度、均匀注水和合适的水温(90-96°C)是关键。 法压壶的步骤:1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。 意式浓缩咖啡需要一台高压机器,在9个大气压下快速萃取。 挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。 咖啡豆的产地主要分布在赤道附近,被称为“咖啡带”。
curl -X POST "https://api.modelarts-maas.com/v1/rerank" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MAAS_API_KEY" \
-d '{
"model": "bge-reranker-v2-m3",
"query": "如何冲泡一杯好喝的咖啡?",
"documents": [
"咖啡豆的产地主要分布在赤道附近,被称为‘咖啡带’。",
"法压壶的步骤:1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。",
"意式浓缩咖啡需要一台高压机器,在9个大气压下快速萃取。",
"挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。",
"手冲咖啡的技巧:控制水流速度、均匀注水和合适的水温(90-96°C)是关键。"
]
}' 效果展示:
手冲咖啡的技巧:控制水流速度、均匀注水和合适的水温(90-96°C)是关键。 法压壶的步骤:1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。 意式浓缩咖啡需要一台高压机器,在9个大气压下快速萃取。 挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。 咖啡豆的产地主要分布在赤道附近,被称为“咖啡带”。
建议JDK版本为15+。
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class Rerank {
public static void main(String[] args) throws Exception {
// API 地址
String url = "https://api.modelarts-maas.com/v1/rerank";
String apiKey = "MAAS_API_KEY"; // 请替换为真实 API Key
String modelName = "bge-reranker-v2-m3";
// 构建请求体
String jsonBody = String.format(
"""
{
"model": "%s",
"query": "如何冲泡一杯好喝的咖啡?",
"documents": [
"咖啡豆的产地主要分布在赤道附近,被称为‘咖啡带’。",
"法压壶的步骤:1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。",
"意式浓缩咖啡需要一台高压机器,在9个大气压下快速萃取。",
"挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。",
"手冲咖啡的技巧:控制水流速度、均匀注水和合适的水温(90-96°C)是关键。"
]
}""", modelName);
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
// 构建 HTTP 请求
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer " + apiKey)
.POST(HttpRequest.BodyPublishers.ofString(jsonBody))
.build();
// 发送请求并获取响应
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
int statusCode = response.statusCode();
String responseBody = response.body();
// 控制台输出
System.out.println(statusCode);
System.out.println(responseBody);
}
} 效果展示:
手冲咖啡的技巧:控制水流速度、均匀注水和合适的水温(90-96°C)是关键。 法压壶的步骤:1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。 意式浓缩咖啡需要一台高压机器,在9个大气压下快速萃取。 挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。 咖啡豆的产地主要分布在赤道附近,被称为“咖啡带”。
相关文档
常见错误排查,请参见错误码。