تصميم بنية وكيل الحملات البريدية

1. ما هو "وكيل إدارة الحملات البريدية"؟ وماذا سيفعل؟

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

تخيل أن لديك قائمة بـ 100 عميل محتمل وتريد إرسال بريد إلكتروني لكل منهم للتعريف بمنتج جديد. يمكنك إرسال نفس الرسالة للجميع، ولكن هذا غير فعال. الرسائل المخصصة تحقق نتائج أفضل بكثير.

هنا يأتي دور وكيلنا. بدلاً من مجرد إرسال نسخة مكررة، سيقوم وكيلنا بالمهام التالية:

1. قراءة قائمة المستلمين من ملف (مثل ملف CSV أو JSON).
2. فهم بيانات كل مستلم (مثل الاسم، اسم الشركة، الاهتمامات السابقة).
3. استخدام نموذج لغوي كبير (LLM) لتخصيص نص البريد الإلكتروني لكل مستلم على حدة، مما يجعل الرسالة تبدو وكأنها كُتبت خصيصًا له.
4. إرسال البريد الإلكتروني المخصص لكل مستلم في القائمة.

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

2. تحديد المكونات الأساسية للوكيل

كما تعلمنا في الوحدات السابقة، يتكون أي وكيل ذكاء اصطناعي من عدة مكونات رئيسية تعمل معًا. الآن، دعنا نحدد هذه المكونات في سياق وكيلنا لإدارة البريد الإلكتروني.

للحصول على شرح تفصيلي ومُنظم لهذه المكونات، أدعوك لقراءة القسم التالي من مقال AWS الذي استعنّا به سابقًا. سيرسّخ هذا النص فهمك لكيفية ارتباط هذه الأجزاء ببعضها البعض.

بناءً على ما قرأته وما تعلمناه سابقًا، دعنا نفصّل مكونات وكيلنا:

أ. العقل المدبر (The Brain - LLM)

هذا هو محرك التفكير في وكيلنا.

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

ب. الذاكرة (Memory)

يحتاج وكيلنا إلى الوصول إلى المعلومات لتنفيذ مهمته.

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

ج. الأدوات (Tools)

هذه هي "أيدي" الوكيل التي تسمح له بالتفاعل مع العالم الرقمي وإنجاز المهام. سيحتاج وكيلنا إلى أداتين رئيسيتين على الأقل:

1. read_contacts_file(file_path): أداة (ستكون دالة في بايثون) لقراءة ملف المستلمين وتحميل بياناتهم إلى الذاكرة. هذا يربطنا بما تعلمناه في الوحدة الثانية حول التعامل مع الملفات.
2. send_email(to_address, subject, body): أداة للتفاعل مع خدمة بريد إلكتروني (عبر API) لإرسال الرسالة المخصصة. هذا يربطنا بما تعلمناه في الوحدة الثانية حول استخدام واجهات برمجة التطبيقات (APIs).

د. المنطق وخطة العمل (Reasoning & Plan)

هذا هو "اللاصق" الذي يربط جميع المكونات معًا. إنه يمثل دورة حياة الوكيل (Perceive-Think-Act) التي ناقشناها سابقًا. ستكون خطة وكيلنا واضحة ومباشرة:

1. الإدراك (Perceive): يستقبل الوكيل الهدف من المستخدم (مثلاً: "أرسل حملة إطلاق المنتج الجديد باستخدام ملف contacts.json").
2. التفكير والتخطيط (Think/Plan): يضع الوكيل خطة عمل متسلسلة:
   • "الهدف هو إرسال حملة بريدية."
   • "أولاً، يجب أن أقرأ قائمة المستلمين. سأستخدم أداة read_contacts_file."
   • "ثانيًا، سأمر على كل مستلم في القائمة، واحدًا تلو الآخر."
   • "لكل مستلم، سأقوم بـ:
     • أ. صياغة طلب (prompt) لـ "عقلي" (LLM) يحتوي على القالب وبيانات هذا المستلم.
     • ب. الحصول على النص المخصص من الـ LLM.
     • ج. استخدام أداة send_email لإرسال هذا النص إلى عنوان بريد المستلم."
   • "أخيرًا، بعد الانتهاء من جميع المستلمين، سأبلغ المستخدم بأن المهمة قد اكتملت."
3. التنفيذ (Act): يبدأ الوكيل في تنفيذ الخطة خطوة بخطوة، مستدعيًا الأدوات والعقل المدبر حسب الحاجة.

3. تصور بنية الوكيل

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

بنية وكيلنا يمكن تلخيصها في المخطط البسيط التالي:

المدخلات: هدف من المستخدم (مثل اسم الحملة وملف جهات الاتصال)
↓
وكيل البريد الإلكتروني (حلقة العمل):

1. استدعاء الأداة: read_contacts_file() ⬅️ (يقرأ contacts.json)
2. حلقة تكرارية (Loop) لكل جهة اتصال:
   • التفكير: يدمج بيانات جهة الاتصال مع قالب البريد لإنشاء طلب (prompt).
   • استدعاء العقل (LLM): يرسل الطلب للحصول على نص البريد المخصص.
   • استدعاء الأداة: send_email() ⬅️ (يرسل البريد المخصص لجهة الاتصال الحالية).
     ↓
     الناتج: تقرير اكتمال المهمة.

خلاصة الدرس

لقد قمنا اليوم بإنجاز أهم خطوة في مشروعنا: وضع الأساس التصميمي.

• حددنا الهدف: بناء وكيل قادر على إرسال حملات بريد إلكتروني مخصصة.
• فصّلنا المكونات: حددنا دور كل من العقل المدبر (LLM) في التخصيص، والذاكرة (ملف جهات الاتصال)، والأدوات (قراءة الملفات وإرسال البريد).
• رسمنا الخطة: وضعنا تسلسلًا منطقيًا للخطوات التي سيتبعها الوكيل (اقرأ، فكر، خصص، أرسل، كرّر).

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

ماذا بعد؟

الآن بعد أن أصبح لدينا التصميم، نحن جاهزون للبدء في البناء الفعلي. في الدرس القادم، سننتقل من التخطيط إلى البرمجة. سنقوم بـ "تنظيم بنية الوكيل باستخدام الفئات (Classes) في بايثون" وسنكتب الهيكل الأساسي لحلقة عمل الوكيل (Perceive-Think-Act loop) التي ستكون بمثابة مركز التحكم الذي ينسق عمل جميع المكونات التي صممناها اليوم. استعد لكتابة الكود