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

# المفاهيم الأساسية

> التكاملات، ومُعرّفات المستخدمين النهائيين، وحاويات لكل مصدر، وتعدد المستأجرين المُعتَّم، وأوضاع الاسترجاع الثلاثة: البحث، والاستدعاء العميق، والاقتراحات.

## التكامل

الحد المُستدام بين منتجك وConare. يمتلك التكامل مؤسستك؛ تُعد مراحل النشر المنفصلة (staging، prod) تكاملات منفصلة يميّزها المُعرّف النصي (slug). لكل واحد مفتاحه الخاص `cint_...` بنطاقات صريحة (`memory:read`، `memory:write`، `memory:delete`).

## المستخدمون النهائيون

يذكر كل استدعاء للذاكرة `endUserId` (1–128 حرفاً، `A-Za-z0-9@._-`) — وهو مُعرّفك لمستخدمك. إنه **ليس** مساحة أسماء: المستأجر الفعلي هو HMAC غير شفاف مُشتق من تكاملك ومُعرّف المستخدم النهائي. لا يمكن للعملاء اختيار مساحات الأسماء أو مخاطبة مستأجر آخر، بحكم البنية.

* عيّن الهوية المعروضة عبر `PUT /api/v1/users/{endUserId}` (الاسم/البريد الإلكتروني لعرض لوحة التحكم).
* `DELETE /api/v1/users/{endUserId}` هو مسح كامل بموجب GDPR لذلك المستخدم.

## الحاويات

تُجمِّع الحاويات ذكريات مستخدم واحد حسب المصدر — مثل `profile`، `claude-chats`، `saved`، أو واحدة لكل مصدر بيانات مُتصل (وسم الحاوية = مُعرّف الموصل). استخدم `containerTag` عند الحفظ للتنظيم، و`DELETE /api/v1/containers/{containerTag}` لإسقاط ذكريات مصدر واحد دون المساس بالباقي.

## أوضاع الاسترجاع

| الوضع            | نقطة النهاية               | زمن الاستجابة | ما تحصل عليه                                                                     |
| ---------------- | -------------------------- | ------------- | -------------------------------------------------------------------------------- |
| البحث            | `POST /api/v1/search`      | أقل من ثانية  | مطابقات خام مُرتَّبة (متجه + BM25، مدمجة بـ RRF، معاد ترتيبها). بدون نموذج لغوي. |
| الاستدعاء العميق | `POST /api/v1/recall`      | \~3–6 ثوانٍ   | إجابة مُركَّبة مُدعَّمة بالاستشهادات كنص قابل للحقن في الموجّه.                  |
| الاقتراحات       | `POST /api/v1/suggestions` | \~3–6 ثوانٍ   | حتى 5 إجراءات ملموسة تالية، كل منها مُدعَّم بذاكرة محددة. `[]` للمستخدمين الجدد. |

## الأخطاء والقابلية للملاحظة

تستخدم الأخطاء غلافاً مستقراً — `{ statusCode, code, message, requestId, details? }` — ولا تُسرّب أبداً مُعرّفات المستأجرين الداخلية أو نصوص الواجهة الخلفية. تتضمن كل استجابة `X-Request-Id`؛ أرسل مُعرّفك الخاص للربط الشامل. تُشار حدود المعدل بترويسات قياسية و`429`؛ وخطط دفتر الاستخدام تشير إلى استنفاد المخصص بـ `402` مع بيانات الرصيد وإعادة التعيين.