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

الوحدة 8 · الدرس 4 · 15 دقيقة قراءة

المهام طويلة التشغيل

Long-Running Tasks

المقدمة

المهمة التي تستغرق ساعات أو أيامًا ستنقطع أو تنتظر حتمًا. في هذا الدرس نتعلم الركائز الأربع للمهام الطويلة: نقاط الحفظ، وعدم التكرار الضار، والميزانيات، وتقارير التقدم، ونطبقها على وكيل يرسل تذكيرات ويُستأنف بعد انقطاع دون أن يكرر أي رسالة.

أهداف التعلم

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

عندما لا تنتهي المهمة في دقيقة

بعض المهام تنتهي في رد واحد، لكن الوكلاء المستقلين يُكلَّفون غالبًا بمهام طويلة التشغيل (Long-Running Tasks): مراجعة مئات الملفات، أو متابعة طلبات على مدى أيام، أو جمع مصادر لبحث ثم تلخيصها. هذه المهام تواجه مشكلات لا تظهر في المحادثات القصيرة:

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

أربع ركائز للمهام الطويلة

  1. نقاط الحفظ (Checkpoints): بعد كل خطوة مهمة تُحفظ الحالة (ما أُنجز، وما بقي، والنتائج الوسيطة) في مخزن دائم. هذا ما يسميه LangGraph التنفيذ المتين (Durable Execution) والاستمرارية، حيث يمكن استئناف التشغيل من آخر حالة محفوظة (بحسب التوثيق الرسمي، مراجعة 18 نوفمبر 2026).
  2. عدم التكرار الضار (Idempotency): كل إجراء له أثر خارجي يحمل مفتاحًا فريدًا، فإذا نُفِّذ مرة ثانية بعد الاستئناف يُتجاهل بدل أن يتكرر أثره.
  3. الميزانيات (Budgets): حد للخطوات، وحد للزمن، وحد للكلفة. عند بلوغ أي حد يتوقف الوكيل بتقرير واضح بدل الاستمرار بصمت.
  4. تقارير التقدم (Progress Reporting): المستخدم يرى نسبة الإنجاز، وآخر خطوة، وسبب أي توقف.
أداة؟حساس؟انتهىSTARTوكيلnodeأدواتnodeموافقة بشريةinterruptENDالحالة Statecheckpoint
سير عمل بمخطط حالات: عقد تقرأ الحالة المشتركة وتعدّلها، وحواف شرطية تختار المسار، ونقاط حفظ تسمح بالاستئناف.

مثال عملي: تذكير الطلاب بالمستندات الناقصة

السيناريو: وحدة القبول لديها قائمة طلاب ينقصهم مستند، والوكيل يجهّز ويرسل تذكيرًا لكل طالب. التشغيل قد ينقطع في المنتصف، ويجب ألا يتلقى أي طالب تذكيرين. الكود التالي بايثون قياسي يحفظ نقطة الحفظ في ملف JSON، ويحاكي انقطاعًا ثم استئنافًا:

python
# مهمة طويلة بنقطة حفظ واستئناف وعدم تكرار - بايثون قياسي
import json, os

CHECKPOINT = "reminders_checkpoint.json"
students = ["s101", "s102", "s103", "s104", "s105"]

def load_state():
    if os.path.exists(CHECKPOINT):
        with open(CHECKPOINT, encoding="utf-8") as f:
            return json.load(f)
    return {"sent": [], "steps_used": 0}

def save_state(state):
    with open(CHECKPOINT, "w", encoding="utf-8") as f:
        json.dump(state, f, ensure_ascii=False)

def send_reminder(student_id, state):
    key = "reminder-" + student_id                # مفتاح عدم التكرار
    if key in state["sent"]:
        return "تخطي (أُرسل سابقًا)"
    state["sent"].append(key)
    return "أُرسل التذكير"

def run(max_steps=10, crash_after=None):
    state = load_state()
    for i, sid in enumerate(students):
        if state["steps_used"] >= max_steps:
            print("توقف: نفدت ميزانية الخطوات")
            break
        if crash_after is not None and i == crash_after:
            print("!! انقطاع مفاجئ")
            return
        print(sid, "->", send_reminder(sid, state))
        state["steps_used"] += 1
        save_state(state)                         # نقطة حفظ بعد كل خطوة
    print("التقدم:", len(state["sent"]), "من", len(students))

run(crash_after=3)     # التشغيل الأول ينقطع بعد ثلاثة طلاب
run()                  # الاستئناف: لا يتكرر أي تذكير
os.remove(CHECKPOINT)

عند الاستئناف يمر الوكيل على الطلاب الثلاثة الأوائل فيجد مفاتيحهم في الحالة المحفوظة فيتخطاهم، ثم يكمل الباقين. لو حذفنا save_state لبدأ الاستئناف بحالة فارغة وأعاد إرسال التذكيرات للطلاب الثلاثة الأوائل مرة ثانية. ولاحظ أن الخطوات المتخطاة تُحتسب أيضًا من الميزانية، وهذا مقصود لأن كل مرور يستهلك وقتًا.

الانتظار الطويل والاستئناف

حين يحتاج الوكيل إلى موافقة بشرية، لا يجب أن يبقى عمليةً معلقة في الذاكرة يومين. التصميم الأصح: يحفظ الحالة ويضع علامة «بانتظار الموافقة» ثم يتوقف، وعندما تصل الموافقة يُستأنف من النقطة نفسها. هذا بالضبط ما تسهّله الأطر التي تدعم الاستمرارية، وسنفصّله في درس الإنسان في الحلقة.

الملخص

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

المصطلحات

المصطلحEnglishالتعريف
نقطة حفظCheckpointلقطة من حالة التشغيل تُحفظ في مخزن دائم للاستئناف منها
عدم التكرار الضارIdempotencyخاصية تجعل تكرار الإجراء نفسه لا يغيّر الأثر بعد أول مرة
مفتاح عدم التكرارIdempotency Keyمعرّف فريد يمنع تنفيذ الإجراء نفسه مرتين
الميزانيةBudgetحد للخطوات أو الزمن أو الكلفة يوقف التشغيل عند بلوغه
الاستئنافResumeمتابعة التشغيل من آخر نقطة حفظ بدل البدء من جديد

أسئلة المراجعة

  1. ما المشكلات الأربع التي تواجه المهام طويلة التشغيل؟
  2. كيف يمنع مفتاح عدم التكرار إرسال الرسالة مرتين بعد الاستئناف؟
  3. لماذا يهم الترتيب بين تنفيذ الأثر وحفظ الحالة؟
  4. كيف يجب أن يتصرف الوكيل حين ينتظر موافقة قد تستغرق يومين؟

المراجع