Dify Knowledge Base icon

Dify Knowledge Base

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

Actions30

Metadata → Unbind Tag

AI-generated

Overview

The node manages metadata tags within the Dify AI knowledge base, specifically allowing users to unbind (remove) a tag from a document in a dataset. This operation is useful when you want to disassociate a specific tag from a document without deleting the tag itself or the document.

Common scenarios include:

  • Cleaning up or reorganizing metadata by removing irrelevant or outdated tags from documents.
  • Managing document categorization dynamically based on changing criteria.
  • Automating workflows where tags are assigned and later removed as part of content lifecycle management.

For example, if a document was incorrectly tagged with "urgent" but no longer requires that label, this node operation can remove that tag association efficiently.

Properties

Name Meaning
Dataset ID The unique identifier of the dataset containing the document.
Tag ID The unique identifier of the tag to be unbound (removed) from the document.
Document ID The unique identifier of the document from which the tag will be unbound.

Output

The output JSON contains the result of the unbind tag operation. Typically, it includes confirmation details such as success status or the updated state of the document's metadata after the tag has been removed.

If the node supports binary data output, it would represent any associated files or attachments related to the metadata operation, but for this operation, the focus is on JSON metadata updates.

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 Knowledge Base API to perform metadata operations.

Troubleshooting

  • Common issues:

    • Invalid or missing Dataset ID, Tag ID, or Document ID will cause the operation to fail.
    • Network or authentication errors if the API key or base URL is incorrect or expired.
    • Attempting to unbind a tag that is not currently bound to the specified document may result in an error or no-op response.

  • Error messages:

    • "The operation "unbindTag" is not supported for resource "metadata": Indicates a misconfiguration or typo in the operation name.
    • Errors related to authorization typically mean the API key is invalid or lacks necessary permissions.
    • "The resource "metadata" is not supported": Means the resource parameter is incorrect or unsupported.

To resolve these:

  • Verify all IDs are correct and exist in the system.
  • Check API credentials and permissions.
  • Ensure the node parameters match the expected values exactly.

Links and References

Discussion