هارنس الوكيل: ما هو وما مكوّناته

التعريف

هارنس الوكيل (agent harness) هو الغلاف البرمجي الذي يحيط بنموذج اللغة: كل ما هو خارج النموذج نفسه، لكنه يؤثر في طريقة عمل الوكيل. المعادلة هي الوكيل = النموذج + الهارنس. يجيد النموذج الاستدلال وكتابة الشيفرة، أما الهارنس فيقرر ما الذي يراه النموذج، وبأي أدوات يتصرف، وأين تُنفَّذ الأوامر، وما الذي يُحفظ بين الجلسات، وكيف يعرف النموذج أنه أخطأ.

مكونات الهارنس الخمسة

• التعليمات——موجّه النظام وملفات المشروع مثل CLAUDE.md وAGENTS.md، والوثائق الموضوعية، وskills.
• الأدوات——تنفيذ الأوامر في shell، وتحرير الملفات، والمتصفح، والخدمات المتصلة عبر MCP.
• البيئة——صندوق رمل (sandbox) أو حاوية يُشغَّل فيها الكود دون أن يمس الإنتاج.
• الحالة——ملفات الخطة والتقدم وسجل git: ذاكرة تبقى بعد انتهاء الجلسة.
• التغذية الراجعة——الاختبارات والمدققات وفحص الأنواع والخطافات، التي تعيد إشارة الخطأ إلى الوكيل.

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

مثال

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

## الخلل: خصم مكرر عند إعادة إرسال الطلب
تم التحقق منه ورفضه:
- مهلة عميل HTTP — لا تأثير
- حالة تسابق في معالج webhook — لم يُعَد إنتاجها
الخطوة التالية: تحقق من مفتاح idempotency في payments/service.py

تقرأ الجلسة الجديدة الملف وتتابع العمل مباشرة من النقطة الصحيحة. لم يتغيّر النموذج، بل تغيّر الهارنس.

الخلاصة

هارنس الوكيل هو التعليمات والأدوات والبيئة والحالة والتغذية الراجعة المحيطة بالنموذج. وهو ما يحدد هل يعمل الوكيل نفسه بثبات أم يتعطل كثيرًا. وقد شرحنا كيفية بناء كل جزء منه عمليًا في دورة هندسة الهارنس.