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

ما ستصبح قادراً عليه في هذا الفصل

الهدف «أن تحسّن الوكيل بأرقام مقيسة، لا بالحدس»

تستطيع قياس الجودة
تصمّم ماذا تقيس وكيف: ليس النتاج النهائي وحده، بل المسار في المنتصف والتكلفة والتأخير أيضاً.
تستطيع تتبّع الحركة
تسجّل كلّ خطوة بـأثر التنفيذ (trace)، وتعيد إنتاج الفشل فتصل إلى سببه.
تستطيع إدارة التحسين
بحلقة قِس ← اكتشف الضعف ← أصلِح ← قِس ثانية، تديم رفع الجودة دون اتّكال على الحدس.

لماذا التقييم هو الأهمّ

البرنامج العاديّ، إن أعطيته الدخل نفسه أعاد النتيجة نفسها. لكنّ في قلب الوكيل يقف الـLLM، وخرْجه احتماليّ. بالتعليمة نفسها، تتغيّر قليلاً في كلّ مرّة الأدواتُ المختارة والخطواتُ والصياغة. أي إنّ عمله جيّداً مرّةً لا يضمن أبداً نجاحه في المرّة التالية.

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

💡 ما لا يُقاس لا يُحسَّن. «أشعر نوعاً ما أنه تحسّن» ليس تحسيناً. حين غيّرت التعليمة، أارتفع معدّل النجاح أم انخفض؟ حين أضفت أداةً، ألم يزدد البطء والتكلفة بلا داعٍ؟ لا تستطيع الحكم بأنّ التغيير تقدّم أم تراجع إلا حين تقارن بالأرقام. التقييم ليس «واجباً بعد الصنع» بل أساس التطوير.

والمهمّ الآخر ألّا تؤجّل التقييم. لا حاجة لأساس تقييم مكتمل من البداية. لكن حين تمضي بمنطق «اصنع أوّلاً، وإن عمل ففكّر بالتقييم»، فغالباً لا يُصنع التقييم أبداً. أن تبدأ القياس فور صنع أول وكيل ولو صغيراً هو — رغم أنه يبدو التفافاً — أقصر طريق. للصورة الكاملة للتقييم الدليل العمليّ لتقييم وكلاء الذكاء الاصطناعي، ولمعنى المصطلح أصلاً ما هو تقييم الوكلاء (evals) مدخل.

ماذا نقيّم ― النتاج والمسار

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

لذا نفكّر في هدف التقييم مقسّماً إلى أربعة جوانب. إن أبقيت هذه الأربعة في ذهنك، زالت حيرة «لا أدري ماذا أقيس».

🎯 صحّة النتاج النهائي

أحقّق الهدف المُعطى؟ أالجواب دقيق ويلبّي المتطلّبات؟ أكثر المؤشّرات أساسيّةً.

🧭 المسار في المنتصف (trajectory)

أيّ أداة استدعى، وبأيّ ترتيب، ولماذا. أالمسار سليم؟ أخلا من الالتفاف والخطوات غير اللازمة؟

🔧 ملاءمة استدعاء الأدوات

أاستدعى الأداة الصحيحة بالوسائط الصحيحة؟ ألم يستدعِ أداةً غير موجودة أو يهمل فشلاً؟

💰 التكلفة والتأخير

كمّية الرموز والرسوم والزمن المستهلك في تنفيذ واحد. أهي متوازنة مع الجودة؟

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

خمسة أساليب للتقييم

«إذن كيف نقيس» — هنا صلب العمل الفعليّ. لأساليب التقييم أنواع عدّة، ولكلٍّ مواطن قوّة وضعف مختلفة. القاعدة ألّا تتّكل على واحد، بل تركّب حسب الهدف المُقاس. لننظر إلى خمسة ممثِّلة، مع محاسنها ومساوئها.

① مطابقة الحقيقة المرجعية (Ground Truth)

تطابق «الجواب الصحيح» المُهيّأ سلفاً مع خرْج الوكيل وتقيس التطابق. مناسب لمهامّ يتحدّد جوابها في واحد، كالتصنيف والاستخلاص والحساب.

الميزة: واضح، سهل الأتمتة، لا يتذبذب.

العيب: يصعب استخدامه في النصّ الحرّ الذي «لا يتحدّد جوابه في واحد».

② القائم على القواعد

يحكم آلياً بشروط محدّدة، مثل «هل تحتوي الكلمة الإلزامية» و«هل الصيغة سليمة كـJSON» و«هل تخلو من كلمة محظورة».

الميزة: سريع ومنخفض التكلفة، قويّ في فحص الصيغة وشروط الأمان.

العيب: لا يقيس الجودة الغامضة مثل «هل المعنى صحيح».

③ LLM-as-judge (تجعل الذكاء الاصطناعي يصحّح)

تعطي LLM آخر معايير التصحيح فيقيّم جودة الخرْج. يقيس المهامّ التي لا يتحدّد جوابها في واحد، كجودة التلخيص ولطف الإجابة.

الميزة: يقيّم آلياً وبكثرة النصّ الحرّ والجودة الذاتية.

العيب: المصحّح نفسه يتذبذب/ينحاز. يلزم توثيق المعايير وفحصٌ يدويّ بالعيّنة.

④ اختبار الانحدار (regression)

تجمع المهامّ الممثِّلة في مجموعة اختبار، وتشغّلها دفعةً عند كلّ تغيير. آليةٌ تحمي «ألم ينكسر ما كان يمرّ حتى الأمس بتعديل اليوم».

الميزة: يكشف مبكّراً التدهور (degradation) الناتج عن التغيير.

العيب: يكلّف عناءً في تجهيز مجموعة الاختبار وصيانتها.

⑤ مراقبة الإنتاج

بعد الإطلاق، تراقب باستمرار تنفيذ المستخدمين الحقيقيين. تتبّع الأداء الواقعيّ بجمع تحوّل معدّل النجاح والتكلفة والتأخير، وتقييم المستخدم (👍/👎).

الميزة: يكشف مشاكل لا تظهر إلا في البيئة الحقيقية، واستخدامات غير متوقّعة.

العيب: لاحقٌ. لا تُعرف المشكلة إلا «بعد وقوعها». يفترض اقترانه بالتقييم القبليّ.

⚠️ التركيب هو الأساس. الصيغة وشروط الأمان بـالقائم على القواعد، وما يتحدّد جوابه بـمطابقة الحقيقة المرجعية، والنصّ الحرّ بـLLM-as-judge، وعند كلّ تغيير بـاختبار الانحدار، وبعد الإطلاق بـمراقبة الإنتاج. لا تحاول تغطية الكلّ بأسلوب واحد. إن غربلت المعظم بالأساليب الرخيصة السريعة (①②)، واستخدمت الغالي (③) في الجزء اللازم فقط، حفظت الدقّة مع كبح التكلفة. للتفصيل راجع ما هو تقييم نماذج اللغة.

كيف تصنع بيانات التقييم (مجموعة الاختبار)

مهما كان الأسلوب، فأساسه «مادّة ما تقيس» = بيانات التقييم (مجموعة الاختبار). وهي بإيجاز مجموعة من المهامّ الممثِّلة تقول «أمام هذا الدخل، أريد هذه النتيجة». إن كانت هزيلة، فلا يُعتمد على أيّ أسلوب تقييم مهما كان بديعاً. وبالعكس، إن امتلكت مجموعة اختبار جيّدة، فكأنّ ثمانين بالمئة من التقييم قد نجحت.

طريقة الصنع بسيطة، تمضي بالترتيب التالي. بدل السعي للكمال، القاعدة الذهبية أن تبدأ صغيراً وتربّي.

STEP 1
اجمع المهامّ الممثِّلة

اجمع الطلبات التي يُرجَّح أن يُطلبها الوكيل فعلاً، متضمّنةً أمثلة نمطية وحدّية وقابلة للفشل.

STEP 2
حدّد النتيجة المتوقّعة

اكتب لكلّ مهمّة «ما تريد أن يكون». جواباً صحيحاً، أو شرطاً يجب استيفاؤه، أو معياراً للتصحيح.

STEP 3
ابدأ من قليل

تكفي في البداية 10~20 حالة. قدّم «الجودة» التي تعكس واقع الميدان على الكمّية.

STEP 4
ربِّها من الفشل

أضِف إلى مجموعة الاختبار أمثلة الفشل المكتشفة في الإنتاج. تصير أصلاً يزداد ذكاءً كلّما استُخدم.

✅ لا تستخفّ بـ«عشر حالات فقط». قد تشعر أنّ «العيّنة قليلة جداً بلا معنى». لكنّ عشر حالات منتقاة بعناية أنفع بكثير من ألف حالة مجموعة على عواهنها. أن تجعل عشر حالات ممثِّلة تعانيها فعلاً قابلةً للقياس أوّلاً، يكفي وحده لتحكم في الحال هل تغيير التعليمة أو الأدوات في الاتجاه الجيّد أم السيّئ. ومجموعة الاختبار ليست تُصنع مرّةً وتنتهي، بل أصلٌ حيّ يُربّى بإضافة حالة واحدة كلّما وجدت فشلاً.

القابلية للمراقبة ― جعل الحركة مرئيّة

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

عناصر القابلية للمراقبة أساساً ثلاثة.

🧵 أثر التنفيذ (trace)

تسجيل تنفيذ واحد من أوّله إلى آخره كاملاً. تتبّع بأكمله زمنياً سلسلةَ «الدخل ← التفكير ← استدعاء الأداة ← النتيجة ← الحكم التالي».

📋 سجلّ كلّ خطوة

في كلّ خطوة: أيّ تعليمة أرسل، وبأيّ وسائط استدعى الأداة، وماذا أُعيد. أبقِ هنا أيضاً استهلاك الرموز والزمن.

🔁 إعادة إنتاج الفشل

أن تستطيع تتبّع التنفيذ الذي وقعت فيه المشكلة مرّةً أخرى بالدخل نفسه والحالة نفسها. لا تحديدَ للسبب ولا تحقّقَ من الإصلاح إلا بعد إمكان إعادة الإنتاج.

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

▼ تصوّر الأثر (تنفيذ واحد)
execution #4837 time 8.2s tokens 12,400
├─ ① think: "ابحث عن مكان بيانات المبيعات"
├─ ② tool: search_files("sales") → 3 hits 0.4s
├─ ③ tool: read_file("q2.csv") → ok 0.2s
├─ ④ tool: calc_sum(col=99) → ✗ column not found 0.1s
├─ ⑤ think: "صحّح رقم العمود وأعِد المحاولة"
└─ ⑥ tool: calc_sum(col=3) → ok 0.2s

📊 الأثر «عين التنقيح». في المثال أعلاه، فشل استدعاء الأداة في ④، وأعاد الوكيل نفسه الاستقامة في ⑤. لو نظرت إلى النتيجة وحدها فهي «نجاح»، لكن برؤية الأثر يظهر ضعفُ «سهولة الخطأ في رقم العمود». هذا الانتباه يقود إلى التحسين التالي. فكرة القابلية للمراقبة مشروحة منهجياً في ما هي قابلية الذكاء الاصطناعي للمراقبة (observability).

إدارة حلقة التحسين

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

📏
① قِس

شغّل التقييم على مجموعة الاختبار، وأخرِج معدّل النجاح والتكلفة والتأخير أرقاماً.

🔍
② اكتشف الضعف

اقرأ أثر التنفيذ الفاشل، وتبيّن أين ولماذا أخطأ.

🛠
③ أصلِح

غيّر جزءاً واحداً يمسّ السبب: التعليمة، أو وصف الأداة، أو المسار، أو تقسيم الأدوار.

🔁
④ قِس ثانية

أعِد التقييم بمجموعة الاختبار نفسها، وتحقّق أظهر التحسين المقصود وألم يسُؤ غيره.

لهذه الحلقة حيلة مهمّة واحدة: أن يكون ما تغيّره في المرّة الواحدة واحداً قدر الإمكان. لو غيّرت التعليمة والأدوات والمسار في آنٍ، فحتى لو ارتفع معدّل النجاح لم تعرف «أيّ تغيير أثّر». ولأنّك تغيّر واحداً وتقيس، يتّصل السببُ بين التغيير والنتيجة، وتتراكم المعرفة. متواضعٌ، لكنّه الحدّ الفاصل بين «التحسين على نحو غامض» و«التحسين المؤكّد».

✅ أدِر الحلقة سريعةً وصغيرة. بدل ضربةٍ واحدة كبيرة بإصلاح ضخم، فإنّ إدارة تغييرات صغيرة سريعاً مراراً تحسّن أسرع في النهاية. إن كانت مجموعة الاختبار عشر حالات، قِست فور التغيير. حين تكتسب إيقاع «غيّر ← قِس فوراً» هذا، يتحوّل تطوير الوكلاء من تخمين حدسيّ إلى عمل هندسيّ يتقدّم بثبات.

خلاصة هذا الفصل
  • الوكيل احتماليّ و«عمل» لا يعني حتماً «صحيح». ما لم تقِس لم تحسّن.
  • هدف التقييم أربعة جوانب — النتاج النهائي، والمسار في المنتصف، واستدعاء الأدوات، والتكلفة والتأخير. و«المسار» خاصّةً جوهر تقييم الوكلاء.
  • الأساليب خمسة — مطابقة الحقيقة المرجعية، والقائم على القواعد، وLLM-as-judge، واختبار الانحدار، ومراقبة الإنتاج — تركّبها حسب الهدف.
  • بيانات التقييم: مهامّ ممثِّلة من قليل. عشر حالات بعناية تغلب ألفاً على عواهنها. ربِّها بإضافة الفشل.
  • القابلية للمراقبة: أثر التنفيذ، وسجلّ كلّ خطوة، وإعادة إنتاج الفشل. اجعل الحركة مرئيّة بأداة تتبّع.
  • التحسين حلقةُ قِس ← اكتشف الضعف ← أصلِح ← قِس ثانية. غيّر واحداً واحداً، صغيراً وسريعاً.

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