必须对接Cohere官方API才能用其rerank-v3模型提升多语言检索效果,它支持100+语言语义对齐,MRR@3从0.58升至0.82;需确保API密钥地域为us-east-1或eu-west-1,Endpoint填cohere.com/v1/rerank,启用Hybrid检索并设关键词权重40%、向量权重60%,手动添加多语言同义词,Top K设为20。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Dify中用Cohere Rerank显著提升多语言知识库(如中英混杂、日文术语、西班牙语政策文档)的检索相关性,必须绕过默认BGE本地模型限制,直接对接Cohere官方API——它原生支持100+语言细粒度语义对齐,实测在跨语言查询“如何申请日本签证”匹配中文指南、日文官网原文、英文FAQ三路结果时,MRR@3从0.58跃升至0.82。
确认Cohere API密钥与地域可用性
登录Cohere控制台 → 进入API Keys页 → 点击「Create API Key」生成新密钥。
右上角地域标识【必须为us-east-1或eu-west-1】,其他区域(如ap-southeast-1)暂不支持rerank-v3多语言模型,否则后续调用会返回404错误且无明确提示。
复制密钥字符串后立即保存到安全位置;该密钥无法二次查看,丢失需重新生成。
在Dify知识库设置中启用Cohere Rerank
进入Dify控制台 → 知识库 → 选择目标多语言知识库 → 点击「设置」→ 滚动至「检索设置」区域。
开启「启用重排序」开关 → 在「重排序模型」下拉菜单中选择「Custom API Endpoint」。
【Endpoint URL必须填cohere.com/v1/rerank】,不能加https://前缀,也不能带任何查询参数(例如?version=xxx),填错会导致请求被静默拒绝,后台无报错日志。
粘贴刚获取的Cohere API密钥到「API Key」字段 → 点击「保存」。系统将自动发起连接测试:若出现红色提示“Failed to validate endpoint”,说明密钥无效、地域不匹配或网络策略拦截,需退回第一步核对。
配置混合检索策略适配多语言场景
仅启用Rerank不够,多语言知识库需前置混合检索增强召回。以下步骤必须按顺序执行:
第一步:进入「应用编排」→ 找到对应检索节点 → 展开「检索配置」→ 将「检索模式」设为「Hybrid」。
第二步:设置权重比例 → 「关键词检索权重」调至【40%】,「向量检索权重」设为60%;原因在于多语言文档中专有名词(如“VISA”“ビザ”“visa”)常以不同形态共存,关键词匹配能强制捕获这些变体,避免纯向量检索因分词器差异漏检。
第三步:在「关键词增强」栏手动添加核心术语同义词组,例如输入“签证”→ 添加“VISA、ビザ、visa、permiso de entrada”,每行一个变体;这一步直接提升非英语查询的初始召回覆盖率。
第四步:设置「Top K」为20;该值需与Cohere rerank-v3的batch处理能力匹配,低于15会导致重排信息损失,高于25将显著增加端到端延迟且收益递减。


















