> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# Фільтри

> Звужуйте пошук або видалення за метаданими документів операторами рівності, $in, діапазону, $and і $or, а також правилами порівняння тексту, чисел і дат.

Передайте фільтр як `filter` у [пошук](https://docs.conare.ai/uk/query.md) або [видалення](https://docs.conare.ai/uk/documents.md#видаліть-кілька), щоб відібрати документи за їхніми [метаданими](https://docs.conare.ai/uk/write.md#метадані).

```json theme={null}
{ "team": "support", "year": { "$gte": 2024 } }
```

Ключі на одному рівні мають збігатися всі.

## Оператори

| Оператор | Збігається з |
| - | - |
| `{ "key": value }`, `$eq` | Дорівнює значенню; для масиву — містить значення |
| `$in` | Дорівнює будь-якому значенню зі списку |
| `$ne`, `$nin` | Не дорівнює значенню або жодному зі списку (лише для пошуку) |
| `$gt`, `$gte`, `$lt`, `$lte` | Більше, не менше, менше, не більше |
| `$and`, `$or` | Усі або будь-який зі списку фільтрів |

## Приклади

| Фільтр | Збігається з |
| - | - |
| `{ "tags": "billing" }` | Документами, чий масив `tags` містить `billing` |
| `{ "lang": { "$in": ["en", "de"] } }` | Англомовними або німецькомовними документами |
| `{ "$or": [{ "team": "support" }, { "year": { "$in": [2024, 2025] } }] }` | Документами команди підтримки або будь-якими за 2024 чи 2025 рік |
| `{ "published_at": { "$gte": "2025-06-01" } }` | Документами, опублікованими 1 червня 2025 року або пізніше |
| `{ "file_id": "report.pdf" }` | Одним [завантаженим файлом](https://docs.conare.ai/uk/files.md) |
| `{ "file_id": "report.pdf", "page": 3 }` | Сторінкою 3 цього файлу |

## Правила

| Правило | |
| - | - |
| Рівність | Порівнюється як текст: `3`, `3.0` і `"3"` збігаються між собою |
| Діапазони | Числа з числами, рядки з рядками, побайтово; записуйте дати в ISO 8601 в одному форматі (`2025-06-01` або `2025-06-01T10:00:00Z`) |
| Ніколи в діапазоні | Булеві значення, елементи масивів і рядки довші за 222 байти |
| Відсутні ключі | Документ без ключа збігається з `$ne` і `$nin` |
| Заперечення | Заперечення, що відсіює більшість документів, може повернути менше результатів, ніж `top_k` |
| Розмір | До 256 умов, вкладеність до 8 рівнів; кожен `$and`, `$or` і багатозначний `$in` рахується як одна |
| Списки | `$in` і `$nin` приймають до 255 значень |
| Невідомі ключі | Не перевіряються: ключ із помилкою не збігається ні з чим |
| Помилки | Недійсний фільтр повертає `400 invalid_filter` |


## Related topics

- [Швидкий старт](https://docs.conare.ai/uk/quickstart.md)
- [Запис документів](https://docs.conare.ai/uk/write.md)
- [turbopuffer API](https://docs.conare.ai/uk/turbopuffer.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.