Rerank API 怎么接？候选文档、结果映射与重排序验收
Rerank 接在检索之后：把问题和候选文本交给重排序接口，再按返回的原始文档索引取回内容，筛选后送给回答模型。它只能重排收到的候选，不能补回检索漏掉的证据。本文以 Cohere v2 为例，官方资料核对日期为 2026-10-25；云岚API是否支持对应端点、模型和参数，需要按实际渠道另行确认。
先冻结候选，再发重排序请求
还没有候选文本，先完成向量相似度检索与配对检查。已有候选时，保留问题、原始顺序、文档 ID、片段 ID、版本和原文位置；先做访问权限、时效和重复内容检查，再把实际提交顺序编号为 0、1、2…。数据库 ID 不能直接当这个编号。
建议另存一份“本次请求索引 → 文档与片段”的清单。请求发出后，不要一边改清单一边接收结果；同一文档的两个片段也要能分别找到原文。这份清单是接入验收记录，不需要作为自定义字段塞进厂商请求。
query、documents 和 top_n 分别填什么？
Cohere 官方端点为 POST https://api.cohere.com/v2/rerank，以下只是请求体示意。三条文本均为虚构材料，未实际调用，也没有预设排序或分数。
{
"model": "rerank-v5.0-pro",
"query": "蓝灯项目退款需要准备哪些材料？",
"documents": [
"蓝灯项目退款申请需提交订单编号和付款凭证。",
"蓝灯项目客服工作时间为周一至周五。",
"绿灯项目退款需要填写另一份申请表。"
],
"top_n": 2,
"max_tokens_per_doc": 4096
}
query 是实际问题，documents 是待比较的文本列表；top_n 控制返回条数，不是数据库召回数量，也不是回答模型的上下文预算。官方当前默认 max_tokens_per_doc 为 4096，超长文本会截断。因此，大篇幅文档中靠后的关键条款可能没有参与判断。Cohere v2 参数说明
先按原文结构切出可核对的片段，再检查提交文本长度。不要因为请求返回了排序，就声称模型读完了整份合同或 PDF。
返回 index 怎样对应原文？
Cohere 的 results 按重排顺序返回，条目里的 index 指向提交时的 documents，而非新的名次。假设首条返回 index: 2，就取本次清单的第三条；不能把首条结果直接贴到原列表第一条。官方字段定义
接收端至少检查：索引为整数且未越界、同一索引未重复、分数符合当前协议、数量与请求预期一致。top_n 小于候选数时，未返回的候选不等于丢包，也不能把它们补成零分。结构异常先停止拼接上下文，保存脱敏响应排查，避免引用错文档。
分数高，就能直接用作答案吗？
不能。相关分数描述问题与材料的匹配，不证明材料正确、仍然有效，或足以回答全部条件。
Cohere 在 2026-10-21 发布的 Rerank 5 中说明，相关分数经过校准，可跨查询和领域采用一致的阈值。这是该版本的官方说明，不能无条件外推到旧模型或其他厂商；它也不代表“得分 0.9，最终答案就有 90% 的正确率”。Rerank 5 发布说明
业务仍要用代表性问题和人工证据标注选择阈值，并记录模型版本。换版本后重验；没有合格候选时，可以返回证据不足、扩大检索或交给人工，不要强行把第一名当答案。
怎样比较重排前后，才有可用结论？
下载重排序请求与结果验收表，先固定一组问题、候选集合和要保留的证据。包含容易混淆的旧版本、同名项目，以及候选中确实没有答案的问题。人工标注相关性与答案依据后，在同样的输出条数和上下文预算下，分别查看原始顺序与重排顺序。
同一份文档的五个相邻片段占满前五名，可能仍只提供一条证据；不同版本的退款条款同时入选，也可能让后续回答混淆适用条件。这时应回看切片、去重和业务过滤，不只是继续提高阈值。需要多个条件共同成立的问题，还应分别检查每项依据是否保留下来。
记录关键证据是否进入前 N 条、是否挤入不适用材料、是否出现同文档重复片段；再记录耗时和真实计费。不要只挑一个排序变好的问题。典型查询与人工相关性标注也是官方搜索排序评估的基础。Elastic 排序评估说明
模板提供清单和空白 CSV，不自动计算质量分，也没有本站模型效果实测。最终引用 PDF 时继续核对页码与原文证据；输出固定字段时再做JSON 结构及事实验收。费用按账单实际单位核对。
常见问题
top_n 调大，就会补回遗漏的文档吗？
不会。它只增加本次候选中返回的条数；证据未被召回时，应检查检索范围、过滤和切片，而不是只改重排序参数。
接入 rerank，需要重建原来的向量库吗？
Cohere 的重排序读取查询与候选原文，本身不要求重建向量索引；原有检索是否充分仍要另验。换了 embeddings 模型则应按向量空间的规则处理。Cohere Rerank 模型说明
返回了相关片段，就可以自动当引用吗？
仍需核对。Rerank 5 可选的相关片段给出提交原文中的字符位置，不是 PDF 页码，也不是事实认证；映射回原文后，检查上下文条件与适用版本。相关片段说明
在云岚API，把聊天模型名换成 rerank 就能用吗？
不能这样推断。先到云岚API控制台核实渠道是否提供重排序端点、对应模型和字段；本文示例属于 Cohere 官方协议，没有验证云岚API的兼容性、排序效果或价格。