Dify Knowledge Base icon

Dify Knowledge Base

Manage Dify AI knowledge base datasets, documents, segments, and metadata with comprehensive CRUD operations

Actions30

Dataset → List

AI-generated

Overview

The node manages datasets within the Dify AI knowledge base platform, specifically allowing users to list datasets. This operation is useful for retrieving an organized collection of datasets that have been created or are available in the knowledge base. Typical use cases include fetching datasets for review, further processing, or integration with other workflows.

For example, a user might want to list all datasets to display them in a dashboard or to select one for updating or analysis.

Properties

Name Meaning
Additional Fields Optional parameters to customize the listing:
- Page The page number for pagination (which set of results to retrieve).
- Limit Maximum number of dataset results to return per request (minimum 1).

Output

The output consists of JSON data representing the list of datasets retrieved from the Dify AI knowledge base. Each item in the output array corresponds to a dataset object with its associated properties as returned by the API.

If the node supports binary data output, it is not indicated here; thus, the output is purely JSON-based.

Dependencies

  • Requires an API key credential for authenticating requests to the Dify AI knowledge base service.
  • Needs the base URL of the Dify API configured in the node credentials.
  • Relies on the external Dify API endpoints to perform dataset listing operations.

Troubleshooting

  • Common issues:
    • Invalid or missing API key can cause authentication failures.
    • Incorrect base URL configuration may lead to connection errors.
    • Requesting a page number or limit outside valid ranges could result in empty or error responses.
  • Error messages:
    • "The operation "list" is not supported for resource "dataset": Indicates a misconfiguration of the operation or resource parameters.
    • Network or authorization errors typically indicate credential or connectivity problems.
  • Resolutions:
    • Verify API key and base URL correctness in credentials.
    • Ensure pagination parameters are within acceptable bounds.
    • Check network connectivity and API availability.

Links and References

Discussion