اختبار وكيل إدارة الحملات

1. من "هل يعمل؟" إلى "هل هو جيد؟"

نجاح أي وكيل ذكاء اصطناعي يُقاس على مستويين:

1. النجاح التقني (Technical Success): هل يعمل الكود بدون أخطاء؟ هل يتم إرسال الرسائل إلى العناوين الصحيحة؟ هل تتصل الأدوات بواجهات برمجة التطبيقات (APIs) بنجاح؟ لقد تأكدنا من هذا الجانب في الدرس الماضي.
2. النجاح النوعي (Qualitative Success): هل المخرجات التي ينتجها الوكيل (في حالتنا، نصوص الرسائل) تحقق الهدف المرجو؟ هل هي مقنعة، شخصية، وخالية من الأخطاء؟ هذا هو محور تركيزنا اليوم.

انظر إلى مخطط سير العمل المعقد هذا. في قلب هذا النظام يوجد "وكيل ذكاء اصطناعي" (AI Agent). مهمتنا اليوم هي بمثابة فتح هذا الصندوق الأسود وتقييم جودة القرارات والمخرجات التي ينتجها.

2. إعداد وتقييم حملتك الاختبارية

لإجراء اختبار فعال، تحتاج إلى مجموعة صغيرة ومتنوعة من البيانات.

الخطوة 1: تجهيز بيانات الاختبار

تأكد من أن ملف recipients.csv الخاص بك يحتوي على 2-3 مستلمين ببيانات مختلفة قليلاً. هذا سيساعدك على رؤية كيف يتكيف الوكيل مع سيناريوهات متعددة. مثال:

name,email,city
أحمد,your-test-email-1@domain.com,الرياض
نورة,your-test-email-2@domain.com,دبي
(بدون اسم),your-test-email-3@domain.com,الدمام

• لماذا هذا التنوع؟
  • "أحمد" يمثل الحالة القياسية.
  • "نورة" من مدينة مختلفة، لاختبار التكيف الجغرافي.
  • "(بدون اسم)" يختبر كيف يتعامل الوكيل مع البيانات المفقودة، وهل يستخدم البديل الذي حددناه في التلقين (عميلنا العزيز).

الخطوة 2: تشغيل الحملة وجمع النتائج

1. تأكد من أن dry_run=False في ملف main.py.
2. قم بتشغيل البرنامج من الطرفية: python main.py.
3. افتح صناديق البريد الإلكتروني التي استخدمتها للاختبار واجمع الرسائل التي أرسلها وكيلك. هذه هي "نتائج" اختبارك.

3. بطاقة الأداء: كيف نقيس الجودة؟

لتقييم الرسائل بشكل موضوعي، سنقوم بإنشاء "بطاقة أداء" (Scorecard) تستند مباشرةً إلى التعليمات التي قدمناها لنموذج اللغة في التلقين (Prompt).

التلقين الذي استخدمناه:

"...اكتب نص بريد إلكتروني قصير جداً وودود. ... المستلم هو {name}، وهو يعيش في مدينة {city}. ... 1. يبدأ بتحية شخصية. 2. يذكر بشكل طبيعي أنه من سكان مدينة [اسم المدينة]. 3. يكون قصيراً ومباشراً (3-4 جمل). 4. ينتهي بدعوة لتجربة الخدمة."

بطاقة الأداء المستخلصة من التلقين:

استخدم هذه البطاقة لتقييم كل بريد إلكتروني تلقيته.

4. تحليل النتائج: الجيد وما يحتاج إلى تحسين

لنفترض أنك تلقيت الرسالتين التاليتين بعد تشغيل حملتك:

الرسالة 1 (إلى أحمد في الرياض):

مرحباً أحمد،
بما أنك في قلب الرياض النابض بالحياة، نعلم أن وقتك ثمين. لهذا نقدم لك وجبات صحية ولذيذة تصلك أينما كنت.
هل تود تجربة الفرق وتذوق أول وجبة بخصم خاص؟
فريقنا بانتظارك!

الرسالة 2 (إلى نورة في دبي):

إلى نورة،
أنت تعيشين في دبي. شركتنا متخصصة في توصيل الطعام.
خدمتنا توفر وجبات صحية.
جربي خدمتنا.

لنقم بتقييم كل رسالة باستخدام بطاقة الأداء:

الاستنتاج: الرسالة الأولى نجحت بامتياز، بينما الرسالة الثانية، رغم أنها صحيحة تقنياً، فشلت في تحقيق الجودة المطلوبة.

5. دورة التحسين: هندسة التلقين (Prompt Engineering)

ماذا تفعل إذا كانت نتائجك تشبه "الرسالة 2"؟ المشكلة هنا ليست في كود بايثون، بل في جودة التعليمات التي قدمتها للذكاء الاصطناعي. هذا هو جوهر ما يسمى بـ "هندسة التلقين" (Prompt Engineering).

إذا كانت النبرة روبوتية، يمكنك تعديل التلقين ليكون أكثر تحديداً:

• التلقين الحالي: تصرف كخبير تسويق عبر البريد الإلكتروني...
• تلقين مُحسّن: تصرف كخبير تسويق متخصص في التواصل الشخصي، واكتب بنبرة حماسية وودودة وكأنك تتحدث إلى صديق.

إذا كان ذكر المدينة يبدو غريباً، يمكنك تزويد النموذج بمثال (وهو أسلوب يسمى Few-shot-prompting):

• تلقين مُحسّن: أضف قسماً جديداً للتلقين:

  مثال على كيفية ذكر المدينة بشكل طبيعي: "بما أنك من سكان جدة المعروفين بذوقهم الرفيع، ستحب بالتأكيد قائمتنا الجديدة."
  
  الآن، اكتب بريداً مشابهاً للمستلم التالي...
  

العمل مع وكلاء الذكاء الاصطناعي هو عملية مستمرة من الاختبار، التقييم، ثم تحسين التلقين.

خلاصة الدرس

في هذا الدرس الأخير من مشروعنا، انتقلنا من مرحلة البناء إلى مرحلة التقييم والجودة. لقد تعلمنا أن:

• اختبار وكيل الذكاء الاصطناعي يشمل كلاً من النجاح التقني (هل يعمل؟) والنجاح النوعي (هل هو جيد؟).
• يمكننا إنشاء "بطاقة أداء" موضوعية لتقييم مخرجات الوكيل بناءً على التعليمات الموجودة في التلقين (Prompt).
• تحليل النتائج يساعدنا في تحديد نقاط القوة والضعف في أداء الوكيل.
• تحسين أداء الوكيل غالباً ما يكون عملية "هندسة تلقين"، حيث نقوم بتعديل التعليمات لتوجيه الذكاء الاصطناعي نحو نتائج أفضل.

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

ماذا بعد؟

لقد بنى وكيلنا حملة رائعة، لكنه يعاني من مشكلة كبيرة: إنه "قصير الذاكرة". لا يتذكر أي شيء عن التفاعلات السابقة. ماذا لو أردنا منه أن يتجنب مراسلة عميل تواصلنا معه الأسبوع الماضي؟ أو أن يتابع محادثة سابقة؟

في الوحدة القادمة، "الذاكرة المتقدمة واسترجاع المعلومات"، سنبدأ في معالجة هذه المشكلة. سنتعلم كيف نمنح وكلاءنا ذاكرة طويلة المدى، مما يجعلهم أكثر ذكاءً وقدرة على بناء علاقات مستمرة. استعد لنقل قدرات وكيلك إلى مستوى جديد تماماً