نقل الوكلاء الذكيين من التصميم المرئي إلى بيئة الإنتاج بخطوة واحدة
إطار للوكلاء الذكيين وخدمة نشر تحوّل الوكيل المصمَّم مرئيًا إلى خدمة تعمل وتُنشر بشكل مستقل في كل بيئة.
- الشريك
- شركة استشارات عالمية
- المدة
- من أكتوبر 2024 إلى يناير 2026
- أنواع من الوكلاء
- 5
- المحادثة، وتوليد المحتوى، وتحليل البيانات، والعام، وCrewAI
- أنواع من المكونات الفرعية
- 8
- الذاكرة، وRAG، وضوابط الحماية، والأدوات، والبحث على الويب، والسلاسل
- حتى النشر
- خطوة واحدة
- من التصميم إلى نقطة نهاية تعمل في كل بيئة
التحدي
كان بوسع الفرق بناء نماذج أولية للوكلاء الذكيين، لكن كل وكيل يحتاج إلى التشغيل الفعلي كان يتحول إلى مشروع هندسي مستقل: شيفرة جديدة، وبنية تحتية جديدة، وعملية نشر جديدة.
ما بنيناه
إطار مكونات لتركيب الوكلاء الذكيين مرئيًا، وخدمة نشر تجهّز كل وكيل في حاوية خاصة به عبر البنية التحتية كرمز برمجي. وتتابع خدمة النشر عملية النشر وتسجّل نقطة النهاية العاملة للبيئة المختارة.
ما تم تسليمه
- خمسة أنواع من الوكلاء وثمانية مكونات فرعية قابلة لإعادة الاستخدام، تُجمع في سير عمل دون كتابة شيفرة جديدة
- سير عمل يُختبر داخل المنصة قبل إصداره، ثم يُنشر لكل بيئة
- كل وكيل منشور يعمل خدمةً مستقلة بذاكرته وبحثه المعرفي وأدواته
نبذة عن الشريك
شريكنا شركة استشارات عالمية تعمل فرقها مع كميات كبيرة من المستندات وجداول البيانات وقواعد البيانات والبريد الإلكتروني. وأراد منصة داخلية واحدة تبني فيها هذه الفرق بنفسها خطوط معالجة البيانات والوكلاء الذكيين، بدلًا من طلب تطبيق جديد لكل حاجة. وكان على المنصة أن تعمل داخل بيئة Microsoft 365 وAzure لدى الشريك، وأن تُبقي عمل كل فريق منفصلًا، وأن تنقل العمل من التجربة إلى بيئة الإنتاج عبر بيئات مضبوطة.
التحدي
كل وكيل كان مشروعًا
كان نقل وكيل من نموذج أولي إلى بيئة الإنتاج يعني كتابة تطبيق، وتجهيز البنية التحتية، وربط الذاكرة والتخزين وبيانات الاعتماد يدويًا. وكانت كلفة هذا العمل هي التي تحدد الأفكار التي تُجرَّب.
الوكلاء يحتاجون إلى أكثر من نموذج
يجمع الوكلاء المفيدون بين الذاكرة والبحث في المستندات وضوابط الحماية والبحث على الويب والأدوات. وكانت كل تركيبة تُبنى على حدة، دون بنية مشتركة يُعاد استخدامها.
بيئة الإنتاج تحتاج إلى حدود
كان على الوكيل المنشور أن يعمل بمعزل عن المنصة نفسها، بموارده ومصادره المسموح بها وبيئته الخاصة، حتى لا يؤثر وكيل فريق في وكيل فريق آخر.
الأهداف
- إتاحة تركيب الوكلاء للفرق من أجزاء قابلة لإعادة الاستخدام بدلًا من كتابة شيفرة جديدة
- اختبار سير العمل داخل المنصة قبل إصداره
- نشر الوكيل في بيئة مختارة بإجراء واحد
- تشغيل كل وكيل منشور خدمةً معزولة تُدار بشكل مستقل
- تسجيل حالة النشر ونقطة النهاية العاملة على سير العمل
دورنا
تولّت كارسنترك القيادة التقنية والبنية المعمارية ضمن فريق هندسي متعدد التخصصات، وأسهمت مباشرة في التنفيذ. وبُنيت المنصة على مدى 16 شهرًا، من أكتوبر 2024 إلى يناير 2026، بواجهة خلفية مبنية على Python وFastAPI على Azure.
النطاق والجدول الزمني
شمل العمل إطار مكونات الوكلاء، ومنسّق سير العمل، وخدمة النشر وتكاملها مع خدمة نشر قائمة على البنية التحتية كرمز برمجي. وبُني الإطار بين فبراير وسبتمبر 2025، والنشر بخطوة واحدة بين يونيو وسبتمبر 2025.
المنهجية
مكونات بعقد واحد
ينفذ كل وكيل وكل مكون فرعي الواجهة نفسها: التهيئة، والتنفيذ، والتنظيف. وتُنشئ أداة إنشاء (factory) المكون المناسب من إعداداته، فلا تتطلب إضافة نوع جديد من الوكلاء أي تغيير في المنسّق.
مخطط بياني، لا نص برمجي متسلسل
يُحوَّل سير العمل إلى مخطط بياني في LangGraph. وتعيد المكونات أوامر تخبر المخطط بالخطوة التالية، ما يتيح التسلسلات الثابتة والتوجيه الذي يقرره النموذج معًا.
النشر بوصفه بنية تحتية
بدلًا من تشغيل الوكلاء المنشورين داخل المنصة، يُجهَّز كل منها في حاوية خاصة به عبر خدمة نشر قائمة على Pulumi. وهذا يُبقي حدود الموارد والتوسع والأعطال منفصلة لكل وكيل ولكل بيئة.
التنفيذ
إطار الوكلاء
تشترك خمسة أنواع من الوكلاء في أساس واحد: المحادثة، وتوليد المحتوى، وتحليل البيانات، والعام، وCrewAI. وترتبط بالوكيل ثمانية أنواع من المكونات الفرعية (السلاسل، وسلاسل LangSmith، وضوابط الحماية، وقاعدة المعرفة، والذاكرة، وRAG، والأدوات، والبحث على الويب)، لكل منها حالته الخاصة.
خدمة النشر
يسجّل طلب النشر البيئة، ومستوى الخدمة، وخيار التوسع التلقائي، والمصادر المسموح بها. وتطلب الخدمة حاوية من خدمة النشر، ثم تتحقق من حالتها كل خمس ثوانٍ لمدة تصل إلى عشرين دقيقة. وتُخزَّن النتيجة، أي تم النشر أو فشل النشر، مع عنوان URL العامل على نسخة سير العمل الخاصة بتلك البيئة.
تشغيل الوكلاء
يعمل الوكلاء المنشورون على إطار Agno، مع PostgreSQL للذاكرة والجلسات، وRedis لبث المخرجات، وWeaviate للبحث المعرفي، إضافة إلى أدوات البحث واستخراج البيانات من الويب. ويمكن إلغاء نشر الوكلاء بالسلاسة نفسها التي تُنشر بها.
الأدوات والتقنيات
| الأداة | الغرض |
|---|---|
| LangGraph | مخطط سير العمل والتوجيه |
| Agno | بيئة التشغيل للوكلاء والفرق المنشورة |
| Pulumi | البنية التحتية كرمز برمجي لحاويات الوكلاء |
| Azure | استضافة خدمات الوكلاء |
| PostgreSQL وRedis | ذاكرة الوكلاء وجلساتهم وبث المخرجات |
| Weaviate | البحث المتجهي في مصادر المعرفة |
| FastAPI | واجهة API للمنصة |
ما تم تسليمه
- أنواع من الوكلاء
- 5
- أنواع من المكونات الفرعية
- 8
- حالات نشر تتم متابعتها
- 4
- نقطة نهاية عاملة مستقلة
- لكل بيئة
- إطار مكونات موثّق بأدلة خاصة لبنيته المعمارية وللمساهمة فيه
- نشر بخطوة واحدة من سير عمل مختبَر إلى خدمة وكيل تعمل
- تسجيل حالة النشر وتوقيته ونقطة النهاية لكل بيئة
- وكلاء منشورون معزولون عن المنصة وعن بعضهم بعضًا
لماذا يهم ذلك
تستطيع معظم المؤسسات بناء نموذج تجريبي لوكيل ذكي. أما الجزء الأصعب فهو أن يصبح إصدار الوكيل الثاني والخامس والعشرين منخفض الكلفة وتشغيله آمنًا. ونموذج المكونات المشترك ومسار النشر القابل للتكرار يعالجان ذلك مباشرة.
إذا كانت مؤسستكم تخطط لمنصة من هذا النوع، أو تحتاج إلى تصميم جزء محدد منها وتسليمه، يسعدنا أن نناقش ذلك معكم.