الحلقة ملكك أنت لا ملك النموذج
من الذي يكرّر فعلًا
النموذج لا يدور في حلقة. إنه يتلقى سياقًا، ويُصدر استجابة واحدة قد تحتوي على استدعاءات أدوات، ثم يتوقف. كل تكرار لاحق يحدث لأن بيئة التشغيل لديك قررت استدعاءه مرة أخرى بسياق أكبر. هذا ليس تمييزًا شكليًا، بل هو مساحة التصميم بأكملها: عدد التكرارات، وما يُضاف، وما يُحذف، ومتى يتوقف التشغيل، وما المسموح للنموذج بفعله بعد ذلك — كلها قرارات تُتخذ في كودك بين الاستدعاءات. الفرق التي ترث حلقة الوكيل (Agent loop) من إطار عمل دون أن تقرأها ينتهي بها الأمر إلى تصحيح سلوك لم تختره قط. اكتب الحلقة بنفسك مرة واحدة على الأقل، حتى لو اعتمدت لاحقًا إطارًا محيطًا (Harness)، لأن الأسئلة التي تجبرك على الإجابة عنها هي الأسئلة نفسها التي تحدد ما إذا كان النظام سيعمل دون إشراف.
- النموذج يُصدر استجابة واحدة؛ وبيئة التشغيل لديك تقرر هل توجد استجابة تالية
- كل ما بين الاستدعاءات — الإضافة والتقليص والضبط وإدارة الميزانية — هو كودك
- حلقة إطار العمل تبقى حلقة تتحمّل أنت عواقبها
- الهندسة المثيرة للاهتمام تقع في الفجوات بين استدعاءات النموذج، لا داخلها
ما الذي يُعدّ خطوة واحدة
عرّف الخطوة بدقة، لأن الميزانيات والمقاييس والتتبّع (Tracing) وكشف التعثّر كلها تعتمد عليها. التعريف العملي: استدعاء واحد للنموذج، مضافًا إليه كل تنفيذ أداة طلبه ذلك الاستدعاء، مضافًا إليه الملاحظات التي تُلحق قبل الاستدعاء التالي. وفق هذا التعريف يمكن أن تحتوي الخطوة على عدة استدعاءات أدوات متوازية، وهذا مهم لأن النموذج الذي يُصدر أربع عمليات قراءة مستقلة في استجابة واحدة يؤدي خطوة استدلال واحدة بأربعة أفعال، لا أربع خطوات. أما عدّ تنفيذات الأدوات بدل استدعاءات النموذج فيجعل الوكيل الذي يعمل بالتوازي يبدو مُسرفًا وهو يفعل العكس تمامًا. اختر تعريفًا واحدًا، ودوّنه، واستخدمه باتساق في ميزانية الخطوات وتقرير التكلفة والتتبّع، وإلا فلن تكون أرقامك قابلة للمقارنة بين التشغيلات أو بين الميزات.
- الخطوة الواحدة = استدعاء نموذج + تنفيذات الأدوات الخاصة به + الملاحظات الناتجة
- استدعاءات الأدوات المتوازية داخل استجابة واحدة خطوة واحدة لا عدة خطوات
- يجب أن تستخدم الميزانيات والتتبّع وتقارير التكلفة التعريف نفسه
- العدّ غير المتّسق للخطوات يجعل الوكلاء المتوازين يبدون أسوأ من المتسلسلين
أشكال الحلقة التي ستختار بينها فعلًا
الشكل المتداخل — استدلّ، نفّذ، لاحظ، كرّر — هو الافتراضي والأكثر مرونة، لأن كل ملاحظة قد تغيّر الخطة. أما شكل «التخطيط أولًا» فيُجري استدعاء تخطيط يُنتج قائمة مرتّبة صريحة، ثم ينفّذها بنموذج أصغر بكثير داخل الحلقة، وهذا يمنحك قابلية للتنبؤ وخطوات أرخص وخطة يمكنك عرضها على إنسان قبل حدوث أي شيء، مقابل تكيّف سيئ حين يناقض الواقعُ الخطة. وشكل المراجعة النقدية يُدرج استدعاء مراجعة للعمل المنجز حتى الآن عند نقاط ثابتة، فيلتقط الانحراف لكنه يضاعف تكلفة كل خطوة تخضع للمراجعة. معظم الأنظمة في التشغيل الفعلي هجينة: خطّط أولًا، ونفّذ بالشكل المتداخل، وراجع عند نقاط التفتيش. اختر لكل ميزة لا لكل شركة، لأن الشكل الصحيح ينبع من مدى قابلية المهمة للتنبؤ.
- المتداخل: أقصى قدرة على التكيّف وأقل قابلية للتنبؤ، وهو الخيار الافتراضي المعقول
- التخطيط أولًا: خطة قابلة للفحص وخطوات تنفيذ أرخص، لكنه هشّ حين تكون الخطة خاطئة
- المراجعة عند نقاط التفتيش: تلتقط الانحراف، وتدفع ثمن كل استدعاء مراجعة
- الأشكال الهجينة أمر طبيعي — اختر الشكل بحسب مدى قابلية المهمة للتنبؤ فعلًا
الحالة تعيش خارج النموذج
تعامل مع التشغيل ككائن حالة صريح لا كمحادثة تواصل الإضافة إليها. يحمل هذا الكائن الهدف، والميزانيات المتبقية، وسجل الرسائل، ومسودة العمل، ونتائج الأدوات التي اخترت الاحتفاظ بها، ومعرّف التشغيل، والحالة. إبقاؤه صريحًا يمنحك ثلاثة أمور مهمة عند العمل دون إشراف. يمكن حفظه، فيصمد التشغيل أمام إعادة تشغيل العملية أو انتظار مدخلات بشرية بدل أن يموت مع الطلب. ويمكن فحصه، فيستطيع مهندس الدعم أن يجيب عمّا يعتقده الوكيل حاليًا دون قراءة نص المحادثة كاملًا. ويمكن استئنافه أو تفريعه عند خطوة محددة، وهذا ما يحوّل عطلًا في التشغيل الفعلي إلى شيء يمكنك العمل عليه فعلًا. المحادثة إسقاط لهذه الحالة، لا الحالة نفسها.
- الهدف والميزانيات والسجل ومسودة العمل والنتائج المحفوظة ومعرّف التشغيل والحالة — كائن واحد
- الحالة القابلة للحفظ تتيح للتشغيل التوقف بانتظار إنسان أو الصمود أمام إعادة التشغيل
- الحالة القابلة للفحص تجيب عن سؤال «ماذا يعتقد الآن» دون قراءة نص المحادثة
- مصفوفة الرسائل عرضٌ لحالة التشغيل، لا مصدر الحقيقة