Agent-Lab هو إطار عمل Python سحابي الأصل (cloud-native) لبناء وكلاء LLM ومحاكاتهم
واختبارهم، مبني على FastAPI وLangChain/LangGraph وPostgreSQL. نفّذ pip install btech-agent-lab، ثم وسّع الفئات الأساسية للوكلاء، وجمّع تطبيقاً جاهزاً للإنتاج
باستدعاء واحد لـ create_app() — يشمل REST API وخادم MCP والتخزين الدائم
والمصادقة وقابلية المراقبة عبر OpenTelemetry.
نُظّم التوثيق وفق ما تسعى إلى إنجازه، على نهج إطار عمل Diátaxis: الدروس التعليمية عندما تتعلّم، والأدلة عندما تعمل، والمراجع عندما تحتاج إلى معلومة محددة. اختر مسارك:
| أريد أن… | المسار |
|---|---|
| أبدأ | وكيلك الأول → دليل المطوّر |
| أبني تطبيقاً | دليل المطوّر → مرجع الإعدادات → مرجع REST API → دليل خادم MCP |
| أقيّم وأبحث | دليل الباحث → الاختبارات والمحاكاة |
| أنشر وأشغّل | دليل النشر → قابلية المراقبة → Keycloak → Vault |
| أساهم | دليل المطوّر → نموذج نطاق الكيانات → شكر وتقدير |
الدروس التعليمية
موجّهة نحو التعلّم: اتّبع الخطوات من البداية إلى النهاية دون الحياد عنها.
| الصفحة | الوصف |
|---|---|
| وكيلك الأول | أنشئ هيكل مشروع، وعرّف وكيلاً، واستدعِه عبر REST، وتابع التتبّع، واعرض أداة MCP — في نحو 15 دقيقة. |
الأدلة
موجّهة نحو العمل: لحل المشكلة التي تواجهها الآن.
| الصفحة | الوصف |
|---|---|
| دليل المطوّر | الدليل الرئيسي: نموذجا التطوير، والإعدادات، وحقن التبعيات (DI)، وبناء الوكلاء، وكل نقاط التوسعة. |
| خادم MCP | اعرض الوكلاء لعملاء MCP (Claude Desktop وMCP Inspector)؛ وأضف الأدوات والموجّهات (prompts). |
| الاختبارات والمحاكاة | حزمة اختبارات التكامل باستخدام testcontainers؛ ومحاكاة الوكلاء بأسلوب LLM-as-judge باستخدام Langfuse/LangWatch. |
| دليل الباحث | دفاتر Jupyter والتجارب وبناء نماذج أولية لسلوكيات جديدة للوكلاء. |
| النشر | حزم Docker Compose المحلية وبيئة Kubernetes الإنتاجية باستخدام Terraform وHelm. |
| المصادقة باستخدام Keycloak | إعداد الـ realm والعميل وحساب الخدمة؛ وتدفقات الرموز المميزة (tokens) التي تتوقعها الواجهة البرمجية. |
| الأسرار باستخدام Vault | كيفية تخزين أسرار الإعدادات واسترجاعها وتدويرها. |
| قابلية المراقبة باستخدام Grafana · باستخدام OpenSearch | لوحات معلومات مرجعية لحزمتَي قابلية المراقبة المضمّنتين. |
المراجع
حقائق فقط: دقيقة وشاملة ومولّدة من الشيفرة البرمجية.
| الصفحة | الوصف |
|---|---|
| مرجع الإعدادات | كل مفتاح إعداد ومتغير بيئة، وكيفية اختيار ConfigSource النشط. |
| REST API | الكتالوج الكامل لنقاط النهاية مع أمثلة على الطلبات والاستجابات. |
| نموذج نطاق الكيانات | الكيانات والعلاقات وقواعد بيانات PostgreSQL الثلاث. |
المشروع
| الصفحة | الوصف |
|---|---|
| شكر وتقدير | المساهمون والبرمجيات الخارجية. |
| الترخيص | MIT. |
ما الخطوة التالية؟
هل أنت جديد على Agent-Lab؟ ابدأ بـ وكيلك الأول — شرح عملي كامل قابل للنسخ واللصق، ينتهي بوكيل قيد التشغيل يمكنك التحدث إليه عبر REST وMCP.