DifyKnowledge

Dify Cloud Knowledge Base implementation.

This class provides integration with Dify Knowledge Base service, implementing the Knowledge interface to enable seamless RAG (Retrieval-Augmented Generation) capabilities with Dify-hosted or self-hosted knowledge bases.

Key features:

• Cloud-hosted or self-hosted Dify deployment support

• Multiple retrieval modes (keyword, semantic, hybrid, fulltext)

• Advanced features like reranking and score filtering

• Conversation history support for context-aware retrieval

• Compatible with Bailian RAG plugin (same Knowledge interface)

Functional Scope: This plugin focuses on retrieval capabilities only, similar to Bailian RAG plugin. Document management (upload/delete/update) should be performed via Dify console.

Example usage:

`// 1. Configure Dify connection
DifyRAGConfig config = DifyRAGConfig.builder()
.apiKey(System.getenv("DIFY_RAG_API_KEY"))
.datasetId("your-dataset-id") // Configure in code
.retrievalMode(RetrievalMode.HYBRID_SEARCH)
.enableRerank(true)
.build();

// 2. Create knowledge base instance
DifyKnowledge knowledge = DifyKnowledge.builder()
.config(config)
.build();

// 3. Retrieve documents
RetrieveConfig retrieveConfig = RetrieveConfig.builder()
.limit(5)
.scoreThreshold(0.5)
.build();

List<Document> results = knowledge.retrieve("query text", retrieveConfig).block();

// 4. Use with agents via built-in RAG configuration
ReActAgent agent = ReActAgent.builder()
.name("Assistant")
.model(chatModel)
.knowledge(knowledge)
.ragMode(RAGMode.AGENTIC)
.build();
`

Note: Document management is not supported via this plugin. Please use Dify console to upload, delete, and manage documents. This design ensures compatibility with Bailian RAG plugin and keeps the plugin focused.