要在dify中让天工ai风格知识库检索生效，必须启用混合检索并精准配置关键词权重0.45、top-k=7、最小相似度0.55、启用重排序，且文档须含http码/api路径等硬编号信息，否则无法准确召回“401错误处理”等结构化查询结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中让天工AI（Kimi）风格的知识库检索真正生效，必须绕过默认向量单路路径，强制启用混合检索并精准匹配其对硬编号、错误码、API字段等结构化信息的强依赖特性，否则用户查询“401错误处理”或“/v1/chat/completions参数说明”时，AI会泛泛而谈却漏掉关键原文片段。
确认知识库已绑定天工AI适配内容
进入Dify控制台 → 点击左侧「知识库」→ 选择目标数据集 → 查看「文档列表」页。确认至少存在一份含明确技术标识的内容：如包含HTTP状态码（400/401/429）、API端点路径（/v1/xxx）、JSON字段名（"model", "temperature", "stream"）、或天工官方文档截图中的编号段落（如“3.2.1 身份验证流程”）。【若文档全是泛泛而谈的概述性文字，未出现任何可被关键词精确命中的硬信息，则混合检索失去意义】。
上传缺失文档：点击「添加文档」→ 选择「文件上传」→ 拖入天工AI官方OpenAPI文档PDF、接口变更日志TXT或Swagger JSON导出文件（需含text字段）。
启用混合检索并设置天工场景专用权重
在同个数据集页面 → 点击右上角「设置」图标 → 滚动至「检索设置」区域。
将「检索模式」下拉菜单从默认的「向量检索」切换为「混合检索」。【未手动切换则系统始终只走向量路径，关键词分支完全不触发】。
方法一：点击预设按钮「精确术语查询」→ 关键词权重自动设为0.4，向量权重0.6；此值适用于天工文档中大量存在标准HTTP码、API路径、字段名的场景。
方法二：手动微调至关键词权重0.45、向量权重0.55；该比例在实测中对“429 Too Many Requests”“max_tokens字段作用”类查询召回率提升最显著，因天工文档术语密度高、语义歧义低。
调整高级参数以适配天工知识特征
第一步：点击「高级参数」折叠区右侧的「展开」按钮。
第二步：将「返回片段数量(Top-K)」从默认5改为7。天工文档常含嵌套结构（如错误码表+原因+解决方案+示例），Top-K=5易截断关键组合信息；设为7可确保至少一个完整错误条目（含码、描述、修复动作）被完整纳入融合范围。
第三步：在「最小相似度分数」框中填入0.55。这个值是向量分支的硬过滤线——低于0.55的向量结果直接丢弃，不参与加权；天工API文档语义紧凑，向量得分普遍偏高，0.55能有效剔除无关泛化段落（如“人工智能发展趋势”类引言），同时保留所有技术段落。
第四步：勾选「启用重排序」。天工用户提问高度结构化（如“POST /v1/chat/completions 的 temperature 取值范围？”），重排序能将来自PDF的参数表格、PostgreSQL里的字段约束、API源返回的实时枚举值，在融合后按综合得分重新锚定优先级，避免语义相近但字段错位的结果前置。
触发重建索引并验证三源混合效果
点击页面底部「保存」按钮 → 弹出提示“需重新索引全部文档以应用新策略” → 点击「立即重建索引」。
等待索引状态变为「就绪」后，执行验证：
在知识库详情页点击「测试检索」→ 输入查询词“429错误响应体结构” → 观察返回结果：前3条中必须出现1条来自PDF文档的HTTP状态码表格行、1条来自PostgreSQL中error_schema表的JSON Schema定义、1条来自REST API源的最新mock响应示例。三者缺一不可，否则说明某类数据源未真正接入或未参与混合。
