> ## 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/ar/query.md) أو [حذف](https://docs.conare.ai/ar/documents.md#حذف-عدة-مستندات) لمطابقة المستندات حسب [بياناتها الوصفية](https://docs.conare.ai/ar/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/ar/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/ar/quickstart.md)


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