List Dify knowledge bases and documents, retrieve chunks, and inspect available models through the official Knowledge API.
Dify Knowledge Plugin
Tool plugin for the Dify Knowledge API. It lets you inspect knowledge bases, inspect documents, retrieve chunks, and query the available models used for knowledge-base configuration.
Features
- : list knowledge bases with optional keyword, pagination, permission, and tag filters.
- : list documents in a knowledge base with optional keyword, status, and pagination filters.
- : retrieve normalized chunk results from a knowledge base.
- : query available Dify models by type, especially and for knowledge-base setup.
Credentials
- : Dify Knowledge API base URL. Both and are accepted. The plugin normalizes the latter to .
- : Dify Service API key with access to the target workspace knowledge resources.
Getting Credentials
Open the Service API panel in Dify, then copy the API endpoint into the plugin field.
Click in the Service API panel, then copy the key from the API key dialog into the plugin field.
Tool Reference
Used to inspect available knowledge bases before retrieval or document lookup.
- : optional name filter.
- : optional page number, defaults to .
- : optional page size, defaults to .
- : optional flag to include all visible knowledge bases regardless of permission scope.
- : optional comma-separated list or JSON array string of tag ids.
Getting
Open a knowledge base in Dify and copy the UUID between and from the browser address bar.
Used to inspect documents inside a specific knowledge base.
- : required knowledge base id.
- : optional document-name filter.
- : optional status filter.
- : optional page number, defaults to .
- : optional page size, defaults to .
Used to retrieve relevant chunks from a specific knowledge base.
Optional retrieval parameters only affect the current request and are not saved to the knowledge base. If an optional retrieval parameter is left empty, Dify uses the retrieval configuration already saved in that knowledge base.
- : required knowledge base id.
- : required search query.
- : optional retrieval-method override for internal knowledge bases.
- : optional result-count override.
- and : optional similarity-threshold overrides.
- and : optional reranking overrides for internal knowledge bases.
- and : required when is . Available values can be obtained from with .
- , , and : optional hybrid-search weight overrides.
- : optional comma-separated list or JSON array string of attachment ids.
Wraps Dify's "Get Available Models" endpoint: .
- : required model type. Supported values are , , , , , and .
- Output: normalized provider groups with , total , and each provider's list.
Notes
- The model-list tool is mainly useful when you need to know which or values can be used in knowledge-base configuration.
- The retrieval tool only sends retrieval-model overrides when you explicitly provide them. These overrides are request-scoped and do not change the saved knowledge-base configuration.
- CSV strings like and JSON array strings like are both accepted for list-style parameters such as and .
Support
If this plugin is helpful, a GitHub Star is appreciated. For bugs, questions, or feature requests, please open an Issue with your Dify version, plugin version, and the steps to reproduce the problem.