كتب الذكاء الاصطناعيمشاريع الذكاء الاصطناعيمقالات الذكاء الاصطناعيمعجم الذكاء الاصطناعياسئلة واجوبة في الذكاء الاصطناعيأكاديمية الذكاء الاصطناعي للأطفالأكاديمية الذكاء الاصطناعيمدرسة رياضيات الذكاء الاصطناعيمختبر الذكاء الاصطناعيمختبر الخوارزميات المستوحاة من الطبيعةأطلس نماذج الذكاء الاصطناعيموسوعة تطبيقات الذكاء الاصطناعيمستكشف مجموعات البيانات للذكاء الاصطناعياختبارات الذكاء الاصطناعيالفايب كودينغدليل البرمجة بالذكاء الاصطناعيمولّد مشاريع الذكاء الاصطناعيمرصد الذكاء الاصطناعيدليل أدوات الذكاء الاصطناعي البحث والنشر الأكاديميمكتبة البرومبتات الأكاديميةمستودع الرسائل والأطاريح في الذكاء الاصطناعيحاسبة الترقية العلميةأكاديمية الوكلاء الذكيينمختبر أخلاقيات الذكاء الاصطناعي والعدالةساحة ألعاب الذكاء الاصطناعيمختبر التنبؤ بالسلاسل الزمنيةمتحف الذكاء الاصطناعيمختبر الرؤية الحاسوبيةمختبر الشبكات العصبية البيانيةمختبر معالجة اللغة الطبيعيةمختبر الحوسبة الكمّيةخرائط طريق الذكاء الاصطناعي

أطر بناء الوكلاء

Agent Frameworks

جولة عملية في أشهر أطر بناء الوكلاء: OpenAI Agents SDK وLangGraph وCrewAI وMicrosoft Agent Framework (وريث AutoGen)، وكيف تختار بينها.

متقدمالمستوى
6الدروس
88 دقيقةزمن القراءة
0أسئلة الوحدة

عن الوحدة

بعد أن بنيت الوكيل من مكوّناته الأساسية بيدك، تتعرّف في هذه الوحدة على الأطر (Frameworks) التي تختصر هذا العمل في الواقع. ندرس أربع مدارس في التصميم: حلقة وكيل بسيطة مع تسليم المهام (Handoffs) في OpenAI Agents SDK، ورسم حالة صريح (State Graph) في LangGraph، وفريق أدوار ومهام في CrewAI، ووكلاء ومسارات عمل (Workflows) في Microsoft Agent Framework الذي خلف AutoGen وSemantic Kernel. لكل إطار نعرض الفكرة المركزية، ومقتطفًا موثّقًا يطابق التوثيق الرسمي بتاريخ مراجعة واضح، ومتى يناسب ومتى لا يناسب. ونختم بمنهجية عملية لاختيار إطار وفق متطلبات المشروع بدل اتباع الشهرة، مع التنبيه إلى أن هذه المكتبات تتغير بسرعة فيجب دائمًا مراجعة الإصدار والتوثيق قبل البناء.

أهداف التعلم

  • تمييز الأنماط التصميمية الكبرى وراء أطر الوكلاء: الحلقة، والرسم البياني للحالة، والفريق القائم على الأدوار
  • قراءة مقتطفات OpenAI Agents SDK وLangGraph وCrewAI وMicrosoft Agent Framework وفهم كل سطر فيها
  • تحديد ما يضيفه الإطار فوق حلقة الوكيل اليدوية: التتبع، والاستمرارية، والتسليم، والحواجز
  • إدراك حالة AutoGen الحالية وانتقال الفرق إلى Microsoft Agent Framework
  • اختيار إطار مناسب لمشروع محدد وتبرير الاختيار بمعايير واضحة

المتطلبات السابقة

  • إتمام وحدة الأساسيات (fundamentals) وفهم حلقة الوكيل
  • وحدة الأدوات (tools) واستدعاء الوظائف
  • وحدة الأنظمة متعددة الوكلاء (multi-agent) ومفهوم التسليم والحالة المشتركة
  • معرفة أساسية بلغة Python وبيئات العمل الافتراضية (venv)

المهارات المكتسبة

  • قراءة توثيق إطار وكلاء والتحقق من الإصدار وتاريخ المراجعة
  • كتابة وكيل بسيط بـ OpenAI Agents SDK مع أداة وتسليم
  • بناء رسم حالة في LangGraph بعُقد وحواف واضحة
  • تعريف فريق CrewAI من وكلاء ومهام وعملية تنفيذ
  • مقارنة الأطر عبر مصفوفة معايير موزونة

الدروس

  1. 1خريطة أطر بناء الوكلاءThe Agent Frameworks Landscapeالأطر تختصر الكود المتكرر في بناء الوكلاء، لكنها تختلف في فكرتها المركزية. في هذا الدرس نرى ما الذي يضيفه أي إطار فوق حلقة الوكيل اليدوية، و…14 د
  2. 2OpenAI Agents SDK: الوكيل والمشغّل والتسليمOpenAI Agents SDK: Agents, Runner and Handoffsيقدّم OpenAI Agents SDK عددًا قليلًا من المفاهيم: وكيل، ومشغّل، وتسليم، وحواجز. في هذا الدرس نقرأ الشكل الموثّق للواجهة، ونفهم كيف تدور الحل…16 د
  3. 3LangGraph: الوكيل كرسم بياني للحالةLangGraph: Agents as State Graphsيعامل LangGraph الوكيل كرسم بياني: عُقد تقرأ حالة مشتركة وتحدّثها، وحواف تحدد المسار. في هذا الدرس نبني رسمًا صغيرًا يعمل دون مفتاح API، ونف…16 د
  4. 4CrewAI: فرق الوكلاء والأدوار والمهامCrewAI: Crews, Roles and Tasksيستعير CrewAI لغة فرق العمل: وكلاء بأدوار وأهداف، ومهام بنواتج متوقعة، وعملية تحدد ترتيب التنفيذ. في هذا الدرس نبني فريقًا صغيرًا يكتب نشرة…15 د
  5. 5من AutoGen إلى Microsoft Agent FrameworkFrom AutoGen to Microsoft Agent Frameworkاشتهر AutoGen بفكرة الوكلاء الذين يتحاورون لحل المهام، لكنه لم يعد يتلقى إصدارات جديدة، وخلفه رسميًا Microsoft Agent Framework. في هذا الدرس…14 د
  6. 6كيف تختار إطار الوكلاء المناسب؟Choosing an Agent Frameworkلا يوجد إطار أفضل مطلقًا، بل إطار أنسب لمشكلة محددة. في هذا الدرس نحوّل المشكلة إلى متطلبات، ونبني مصفوفة قرار موزونة ببايثون، ونتعلم كيف نخ…13 د

مخططات الوحدة

ملاحظةمحرك الاستدلالLLM / Reasonerالتعليمات والهدفInstructions / GoalالذاكرةMemoryالمخططPlannerالأدواتTools / APIsالبيئةEnvironmentضوابط الأمانGuardrails
مكونات الوكيل: محرك استدلال (غالباً نموذج لغوي) تحكمه التعليمات، ويتصل بالذاكرة والأدوات والمخطط، وتحيط به ضوابط الأمان.
handoffhandoffhandoffطلب المستخدموكيل الفرزTriage Agentوكيل الفواتيرBilling Agentوكيل الدعم الفنيSupport Agentوكيل المبيعاتSales Agent
التسليم (Handoff): وكيل الفرز ينقل المحادثة كاملة إلى الوكيل المختص، الذي يكمل العمل بتعليماته وأدواته.
أداة؟حساس؟انتهىSTARTوكيلnodeأدواتnodeموافقة بشريةinterruptENDالحالة Statecheckpoint
سير عمل بمخطط حالات: عقد تقرأ الحالة المشتركة وتعدّلها، وحواف شرطية تختار المسار، ونقاط حفظ تسمح بالاستئناف.
أبجتفرع123تجميعالمشرفSupervisorعاملعاملعاملمديرمشرفمشرفعععع
أنماط التعاون: تسلسلي (سلسلة)، ومتوازٍ (تفرع ثم تجميع)، ومشرف يوزع ويجمع، وهرمي بطبقات من المشرفين.

مصطلحات الوحدة

المصطلحEnglishالتعريف
إطار الوكلاءAgent Frameworkمكتبة تقدم مكونات جاهزة لبناء الوكلاء وتشغيلهم
التتبعTracingتسجيل كل استدعاء للنموذج والأدوات في أثر قابل للفحص
الاستمراريةPersistenceحفظ حالة التشغيل بحيث يمكن استئنافه لاحقًا
التسليمHandoffنقل المحادثة من وكيل إلى وكيل متخصص
رسم الحالةState Graphتمثيل سير العمل كعُقد وحواف تتشارك حالة واحدة
المشغّلRunnerالكائن الذي يدير حلقة تنفيذ الوكيل حتى المخرج النهائي
المخرج النهائيfinal_outputناتج آخر وكيل عمل في التشغيل
أداة وظيفيةfunction_toolمزخرف يحوّل دالة بايثون إلى أداة يستدعيها الوكيل
حاجزGuardrailفحص على المدخلات أو المخرجات يوقف التنفيذ عند الإخفاق
الحد الأقصى للدوراتmax_turnsسقف لعدد دورات الحلقة يُطلق MaxTurnsExceeded عند تجاوزه
عقدةNodeدالة تقرأ الحالة وتعيد تحديثًا لها
حافةEdgeانتقال محدد من عقدة إلى أخرى
حالة الرسائلMessagesStateحالة جاهزة بمفتاح messages تُضاف إليه الرسائل الجديدة
التنفيذ المتينDurable Executionالقدرة على استئناف التشغيل بعد انقطاع من آخر حالة محفوظة
التجميعcompileتحويل الباني إلى رسم قابل للتشغيل
الفريقCrewمجموعة وكلاء ومهام تُنفَّذ وفق عملية محددة
الدورRoleوصف وظيفة الوكيل داخل الفريق
الناتج المتوقعexpected_outputوصف شكل نتيجة المهمة ومعايير اكتمالها
العملية التسلسليةSequential Processتنفيذ المهام بالترتيب مع تمرير النتائج
العملية الهرميةHierarchical Processمدير يوزّع المهام ويراجع النتائج
وكيل متحاورConversable Agentوكيل يرسل الرسائل ويستقبلها ضمن محادثة متعددة الوكلاء
مسار عملWorkflowتدفق خطوات ووكلاء قائم على الرسم ومضبوط بالكود
شرط الإنهاءTermination Conditionقاعدة توقف المحادثة عند تحقق هدف محدد
عميل النموذجChat Clientكائن يربط الوكيل بمزوّد نموذج لغوي معين
الإطار الخلفSuccessor Frameworkإطار يحل محل إطار سابق ويستمر في تطويره
المتطلباتRequirementsما يجب أن يحققه النظام ويقيس به الاختيار
مصفوفة القرارDecision Matrixجدول معايير وأوزان ودرجات لمقارنة الخيارات
نموذج أولي استكشافيSpikeتجربة قصيرة لاختبار فرضية تقنية قبل الالتزام
تثبيت الإصدارVersion Pinningتحديد رقم إصدار المكتبة في ملف المتطلبات
مسار عمل مقابل وكيلWorkflow vs Agentمسار ثابت يحدده الكود مقابل مسار يقرره النموذج

التجربة التطبيقية

تمثيل الوكيل كرسم بياني للحالة Agent as a State Graph

أن تربط بين مخطط المحاكي ومفهوم StateGraph في LangGraph: عقد تعمل على حالة مشتركة وحواف تحدد المسار، بما فيها حواف شرطية.

  1. افتح المحاكي (افتح ↗) وابنِ مخططاً: Start ثم LLM بالمهمة classify ثم Decision ثم فرعين، ثم Output ثم End
  2. اضبط Decision على القاعدة contains بقيمة كلمة مفتاحية، واجعل فرعاً يذهب إلى Tool بالأداة knowledge_search والآخر إلى LLM بالمهمة answer
  3. شغّل بمدخلين مختلفين ولاحظ أي فرع نُفذ في كل مرة
  4. صدّر المخطط بصيغة JSON واقرأ بنية nodes وحوافها
  5. اكتب على الورق ما يقابل كل عقدة في LangGraph: add_node لكل عقدة وadd_edge من START وإلى END
  6. أضف عقدة Human Approval قبل Output ولاحظ كيف تشبه نقطة التوقف في الإنسان في الحلقة

ما الذي ستلاحظه: ستلاحظ أن المسار يتحدد بالحالة والشروط لا بترتيب ثابت، وأن ملف JSON المصدَّر بيانات تصف الرسم البياني فقط. هذا هو التفكير نفسه الذي يتطلبه LangGraph، مع أن شيفرة الإطار الفعلية تحتاج تثبيت المكتبة.

افتح التجربة

المهمة الختامية

صمّم «وكيل فرز طلبات الدعم» مرتين على الورق ثم في محاكي الأكاديمية (افتح ↗): مرة كحلقة وكيل واحد مع تسليم إلى وكيل متخصص (على طريقة OpenAI Agents SDK)، ومرة كرسم حالة بعُقد صريحة (على طريقة LangGraph). سلّم: (1) مخطط كل تصميم، (2) مقتطف كود لكل منهما يطابق أشكال الواجهات الواردة في الدروس مع رقم الإصدار وتاريخ المراجعة، (3) مصفوفة اختيار موزونة من خمسة معايير على الأقل تنتهي بتوصية مبرّرة. معايير القبول: كل عقدة أو وكيل له مسؤولية واحدة واضحة، ويوجد حد أقصى للدورات، ونقطة موافقة بشرية قبل أي إجراء يغيّر بيانات العميل، ولا يُذكر أي إطار بخاصية غير موثّقة.

تقييم الإكمال: تُعد الوحدة مكتملة عندما تنهي جميع دروسها وتنجح في اختبارها.

المراجع الرسمية