أطر بناء الوكلاء
Agent Frameworks
جولة عملية في أشهر أطر بناء الوكلاء: OpenAI Agents SDK وLangGraph وCrewAI وMicrosoft Agent Framework (وريث AutoGen)، وكيف تختار بينها.
عن الوحدة
بعد أن بنيت الوكيل من مكوّناته الأساسية بيدك، تتعرّف في هذه الوحدة على الأطر (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)
المهارات المكتسبة
الدروس
- 1خريطة أطر بناء الوكلاءThe Agent Frameworks Landscapeالأطر تختصر الكود المتكرر في بناء الوكلاء، لكنها تختلف في فكرتها المركزية. في هذا الدرس نرى ما الذي يضيفه أي إطار فوق حلقة الوكيل اليدوية، و…
- 2OpenAI Agents SDK: الوكيل والمشغّل والتسليمOpenAI Agents SDK: Agents, Runner and Handoffsيقدّم OpenAI Agents SDK عددًا قليلًا من المفاهيم: وكيل، ومشغّل، وتسليم، وحواجز. في هذا الدرس نقرأ الشكل الموثّق للواجهة، ونفهم كيف تدور الحل…
- 3LangGraph: الوكيل كرسم بياني للحالةLangGraph: Agents as State Graphsيعامل LangGraph الوكيل كرسم بياني: عُقد تقرأ حالة مشتركة وتحدّثها، وحواف تحدد المسار. في هذا الدرس نبني رسمًا صغيرًا يعمل دون مفتاح API، ونف…
- 4CrewAI: فرق الوكلاء والأدوار والمهامCrewAI: Crews, Roles and Tasksيستعير CrewAI لغة فرق العمل: وكلاء بأدوار وأهداف، ومهام بنواتج متوقعة، وعملية تحدد ترتيب التنفيذ. في هذا الدرس نبني فريقًا صغيرًا يكتب نشرة…
- 5من AutoGen إلى Microsoft Agent FrameworkFrom AutoGen to Microsoft Agent Frameworkاشتهر AutoGen بفكرة الوكلاء الذين يتحاورون لحل المهام، لكنه لم يعد يتلقى إصدارات جديدة، وخلفه رسميًا Microsoft Agent Framework. في هذا الدرس…
- 6كيف تختار إطار الوكلاء المناسب؟Choosing an Agent Frameworkلا يوجد إطار أفضل مطلقًا، بل إطار أنسب لمشكلة محددة. في هذا الدرس نحوّل المشكلة إلى متطلبات، ونبني مصفوفة قرار موزونة ببايثون، ونتعلم كيف نخ…
مخططات الوحدة
مصطلحات الوحدة
| المصطلح | 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: عقد تعمل على حالة مشتركة وحواف تحدد المسار، بما فيها حواف شرطية.
- افتح المحاكي (افتح ↗) وابنِ مخططاً: Start ثم LLM بالمهمة classify ثم Decision ثم فرعين، ثم Output ثم End
- اضبط Decision على القاعدة contains بقيمة كلمة مفتاحية، واجعل فرعاً يذهب إلى Tool بالأداة knowledge_search والآخر إلى LLM بالمهمة answer
- شغّل بمدخلين مختلفين ولاحظ أي فرع نُفذ في كل مرة
- صدّر المخطط بصيغة JSON واقرأ بنية nodes وحوافها
- اكتب على الورق ما يقابل كل عقدة في LangGraph: add_node لكل عقدة وadd_edge من START وإلى END
- أضف عقدة Human Approval قبل Output ولاحظ كيف تشبه نقطة التوقف في الإنسان في الحلقة
ما الذي ستلاحظه: ستلاحظ أن المسار يتحدد بالحالة والشروط لا بترتيب ثابت، وأن ملف JSON المصدَّر بيانات تصف الرسم البياني فقط. هذا هو التفكير نفسه الذي يتطلبه LangGraph، مع أن شيفرة الإطار الفعلية تحتاج تثبيت المكتبة.
المهمة الختامية
صمّم «وكيل فرز طلبات الدعم» مرتين على الورق ثم في محاكي الأكاديمية (افتح ↗): مرة كحلقة وكيل واحد مع تسليم إلى وكيل متخصص (على طريقة OpenAI Agents SDK)، ومرة كرسم حالة بعُقد صريحة (على طريقة LangGraph). سلّم: (1) مخطط كل تصميم، (2) مقتطف كود لكل منهما يطابق أشكال الواجهات الواردة في الدروس مع رقم الإصدار وتاريخ المراجعة، (3) مصفوفة اختيار موزونة من خمسة معايير على الأقل تنتهي بتوصية مبرّرة. معايير القبول: كل عقدة أو وكيل له مسؤولية واحدة واضحة، ويوجد حد أقصى للدورات، ونقطة موافقة بشرية قبل أي إجراء يغيّر بيانات العميل، ولا يُذكر أي إطار بخاصية غير موثّقة.
تقييم الإكمال: تُعد الوحدة مكتملة عندما تنهي جميع دروسها وتنجح في اختبارها.
المراجع الرسمية
- OpenAI Agents SDK openai.github.io روجع في 2026-11-18
- LangGraph overview docs.langchain.com روجع في 2026-11-18
- CrewAI Agents docs.crewai.com روجع في 2026-11-18
- Microsoft Agent Framework overview learn.microsoft.com روجع في 2026-11-18
