Phase 16: Multi-Agent & Swarms

الهندسة المعمارية الهرمية ونمط فشلها

الهييراركية هي المشرفين المرتبطين وكلاء المديرين على المديرين الفرعيين على العمالProcess.hierarchicalهو نسخة الكتاب الدراسي:manager_llmيمنح المهام بشكل ديناميكي ويمتد خروجيات.create_supervisor(create_supervisor(...)). إنه النمط الطبيعي عندما تكون المهمة رسمية منظمة حقيقية. إنه أيضًا النمط الأكثر عرضة للإنهيار في حلقة إدارية يقوم وكلاء المديرين بتخصيص العمل بشكل سيء ، أو يفسرون الخروج الفرعية بشكل خاطئ ، أو يفشلون في التوصل إلى توافق. غالبًا ما يتغلب على التسلسل.

Type: Learn + Build

Languages: Python (stdlib)

Prerequisites: Phase 16 · 05 (Supervisor Pattern)

Time: ~60 minutes

المشكلة

عندما يضغط نمط المشرف، فإن الخطوة التالية الطبيعية هي "ماذا لو كان العمال هم المشرفون أنفسهم؟" الفريقات لديها فرق فرعية؛ الشركات لديها إدارات من الإدارات. تعكس الهندسة المعمارية الهرمية ذلك.

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

المفهوم

الشكل

                 Manager
                 ┌─────┐
                 └──┬──┘
           ┌────────┴────────┐
           ▼                 ▼
       Sub-Mgr A         Sub-Mgr B
       ┌─────┐           ┌─────┐
       └──┬──┘           └──┬──┘
         ┌┴──┬──┐          ┌┴──┐
         ▼   ▼  ▼          ▼   ▼
       W1  W2  W3         W4  W5

كل عقدة داخلية تخطط، تمنح، وتجمع.

حيث يضيء

Clear org mapping.إذا كانت المهمة الحقيقية هي الإدارية ("البحث القانوني في الوثيقة، والبحث المالي في الوثيقة، والبحث الهندسي في الوثيقة، ثم التلخص لتنفيذها") ، فإن الهرم صريح.
Local summarization.يختلط كل مدير فرعي إنتاج فريقه قبل أن يراه المدير الأعلى. يرى المدير الأعلى ثلاثة ملخصات للمدير الفرعي، وليس خمسة عشر إنتاجًا للعمال.

حيث انهار

ثلاثة أنظمة فشل تستمر في العثور عليها بعد 2026:

Task assignment error.يقرأ المدير الهدف، ويحالون على تفكيك، ويمنح المدير الفرعي الخطأ. لأن المدير الفرعي يعمل بشكل مطيع على ما تم إعطائه، فإن الخطأ يظهر فقط في التجميع العلوي مستوى واحد بعيدا عن حيث يمكن أن يكون الإنسان قد أمسك به.
Output misinterpretation.يعود المدير الفرعي "لا يستطيع التحقق من المطالبة X". يختتم المدير الأعلى باسم "المطالبة X غير مؤكدة".
Consensus loops.يختلف اثنان من المديرين الفرعيين؛ يطلب منهم المدير الأعلى التوفيق؛ يعيدون التفويض إلى أسفل؛ يعيدون تشغيل العمال؛ يعود المديرون الفرعيون إجابات مختلفة قليلاً؛ حلقة.Process.hierarchicalالحدود هي الآن المعيار المفرط

السؤال الحاسم

التسلسل (خط الأنابيب) مقابل الهرمية: هل لديك بالفعل فرق فرعية مستقلة ، أم أنها تدفق خطي واحد يتظاهر بأنه شجرة؟ إذا كان الأخير ، استخدم التسلسل. إذا كان الأول ، استخدم قواعد المصالحة الهرمية ولكن الميزانية الصريحة.

تنفيذ إطار الدور

الطاقمProcess.hierarchicalيُحصل على ماجستير في التدريس على طاقم متخصصين

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

الوثائق: https://docs.crewai.com/en/introduction(بحث عن "عملية مرتبة" تحت المفاهيم الأساسية).

تنفيذ إطار الرسم البياني

LangGraph يستخدم مستوى التجميعcreate_supervisorالمراقب الداخلي لديه الرسم البياني الخاص به، والمرجع الخارجي يعامل الرسم البياني الداخلي كعقدة غير شفافة. هذا أكثر نظافة من CrewAI للتحليل (يمكنك الدخول من خلال كل الرسم البياني بشكل منفصل) ولكن أصعب للتعبير عن إعادة تشكيل ديناميكية للشجرة.

الإشارة:https://reference.langchain.com/python/langgraph-supervisor.

بناءها

code/main.pyيستخدم ترتيب ثلاث مستويات:

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

التناقضات الديموقراطية مسار السعادة (كل واحد يوافق) ضد perturbed pathحيث يضع التفكيكات السلبية للمدير الأعلى علامة خاطئة على "قانونية" ك"تمويل" ويراقب سلسلة الأخطاء يقوم المدير الفرعي بإطاعة بعمل التمويل، ويقوم المختلط الأعلى بإبلاغ عن نتائج التمويل، والسؤال القانوني الأصلي لا يجيب عليه.

أركض

python3 code/main.py

إنتاج يظهر كلا الطرق مع جانب واضح من "ما سُئلت" مقابل "ما تم تسليم".

استخدمها

outputs/skill-hierarchy-fitness.mdيقيّم ما إذا كان يجب على مهمة معينة استخدام إشراف سلسلي أو متسلسل أو مسطح. المدخلات: وصف المهمة، بنية المنظمة، ميزانية المصالحة. الخروج: توصية نمط مع أساليب الفشل المحددة للوقاية منها.

أرسله

إذا كنت ترسل الهرمية:

Cap tree depth at 2.ثلاثة مستويات تخفي بالفعل معظم الأخطاء من قابلية الملاحظة.
Explicit reconciliation budget.حدد أقصى عدد من الجولات قبل أن يتحمل المدير الأعلى الالتزام عادةً 2
Provenance on every synthesis.يجب أن يذكر ملخص كل عقد أي نتائج ورقة أنتجتها.
Alert on decomposition drift.سجل تحلل المدير لكل خطوة؛ تختلف عن استفسار المستخدم. إذا لم يعد التحلل يغطي الاستفسار، اطلق تحذير.

التمارين

أركضcode/main.pyكم مستوى من الإسقاط المدير يستغرق قبل أن يختلف الخروج الأعلى تماما عن سؤال المستخدم؟
أضف مستوى ثالث (أعلى → فرع → فرع → عامل). قياس عدد المرات التي تصحح بها المسار المزعجم نفسه مقابل الانحراف الكامل مع نمو العمق.
تنفيذ عامل "كاناري" في كل مدير فرعي يُسأل دائماً سؤال المستخدم الأصلي دون تغيير. استخدم إجابة كاناري للكشف عن التحرك المتجه نحو التفكك. كيف يجب على المدير أن يتفاعل عندما يكون الكاناري غير متفق مع الإجابة المختلطة؟
اقرأ كتاب "كرو آي"Process.hierarchicalتحديد واحد الحواجز الملموسة CrewAI يطبق (حد الخطوة، القيود manager_llm) ووصف أي وضع فشل هو الهدف.
مقارنة مراقبي لنجغراف المربوطين مع جهاز CrewAI التسلسلي الذي يجعل حلقات المصالحة أرخص للكشف عنها؟

الشروط الرئيسية

Term	What people say	What it actually means
Hierarchical	"Org chart pattern"	Supervisors over supervisors; only leaves do work.
Manager LLM	"The boss"	The LLM that decomposes, assigns, and validates at an internal node.
Decomposition drift	"The boss lost the plot"	Top manager's split no longer covers the original question.
Reconciliation loop	"Endless meetings"	Sub-managers disagree; top re-delegates; workers re-run; loop until budget exhausted.
Depth-2 ceiling	"Don't go deeper than 2 levels"	Empirical guardrail: 3+ levels collapses observability.
Canary question	"Ground truth at every level"	A worker that is always asked the original query unchanged, to detect drift.
Provenance chain	"Who said what"	Trace from each synthesis back to the leaf outputs that produced it.