# 对文档重排序

根据查询与候选文档的相关性重新排序，取得候选文档的相关性分数和原始位置。

## 前提条件

准备具有 Genesis 权限的个人访问令牌或服务账号 API Key，凭据配置参阅[管理 Genesis 访问凭据](../../../../guides/genesis/api-keys.md#选择凭据类型)。先[查询与选择模型](models.md)，选择重排序模型，并准备查询文本和非空候选文档列表。

## 调用顺序

1. 保留候选文档的原始顺序，使用所选模型、查询文本和候选列表[重排序文档](../../../../reference/api/genesis/text-reranking/rerank.md)。
2. 读取排序结果中的相关性分数和原始文档索引，将结果关联回候选列表。
3. 按应用需要使用返回的排序结果；需要限制返回数量时，按动作页设置数量上限。

## API 操作

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 按相关性重排候选文档 | [重排序文档](../../../../reference/api/genesis/text-reranking/rerank.md) | 已有查询和候选列表后使用，取得排序分数与原始索引。 |

## 结果确认

确认每条排序结果都能关联到原始候选文档，并检查返回数量是否符合请求配置。

## 限制和注意事项

重排序处理请求中提供的候选文档。发送请求前保留候选顺序，避免将返回索引关联到错误的文档。