المنهج الدراسي الدرس 174 من 250 · بناء الوكلاء (استخدام الأدوات و ReAct)
بناء الوكلاء (استخدام الأدوات و ReAct)

حراس الحلقات: max_steps ووقف الإجراء المتكرر

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

ستقوم ببناء run_with_guard(plan, tools, max_steps). يقوم بتشغيل نفس نوع الخطة كما في السابق، ولكن بدلاً من مجرد أثر فإنه يعيد تقريراً صغيراً: {"status": ..., "trace": [...]}، حيث status هو أحد ثلاث نتائج:

  • "max_steps" - وصل الوكيل إلى الحد الأقصى للخطوات قبل الانتهاء. توقف وقم بتمييزه.
  • "loop_detected" - حاول الوكيل القيام بـ نفس الإجراء تماما (نفس الأداة، نفس الـ args) الذي قام به بالفعل. هذا عبارة عن حلقة مفرغة؛ توقف قبل أن يستمر في التكرار.
  • "done" - اكتملت الخطة بشكل طبيعي (انتهت خطواتها أو وصلت إلى إجراء "finish").

تتبّع الإجراءات التي رأيتها لكي يكون اكتشاف التكرار رخيصاً. القاموس غير قابل للتجزئة (hashable)، لذا حوّل كل إجراء إلى مفتاح قابل للتجزئة أولاً:

seen = set()
...
key = (action, repr(args))   # repr makes the args dict hashable
if key in seen:
    return {"status": "loop_detected", "trace": trace}
seen.add(key)

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

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

دورك

اكتب run_with_guard(plan, tools, max_steps=10) ليعيد {"status": ..., "trace": [...]}. توقف باستخدام "max_steps" عندما تصل التتبع إلى max_steps مدخلات، وباستخدام "loop_detected" عندما يتكرر إجراء بالضبط (نفس الأداة و args)، وباستخدام "done" عندما تكتمل الخطة أو تصل إلى "finish". تحقق من الحراس قبل تسجيل كل خطوة لكي ينقطع التتبع عند نقطة التوقف.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.