تتشارك تطبيقات Agent-Lab نموذج نطاق واحداً، معرّفاً في agent_lab/domain/. ويُشغّل
هذا النموذج نفسه مخططات REST API وطبقة التخزين الدائم وبيئة تشغيل الوكلاء —
تعلّمه مرة واحدة وستعرف ما تقرؤه كل نقطة نهاية وما تكتبه.
الكيانات
| الكيان | ما يمثّله |
|---|---|
| Agent | نسخة من وكيل LLM — agent_name، وagent_type (يُتحقق منه مقابل السجل)، وعلامة التفعيل، والطوابع الزمنية. تنفيذ واحد، ونسخ متعددة مُعدّة. |
| AgentSettings | إعدادات بصيغة مفتاح-قيمة لنسخة الوكيل: الموجّهات (قوالب Jinja2)، وأسماء المجموعات، ودرجة الحرارة (temperature)، والقيم المخصّصة. حتى 16,000 حرف لكل قيمة — وهنا يُضبط سلوك الوكيل عبر POST /agents/update_setting. |
| LanguageModel | نموذج لغوي متاح للوكلاء، مع اتصاله بالمزوّد. |
| LanguageModelSettings | معاملات خاصة بكل نموذج (درجة الحرارة، والحد الأقصى للرموز، …)، تُدار عبر نقاط النهاية /llms. |
| Integration | تكامل خارجي (مثل مزوّد ذكاء اصطناعي) وإعداداته. تُخزَّن الأسرار في Vault، وليس في قاعدة البيانات مطلقاً. |
| Message | دورة واحدة من المحادثة: الدور (human / assistant / tool)، والمحتوى، وresponse_data، وروابط سلسلة المحادثة (replies_to). تُخزَّن مع ذاكرة الوكيل عبر نقاط الحفظ في LangGraph. |
| Attachment | ملف مرفق برسالة: المحتوى الخام، والمحتوى المُحلَّل، ومرجع مجموعة التضمينات المستخدمة في الاسترجاع. |
مثال على إعدادات وكيل مخزّنة — الموجّهات والقيم المخصّصة لوكيل المذكرات الصوتية — من notebooks/08_test_agent_type-multiagent-voice-assistant.ipynb:
أين تُخزَّن البيانات
يستخدم Agent-Lab ثلاث قواعد بيانات PostgreSQL (إضافة إلى Redis) — يجري تجهيزها وفق
دليل النشر وتُضبط عبر db.url وdb.vectors و
db.checkpoints (راجع مرجع الإعدادات):
| المخزن | المحتويات |
|---|---|
db.url |
البيانات العلائقية: الوكلاء، والإعدادات، والنماذج، والتكاملات، والرسائل، والمرفقات |
db.vectors |
تضمينات pgvector — البحث المتّجهي والاسترجاع (/attachments/embeddings) |
db.checkpoints |
بيانات نقاط الحفظ في LangGraph — ذاكرة الوكيل عبر التفاعلات |
Redis (broker.url) |
وسيط النشر/الاشتراك (pub/sub) لتحديثات الحالة في العمليات طويلة التشغيل؛ وكذلك تخزين عملاء OAuth الخاصين بـ MCP |
الأمان وإدارة الأسرار
تُدار الأسرار — بيانات اعتماد التكاملات، ومفاتيح API للنماذج، وحمولة الإعدادات نفسها — باستخدام Vault. تخزّن قاعدة البيانات المراجع فقط؛ أما القيم الحساسة فتُسترجع من Vault عند بدء التشغيل وعند الطلب. راجع الأسرار باستخدام Vault ومرجع الإعدادات.