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

التخطيط، والتأمل، وإعادة التخطيط

تعد

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

1. قم بتفكيك الهدف إلى خطة

التخطيط يعني تحويل هدف غير محدد إلى قائمة مرتبة من المهام الفرعية. في الإنتاج يقوم النموذج بكتابة هذه الخطة؛ هنا نجعلها حتمية وتعتمد على الكلمات المفتاحية لتكون قابلة للاختبار. نفس الفكرة، مخرجات مثبتة:

def decompose(goal):
    g = goal.lower()
    if "research" in g or "report" in g:
        return ["gather sources", "extract facts", "write summary"]
    elif "trip" in g or "travel" in g:
        return ["pick dates", "book flights", "book hotel"]
    return ["understand goal", "do the work", "review result"]

2. تأمل في نتيجة كل خطوة

بعد تشغيل مهمة فرعية، ينظر الوكيل إلى النتيجة ويتخذ قرار control decision. نعطيه قاموس نتائج صغير {"ok": bool, "last": bool} (هل نجحت الخطوة، وهل هي الخطوة النهائية) وثلاثة قرارات ممكنة:

  • "replan" - فشلت الخطوة failed. كل ما جربناه لم ينجح، لذا فإن الخطة الحالية مشكوك فيها.
  • "done" - نجحت الخطوة وكانت هي الأخيرة. تم تحقيق الهدف.
  • "continue" - لقد نجح الأمر ولكن هناك المزيد للقيام به. انتقل إلى المهمة الفرعية التالية.

الترتيب مهم: الفشل يعني "replan" حتى في الخطوة الأخيرة (خطوة نهائية معطوبة ليست "done").

3. أعد التخطيط مرة واحدة عند الفشل

يقوم المتحكم بربط كل شيء معاً. إنه يسير وفق الخطة، ويستدعي execute(subtask) لكل خطوة، ويحدد ما إذا كانت هي الأخيرة، ثم يقوم بالتفكير. في "continue" يتقدم؛ وفي "done" يتوقف بنجاح؛ وفي "replan" يبني خطة تعافٍ جديدة ويبدأ من جديد، ولكن فقط حتى max_replans مرة، لذا لا يمكن للمهمة اليائسة أن تستمر في التكرار للأبد (انضباط حماية الحلقة من السابق). عندما تنفد خطط التعافي فإنه يتوقف مع "failed".

def replan(goal, failed_step):
    # retry the failed step, then still do every step that came after it
    base = failed_step[len("retry: "):] if failed_step.startswith("retry: ") else failed_step
    plan = decompose(goal)
    rest = plan[plan.index(base) + 1:] if base in plan else []
    return ["retry: " + base] + rest

execute هو نموذج هنا - وهي function تقوم بتمريرها وتعيد {"ok": ...} لمهمة فرعية - وهي تحل محل استدعاءات الأدوات الحقيقية ليكون الـ controller حتمياً وقابلاً للاختبار بالكامل. في الـ agent الحقيقي، يقوم نفس الـ controller بتشغيل أدوات حقيقية وخطة مكتوبة بواسطة model دون تغيير منطقه. اضغط على Run لمشاهدة خطة تنجح، ثم شاهد خطة تفشل في خطوة وتتعافى عند الـ replan.

دورك

قم ببناء وحدة تحكم للتخطيط. اكتب decompose(goal) التي تعيد قائمة المهام الفرعية المرتبة (research/report -> ["gather sources", "extract facts", "write summary"]; trip/travel -> ["pick dates", "book flights", "book hotel"]; else -> ["understand goal", "do the work", "review result"]). اكتب reflect(step_result) فوق {"ok", "last"} لتعيد "replan" إذا لم تكن جيدة، وإلا تعيد "done" إذا كانت الأخيرة، وإلا تعيد "continue". اكتب replan(goal, failed_step) -> خطة تعافي تعيد محاولة الخطوة الفاشلة ثم تقوم بكل خطوة جاءت بعدها في decompose(goal): لهدف بحث يفشل عند "extract facts"، ["retry: extract facts", "write summary"]. (خطة التعافي التي تتخطى العمل المتبقي وتُبلغ "done" هي خطأ الوكيل الكلاسيكي: لم يتم كتابة الملخص أبداً). إذا كانت failed_step هي إعادة محاولة في حد ذاتها، قم بإزالة بادئة "retry: " أولاً حتى لا تتكرر. ثم اكتب run_plan(goal, execute, max_replans=1) التي تمر على الخطة، وتستدعي execute(subtask) (تعيد {"ok": bool})، وتتأمل (أنت تحدد last)، وتسجل أثراً (subtask, ok, decision)، وتعيد التخطيط حتى max_replans مرات عند الفشل (إعادة تشغيل خطة التعافي من خطوتها الأولى)، وتعيد {"status": "done"|"failed", "trace": [...], "replans": int}.

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

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

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