Attribute Filter

Filter documents by payload field values with boolean logic and comparison operators

Vector search returns similar content regardless of metadata. You need filtering to scope results by category, date, status, etc.

Real applications need faceted search. Users expect to filter by attributes while getting semantic results.

Powerful payload filtering with AND/OR logic, comparison operators (eq, gt, lt, in, contains), and nested field support.

How It Works

Attribute filter is a retriever stage that filters documents by payload field values.

Parse filter conditions and boolean logic

Extract field values from document payloads

Evaluate conditions against field values

Pass/reject documents based on evaluation

Flexible filtering enables faceted search. Boolean logic supports complex conditions.

retriever = client.retrievers.create(stages=[{"type": "attribute_filter", "conditions": [...]}])

Combine search with filtering

LLM-based semantic filtering