Connect to an External Knowledge Base

To enhance content retrieval accuracy, some teams opt to develop their own retrieval algorithms or host knowledge bases on cloud service providers (such as AWS Bedrock). As a neutral LLM application development platform, Dify is committed to empowering developers with greater flexibility in choosing knowledge bases.

Dify offers functionality to connect to external knowledge bases via API, providing developers with diverse options for knowledge base selection and content expansion. Text resources from external knowledge bases can be seamlessly integrated into Dify's AI application ecosystem, enhancing the breadth and depth of application knowledge.

Here are the detailed steps for connecting to external knowledge:

1. Create a Compliant External Knowledge Base API

Create a compliant External Knowledge Base API before setting up the API service, please refer to Dify's External Knowledge Base API specifications to ensure successful integration between your external knowledge base and Dify.

2. Add External Knowledge API

Currently, when connecting to external knowledge bases, Dify only supports retrieval permissions and does not support optimization or modification of external knowledge bases. Developers need to maintain external knowledge bases themselves.

Navigate to the "Knowledge" page, click "External Knowledge API" in the upper right corner, then click "Add External Knowledge API". Follow the page prompts to fill in the following information:

  • Name Customizable name to distinguish different external knowledge APIs;

  • API Endpoint The URL of the external knowledge base API endpoint, e.g., api-endpoint/retrieval; refer to the External Knowledge API for detailed instructions;

  • API Key Connection key for the external knowledge, refer to the External Knowledge API for detailed instructions.

3. Connect to the External Knowledge Base

Go to the "Knowledge" page, click "Connect to an External Knowledge Base" under the Add Knowledge Base card to direct to the parameter configuration page.

Fill in the following parameters:

  • Knowledge base name & description

  • External Knowledge API

    Select the external knowledge base API associated in step 2; Dify will call the text content stored in the external knowledge base through the API connection method.

  • External knowledge ID

    Specify the particular external knowledge base ID to be associated, refer to the external knowledge base API definition for detailed instructions.

  • Retrieval Setting

    Top K: When a user sends a question, it will request the external knowledge API to obtain highly relevant content chunks. This parameter is used to filter text chunks with high similarity to the user's question. The default value is 3; the higher the value, the more text chunks with relevant similarities will be retrieval.

    Score Threshold: The similarity threshold for text chunk filtering, only recalling text chunks that exceed the set score. The default value is 0.5. A higher value indicates a higher requirement for similarity between the text and the question, expecting fewer recalled text chunks, and the results will be relatively more precise.

4. Test External Knowledge Base and Retrieval Results

After connected with the external knowledge base, developers can simulate possible question keywords in the "Retrieval Testing" to preview text chunks that might be retrieval. If you are unsatisfied with the retrieval results, try modifying the External Knowledge Base Settings or adjusting the retrieval strategy of the external knowledge base.

5. Integrating External Knowledge base in Applications

  • Chatbot / Agent type application

    Associate the external knowledge base in the orchestration page within Chatbot / Agent type applications.

  • Chatflow / Workflow type application

    Add a "Knowledge Retrieval" node and select the external knowledge base.

6. Manage External Knowledge

Navigate to the "Knowledge" page, external knowledge base cards will list an EXTERNAL label in the upper right corner. Select the knowledge base needs to be modified, click "Settings" to modify the following information:

  • Knowledge base name and description

  • Permissions

    Provide "Only me", "All team members", and "Partial team members" permission scope. Those without permission will not be able to access the knowledge base. If you choose to make the knowledge base public to other members, it means that other members also have the rights to view, edit, and delete the knowledge base.

  • Retrieval Setting

    Top K: When a user sends a question, it will request the external knowledge API to obtain highly relevant content segments. This parameter is used to filter text chunks with high similarity to the user's question. The default value is 3; the higher the value, the more text chunks with relevant similarities will be recalled.

    Score threshold: The similarity threshold for text chunk filtering, only recalling text chunks that exceed the set score. The default value is 0.5. A higher value indicates a higher requirement for similarity between the text and the question, expecting fewer recalled text chunks, and the results will be relatively more precise.

The "External Knowledge API" and "External Knowledge ID" associated with the external knowledge base do not support modification. If modification is needed, please associate a new "External Knowledge API" and reset it.

FAQ

How to Fix the Errors Occurring When Connecting to External Knowledge API?

Solutions corresponding to each error code in the return information:

Last updated