双轨知识库方案核心是fastgpt负责检索、dify负责逻辑:部署fda适配器,配置fastgpt api地址与密钥,dify中添加外部知识库并绑定应用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Dify中实现高精度问答效果,同时保留其强大的工作流编排能力,必须绕过Dify原生知识库的检索短板,把FastGPT作为专用RAG引擎接入——这正是双轨知识库方案的核心:FastGPT跑检索,Dify跑逻辑。
部署fda适配器服务
进入任意Linux服务器或本地开发机,确保已安装Docker与docker-compose。这一步操作起来很简单,直接把项目仓库克隆下来就行。
执行命令:git clone https://github.com/yourname/fda.git && cd fda。
修改.env文件中的FASTGPT_API_BASE_URL为你的FastGPT服务地址(例如http://192.168.1.100:3000/api),【务必确认该地址可从Dify所在服务器curl通】。
运行docker-compose up -d启动fda服务,默认监听http://localhost:8000。等待约15秒后,执行curl http://localhost:8000/health返回{"status":"ok"}即表示服务就绪。
在FastGPT中开通OpenAPI并获取知识库ID
登录FastGPT管理后台 → 点击右上角头像 → 进入「API密钥管理」→ 点击「新建API密钥」→ 勾选「知识库读取」权限 → 保存后复制生成的API Key。
打开「知识库」列表页 → 找到目标知识库 → 点击右侧「详情」→ 在URL中截取形如/knowledgeBase/65a1b2c3d4e5f67890123456末尾的32位十六进制字符串,这就是知识库ID。
注意:一个API Key可关联多个知识库ID,但每个知识库ID需单独配置进Dify外部知识库条目中。
在Dify中添加外部知识库并绑定应用
登录Dify控制台 → 进入「知识库」→ 点击「+ 新建知识库」→ 选择「外部知识库」类型。
填写以下三项:
• 名称:随意,建议含“FGPT-”前缀便于识别;
• API Endpoint:填入fda服务地址,例如http://192.168.1.100:8000/v1/vector/search;
• Credentials:格式为{"api_key": "sk-xxx", "knowledge_id": "65a1b2c3d4e5f67890123456"},【json字段名和引号必须严格匹配,少一个双引号都会导致调用失败】。
点击「保存」后,该知识库即出现在列表中,状态显示「已连接」即生效。
进入目标应用编辑页 → 左侧导航点「增强」→ 「知识检索」→ 开启「启用知识检索」→ 在「知识库」下拉框中勾选刚创建的外部知识库 → 保存应用设置。











