Dify集成RAGFlow作为外部知识库

除了自带的知识库功能,Dify还支持集成其他系统的知识库作为外部知识库。当然,前提是该系统实现了Dify外部知识库API。以RAGFlow为例。

RAGFlow

从版本v0.13.0起,RAGFlow开始支持Dify外部知识库API,API地址为/api/v1/dify/retrieval,默认端口是9380

可以通过Postman来测试该API是否运行正常,如下图:

Postman测试对接DifyAPI 1

Postman测试对接DifyAPI 2

参数说明:

  • 请求头Token,即API KEY,可以在个人中心 / API功能中创建:

    RAGFlow API KEY

  • 请求参数knowledge_id,即知识库ID,可以在知识库详情页面中,通过浏览器地址栏查看:

    RAGFlow 知识库ID

    注意:

    API KEY和知识库的创建人必须一致!!!否则调用API会返回如下错误:

    {
        "code": 404,
        "message": "Knowledgebase not found!"
    }
    
  • 参数query,即在检索测试中输入的关键字;

如果出现上述截图中的API返回结果,就说明该API运行正常。接下来,可以尝试在Dify中配置连接RAGFlow。

Dify

首先,进入知识库功能模块,然后,按照如下步骤集成RAGFlow作为外部知识库:

  1. 添加外部知识库API:

    添加外部知识库API

    参数说明:

    • API Endpoint:即上述API地址,但是需要去掉/retrieval部分;
    • API Key:即上述在RAGFlow的个人中心 / API功能中创建的API KEY
  2. 连接外部知识库:

    连接外部知识库

    参数说明:

    • 外部知识库API:选择步骤1添加的RAGFlow
    • 外部知识库ID:即上述在知识库详情页面中看到的c7454afc4b5011f08eb10242ac1200051
  3. 召回测试:

    召回测试

    若出现类似右侧的召回段落,则成功集成RAGFlow知识库!!!

写于 2025年06月17日