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