Phase 16: Multi-Agent & Swarms

पदानुक्रमिक वास्तुकला और उसकी विफलता मोड

कार्यकारी अधिकारी कर्मचारी के ऊपर उप-प्रबंधक के ऊपर प्रबंधक एजेंट।Process.hierarchicalपाठ्यपुस्तक संस्करण है: a 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.यदि वास्तविक कार्य विभागात्मक है ("कानूनी समीक्षा दस्तावेज़, वित्त समीक्षा दस्तावेज़, इंजीनियरिंग समीक्षा दस्तावेज़, फिर exec के लिए सारांशित करें"), पदानुक्रम स्पष्ट है।
Local summarization.प्रत्येक उप प्रबंधक शीर्ष प्रबंधक को देखने से पहले अपनी टीम के आउटपुट को संश्लेषित करता है। शीर्ष प्रबंधक 15 कर्मचारी आउटपुट नहीं, बल्कि तीन उप प्रबंधक सारांश देखता है।

जहां यह टूट जाता है

तीन विफलता मोड 2026 पोस्ट-मॉर्टम जारी रखने के लिए पा रहे हैंः

Task assignment error.प्रबंधक लक्ष्य को पढ़ता है, विघटन का भ्रम बनाता है, और गलत उप-प्रबंधक को सौंपता है। क्योंकि उप-प्रबंधक आज्ञाकारी रूप से उस पर काम करता है जो उसे दिया गया था, त्रुटि केवल शीर्ष संश्लेषण पर दिखाई देती है एक स्तर जहां से एक मानव इसे पकड़ सकता था।
Output misinterpretation.उप प्रबंधक "क्रांति X की पुष्टि करने में असमर्थ" रिटर्न देता है। शीर्ष प्रबंधक "क्रांति X की पुष्टि नहीं हुई है" के रूप में सारांशित करता है।
Consensus loops.दो उप-प्रबंधक असहमत हैं; शीर्ष प्रबंधक उनसे मेल खाने के लिए कहता है; वे फिर से नीचे स्थानांतरित करते हैं; श्रमिक फिर से दौड़ते हैं; उप-प्रबंधक थोड़ा अलग जवाब देते हैं; लूप। CrewAI की Process.hierarchicalइसके खिलाफ कदम सीमाओं के साथ सुरक्षा, लेकिन सीमा स्वयं अब एक हाइपरपरमैटर है।

निर्णायक प्रश्न

अनुक्रमिक (रैखिक पाइपलाइन) बनाम पदानुक्रमिकः क्या आपके कार्य में वास्तव में स्वतंत्र उप-समूह हैं, या क्या यह एक रैखिक प्रवाह है जो एक पेड़ का नाटक करता है? यदि यह अंतिम है, तो अनुक्रमिक का उपयोग करें। यदि पहला है, तो पदानुक्रमिक लेकिन बजट स्पष्ट मेल खाने के नियमों का उपयोग करें।

भूमिका ढांचे का कार्यान्वयन

चालक दल के Process.hierarchicalप्रबंधक विशेषज्ञ चालक दल के ऊपर एक प्रबंधक LLM तारों।

शीर्ष स्तर का कार्य प्राप्त करता है,
चालक दल को उप-कार्य सौंपता है,
चालक दल के आउटपुट का मूल्यांकन करता है,
निर्णय लेता है कि स्वीकार करना, पुनः स्थानांतरित करना या पुनरावृत्ति करना है।

प्रलेखन: https://docs.crewai.com/en/introduction(कोर कॉन्सेप्ट्स के अंतर्गत "हियरार्मिक प्रक्रिया" खोजें) ।

ग्राफ-फ्रेमवर्क को लागू करना

LangGraph नेस्ट का उपयोग करता है create_supervisorआंतरिक पर्यवेक्षक का अपना ग्राफ है; बाहरी पर्यवेक्षक आंतरिक ग्राफ को एक अपारदर्शी नोड के रूप में व्यवहार करता है। यह डिबगिंग के लिए CrewAI से साफ है (आप प्रत्येक ग्राफ के माध्यम से अलग से कदम रख सकते हैं) लेकिन पेड़ के गतिशील पुनर्गठन को व्यक्त करना कठिन है।

संदर्भ: https://reference.langchain.com/python/langgraph-supervisor.

इसे बनाओ

code/main.pyएक 3-स्तर पदानुक्रम चलाता हैः

शीर्ष प्रबंधक: एक कार्य को "इंजीनियरिंग" और "कानूनी" शाखाओं में विभाजित करता है,
इंजीनियरिंग उप प्रबंधक: "फ्रंटेंड" और "बैकेंड" श्रमिकों में विभाजित,
कानूनी उप प्रबंधक: एक कर्मचारी।

डेमो एक के खिलाफ खुश पथ (हर कोई सहमत है) के विपरीत है perturbed pathजहां शीर्ष प्रबंधक के विघटन "कानूनी" को "वित्त" के रूप में गलत लेबल करता है और त्रुटि कैस्केड देखता है उप प्रबंधक आज्ञाकारी रूप से वित्त कार्य करता है, शीर्ष सिंथेसाइज़र वित्त निष्कर्षों की रिपोर्ट करता है, मूल कानूनी प्रश्न उत्तरहीन रहता है।

दौड़ें:

python3 code/main.py

आउटपुट दोनों पथों को "क्या पूछा गया" बनाम "क्या दिया गया" के साथ स्पष्ट रूप से दिखाता है।

इसका प्रयोग करें

outputs/skill-hierarchy-fitness.mdयह मूल्यांकन करता है कि किसी दिए गए कार्य में पदानुक्रमिक, अनुक्रमिक या फ्लैट पर्यवेक्षक का उपयोग करना चाहिए या नहीं। इनपुटः कार्य विवरण, संगठन संरचना, संगति बजट। आउटपुटः विशिष्ट विफलता मोडों के साथ पैटर्न सिफारिशें जो बचाने के लिए हैं।

इसे भेजें

यदि आप पदानुक्रम जहाजः

Cap tree depth at 2.तीन स्तर पहले से ही अधिकांश त्रुटियों को देख सकते हैं।
Explicit reconciliation budget.शीर्ष प्रबंधक को प्रतिबद्ध होने से पहले अधिकतम राउंड सेट करें।
Provenance on every synthesis.प्रत्येक नोड के सारांश में यह उल्लेख किया जाना चाहिए कि किस पत्ती के आउटपुट ने इसे उत्पन्न किया है।
Alert on decomposition drift.प्रबंधक के विघटन को प्रति चरण लॉग करें; उपयोगकर्ता क्वेरी के विपरीत। यदि विघटन अब क्वेरी को कवर नहीं करता है, तो एक अलर्ट चलाएं।

व्यायाम

दौड़ेंcode/main.pyऔर खुश बनाम परेशान तुलना. यह प्रबंधक के हाथ से बाहर करने के लिए कितना स्तर लेता है शीर्ष उत्पादन पूरी तरह से उपयोगकर्ता के प्रश्न से विचलित करने से पहले?
एक तीसरा स्तर जोड़ें (शीर्ष → उप → उप → कार्यकर्ता) यह मापें कि कितनी बार विचलित पथ गहराई बढ़ने के साथ खुद को सुधारता है।
प्रत्येक उप-प्रबंधक पर एक "कैनरी" कार्यकर्ता लागू करें जो हमेशा मूल उपयोगकर्ता प्रश्न को अपरिवर्तित पूछे जाने पर। विघटन बहाव का पता लगाने के लिए कैनरी उत्तर का उपयोग करें। जब कैनरी संश्लेषित उत्तर से असहमत हो तो प्रबंधक को कैसे प्रतिक्रिया करनी चाहिए?
क्रूएआई की पढें Process.hierarchicalदस्तावेज़. एक कंक्रीट गार्डरेल की पहचान करें जो CrewAI लागू करता है (चरण सीमा, प्रबंधक_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.

आगे पढ़ना

CrewAI introduction — Process.hierarchical प्रबंधक के साथ पाठ्यपुस्तक पदानुक्रम
LangGraph supervisor reference निवासी पर्यवेक्षक द्वारा create_supervisor
Anthropic engineering — Research system क्यों मानव जाति ने जानबूझकर पदानुक्रमिक से अधिक फ्लैट पर्यवेक्षक चुना
Cemri et al. — Why Do Multi-Agent LLM Systems Fail? MAST वर्गीकरण; समन्वय विफलताओं पर अनुभाग

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.