الأسئلة الشائعة
إجابات قصيرة عن الأسئلة التي يطرحها المُشغّلون والمُكاملون فعلًا.
هل كاظمة جاهزٌ للإنتاج؟
Section titled “هل كاظمة جاهزٌ للإنتاج؟”إنّ الوكيل النواة، وتنسيق السرب، وبوابات الموافقة البشرية في الحلقة (HITL)، والبوابات منفّذةٌ ومتناسقة داخليًّا. لكن عدّة ميزات للذاكرة/RAG موصولةٌ جزئيًّا فقط (انظر الذاكرة وRAG وخارطة الطريق). تعامل مع طبقة السلامة بوصفها جاهزةً للإنتاج، ومع طبقة الذاكرة بوصفها اختياريّة/تجريبيّة.
ما هي لغة واجهة المستخدم الافتراضيّة؟
Section titled “ما هي لغة واجهة المستخدم الافتراضيّة؟”العربية، باتجاه RTL (agent.language: ar، agent.rtl: true). اضبطها على en للإنجليزيّة. تُبدّل الـ kazma-lang cookie لكلّ متصفّح دون الحاجة إلى إعادة تشغيل.
ماذا يعني «كاظمة»؟
Section titled “ماذا يعني «كاظمة»؟”كاظمة (Kazma) — اسم الإطار الذي يحمله. ينفّذ بروتوكول المجلس (majlis.py) إيقاعات المحادثة العربيّة الخليجيّة.
المُزوّدون والنماذج
Section titled “المُزوّدون والنماذج”أيّ مُزوّدي LLM يعملون؟
Section titled “أيّ مُزوّدي LLM يعملون؟”تُرفق عشرة إعدادات مُسبقة: OpenAI، Anthropic، DeepSeek، Google Gemini (ADC)، xAI، OpenRouter، Ollama، LM Studio، NVIDIA NIM، Custom. أيّ نقطة نهاية متوافقة مع OpenAI تعمل. انظر الإعدادات → الإعدادات المُسبقة للمُزوّدين.
هل أحتاج إلى LiteLLM؟
Section titled “هل أحتاج إلى LiteLLM؟”لا. إنّ models.router: litellm هي سلسلة نصّيّة تتحكّم فقط في فرع النموذج الاحتياطي. كاظمة لا يستورد LiteLLM قطّ. إذا شغّلت وسيط LiteLLM (proxy)، وجّه base_url إلى http://host:4000/v1.
لماذا لا يعمل DEEPSEEK_API_KEY / ANTHROPIC_API_KEY؟
Section titled “لماذا لا يعمل DEEPSEEK_API_KEY / ANTHROPIC_API_KEY؟”إنّهما موجودتان في .env.example لكن لا يقرؤهما أيّ كود. اضبط مفتاحَيْ هذين المُزوّدَيْن عبر قائمة مُزوّدي ConfigStore أو kazma.yaml. لا يوجد سوى OPENAI_API_KEY وKAZMA_API_KEY كقيمتَيْ احتياطٍ عامّتَيْن عبر متغيّرات البيئة.
كيف أُبدّل النماذج بأمان؟
Section titled “كيف أُبدّل النماذج بأمان؟”استخدم set_active_model() (تُبدّل المُزوّد تلقائيًّا) أو واجهة الويب / POST /api/provider/switch. لا تضبط النموذج قطّ دون مُزوّد — فـ get_client() يُصحّح تلقائيًّا، لكنّ الإفصاح الصريح أكثر أمانًا.
كيف أستخدم نموذجًا محلّيًّا؟
Section titled “كيف أستخدم نموذجًا محلّيًّا؟”وجّه المُزوّد إلى Ollama (http://127.0.0.1:11434/v1) أو LM Studio (http://localhost:1234/v1). لا حاجة إلى مفتاح API — تُحقن مفاتيح وهميّة تلقائيًّا.
الذاكرة وRAG
Section titled “الذاكرة وRAG”لماذا لا يتذكّر وكيلي الأشياء؟
Section titled “لماذا لا يتذكّر وكيلي الأشياء؟”استرجاع الذاكرة غير تلقائي. لا يسترجع الوكيل إلا عندما يستدعي memory_search. لا يوجد حقنٌ ولا ترسيخٌ من قصير المدى إلى دائم. انظر الذاكرة وRAG → الحالة الصادقة.
هل «الذاكرة رباعيّة الطبقات» حقيقيّة؟
Section titled “هل «الذاكرة رباعيّة الطبقات» حقيقيّة؟”الكود موجود (swarm/memory/adapter.py) ويعمل، لكنّه يُستخدم فقط من self_improvement.py وphonebook.py — وليس من وكيل المحادثة. يستخدم مسار المحادثة استعلام ChromaDB واحدًا خلف أداة اختياريّة.
هل أحتاج إلى تثبيت ChromaDB؟
Section titled “هل أحتاج إلى تثبيت ChromaDB؟”فقط من أجل الذاكرة المُتجهة. ثبّته عبر pip install -e ".[rag]". بدونه تكون memory_search/memory_store غير متاحة.
لماذا يُذكر tiktoken رغم أنّه ليس تبعيّة؟
Section titled “لماذا يُذكر tiktoken رغم أنّه ليس تبعيّة؟”يستخدم TokenCounter مُكدّس tiktoken إن كان مُثبَّتًا، وإلّا فيلجأ إلى تقدير chars/4. ثبّته بنفسك (pip install tiktoken) للحصول على عدٍّ دقيق.
السلامة وHITL
Section titled “السلامة وHITL”نُفِّذت أداة خطيرة دون سؤال — لماذا؟
Section titled “نُفِّذت أداة خطيرة دون سؤال — لماذا؟”ثلاثة أمور ينبغي فحصها (انظر استكشاف الأخطاء §3):
- هل مرّر
hitl_configإلى بناء الرسم البياني لديك؟ (البناءات المخصّصة عبرcreate_supervisor_graph()دون إمراره = بوابةٌ خاملة.) - هل الأداة في القائمة الخطيرة الصحيحة؟ (ثلاث قوائم: yaml،
_EXTENDED_DANGER،classify_mcp_tool.) - هل
allow_headless_danger=Trueمُضبوط؟ (ينبغي أن يكونFalseفي الإنتاج.)
هل أحتاج إلى KAZMA_SECRET؟
Section titled “هل أحتاج إلى KAZMA_SECRET؟”نعم لأيّ نشرٍ خارج localhost. يحمي /api/approve. بدونه تكون نقاط نهاية الموافقة غير مُصادَق عليها. لا يربط kazma serve على 0.0.0.0 إلّا إذا كان مُضبوطًا.
هل المهارات موقّعة تشفيريًّا؟
Section titled “هل المهارات موقّعة تشفيريًّا؟”نعم. يكتب kazma hub sign توقيع HMAC-SHA256؛ ويتحقّق المُحمِّل منه في الوضع الفاشل المغلق (fail-closed) عبر hmac.compare_digest. انظر المهارات وMCP والأدوات.
هل تُصادَق خوادم MCP؟
Section titled “هل تُصادَق خوادم MCP؟”فقط وسيلة النقل SSE (bearer/ترويسة مخصّصة). أمّا stdio فليس لها مصادقة — عزلها في صندوق رمل (sandbox).
كيف أُشغّل مهمّة متعدّدة العمّال؟
Section titled “كيف أُشغّل مهمّة متعدّدة العمّال؟”kazma swarm dispatch researcher "summarize X"kazma swarm fanout --workers a,b,c --aggregation vote "question"kazma swarm pipeline --workers researcher,builder "build Y"انظر مرجع CLI → swarm.
لماذا انكسر تمرير التسليم (handoff) لديّ بخطأ؟
Section titled “لماذا انكسر تمرير التسليم (handoff) لديّ بخطأ؟”تُحدّ عمليات التسليم عند عمقٍ أقصاه 5 وزيارتَيْن لكلّ عامل (handoff_guards.py). النمط A→B→A→B… محظورٌ عمدًا. أمّا عمليات التسليم للعودة المشروعة A→B→A فتعمل (يُسمح بزيارتَيْن).
هل هناك Prometheus؟
Section titled “هل هناك Prometheus؟”لا. المقاييس في الذاكرة + SQLite. انظر خارطة الطريق.
Docker أم الخادم المجرّد (bare metal)؟
Section titled “Docker أم الخادم المجرّد (bare metal)؟”Docker Compose هو المسار الأساسي. يعمل kazma serve المجرّد لخادم تطوير على مضيف واحد. انظر النشر.
هل يمكنني النشر على Cloudflare Pages / الحافّة (edge)؟
Section titled “هل يمكنني النشر على Cloudflare Pages / الحافّة (edge)؟”لا. كاظمة خدمة Python ذات حالة. لا تحاول تغليفها بأسلوب serverless.
يبدو أنّ بيانيّات Kubernetes غير صحيحة.
Section titled “يبدو أنّ بيانيّات Kubernetes غير صحيحة.”إنّها تنشر خدمة Hub API (PostgreSQL + Redis)، وليس الوكيل الرئيسي. لا تطبّقها للوكيل الرئيسي. انظر النشر §4.
لماذا يربط الحاوي (container) على 0.0.0.0؟
Section titled “لماذا يربط الحاوي (container) على 0.0.0.0؟”مطلوبٌ داخل Docker كي يصل المنفذ المنشور إلى الخدمة. عزل شبكة Docker هو حدّ الأمان (موضّح في تعليق Dockerfile). للخادم المجرّد، استخدم 127.0.0.1 + وسيطًا عكسيًّا (reverse proxy).
التزامن
Section titled “التزامن”تلقّيت «database is locked» — ماذا أفعل؟
Section titled “تلقّيت «database is locked» — ماذا أفعل؟”يُضبط WAL + busy_timeout=5000 في كلّ مكان. من المرجّح أنّ لديك معاملة كتابة طويلة أو اتصالًا ثانيًا. استخدم batch_set() للكتابات متعدّدة المفاتيح واستخدم دائمًا get_config_store(). انظر استكشاف الأخطاء §4.
هل يمكنني تشغيل عدّة عمليّات كاظمة على قاعدة البيانات نفسها؟
Section titled “هل يمكنني تشغيل عدّة عمليّات كاظمة على قاعدة البيانات نفسها؟”غير مُوصى به. يسمح WAL بكاتبٍ واحد. إذا توسّعت أفقيًّا، امنح كلّ عمليّة kazma-data/ الخاصّ بها أو وزّع حسب المستأجر (shard by tenant).
ملاحظات تدقيق الوثائق
Section titled “ملاحظات تدقيق الوثائق”يعكس هذا الأسئلة الشائعة السلوك المُتحقَّق منه. إذا تعارضت إجابةٌ هنا مع نصٍّ أقدم في README، فهذه الأسئلة الشائعة هي الدقيقة وذلك حتى تمّوز/يوليو 2026.