مساحات الأسماء

مساحة الأسماء هي مجموعة مسمّاة من المستندات؛ تُنشئها أول كتابة، وتخصيص واحدة لكل مستخدم يُبقي بيانات المستخدمين منفصلة.

سرد مساحات الأسماء

GET /namespaces

curl "https://api.conare.ai/namespaces?prefix=user-" \
  -H "Authorization: Bearer $CONARE_API_KEY"

await conare.namespaces({ prefix: "user-" });

Response

{
  "namespaces": [
    {
      "name": "user-42",
      "documents": 2,
      "embedding_model": "conare-embed-1",
      "rerank_model": "conare-rerank-1",
      "created_at": "2026-10-21T21:38:52.859567Z",
      "updated_at": "2026-10-21T21:38:52.895Z",
      "last_query_at": "2026-10-21T21:38:54.56266Z"
    }
  ]
}

الخيار	النوع	ما يفعله
`prefix`	string	مساحات الأسماء التي تبدأ أسماؤها بهذه القيمة فقط

الحقل	المعنى
`name`، `documents`	مساحة الأسماء وعدد المستندات التي تحتويها
`embedding_model`، `rerank_model`	النماذج التي تستخدمها
`created_at`	وقت إنشائها؛ وقبل 2026-10-18، وقت كتابة أقدم مستند فيها (`null` إذا لم تحتوِ على أي مستند)
`updated_at`	آخر كتابة فيها
`last_query_at`	آخر بحث فيها، يُسجَّل مرة واحدة في الدقيقة على الأكثر؛ `null` إذا لم يُبحث فيها منذ 2026-10-18

المخطط الكامل: سرد مساحات الأسماء.

جلب مساحة أسماء

GET /namespaces/:namespace يُرجع مساحة أسماء واحدة بالحقول نفسها، أو 404 namespace_not_found.

curl

curl https://api.conare.ai/namespaces/user-42 \
  -H "Authorization: Bearer $CONARE_API_KEY"

المخطط الكامل: جلب مساحة أسماء.

إنشاء مساحة أسماء

POST /namespaces لا تحتاج إليه إلا لنموذج مدرَّب لمؤسستك: أنشئ مساحة الأسماء قبل أول كتابة فيها.

curl

curl https://api.conare.ai/namespaces \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "contracts", "embedding_model": "<your model id>"}'

الخيار	النوع	ما يفعله
`name`	string، مطلوب	من 1 إلى 64 حرفًا من `a-z 0-9 _ -`، يبدأ بحرف أو رقم
`embedding_model`	string	معرّف نموذجك؛ القيمة الافتراضية `conare-embed-1`

يُرجع name وembedding_model وrerank_model؛ وإنشاء مساحة أسماء موجودة مجددًا يُرجع القيم نفسها. المخطط الكامل: إنشاء مساحة أسماء.

حذف مساحة أسماء

DELETE /namespaces/:namespace يحذف مساحة الأسماء وكل مستنداتها وملفاتها المرفوعة؛ ولا يمكن التراجع عن ذلك.

curl -X DELETE https://api.conare.ai/namespaces/docs \
  -H "Authorization: Bearer $CONARE_API_KEY"

await conare.namespace("docs").drop();

Response

{ "deleted": true, "sources_deleted": ["src_01139ca8ca59f2556f65b60e"] }

الخيار	النوع	ما يفعله
`force`	boolean، الافتراضي `false`	حذف المصادر التي تكتب فيها أيضًا

دون force، تُرجع مساحة الأسماء التي يكتب فيها تطبيق مربوط أو حاوية 409 namespace_has_sources، مع معرّفاتها في details.source_ids.
تسرد sources_deleted المصادر المحذوفة معها؛ ويُظهر GET /sources/:id القيمة deleted عند اكتمال حذف كلٍّ منها.

المخطط الكامل: حذف مساحة أسماء.

البدء

الأساسيات

الملفات

المزامنة

النماذج

الأدوات

مساحات الأسماء

سرد مساحات الأسماء

جلب مساحة أسماء

إنشاء مساحة أسماء

حذف مساحة أسماء

​سرد مساحات الأسماء

​جلب مساحة أسماء

​إنشاء مساحة أسماء

​حذف مساحة أسماء

سرد مساحات الأسماء

جلب مساحة أسماء

إنشاء مساحة أسماء

حذف مساحة أسماء