تمرين التصميم المعماري: نظام وكيل لصانعي المحتوى

في هذا المختبر، ستصمم بنية تنسيق وكلاء كاملة لـ صانع محتوى ينتج مقالات مدونة وتحديثات وسائل التواصل الاجتماعي ونشرات إخبارية. ستفكر في كل طبقة من النظام: من اختيار النموذج إلى أتمتة سير العمل وتقييم الأطر وتخفيف المخاطر.

هذا التمرين يعكس ما يفعله مهندسو الذكاء الاصطناعي الحقيقيون قبل كتابة سطر واحد من الكود. البنية المصممة جيدا تمنع إعادة الكتابة المكلفة وتضمن أن نظام الوكيل الخاص بك موثوق وقابل للتوسع وآمن.

السيناريو

عميلك هو صانع محتوى محترف:

• ينشر 3 مقالات مدونة أسبوعيا عبر منصات متعددة
• يدير حسابات وسائل التواصل الاجتماعي على Twitter/X وLinkedIn وInstagram
• يرسل نشرة إخبارية أسبوعية لـ 10,000 مشترك
• يحتاج مساعدة في البحث والصياغة والتحرير وتحسين SEO والجدولة
• يريد مراجعة بشرية قبل نشر أي شيء
• لديه ميزانية شهرية 500 دولار لأدوات وواجهات الذكاء الاصطناعي

مهمتك هي تصميم نظام تنسيق وكلاء يؤتمت خط إنتاج المحتوى مع إبقاء الإنسان في الحلقة لضبط الجودة.

الخطوة 1: بنية النظام (architecture.yaml)

صمم البنية العامة للنظام بتحديد:

تعريف الوكيل:

• أعطِ نظام الوكيل اسما
• حدد غرضه الأساسي ونطاقه
• حدد ما يجب وما لا يجب أن يفعله (الحدود)

اختيار النموذج:

• اختر نماذج LLM محددة لمهام مختلفة (مثل البحث، الصياغة، التحرير، SEO)
• برر لماذا قد تحتاج المهام المختلفة نماذج مختلفة (التكلفة، السرعة، الجودة)
• أضف نماذج احتياطية في حال عدم توفر النموذج الأساسي

قنوات الاتصال:

• حدد كيف يتفاعل المستخدم مع الوكيل (CLI، لوحة تحكم ويب، محادثة، بريد إلكتروني)
• حدد كيف تتواصل الوكلاء مع بعضها (إذا كنت تستخدم وكلاء متعددين)
• حدد قنوات الإشعار للمهام المكتملة

الأدوات والتكاملات:

• اذكر الأدوات الخارجية التي يحتاجها الوكيل (واجهات البحث، واجهات CMS، واجهات وسائل التواصل، خدمات البريد)
• لكل أداة حدد: الاسم، الغرض، طريقة المصادقة، وحدود المعدل
• أضف 5 تكاملات أدوات على الأقل

الخطوة 2: سير عمل إنشاء المحتوى (workflow.yaml)

صمم سير عمل إنشاء المحتوى من البداية للنهاية:

خطوات سير العمل:

• حدد كل خطوة من الفكرة الأولى إلى المحتوى المنشور
• لكل خطوة حدد: اسم الخطوة، الوصف، مسؤولية الوكيل أو الإنسان، المدخلات، المخرجات، المدة المقدرة
• أضف 6 خطوات على الأقل في سير العمل

الأتمتة مقابل المراجعة البشرية:

• حدد بوضوح أي الخطوات مؤتمتة بالكامل وأيها تتطلب موافقة بشرية وأيها هجينة
• حدد بوابات الموافقة (ما الذي يستدعي المراجعة البشرية)
• حدد ما يحدث إذا رفض الإنسان المخرجات عند أي بوابة

معالجة الأخطاء:

• حدد ما يحدث عند فشل خطوة (منطق إعادة المحاولة، السلوك الاحتياطي، الإشعار)
• حدد قيم المهلة الزمنية لكل خطوة
• حدد مسارات التصعيد للفشل الحرج

الخطوة 3: تقييم الأطر (evaluation.yaml)

قارن ثلاثة أطر تنسيق وكلاء حقيقية لتحديد الأنسب لهذه الحالة:

الأطر للمقارنة:

• اختر 3 أطر من: LangGraph، CrewAI، OpenAI Agents SDK، AutoGen، Semantic Kernel، أو أي إطار معروف آخر
• لكل إطار قدم وصفا موجزا

معايير التقييم:

• دعم النماذج (أي مزودي LLM مدعومون)
• نظام الأدوات (أدوات مدمجة، دعم أدوات مخصصة، توافق MCP)
• إدارة الذاكرة والحالة (سجل المحادثة، الذاكرة طويلة المدى، نقاط الحفظ)
• ميزات الأمان (العزل، التحقق من المدخلات، تصفية المخرجات)
• المجتمع والنظام البيئي (جودة التوثيق، حجم المجتمع، تكرار التحديثات)
• التكلفة والترخيص (مفتوح المصدر مقابل تجاري، تكاليف الاستضافة)

التسجيل:

• سجل كل إطار من 1 إلى 5 على كل معيار
• قدم تبريرا موجزا لكل تسجيل
• اختر فائزا مع مبررات مكتوبة

الخطوة 4: تقييم المخاطر (risk-assessment.yaml)

حدد المخاطر واستراتيجيات التخفيف:

فئات المخاطر:

• مخاطر الهلوسة (الوكيل يولد معلومات خاطئة في المحتوى المنشور)
• حدود نافذة السياق (المقالات الطويلة تتجاوز سياق النموذج)
• فشل الأدوات (حدود معدل API، انقطاع الخدمة، انتهاء المصادقة)
• تجاوز التكاليف (ارتفاعات غير متوقعة في استخدام API)
• مخاطر الأمان (حقن الأوامر، تسرب البيانات، النشر غير المصرح به)

لكل خطر:

• صف سيناريو الخطر
• قيّم الشدة (منخفضة، متوسطة، عالية، حرجة)
• قيّم الاحتمالية (غير محتمل، ممكن، محتمل، محتمل جدا)
• حدد استراتيجية تخفيف واحدة على الأقل
• حدد نهج المراقبة (كيف تكتشف هذا الخطر في الإنتاج)

أضف 6 مخاطر مميزة على الأقل عبر الفئات أعلاه.

ماذا تقدم

المحرر يحتوي على 4 أقسام ملفات مع تعليقات TODO. استبدل كل TODO بمحتوى YAML الخاص بك. سيقوم المقيّم الذكي بتقييم كل قسم وفقا لمعايير التقييم.

تلميحات

• لاختيار النموذج، فكر في مفاضلات التكلفة-الجودة: استخدم نماذج أرخص للمهام البسيطة (كلمات SEO، الجدولة) ونماذج متميزة للكتابة الإبداعية
• لتصميم سير العمل، فكر في خط إنتاج المحتوى كرسم بياني موجه غير دوري (DAG) حيث يمكن تشغيل بعض الخطوات بالتوازي
• لتقييم الأطر، ركز على القدرات الحقيقية التي يمكنك التحقق منها من التوثيق الرسمي
• لتقييم المخاطر، فكر فيما يحدث الساعة 3 صباحا عندما لا يراقب أحد النظام