المهام المجدولة وإطار عمل SWIFT

حتى الآن، وكيلك يتصرف عندما تطلب منه. لكن القوة الحقيقية للوكيل المستقل هي إنجاز العمل دون أن يُطلب منه — المراقبة وإعداد التقارير والصيانة والاستجابة وفق جدول زمني. المهام المجدولة تمنح وكيلك ساعة. إطار عمل SWIFT يمنحه مخططاً لتحويل المهام العشوائية إلى سير عمل قابل للتكرار وموثق.

المهام المجدولة: أتمتة الوكيل المجدولة

Cron هو مُجدوِل قائم على الوقت متاح على أنظمة Linux وmacOS. يُشغّل الأوامر في فترات محددة — كل دقيقة، كل ساعة، كل يوم الساعة 3 صباحاً، كل اثنين عند الظهر. لأنظمة الوكلاء، يحوّل Cron الوكلاء التفاعليين إلى وكلاء استباقيين.

صيغة Cron

تعبير Cron يحتوي على خمسة حقول:

┌───────── الدقيقة (0-59)
│ ┌─────── الساعة (0-23)
│ │ ┌───── يوم الشهر (1-31)
│ │ │ ┌─── الشهر (1-12)
│ │ │ │ ┌─ يوم الأسبوع (0-6، حيث 0 = الأحد)
│ │ │ │ │
* * * * *

أنماط شائعة:

الجدول	تعبير Cron	حالة الاستخدام
كل ساعة	`0 * * * *`	التحقق من الرسائل أو التنبيهات الجديدة
يومياً الساعة 8 صباحاً	`0 8 * * *`	إنشاء الإحاطة الصباحية
كل اثنين الساعة 9 صباحاً	`0 9 * * 1`	إنشاء تقرير الملخص الأسبوعي
كل 15 دقيقة	`/15 * * *`	مراقبة صحة الخدمة
أول يوم من الشهر عند منتصف الليل	`0 0 1 * *`	إنشاء تقرير التحليلات الشهري

إعداد المهام المجدولة للوكيل

لجدولة مهمة وكيل، تنشئ إدخال cron يُفعّل الوكيل بتعليمة محددة:

# تحرير جدول المهام
crontab -e

# الإحاطة الصباحية اليومية الساعة 8 صباحاً
0 8 * * * /usr/local/bin/agent-cli run "أنشئ إحاطتي اليومية مع أحداث التقويم والرسائل ذات الأولوية وقائمة المهام"

# تقرير أداء المحتوى الأسبوعي كل اثنين الساعة 9 صباحاً
0 9 * * 1 /usr/local/bin/agent-cli run "أنشئ تقرير أداء المحتوى الأسبوعي وأرسله لتيليجرام الخاص بي"

# فحص صحة الموقع كل ساعة
0 * * * * /usr/local/bin/agent-cli run "تحقق إذا كان mywebsite.com يستجيب وأنبهني إذا كان معطلاً"

كل إدخال cron يُفعّل الوكيل بتعليمة بلغة طبيعية. يستخدم الوكيل مهاراته المُكوَّنة واتصالات MCP وذاكرته لتنفيذ المهمة.

أفضل ممارسات Cron

سجّل المخرجات: أعد توجيه مخرجات cron لملفات سجل لتتمكن من تتبع الأخطاء. أضف >> /var/log/agent-cron.log 2>&1 لكل إدخال
تجنب التداخل: إذا كانت المهمة تستغرق 10 دقائق، لا تجدولها كل 5 دقائق. استخدم ملفات القفل أو تحقق إذا كانت نسخة سابقة لا تزال تعمل
استخدم مسارات مطلقة: يعمل Cron ببيئة محدودة. استخدم دائماً المسارات الكاملة للأوامر والنصوص البرمجية
اختبر يدوياً أولاً: شغّل الأمر نفسه من الطرفية قبل إضافته لجدول المهام

إطار عمل SWIFT

Cron يتعامل مع "متى." SWIFT يتعامل مع "كيف." إطار عمل SWIFT هو نهج منظم لتصميم سير عمل وكيلي قابل للتكرار وموثق وقابل للصيانة.

SWIFT يرمز إلى:

S — الإعداد (Setup)

حدد الهدف وعرّف الأدوات المطلوبة.

ما هي النتيجة المرغوبة؟
ما مصادر البيانات التي يحتاج الوكيل الوصول إليها؟
ما خوادم MCP أو المهارات أو واجهات API المطلوبة؟
ما الصلاحيات التي يحتاجها الوكيل؟

مثال: "أريد تقريراً أسبوعياً عن قناة YouTube يُسلَّم لبريدي الإلكتروني كل اثنين صباحاً."

قائمة التحقق للإعداد:

خادم YouTube MCP مُكوَّن بوصول للقناة
خادم البريد MCP مُكوَّن للإرسال
الوكيل لديه مهارة لتنسيق بيانات التحليلات
وصول قراءة فقط لـ YouTube، وصول إرسال فقط للبريد

W — سير العمل (Workflow)

صمم العملية خطوة بخطوة التي سيتبعها الوكيل.

ارسم كل إجراء بالتسلسل:

الاتصال بـ YouTube MCP واسترجاع إحصائيات القناة للأيام السبعة الماضية
مقارنة المقاييس الحالية بالأسبوع السابق
تحديد الفيديو الأعلى أداءً والفيديو الأقل أداءً
ملاحظة أي تغييرات مهمة في عدد المشتركين أو وقت المشاهدة
تنسيق البيانات في تقرير منظم بأقسام للنظرة العامة والأبرز والتوصيات
إرسال التقرير عبر MCP البريد الإلكتروني للعنوان المحدد

كل خطوة يجب أن تكون محددة بما يكفي ليتمكن الوكيل من تنفيذها بدون غموض.

I — التكرار (Iterate)

اختبر سير العمل وحسّنه بناءً على النتائج.

شغّل سير العمل يدوياً وراجع المخرجات
هل تنسيق التقرير مفيد؟ هل يتضمن المقاييس الصحيحة؟
هل هناك حالات استثنائية؟ ماذا يحدث عندما لا يكون للقناة فيديوهات جديدة هذا الأسبوع؟
هل يتعامل الوكيل مع أخطاء API بشكل سلس؟
عدّل خطوات سير العمل أو تعليمات المهارة أو التنسيق بناءً على التغذية الراجعة

توقع التكرار عدة مرات. النسخة الأولى من أي سير عمل هي مسودة.

F — الإضفاء الرسمي (Formalize)

وثّق العملية النهائية لتكون قابلة للتكرار والصيانة.

أنشئ ملف تعريف سير العمل:

name: weekly-youtube-report
description: ينشئ ويرسل تقرير أداء قناة YouTube الأسبوعي
version: 1.2
last_updated: 2025-01-15

trigger:
  type: cron
  schedule: "0 9 * * 1"  # كل اثنين الساعة 9 صباحاً

requirements:
  mcp_servers:
    - youtube  # وصول قراءة للقناة
    - email    # وصول إرسال
  skills:
    - format-analytics-report

steps:
  - استرجاع إحصائيات قناة YouTube للأيام السبعة الماضية
  - مقارنة مع مقاييس الأسبوع السابق
  - تحديد الفيديوهات الأعلى والأقل أداءً
  - ملاحظة التغييرات المهمة في المشتركين ووقت المشاهدة
  - تنسيق تقرير منظم بنظرة عامة وأبرز النقاط والتوصيات
  - إرسال التقرير عبر البريد الإلكتروني للمالك

constraints:
  - لا تشارك بيانات API الخام، فقط الملخصات المنسقة
  - إذا كان YouTube API غير متاح، أعد المحاولة مرة واحدة ثم أرسل إشعاراً
  - يجب أن يكون التقرير أقل من 500 كلمة

T — التفعيل (Trigger)

حدد طريقة التفعيل — كيف ومتى يبدأ سير العمل.

المفعّلات تنقسم إلى ثلاث فئات:

نوع المفعّل	الوصف	مثال
يدوي	المستخدم يطلب التنفيذ صراحةً	"شغّل تقرير YouTube الآن"
مجدول	مهمة cron تعمل في أوقات محددة	كل اثنين الساعة 9 صباحاً
مدفوع بالأحداث	يُفعَّل بحدث خارجي	نشر فيديو جديد، وصول لمحطة مشتركين

لتقرير YouTube، نستخدم مفعّلاً مجدولاً (cron)، لكننا نسمح أيضاً بالتفعيل اليدوي ليتمكن المستخدم من طلب التقرير في أي وقت.

جمع كل شيء معاً

إليك المسار الكامل من الاستخدام العشوائي إلى سير عمل رسمي:

عشوائي: تسأل الوكيل يدوياً "كيف كان أداء قناتي على YouTube هذا الأسبوع؟" كل اثنين
الإعداد: تكوّن خوادم YouTube وبريد إلكتروني MCP، تنشئ مهارة تنسيق التحليلات
سير العمل: تصمم عملية من ست خطوات من استرجاع البيانات لتسليم التقرير
التكرار: تشغّله ثلاث مرات، وتعدّل تنسيق التقرير وتضيف معالجة الأخطاء
الإضفاء الرسمي: توثّق سير العمل في ملف تعريف مع القيود والمتطلبات
التفعيل: تضيف مهمة cron ليوم الاثنين الساعة 9 صباحاً وتُبقي التفعيل اليدوي متاحاً

النتيجة: مهمة كانت تستغرق منك 20 دقيقة من العمل اليدوي أصبحت تعمل تلقائياً وتنتج مخرجات متسقة وموثقة بشكل كافٍ بحيث يمكنك تسليمها لشخص آخر.

النقطة الرئيسية: المهام المجدولة تحوّل وكيلك من تفاعلي إلى استباقي. إطار عمل SWIFT يضمن أن سير عملك ليس مؤتمتاً فحسب بل مصمَّم ومُختبَر وموثّق وقابل للصيانة أيضاً. ابدأ بسير عمل واحد تكرره أسبوعياً، طبّق SWIFT عليه، وابنِ من هناك.

الوحدة التالية: بناء مشاريع واقعية — جمع كل شيء معاً لإنشاء أنظمة وكلاء متكاملة يمكنك نشرها وتحقيق الربح منها. :::