> ## 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.

# Filtros

> Restrinja uma busca ou exclusão pelos metadados dos documentos com igualdade, $in, intervalos, $and e $or, e regras para comparar texto, números e datas.

Passe um filtro como `filter` para uma [busca](https://docs.conare.ai/pt-BR/query.md) ou uma [exclusão](https://docs.conare.ai/pt-BR/documents.md#excluir-vários) para selecionar documentos pelos seus [metadados](https://docs.conare.ai/pt-BR/write.md#metadados).

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

Chaves lado a lado devem corresponder todas.

## Operadores

| Operador | Corresponde a |
| - | - |
| `{ "key": value }`, `$eq` | Igual ao valor; em um array, contém o valor |
| `$in` | Igual a qualquer valor de uma lista |
| `$ne`, `$nin` | Diferente do valor, ou de todos de uma lista (apenas buscas) |
| `$gt`, `$gte`, `$lt`, `$lte` | Maior que, no mínimo, menor que, no máximo |
| `$and`, `$or` | Todos, ou qualquer um, de uma lista de filtros |

## Exemplos

| Filtro | Corresponde a |
| - | - |
| `{ "tags": "billing" }` | Documentos cujo array `tags` contém `billing` |
| `{ "lang": { "$in": ["en", "de"] } }` | Documentos em inglês ou alemão |
| `{ "$or": [{ "team": "support" }, { "year": { "$in": [2024, 2025] } }] }` | Documentos do suporte, ou qualquer um de 2024 ou 2025 |
| `{ "published_at": { "$gte": "2025-06-01" } }` | Documentos publicados em 1º de junho de 2025 ou depois |
| `{ "file_id": "report.pdf" }` | Um [arquivo enviado](https://docs.conare.ai/pt-BR/files.md) |
| `{ "file_id": "report.pdf", "page": 3 }` | A página 3 desse arquivo |

## Regras

| Regra | |
| - | - |
| Igualdade | Compara como texto: `3`, `3.0` e `"3"` correspondem entre si |
| Intervalos | Números com números, strings com strings, byte a byte; escreva datas em ISO 8601 em um único formato (`2025-06-01` ou `2025-06-01T10:00:00Z`) |
| Nunca em um intervalo | Booleanos, itens de array e strings acima de 222 bytes |
| Chaves ausentes | Um documento sem a chave corresponde a `$ne` e `$nin` |
| Negações | Uma que exclui a maioria dos documentos pode retornar menos resultados que `top_k` |
| Tamanho | Até 256 condições, aninhadas em até 8 níveis; cada `$and`, `$or` e `$in` com vários valores conta como uma |
| Listas | `$in` e `$nin` aceitam até 255 valores |
| Chaves desconhecidas | Não são verificadas: uma chave com erro de digitação não corresponde a nada |
| Erros | Um filtro inválido retorna `400 invalid_filter` |


## Related topics

- [Obter, listar e excluir documentos](https://docs.conare.ai/pt-BR/documents.md)
- [Gravar documentos](https://docs.conare.ai/pt-BR/write.md)
- [turbopuffer API](https://docs.conare.ai/pt-BR/turbopuffer.md)
- [Início rápido](https://docs.conare.ai/pt-BR/quickstart.md)
- [MCP](https://docs.conare.ai/pt-BR/mcp-server.md)


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