ما هو إطار تشغيل الوكلاء (Agent Harness)؟ الدليل الشامل لبنية وكلاء الذكاء الاصطناعي

مع تطوّر النماذج اللغوية الكبيرة، انتقل الاهتمام من مجرد «الدردشة» مع النموذج إلى بناء وكلاء (Agents) قادرين على إنجاز مهام حقيقية: قراءة الملفات، تنفيذ الأوامر، البحث في الويب، وتعديل الأكواد. لكن النموذج وحده لا يكفي — فهو يولّد نصاً فقط. ما يحوّل هذا النص إلى أفعال حقيقية هو ما نسمّيه إطار تشغيل الوكيل (Agent Harness). في هذا الدليل المطوّل نفكّك هذا المفهوم من الصفر.

💡 ببساطة: النموذج هو «الدماغ» الذي يقرّر، وإطار التشغيل هو «الجسد والبيئة» الذي يمنح الدماغ حواسّاً (مدخلات) وأطرافاً (أدوات) ويُغلق الحلقة بينهما.

ما هو إطار تشغيل الوكيل؟

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

الفرق بين النموذج والوكيل والإطار

حلقة الوكيل (The Agent Loop)

قلب أي إطار تشغيل هو حلقة بسيطة من حيث المبدأ، عميقة من حيث التفاصيل:

while (not done):
    response = model(context)          # النموذج يقرّر الخطوة التالية
    if response.has_tool_call:
        result = run_tool(response.call)  # نفّذ الأداة (قراءة ملف، أمر، بحث...)
        context.append(result)            # أعِد النتيجة إلى السياق
    else:
        done = True                       # لا توجد أداة مطلوبة → اكتملت المهمة

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

المكوّنات الأساسية لإطار التشغيل

1. النموذج اللغوي (المحرّك)

هو العقل المُقرِّر. تختلف النماذج في قدراتها على الاستدلال واتباع التعليمات واستخدام الأدوات. عائلات حديثة مثل نماذج Claude تُصمَّم خصيصاً لتكون قوية في سيناريوهات الوكلاء واستدعاء الأدوات. اختيار النموذج المناسب للمهمة (سرعة مقابل عمق) قرار تصميمي مهم في أي إطار.

2. موجّه النظام (System Prompt)

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

3. الأدوات (Tools / Function Calling)

الأدوات هي «أطراف» الوكيل التي يؤثّر بها على العالم. كل أداة لها اسم، ووصف، ومخطّط للمدخلات (Schema). يقرّر النموذج أيّ أداة يستدعي وبأيّ وسائط، بينما ينفّذها الإطار فعلياً. أمثلة شائعة:

• قراءة وكتابة الملفات.
• تنفيذ أوامر الطرفية.
• البحث في الويب أو في قاعدة معرفة.
• الاستعلام من قواعد البيانات أو واجهات برمجية (APIs).

💡 جودة وصف الأداة لا تقلّ أهمية عن الكود نفسه: وصف واضح يجعل النموذج يستخدمها بدقّة، ووصف غامض يقوده لأخطاء.

4. إدارة السياق والذاكرة (Context Management)

للنماذج «نافذة سياق» محدودة. مع طول المهمة تمتلئ النافذة بالمحادثات ونتائج الأدوات. لذا يتولّى الإطار إدارة ذكية للسياق: تلخيص ما مضى، حذف التفاصيل غير المهمة، أو حفظ المعلومات في ذاكرة خارجية (ملفات أو قاعدة بيانات) واستحضارها عند الحاجة. إدارة السياق الجيدة هي ما يسمح للوكيل بإنجاز مهام طويلة دون أن «ينسى» هدفه.

5. بيئة التنفيذ والصلاحيات (Sandbox & Permissions)

بما أن الوكيل ينفّذ أفعالاً حقيقية، يجب أن يعمل داخل بيئة محكومة. يوفّر الإطار:

• عزل (Sandbox): تقييد ما يمكن للوكيل الوصول إليه من ملفات وشبكة.
• صلاحيات (Permissions): طلب موافقة المستخدم قبل الأفعال الحسّاسة (حذف، إرسال بيانات خارجية).
• حدود (Limits): سقف لعدد الخطوات أو التكلفة لتفادي الحلقات اللانهائية.

⚠️ مبدأ أمني جوهري: الوكيل قوي بقدر أدواته، وخطر بقدرها أيضاً. الصلاحية الأدنى (Least Privilege) قاعدة ذهبية — لا تمنح الوكيل إلا ما يحتاجه فعلاً.

6. التحقّق والمراقبة (Verification & Observability)

الوكيل قد «يهلوس» أو يخطئ بثقة. لذا تضيف الأطر الجيدة طبقات تحقّق: تشغيل الاختبارات بعد تعديل الكود، التأكد من نجاح الأمر فعلاً، أو حتى استدعاء وكيل ثانٍ «ناقد» يراجع النتيجة. كما تسجّل الأطر كل خطوة (Logging) لتتبّع ما فعله الوكيل ولماذا.

تنسيق عدة وكلاء (Multi-agent Orchestration)

للمهام الكبيرة، قد لا يكفي وكيل واحد. تتيح بعض الأطر تشغيل عدة وكلاء بالتوازي، كلٌّ متخصّص: وكيل يبحث، وآخر يكتب، وثالث يراجع. ثم يجمع وكيل «منسّق» النتائج. هذا النمط يزيد الشمول والموثوقية، لكنه يضيف تعقيداً في التنسيق وإدارة التكلفة.

أمثلة واقعية

• أدوات سطر الأوامر البرمجية: مثل Claude Code، حيث يعمل الوكيل داخل مشروعك: يقرأ الملفات، يعدّلها، يشغّل الأوامر والاختبارات، ضمن نظام صلاحيات يحمي عملك.
• مجموعات تطوير الوكلاء (Agent SDKs): مثل Claude Agent SDK، التي تمنح المطوّرين لبِنات جاهزة لبناء وكلائهم الخاصّين: الحلقة، الأدوات، إدارة السياق، والصلاحيات.
• وكلاء داخل المتصفح أو الخوادم: لأتمتة المهام المتكرّرة وربط الأنظمة ببعضها.

تحديات بناء إطار موثوق

1. الموثوقية: ضمان أن يُنهي الوكيل المهمة فعلاً لا أن «يدّعي» إنهاءها.
2. التكلفة: كل خطوة استدعاء للنموذج لها كلفة؛ الإطار يجب أن يكون اقتصادياً.
3. الأمان: منع الأفعال الضارة وحقن التعليمات الخبيثة (Prompt Injection) عبر المحتوى الذي يقرأه الوكيل.
4. إدارة الأخطاء: ماذا يحدث حين تفشل أداة؟ الإطار الجيد يلتقط الخطأ ويعيد المحاولة بذكاء.

أفضل الممارسات

• ابدأ بسيطاً: حلقة + بضع أدوات واضحة، ثم وسّع تدريجياً.
• اكتب أوصاف أدوات دقيقة ومخطّطات مدخلات صارمة.
• طبّق الصلاحية الأدنى واطلب موافقة المستخدم للأفعال الخطرة.
• أضف تحقّقاً بعد كل فعل مؤثّر (اختبارات، فحص نتائج).
• سجّل كل خطوة لتسهيل التشخيص.
• ضع سقوفاً للخطوات والتكلفة لتفادي الحلقات اللانهائية.

خلاصة

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