必须开通doubao-seed-2-0-rerank-260512或更高版本模型才能启用Rerank，配置后通过测试检索并查看rerank_score字段验证是否生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认知识库已启用Rerank能力
进入火山引擎「方舟控制台」→「AI 知识库」→ 选择目标知识库 → 点击「配置」标签页，在「检索增强」区域查看「重排序（Rerank）」开关状态。若显示为灰色不可操作，说明当前知识库未开通Rerank服务，需先完成模型授权。
【必须开通 doubao-seed-2-0-rerank-260512 或更高版本 rerank 模型】，否则后续所有配置均无效。该模型不在默认开通列表中，需手动前往「开通管理 >> 大语言模型」单独勾选并提交开通申请。
配置Rerank模型与权重参数
方法一：使用控制台可视化配置
在知识库「配置」页→「检索增强」→「重排序」区域，点击「启用」后出现下拉菜单，选择已开通的 rerank 模型（如 doubao-seed-2-0-rerank-260512）。下方「重排 Top-K」输入框默认为5，建议根据业务场景调整：问答类场景设为3～5，摘要生成类可设为8～12。值过大会增加延迟，值过小可能漏掉关键片段。
方法二：通过API方式精确控制
调用知识库更新接口 PUT /api/v1/kb/{kb_id}，在 request body 的 rerank_config 字段中传入完整参数：
{"enable": true, "model": "doubao-seed-2-0-rerank-260512", "top_k": 5, "rerank_weight": 0.75}
其中 rerank_weight 控制重排结果对最终打分的影响强度，取值范围0.1～0.95。设为0.75表示重排得分占总分75%，原始向量相似度仅占25%；低于0.5时重排效果微弱，高于0.85可能压制语义召回多样性。
验证Rerank是否生效
第一步：在知识库详情页点击右上角「测试检索」按钮
第二步：输入一个存在多义词或长尾表述的查询，例如“合同里甲方违约怎么处理”，观察返回结果顺序
第三步：勾选「显示检索过程」选项，展开每条结果的 detail 字段，查找 rerank_score 字段是否存在且数值不为 null
第四步：对比开启/关闭Rerank前后同一查询的 top1 文档ID是否变化——若ID不同，说明Rerank已介入排序逻辑
注意：rerank_score 值通常在0.3～0.98之间，低于0.4的结果大概率被过滤；若所有结果 rerank_score 都是0.000，则说明模型未加载成功或输入文本被截断。
