مرحبًا بك في كاظمة

كاظمة (Kazma) هي إطار متعدد المنصات لوكلاء الذكاء الاصطناعي المستقلين، مبني على عقل مُشرف عبر LangGraph، وتنسيق السرب، والإرسال متعدد المنصات (Telegram / Discord / Slack / الويب / TUI)، وطبقة مُزوّدات نماذج لغوية متوافقة مع OpenAI — مع دعم من الدرجة الأولى للّغة العربية / RTL وبروتوكول محادثة يحاكي الثقافة الخليجية (المجلس).

هذه الوثائق مرجع مُعاد بناؤه من الصفر ومُتحقَّق من الكود: كل ادعاء وقائعي يمكن تتبّعه إلى المصدر، وكل ما هو غير مُنفَّذ بعد يُشار إليه صراحةً.

البداية السريعة

ثبّت الإطار، واضبط مُزوّدًا واحدًا، وأرسل أول رسالة في أقل من 10 دقائق.

البنية المعمارية

حلقة ReAct للمُشرف، ومخططات تدفق البيانات، وتفاصيل الأنظمة الفرعية.

الإعدادات

كل مفتاح في kazma.yaml، وكل متغير بيئة، ونموذج تجاوز ConfigStore.

الأمان والسلامة

بوابات الموافقة البشرية في الحلقة (HITL) الثلاث، وقوائم الأدوات الخطيرة، وسلوك الإغلاق عند الفشل.

إلى أين تتجه بعد ذلك

• جديد على كاظمة؟ ابدأ بـ البداية السريعة.
• تُقيّم الإطار للإنتاج؟ اقرأ البنية المعمارية، ثم الأمان والسلامة والنشر.
• تُدير نسخة قيد التشغيل؟ انتقل إلى استكشاف الأخطاء وإصلاحها ومرجع CLI.

إرث الاسم

كاظمة كانت منطقة ساحلية قديمة في الكويت — اشتهرت كشبكة واحات حيوية من الآبار المائية وبوابة تجارية استراتيجية تربط حضارات متمايزة. كما كانت موقعًا لـ معركة السلاسل الأسطورية (ذات السلاسل، 633 م)، حيث حطّم التنسيق الصارم الموحّد خطًّا دفاعيًا صلبًا عبر مناورة لامركزية دقيقة.

يرث الإطار هذه المبادئ البنيوية الثلاثة — مُوصوفة بأمانة، كما يُنفّذها الكود اليوم:

• الآبار ← الذاكرة. ذاكرة طويلة الأمد تحتفظ بالسياق عبر الجلسات ويستقي منها الوكيل عندما يحتاج إلى التذكّر. (استرجاع الذاكرة اختياري عبر أداة memory_search — انظر الذاكرة وRAG للاطّلاع على التوصيل الفعلي.)
• البوابة ← التوجيه. مُشرف LangGraph واحد يُوجَّه إلى قنوات عديدة — Telegram وDiscord وSlack والويب وTUI — عبر طبقة مُكيّفات واحدة. (انظر البوابات والمنصات.)
• السلاسل ← الثقة. كل مهارة موقّعة بـ HMAC وكل إجراء خطير يمرّ عبر ثلاث بوابات مستقلة للموافقة البشرية في الحلقة. (انظر الأمان والسلامة.)

أمانة الوثائق: تميّز كاظمة بين ما يفعله الكود اليوم وما تدّعيه النصوص القديمة. الميزات الموصلة جزئيًا فقط تُعلَّم داخل النص تحت عنوان “ملاحظات الحالة الأمينة” — أبرزها في الذاكرة وRAG واستكشاف الأخطاء وإصلاحها.