تجهيز ونشر وكيل جاهز للعملاء

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

في النهاية، سيكون لديك حزمة تسليم احترافية يمكنك تقديمها لعميل حقيقي — مما يُظهر ليس فقط القدرة التقنية بل الجاهزية التجارية.

نظرة عامة على النظام

أنت تبني محرك المحتوى اليومي — نظام وكيل يقوم بـ:

1. الاستيقاظ كل صباح وفق جدول زمني
2. جلب المحتوى من خلاصات RSS ومصادر الأخبار
3. تلخيص القصص الرئيسية باستخدام نموذج لغوي كبير
4. إنشاء عروض دوّارة لوسائل التواصل الاجتماعي من منشورات المدونة
5. تسليم إحاطة صباحية منسقة عبر قناة مراسلة

┌──────────────────────────────────────────────────┐
│              محرك المحتوى اليومي                  │
│                                                   │
│  ┌────────────┐   ┌──────────────┐               │
│  │  النبض     │──→│  جلب RSS     │               │
│  │  (cron)    │   │  واستيعاب    │               │
│  └────────────┘   └──────┬───────┘               │
│                          ↓                        │
│                   ┌──────────────┐               │
│                   │  ملخص LLM   │               │
│                   │  وتحليل     │               │
│                   └──────┬───────┘               │
│                          ↓                        │
│            ┌─────────────┴─────────────┐         │
│            ↓                           ↓         │
│  ┌──────────────┐          ┌──────────────┐     │
│  │   الإحاطة   │          │   مولد       │     │
│  │   الصباحية  │          │   العرض الدوار│     │
│  └──────┬───────┘          └──────┬───────┘     │
│         ↓                         ↓              │
│  ┌──────────────┐          ┌──────────────┐     │
│  │   قناة      │          │   تصدير      │     │
│  │   المراسلة  │          │   المنصة     │     │
│  └──────────────┘          └──────────────┘     │
│                                                   │
│  ┌────────────────────────────────────────────┐  │
│  │  طبقة الأمان: ثقة، قوائم سماح، تدقيق     │  │
│  └────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────┘

الخطوة 1: تكوين الوكيل (agent-config.yaml) — FILE 1

أنشئ ملف تكوين YAML كامل لوكيل محرك المحتوى اليومي. هذا هو الملف المركزي الذي يحدد كيف يتصرف الوكيل، وما النماذج التي يستخدمها، وكيف يعمل.

يجب أن يتضمن تكوينك هذه الأقسام:

هوية الوكيل:

• اسم الوكيل، الإصدار، والوصف
• معلومات المؤلف والتواصل

تكوين النماذج:

• حدد 3 تعيينات نماذج على الأقل لأنواع مهام مختلفة:
  • summarization — نموذج سريع وموفر للتكلفة لتلخيص المقالات
  • analysis — نموذج قادر للتحليل الأعمق للمحتوى
  • creative — نموذج قوي لإنشاء نص العرض الدوّار والمحتوى الإبداعي
• لكل نموذج حدد: اسم النموذج، درجة الحرارة، الحد الأقصى للرموز، وتعليق مبرر موجز

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

• كوّن قناتين على الأقل (مثل Slack والبريد الإلكتروني)
• لكل قناة: النوع، الوجهة/عنصر نائب للـ webhook، تفضيل التنسيق، وعلامة التمكين

إعدادات الذاكرة:

• حجم نافذة السياق وحد سجل المحادثة
• مسار قاعدة المعرفة لتخزين المقالات المعالجة
• مدة صلاحية الذاكرة المؤقتة للمحتوى المجلوب

جدول النبض:

• تعبير cron للإحاطة الصباحية (مثلاً أيام العمل الساعة 7 صباحاً)
• إعداد المنطقة الزمنية
• جدول ثانوي للملخص الأسبوعي (مثلاً الجمعة الساعة 5 مساءً)

قواعد الأمان:

• مرجع لملف تقوية الأمان
• الحد الأقصى للإجراءات لكل تشغيل
• النطاقات الخارجية المسموحة لجلب RSS
• سياسة الاحتفاظ بالبيانات

الخطوة 2: سير عمل المحتوى (content-workflow.py) — FILE 2

أنشئ سكريبت Python ينفذ سير عمل الإحاطة الصباحية. استخدم بنية بأسلوب الكود الزائف مع توقيعات دوال واضحة، وسلاسل توثيق، وتدفق بيانات. لا تستخدم استدعاءات API حقيقية — استخدم عناصر نائبة منظمة توضح بالضبط ما سيحدث.

يجب أن ينفذ سير عملك:

fetch_rss_feeds(feed_urls: list) -> list

• قبول قائمة عناوين URL لخلاصات RSS
• إرجاع قائمة قواميس المقالات مع: العنوان، الرابط، تاريخ النشر، والملخص
• تضمين معالجة الأخطاء للخلاصات غير القابلة للوصول
• إضافة تعليق نائب يوضح أين سيُستخدم محلل RSS حقيقي (مثل feedparser)

summarize_articles(articles: list, model: str, max_length: int) -> list

• أخذ المقالات المجلوبة وإنتاج ملخصات موجزة
• كل ملخص يتضمن: العنوان، ملخص من 2-3 جمل، درجة الصلة (1-10)، ونسب المصدر
• تضمين عنصر نائب لاستدعاء API النموذج اللغوي مع قالب الأمر الدقيق الذي ستستخدمه
• معالجة حالة قائمة المقالات الفارغة

format_morning_briefing(summaries: list, date: str) -> str

• تنسيق الملخصات في إحاطة صباحية نظيفة وسهلة القراءة
• تضمين: تحية مع التاريخ، قسم القصص الرئيسية (مرتبة حسب الصلة)، قسم الروابط السريعة، وخاتمة
• استخدام تنسيق Markdown

send_briefing(briefing: str, channel_config: dict) -> bool

• إرسال الإحاطة المنسقة عبر القناة المكوّنة
• دعم Slack (webhook) والبريد الإلكتروني (SMTP) على الأقل كأنواع قنوات
• إرجاع حالة النجاح/الفشل
• تضمين عنصر نائب لاستدعاءات HTTP/SMTP الفعلية

run_morning_workflow(config: dict) -> dict

• دالة المُنسق الرئيسية التي تربط كل شيء معاً
• تحميل التكوين، جلب الخلاصات، التلخيص، التنسيق، والإرسال
• إرجاع تقرير حالة مع: المقالات المعالجة، حالة إرسال الإحاطة، المدة، وأي أخطاء
• تضمين التسجيل في كل خطوة

الخطوة 3: مهارة العرض الدوّار لوسائل التواصل (skills/social-media-carousel.yaml) — FILE 3

أنشئ تعريف مهارة مخصصة بتنسيق YAML لإنشاء محتوى عرض دوّار لوسائل التواصل الاجتماعي من منشورات المدونة. يجب أن تتبع هذه المهارة نمط قائم على الإجراءات.

يجب أن يتضمن تعريف مهارتك:

بيانات المهارة الوصفية:

• الاسم، الوصف، الإصدار، والمؤلف
• الفئة (مثلاً content-creation)
• تعريفات نوع المدخلات والمخرجات

خطوات الإجراء (5 على الأقل):

1. استخراج — أخذ URL منشور مدونة (أو نص)، استخراج المحتوى الرئيسي، العنوان، والمواضيع الرئيسية
2. تحليل — تحديد 5-8 نقاط رئيسية تصلح لشرائح عرض دوّار جذابة
3. إنشاء — كتابة نص الشريحة لكل نقطة رئيسية (عنوان + نص داعم، 40 كلمة كحد أقصى لكل شريحة)
4. خطاف — إنشاء شريحة أولى جاذبة للانتباه وشريحة أخيرة بدعوة لاتخاذ إجراء
5. تنسيق — هيكلة المخرجات لمنصات متعددة (LinkedIn، Instagram، Twitter/X) مع حدود أحرف خاصة بالمنصة واستراتيجيات الهاشتاج

خيارات التكوين:

• عدد الشرائح (افتراضي: 8، المدى: 5-12)
• النبرة (احترافي، عادي، تعليمي)
• قائمة المنصات المستهدفة
• تبديل تضمين الرموز التعبيرية
• عدد الهاشتاج لكل منصة

مثال على المدخلات/المخرجات:

• تضمين مدخل نموذجي (موضوع منشور مدونة) وتنسيق المخرجات المتوقع يعرض جميع شرائح العرض الدوّار

الخطوة 4: عرض العميل (client-proposal.md) — FILE 4

اكتب وثيقة عرض عميل احترافية بتنسيق Markdown. تخيل أنك تقدم محرك المحتوى اليومي لوكالة تسويق تريد أتمتة سير عمل المحتوى.

يجب أن يتضمن عرضك:

الملخص التنفيذي (2-3 فقرات)

• مشكلة العميل: تنسيق المحتوى اليدوي بطيء وغير متسق
• الحل المقترح: محرك محتوى مدعوم بالذكاء الاصطناعي
• الفائدة الرئيسية: توفير 10+ ساعات أسبوعياً مع جودة مخرجات أعلى

بيان المشكلة

• تفصيل 3-4 نقاط ألم محددة يواجهها العميل
• تضمين تقدير الوقت/التكلفة للعملية اليدوية الحالية

الحل المقترح

• نظرة عامة على البنية (الإشارة إلى هيكل agent-config.yaml)
• كيف يعالج كل مكون نقطة ألم محددة
• ملخص مجموعة التقنيات

التسليمات

• قائمة كل تسليم مع الوصف والجدول الزمني
• تضمين: نظام الوكيل، المهارات المخصصة، التوثيق، جلسة تدريب

الجدول الزمني

• المرحلة 1: الإعداد والتكوين (الأسبوع 1)
• المرحلة 2: تطوير سير العمل والاختبار (الأسبوع 2-3)
• المرحلة 3: النشر والتدريب (الأسبوع 4)

نموذج التسعير

• استخدام التسعير القائم على القيمة مع مبرر واضح
• عرض حساب العائد على الاستثمار: الوقت الموفر * السعر بالساعة = القيمة المقدمة
• تقديم تسعير متدرج (أساسي، احترافي، مؤسسي)
• كل مستوى يحتوي على مجموعة ميزات مختلفة

الشروط والخطوات التالية

• جدول الدفع، شروط الدعم، وكيفية البدء

الخطوة 5: دليل النشر (deployment-guide.md) — FILE 5

اكتب توثيق نشر يمكن لعضو فريق تقني اتباعه لإعداد نظام الوكيل من الصفر.

يجب أن يتضمن دليلك:

المتطلبات المسبقة

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

خطوات التثبيت

• أوامر خطوة بخطوة (استخدم كتل كود bash)
• إعداد متغيرات البيئة
• وضع ملفات التكوين

التكوين

• كيفية تخصيص agent-config.yaml لاحتياجات العميل
• كيفية إضافة خلاصات RSS جديدة
• كيفية تكوين قنوات المراسلة

إعداد المراقبة

• كيفية فحص صحة الوكيل
• مواقع ملفات السجل والتدوير
• المقاييس الرئيسية للمراقبة (المقالات المعالجة، معدل نجاح التسليم، استخدام رموز LLM)

استكشاف الأخطاء وإصلاحها

• 5 مشاكل شائعة على الأقل مع حلول (مثل انتهاء مهلة الخلاصة، حد معدل LLM، فشل مصادقة القناة)
• كل مشكلة تتضمن: العرَض، السبب، والإصلاح

جدول الصيانة

• مهام الصيانة اليومية والأسبوعية والشهرية
• كيفية تحديث مصادر الخلاصات
• كيفية ترقية الوكيل

الخطوة 6: تقوية الأمان (security-hardening.yaml) — FILE 6

أنشئ ملف تكوين أمان يُحكم إغلاق نظام الوكيل للاستخدام الإنتاجي.

يجب أن يتضمن تكوين الأمان:

مستويات الثقة:

• حدد 3 مستويات ثقة على الأقل (مثلاً restricted، standard، elevated)
• لكل مستوى: ما الإجراءات المسموحة، حدود الرموز، وأي المستخدمين/الأدوار يحصلون على هذا المستوى

قوائم السماح للمراسلة:

• نطاقات/عناوين المرسلين المعتمدة
• نطاقات/عناوين المستلمين المعتمدة
• الأنماط المحظورة (مثل نطاقات البريد الشخصي لنظام تجاري)

إدارة بيانات الاعتماد:

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

قواعد الموافقة على الإجراءات:

• الإجراءات التي تتطلب موافقة بشرية قبل التنفيذ
• الإجراءات الموافق عليها تلقائياً مع شروط
• التكلفة القصوى لكل إجراء (ميزانية الرموز)
• حدود المعدل لكل نوع إجراء

المراقبة والتنبيه:

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

---

ما يجب تقديمه

يجب أن يحتوي تقديمك على 6 أقسام ملفات في المحرر:

• FILE 1: agent-config.yaml — تكوين الوكيل الكامل
• FILE 2: content-workflow.py — تنفيذ سير عمل الإحاطة الصباحية
• FILE 3: skills/social-media-carousel.yaml — مهارة إنشاء العرض الدوّار
• FILE 4: client-proposal.md — عرض العميل الاحترافي
• FILE 5: deployment-guide.md — توثيق النشر
• FILE 6: security-hardening.yaml — تكوين الأمان