Atlas · skill

Metadata Filtering

Metadata filtering restricts retrieval using structured fields such as product, date, tenant or access category. It helps search obey explicit constraints that embeddings may not preserve, but correct behavior depends on the filter semantics, where filtering occurs and whether the application enforces the underlying authorization policy.

conceptVector Search

What it is

Each indexed record can carry structured attributes in addition to its text or vectors. A filter expresses allowed values or conditions, such as a date range and product identifier. A search engine may apply filtering before candidate search, during index traversal or after candidates are produced. These choices affect efficiency and recall, particularly for approximate vector search with selective filters. Filtering differs from ranking: it determines eligibility rather than relative preference. A metadata field can encode an access rule, but trusted server-side logic must derive that rule rather than accepting an arbitrary user-provided tenant identifier.

What the work involves

The practitioner defines typed metadata and its source of truth, validates missing values and tests filter combinations. Retrieval evaluations include highly selective conditions and cases with no eligible result. Access tests attempt cross-tenant queries and inspect every search path, not only the main interface. Useful artifacts include the metadata schema, query builder and filter correctness tests. Update workflows must propagate permission or date changes promptly. The application also distinguishes an empty authorized result from a broad search that found material it must not reveal.

Illustrative example

A maintenance assistant retrieves procedures for one factory and a specific equipment revision. The server constructs a filter from the user's allowed factory list and selected revision, then performs vector search within eligible records. Tests include a relevant procedure from another factory and a nearly identical older revision. Neither may enter the generated answer. When the eligible set is small, the team measures approximate-search recall and adjusts the search strategy instead of widening the permission boundary to obtain more results.

Limits and common mistakes

Missing or stale metadata can exclude useful evidence or expose the wrong records. Post-filtering may return too few results even when eligible relevant documents exist. Some engines support different operators or null behavior, so filters need implementation-specific tests. Metadata similarity and ranking cannot replace authorization. The quality criterion combines correct eligibility with adequate retrieval recall, preserving explicit constraints even when relaxing them would produce an apparently better semantic match.

Prerequisites

No prerequisites.

Related skills

Sources and further reading

  • Qdrant filtering

    Official explanation of payload conditions and their role in vector search filtering.

Last updated: 2026-10-10