更新时间:2026-11-17 GMT+08:00
分享

重排序

面向企业搜索应用的开发者和算法工程师:在电商搜索、信息检索等场景中,传统文本检索系统在"召回"阶段为兼顾效率,返回结果可能不够精准。使用文本排序(重排序)模型对召回文档进行二次排序,并创建重排序API提供灵活的数据项排序功能,可确保最相关结果优先展示,从而提升用户体验与应用准确率。

面向企业搜索应用的开发者、算法工程师,以及问答系统、推荐系统等场景的建设者:在电商搜索、信息检索、智能问答等场景中,传统文本检索系统在"召回"阶段为兼顾效率,返回结果可能不够精准。使用文本排序(重排序)模型对召回文档进行二次排序,可显著改善以下场景的效果:

应用场景

重排序的作用

智能问答系统(RAG)

对检索出的知识库片段二次排序,优先呈现最相关上下文,提升回答的准确性与可信度

电商搜索

将最符合用户需求的商品置顶,提高点击率、转化率与购物体验

推荐系统

对候选物品按用户意图与上下文重新打分排序,让推荐结果更贴合当前需求

信息检索/知识库检索

在海量召回结果中精准定位相关资料,减少无关干扰

企业文档/工单检索

快速定位相关政策、方案或历史工单,提升办公与运维效率

同时,创建重排序API提供灵活的数据项排序功能,可确保最相关结果优先展示,从而提升用户体验与应用准确率。

前提条件

  • 已在“模型推理 > 在线推理 > 预置服务”页签开通预置服务。详情请见开通预置服务。
  • (可选)如果需要控制服务调用流量,可提前创建自定义接入点,详情请参见创建自定义接入点。
  • 已获取API Key。详情请见管理 API Key。
  • 已获取模型服务的model参数值。详情请见重排序。

支持模型

重排序支持的模型请见重排序。

表1 精选模型

model参数(模型 ID)

支持能力

输入输出限制

默认限流

bge-reranker-v2-m3

重排序

单个列表元素最大输入限制:8192 Token

支持输入类型:文本

支持输出类型:文本

最大输入长度:8K

  • TPM: 20,000
  • RPM: 120

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个大气压下快速萃取。
挑选咖啡豆时,要注意其烘焙日期,新鲜的豆子风味更佳。
咖啡豆的产地主要分布在赤道附近,被称为“咖啡带”。

相关文档

常见错误排查,请参见错误码。

相关文档