مشاريع تطبيقية
Practical Projects
وحدة تطبيقية تجمع كل ما سبق في مشاريع كاملة: من الفكرة والتصميم إلى البناء والاختبار والنشر، وتنتهي بمشروع تخرج.
عن الوحدة
هذه الوحدة هي ورشة العمل الختامية في الأكاديمية. بدل دراسة مفهوم واحد في كل درس، نبني وكلاء كاملين لحل مشكلات واقعية. نبدأ بمنهجية تحويل الفكرة إلى تصميم: تحديد المستخدم والمهمة ومستوى الاستقلالية والأدوات والذاكرة. ثم نبني ثلاثة وكلاء نموذجيين: وكيل بحث يجمع المصادر ويلخصها مع الاستشهاد، ووكيل دعم فني يجيب من قاعدة معرفة ويصعّد إلى إنسان عند الحاجة، ووكيل تحليل بيانات يحسب ولا يخمّن. بعد ذلك نتعلم اختبار الوكيل ونشره بأمان مع المراقبة والحدود التشغيلية. وتنتهي الوحدة بدليل مشروع التخرج الذي يحدد المراحل والمخرجات ومعايير التقييم، مع تطبيق عملي في محاكي الأكاديمية التعليمي الذي يعمل بقواعد محددة لا بنموذج لغوي حقيقي.
أهداف التعلم
- تحويل فكرة وكيل إلى وثيقة تصميم تحدد المهمة والأدوات والذاكرة ومستوى الاستقلالية
- بناء وكيل بحث ووكيل دعم فني ووكيل تحليل بيانات بمكونات بسيطة قابلة للاختبار
- كتابة اختبارات وحدات واختبارات سيناريو لوكيل قبل نشره
- تطبيق ضوابط النشر: حدود الخطوات والتكلفة والمراقبة والتصعيد البشري
- إنجاز مشروع تخرج موثق وفق معايير قبول واضحة
المتطلبات السابقة
- إتمام وحدات المستوى الأول: الأساسيات (fundamentals) والذاكرة (memory) والأدوات (tools)
- إتمام وحدتي التخطيط (planning) والوكلاء المتعددين (multi-agent)
- إتمام وحدة تقييم الوكلاء وأمنها (evaluation-security)
- الاطلاع على وحدة الأطر (frameworks) إن أردت تنفيذ المشروع بإطار عمل
المهارات المكتسبة
الدروس
- 1من الفكرة إلى التصميمFrom Idea to Designأغلب مشاريع الوكلاء التي تفشل لا تفشل بسبب الكود، بل لأن المشكلة لم تُحدد جيدًا أو لأن الفريق بنى وكيلًا حيث يكفي سير عمل بسيط. في هذا الدرس…
- 2بناء وكيل بحثBuilding a Research Agentوكيل البحث من أكثر المشاريع فائدة للطلاب والباحثين: يستقبل سؤالًا، يبحث في مصادر متعددة، يقرأ ويقارن، ثم يكتب ملخصًا مستشهدًا بمصادره. في هذ…
- 3بناء وكيل دعم فنيBuilding a Support Agentوكيل الدعم الفني يتعامل مع أشخاص حقيقيين لديهم مشكلة الآن، لذلك يجب أن يكون دقيقًا ومهذبًا ويعرف متى يتوقف ويحوّل المحادثة إلى إنسان. في هذا…
- 4بناء وكيل تحليل بياناتBuilding a Data Analysis Agentالنماذج اللغوية بارعة في فهم السؤال وكتابة الشرح، لكنها ليست آلة حاسبة موثوقة. وكيل تحليل البيانات الجيد يقسم العمل: النموذج يفهم السؤال ويخ…
- 5اختبار الوكيل ونشرهTesting and Deploymentالوكيل الذي يعمل على جهازك أمام حالات جربتها بنفسك لم يصبح جاهزًا للمستخدمين بعد. في هذا الدرس نبني هرم اختبارات خاصًا بالوكلاء، من اختبار ا…
- 6دليل مشروع التخرجCapstone Project Guideهذا الدرس دليلك العملي لمشروع التخرج في الأكاديمية. يجمع كل ما تعلمته من الأساسيات حتى الأمان في مشروع واحد متكامل: وكيل يحل مشكلة حقيقية لم…
مخططات الوحدة
مصطلحات الوحدة
| المصطلح | English | التعريف |
|---|---|---|
| سير العمل | Workflow | نظام يتبع مسارًا محددًا مسبقًا في الكود |
| وثيقة تصميم الوكيل | Agent Design Doc | وثيقة تحدد المستخدم والمهمة والأدوات والذاكرة والحدود |
| معايير النجاح | Success Criteria | شروط قابلة للفحص تحدد متى تُعد المهمة منجزة |
| مستوى الاستقلالية | Autonomy Level | مقدار ما يفعله الوكيل دون تدخل بشري |
| النطاق | Scope | حدود ما يغطيه الوكيل وما يحيله إلى غيره |
| وكيل البحث | Research Agent | وكيل يجمع المعلومات من مصادر ويكتب إجابة مستشهدًا بها |
| التجميع | Synthesis | دمج المعلومات من مصادر متعددة في إجابة متماسكة |
| الاستشهاد | Citation | ربط كل ادعاء بمعرّف المصدر الذي يدعمه |
| الاستشهاد المختلق | Fabricated Citation | ذكر مصدر غير موجود أو لا يدعم الادعاء |
| التغطية | Coverage | مدى إجابة النتيجة عن كل الأسئلة الفرعية |
| التصعيد | Escalation | تحويل المحادثة إلى موظف بشري عند الحاجة |
| تصنيف النية | Intent Classification | تحديد نوع طلب المستخدم لتوجيهه إلى المسار المناسب |
| تذكرة | Ticket | سجل لطلب دعم يتابعه فريق بشري |
| التسليم | Handoff | نقل المحادثة مع سياقها إلى وكيل آخر أو إنسان |
| خارج النطاق | Out of Scope | طلب لا يغطيه الوكيل ويجب إحالته |
| وكيل تحليل البيانات | Data Analysis Agent | وكيل يجيب عن أسئلة حول بيانات بحسابات تنفذها الأدوات |
| التجميع الإحصائي | Aggregation | حساب قيمة واحدة من مجموعة قيم مثل المتوسط أو العدد |
| القيم الناقصة | Missing Values | خانات فارغة في البيانات يجب الإبلاغ عنها لا تجاهلها بصمت |
| الخطة المنظمة | Structured Plan | تمثيل السؤال بحقول محددة مثل العمود والعملية والتصفية |
| تنفيذ الكود | Code Execution | تشغيل كود يكتبه النموذج، ويتطلب عزلًا صارمًا |
| اختبار الوحدة | Unit Test | اختبار دالة أو أداة واحدة بمعزل عن بقية النظام |
| نموذج وهمي | Mock Model | دالة تحل محل النموذج اللغوي وتعيد ردودًا محددة مسبقًا للاختبار |
| تشغيل الظل | Shadow Mode | تشغيل النظام على طلبات حقيقية دون إيصال مخرجاته للمستخدمين |
| التراجع | Rollback | العودة السريعة إلى إصدار سابق مستقر |
| إدارة الإصدارات | Versioning | ترقيم التعليمات والأدوات والنموذج لتتبع التغييرات |
| مشروع التخرج | Capstone Project | مشروع ختامي يجمع مهارات البرنامج في منتج متكامل |
| قواعد التقدير | Rubric | معايير تقييم معلنة مسبقًا بأوزان محددة |
| النموذج الأولي | Prototype | نسخة أولى عاملة تختبر الفكرة قبل التطوير الكامل |
| تحليل التهديدات | Threat Analysis | تحديد طرق إساءة استخدام النظام والدفاعات المقابلة |
| المُخرَج | Deliverable | ناتج محدد يُسلَّم في نهاية مرحلة |
التجربة التطبيقية
محاكاة مشروعك الختامي قبل كتابة الشيفرة Simulate Your Capstone
أن تصمم معمارية مشروعك الختامي في المحاكي، وتختبر مسارات النجاح والفشل، ثم تصدّرها مخططاً مرجعياً للتنفيذ الفعلي.
- اختر مشروعاً من صفحة المشاريع وافتح قالب المحاكي المرتبط به (افتح ↗)
- عدّل المخطط ليطابق تصميمك: عقد Agent بأدوار وأدوات محددة، وMemory، وPlanner إن لزم، وHuman Approval قبل الأفعال الحساسة
- اضبط لكل Agent القيم maxSteps وretry وtimeout بحسب طبيعة المهمة
- شغّل مسار النجاح، ثم فعّل fail لأداة واحدة وشغّل مسار الفشل
- تأكد من عدم وجود عقد غير متصلة، وأن كل فرع ينتهي بـ Output وEnd
- صدّر المخطط بصيغة JSON واحفظه مع وثيقة التصميم
- اكتب لكل عقدة ما سيقابلها في الشيفرة الحقيقية
ما الذي ستلاحظه: ستخرج بمخطط مُختبر لمسارين على الأقل، وبقائمة واضحة بالمكونات التي ستكتبها. ستكتشف مشكلات التصميم، مثل فرع بلا نهاية أو أداة بلا معالجة فشل، قبل أن تكلفك وقتاً أو استدعاءات حقيقية.
المهمة الختامية
أنجز مشروع تخرج: وكيل ذكي يحل مشكلة محددة لمستخدم محدد (مثل مساعد إرشاد أكاديمي يجيب من لائحة الكلية). المخرجات: (1) وثيقة تصميم من صفحتين تشمل المهمة، والأدوات بمخططاتها، ونوع الذاكرة، ومستوى الاستقلالية، ونقاط الموافقة البشرية؛ (2) نموذج أولي يعمل في محاكي الأكاديمية أو بكود Python؛ (3) مجموعة تقييم من 20 حالة على الأقل مع نتائج مقاسة؛ (4) تحليل أمني يتضمن حالتي حقن أوامر على الأقل؛ (5) عرض مدته عشر دقائق. معايير القبول: الوكيل يرفض أو يصعّد عند غياب المعلومة بدل الاختلاق، كل أداة كتابة محمية بموافقة، ونتائج التقييم قابلة لإعادة الإنتاج.
تقييم الإكمال: تُعد الوحدة مكتملة عندما تنهي جميع دروسها وتنجح في اختبارها.
المراجع الرسمية
- Building effective agents (Anthropic, 2024) www.anthropic.com روجع في 2026-11-18
- Building agents track (OpenAI) developers.openai.com روجع في 2026-11-18
- Retrieval-Augmented Generation (Lewis et al., 2020) arxiv.org روجع في 2026-11-18
