الأسئلة الشائعة
إجابات قصيرة على ما يسأله المشغّلون والمكاملون فعلًا.
هل كاظمة جاهزة للإنتاج؟
Section titled “هل كاظمة جاهزة للإنتاج؟”الوكيل الأساسي، تنسيق السرب، بوابات HITL، البوابات، وذاكرة الدردشة (محرك V2 المعرفي — معتقدات ثنائية الزمن + استدعاء PPR لكل دور + auto-store) منفَّذة وموصولة. ثبّت pip install -e ".[rag]" للاسترجاع المتجهي الكامل. اعتبر طبقة الأمان بمستوى إنتاج؛ الذاكرة قابلة للإنتاج على عقدة واحدة مع مراقبة الصحة (انظر الذاكرة وRAG).
ما لغة الواجهة افتراضيًا؟
Section titled “ما لغة الواجهة افتراضيًا؟”العربية، RTL (agent.language: ar, agent.rtl: true). عيّن en للإنجليزية. كوكي kazma-lang يبدّل لكل متصفح بلا إعادة تشغيل.
ماذا تعني «كاظمة»؟
Section titled “ماذا تعني «كاظمة»؟”Kazma باللاتينية؛ العلامة العربية كاظمه (مفضّلة) أو كاظمة. الإملاء كازما خطأ. بروتوكول المجلس (majlis.py) ينفّذ إيقاعات محادثة خليجية.
هل الصوت الحيّ على الويب مكالمة هاتفية (duplex)؟
Section titled “هل الصوت الحيّ على الويب مكالمة هاتفية (duplex)؟”على زر Live في واجهة الويب، نعم إذا كان LiveKit مُعدًّا (LIVEKIT_URL + مفتاح/سر API): يمكنك مقاطعة الوكيل أثناء حديثه. والعقل ما يزال LangGraph (الأدوات/HITL/الذاكرة). أما Telegram/Discord/Slack فتبقى رسائل صوتية. انظر الصوت والوسائط.
هل "barcode" يختار نموذج البرمجة؟
Section titled “هل "barcode" يختار نموذج البرمجة؟”لا. التصنيف يستخدم حدود الكلمات. وmodels.defaults.code الصريح (الإعدادات → النماذج) يتقدم على التوجيه بالكلمات المفتاحية. وKAZMA_MODEL يتقدم على الاثنين.
هل يستطيع خادم MCP جعل كاظمة تنادي الـ LLM (sampling)؟
Section titled “هل يستطيع خادم MCP جعل كاظمة تنادي الـ LLM (sampling)؟”ليس تلقائيًا. مطفأ افتراضيًا (KAZMA_MCP_SAMPLING). عند التفعيل تحصل على بطاقة HITL لمرة واحدة؛ ونداء العيّنة بلا أدوات. انظر المهارات وMCP والأدوات.
هل يمكن تشغيل الوكيل دون خادم الويب؟
Section titled “هل يمكن تشغيل الوكيل دون خادم الويب؟”نعم. kazma ask "…" يشغّل مُشرف LangGraph داخل العملية (بلا uvicorn). وتيارات الـ tokens إلى stdout؛ وأسطر الأدوات إلى stderr. وعلى TTY تنبّه أدوات الخطر y/N. انظر المرجع السريع ومرجع CLI.
كيف أربط Gmail أو Microsoft؟
Section titled “كيف أربط Gmail أو Microsoft؟”انظر تكامل البريد. الـ sandbox يعمل بلا إعداد.
الإعدادات → البريد (/settings?tab=email): OAuth | IMAP | POP لكل مزوّد.
| المزوّد | المُوصى | البدائل |
|---|---|---|
| Gmail | OAuth متصفح (Gmail API) | IMAP/POP بكلمة مرور تطبيق Google |
| Microsoft 365 | OAuth (Graph) أو device-code | IMAP/POP إن سمح المستأجر |
أدوات التعديل تحتاج موافقة HITL. إن أعاد Gmail 403 insufficient scopes أضف نطاقات Gmail وافصل وأعد الاتصال.
كيف تغرّد كاظمة على X؟
Section titled “كيف تغرّد كاظمة على X؟”عبر الـ API الرسمي لـ X فقط — ناشر X. أنشئ تطبيق Read + Write على developer.x.com، وضع مفاتيح OAuth 1.0a الأربعة في الإعدادات → X (لا في المحادثة). ألّف في استوديو X (/x): انشر الآن، جدوِل، أعد الجدولة، قفزات الخيط، احذف. نقرك في تلك الصفحة هو الموافقة. أدوات المحادثة (x_post، x_schedule_post، x_delete_post) ما تزال تحتاج بطاقة HITL (لا يمكن لـ YOLO تجاوزها). كل الجداول في الاستوديو يفتح /scheduled (cron + X معًا)؛ مخطِّط الاستوديو X فقط. مفتاح الإيقاف: KAZMA_X_POST=0.
كيف أجعل الوكيل يبحث في الويب؟
Section titled “كيف أجعل الوكيل يبحث في الويب؟”لا يوجد أمر /research. اسأل في الدردشة أو استخدم /swarm research …. الأدوات: web_search، read_url / read_url_to_file، crawl_site اختياري، digest_research_file. انظر البحث على الويب.
لماذا تُقتطع الصفحة الطويلة؟
Section titled “لماذا تُقتطع الصفحة الطويلة؟”read_url يعيد نافذة (افتراضي 16k، KAZMA_READ_URL_MAX_CHARS) مع offset / max_chars. للصفحة كاملة: read_url_to_file ثم digest_research_file أو read_research_chunk.
المزوّدون والنماذج
Section titled “المزوّدون والنماذج”أي مزوّدي LLM يعملون؟
Section titled “أي مزوّدي LLM يعملون؟”OpenAI، Anthropic، DeepSeek، Gemini (ADC)، xAI، OpenRouter، Ollama، LM Studio، NVIDIA NIM، Custom — وأي نقطة OpenAI-متوافقة. انظر الإعدادات.
هل أحتاج LiteLLM؟
Section titled “هل أحتاج LiteLLM؟”لا. كاظمة لا تنفّذ import litellm أبدًا. يكفي بروكسي اختياري: اضبط KAZMA_LITELLM_URL=http://127.0.0.1:4000 (أو llm.gateway.url). المزوّدون المتوافقون مع OpenAI فقط (OpenAI وDeepSeek وGroq وNIM و…) يمرّون عبره. أما Anthropic / Azure / Bedrock / Gemini فتبقى أصلية. والمحلي Ollama / LM Studio مباشر ما لم يُضبط KAZMA_LITELLM_LOCAL=1. مفتاح الإيقاف: KAZMA_LITELLM=0. ويمكنك كذلك توجيه base_url لمزوّد واحد نحو البروكسي.
لماذا لا يعمل 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 احتياطات env عامة.
كيف أبدّل النماذج بأمان؟
Section titled “كيف أبدّل النماذج بأمان؟”set_active_model() أو الواجهة / POST /api/provider/switch. لا تضبط نموذجًا بلا مزوّد.
كيف أستخدم نموذجًا محليًا؟
Section titled “كيف أستخدم نموذجًا محليًا؟”Ollama (http://127.0.0.1:11434/v1) أو LM Studio (http://localhost:1234/v1). بلا مفتاح API.
الذاكرة وRAG
Section titled “الذاكرة وRAG”لماذا لا يتذكر وكيلي؟
Section titled “لماذا لا يتذكر وكيلي؟”افتراضيًا الذاكرة تلقائية:
- RAG لكل دور يحقن حقائق سابقة (
memory.per_turn_retrieval). - Auto-store يكتب حقائق دائمة بعد كل رد (
memory.auto_store). - يمكن لـ LLM استدعاء
memory_store/memory_searchصراحة.
إن كان الاسترجاع فارغًا: ثبّت .[rag]، تأكد أن صحة الذاكرة ACTIVE، وmemory.enabled=true.
هل «الذاكرة بأربع طبقات» حقيقية؟
Section titled “هل «الذاكرة بأربع طبقات» حقيقية؟”كان ذلك مكدّس V1 (UnifiedMemoryAdapter: Chroma L1 + رسم L2 + FTS5 L3 + sqlite-vec L4، مدموج بـ RRF). أُزيلت V1 في التحوّل من V1 إلى V2. المكدّس الحالي والوحيد هو محرك V2 المعرفي — رسم معتقدات ثنائي الزمن + حلقات من 4 طبقات + استدعاء PPR بمخطط الأنانية المحلي (memory/recall.py:recall()). وهو افتراضي الدردشة للاستدعاء لكل دور، والأدوات، وauto-store، والضغط.
هل أحتاج ChromaDB؟
Section titled “هل أحتاج ChromaDB؟”استدعاء V2 على عقدة واحدة يعمل على sqlite-vec (مُضمَّن عبر الإضافة [rag])، وليس ChromaDB. وعند ضبط KAZMA_DATABASE_URL (أو state DSN للذاكرة) يختار البحث dense تلقائيًا pgvector (KAZMA_PGVECTOR=0 يبقي sqlite-vec). ثبّت pip install -e ".[rag]" للتضمين المحلي (sqlite-vec + sentence-transformers؛ لا يزال chromadb يُسحب لأنواع الـ embedder والـ semantic router). وبدون تضمينات تتدهوّر V2 إلى بحث حلقات FTS5 فقط؛ لوحة صحة الذاكرة تُظهر ما هو متاح.
لماذا يُذكر tiktoken دون اعتماد؟
Section titled “لماذا يُذكر tiktoken دون اعتماد؟”TokenCounter يستخدمه إن وُجد، وإلا chars/4. ثبّته يدويًا للعدّ الدقيق.
الأمان وHITL
Section titled “الأمان وHITL”نُفِّذت أداة خطر بلا سؤال — لماذا؟
Section titled “نُفِّذت أداة خطر بلا سؤال — لماذا؟”- هل مُرِّر
hitl_configلبناء الرسم؟ - هل الأداة على قائمة الخطر الصحيحة؟
- هل
allow_headless_danger=True؟ (يجبFalseفي الإنتاج)
هل أحتاج KAZMA_SECRET؟
Section titled “هل أحتاج KAZMA_SECRET؟”نعم لأي نشر غير localhost. يحمي /api/approve.
هل المهارات موقّعة تشفيريًا؟
Section titled “هل المهارات موقّعة تشفيريًا؟”نعم — HMAC-SHA256 fail-closed. انظر المهارات وMCP.
هل خوادم MCP مصادقة؟
Section titled “هل خوادم MCP مصادقة؟”SSE فقط (bearer/header). Stdio بلا مصادقة — اعزله.
كيف أشغّل مهمة متعددة العمال؟
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"لماذا انكسرت حلقة التسليم؟
Section titled “لماذا انكسرت حلقة التسليم؟”عمق 5 وزيارتان لكل عامل كحد أقصى. انظر تنسيق السرب.
هل يوجد Prometheus؟
Section titled “هل يوجد Prometheus؟”لا. مقاييس في الذاكرة + SQLite. انظر خارطة الطريق.
Docker أم خادم عادي؟
Section titled “Docker أم خادم عادي؟”Docker Compose هو المسار الأساسي. kazma serve للتطوير. انظر النشر.
هل أنشر على Cloudflare Pages / edge؟
Section titled “هل أنشر على Cloudflare Pages / edge؟”لا. كاظمة خدمة Python ذات حالة.
بيانات Kubernetes تبدو خاطئة؟
Section titled “بيانات Kubernetes تبدو خاطئة؟”تنشر خدمة Hub API فقط، ليس الوكيل الرئيسي.
لماذا الحاوية تربط 0.0.0.0؟
Section titled “لماذا الحاوية تربط 0.0.0.0؟”مطلوب داخل Docker. على المعدن استخدم 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().
هل أشغّل عدة عمليات كاظمة على نفس قاعدة البيانات؟
Section titled “هل أشغّل عدة عمليات كاظمة على نفس قاعدة البيانات؟”غير مُستحسن. WAL كاتب واحد. للتوسّع الأفقي: kazma-data/ لكل عملية أو تقسيم بالمستأجر.
ملاحظات تدقيق الوثائق
Section titled “ملاحظات تدقيق الوثائق”هذا FAQ يعكس السلوك المتحقَّق. إن تعارض مع README قديم، هذا FAQ هو الأدق اعتبارًا من v0.10.0+.