टीम सहयोग

AWR कई लोगों को — और उन एजेंटों को जिनके साथ वे काम करते हैं — एक साझा प्रोजेक्ट पर समन्वय करने देता है: सभी वही टास्क देखते हैं, जो काम कर रहे हैं उसे क्लेम करते हैं, चलते-चलते प्रगति रिपोर्ट करते हैं, और पूरा काम किसी स्वतंत्र समीक्षक को सौंपते हैं। यह सब आप अपने सामान्य एजेंट वार्तालाप से चलाते हैं; ब्राउज़र में टास्क ID इधर-उधर कॉपी करने की ज़रूरत नहीं।

उपलब्धता: यह लेख Team सेवा का वर्णन करता है, जो अभी विकास में है। यह प्रकाशित 0.5.0 पर्सनल MCP सर्वर का हिस्सा नहीं है। नीचे दी गई क्षमताएँ आपके प्रोजेक्ट प्रशासक द्वारा होस्ट किए गए टीम प्रोजेक्ट पर लागू होती हैं, न कि किसी निजी लोकल सेटअप पर।

अंतर्निहित विचारों (कार्य-आइटम, कॉन्ट्रैक्ट, साक्ष्य, सत्र) के लिए पहले Concepts पढ़ें। अकेले व्यक्ति की रोज़मर्रा की दिनचर्या के लिए आपका दैनिक वर्कफ़्लो देखें।

सहयोग मॉडल एक नज़र में

पूरे मॉडल को चार विचार उठाते हैं:

वर्कस्ट्रीम और साझा काम। दूरस्थ प्रोजेक्ट ही साझा कार्य-अधिकार है — वह एक जगह जहाँ टास्क, निर्भरताएँ, प्रगति और परिणाम रहते हैं। आपका लोकल चेकआउट केवल कोड और टेस्ट के लिए है; दूरस्थ प्रोजेक्ट की जगह लेने के लिए दूसरा लोकल टास्क लेजर इनिशियलाइज़ न करें।
क्लेम करना। कोई एजेंट निष्पादन का काम शुरू करने से पहले, अपने सत्र के तहत टास्क पर लाइव क्लेम लेता है। किसी दूसरे व्यक्ति के लाइव क्लेम को बदला नहीं जाना चाहिए, इसलिए दो एजेंट चुपचाप एक ही चीज़ पर काम नहीं कर सकते।
समीक्षा। डिलीवरी और स्वीकृति अलग-अलग तथ्य हैं। किसी अधिकृत, स्वतंत्र व्यक्ति द्वारा सबमिट किए गए काम की समीक्षा स्वीकार किए जाने से पहले होती है। आपके ही दूसरे एजेंट स्वतंत्र समीक्षक नहीं होते।
हैंडऑफ़। सत्र टिकाऊ हैं: वे MCP रीकनेक्ट से बचे रहते हैं, चेकपॉइंट और रिकवरी स्थिति ले जाते हैं, और बिना कॉन्टेक्स्ट खोए फिर से उठाए जा सकते हैं — ब्रेक के बाद आपके द्वारा, या किसी टीममेट द्वारा निरीक्षण के लिए।

एक बार कनेक्ट करें

अपने प्रोजेक्ट प्रशासक से प्रोजेक्ट MCP URL और अपना व्यक्तिगत क्रेडेंशियल माँगें। हर प्रतिभागी अपना क्रेडेंशियल इस्तेमाल करता है, और रिपॉज़िटरी अनुमतियाँ AWR अनुमतियों से अलग रहती हैं — AWR प्रोजेक्ट में जुड़ने से Git एक्सेस नहीं मिलता, और इसका उल्टा भी।

पर्दे के पीछे, एक अधिकृत प्रशासक Inspector में Members खोलता है, आपको जोड़ता है, आपकी प्रोजेक्ट भूमिका और वर्कस्ट्रीम चुनता है, और एंडपॉइंट व आपका क्रेडेंशियल वाला एक-बार का व्यक्तिगत कनेक्शन निर्देश कॉपी करता है। आपको यह किसी निजी चैनल से मिलता है। प्रशासक इश्यूएंस पैनल साफ़ करने के बाद उसका प्लेनटेक्स्ट पुनः प्राप्त नहीं कर सकता; यदि आप क्रेडेंशियल खो दें, तो उसे स्पष्ट रूप से बदला जा सकता है।

किसी भी एजेंट क्लाइंट में दूरस्थ MCP सर्वर जोड़ें जो Streamable HTTP पर Bearer प्रमाणीकरण के साथ रिमोट MCP का समर्थन करता हो:

सेटिंग	मान
Transport	Streamable HTTP
Server URL	आपका प्रोजेक्ट एंडपॉइंट, जैसे `https://team.example/v1/projects/example/mcp`
Authentication	HTTP `Authorization` हेडर में Bearer टोकन
Credential	आपका प्रशासक-प्रदत व्यक्तिगत क्रेडेंशियल

ये कनेक्शन सेटिंग्स हैं, कॉन्फ़िगरेशन-फ़ाइल फ़ॉर्मैट या शेल कमांड नहीं; हर क्लाइंट की अपनी सेटिंग्स और संस्करण आवश्यकताएँ हैं। यदि आपका क्लाइंट केवल लोकल stdio MCP समर्थन करता है, तो यह URL सीधे इस्तेमाल नहीं हो सकता — रिमोट ट्रांसपोर्ट समर्थन करने वाला क्लाइंट संस्करण या इंटीग्रेशन इस्तेमाल करें।

क्रेडेंशियल के लिए कुछ सुरक्षा नियम:

अपने क्लाइंट की समर्थित सीक्रेट सेटिंग्स या किसी भरोसेमंद निजी एजेंट इनपुट का उपयोग करें।
क्रेडेंशियल को कभी URL, साझा वार्तालाप या रिपॉज़िटरी में न रखें।
कॉन्फ़िगरेशन बदलने के बाद रीकनेक्ट करें, फिर एजेंट में अपना लोकल कोड चेकआउट खोलें।

अपने एजेंट को परिणाम बताएँ

आप उसी वार्तालाप में काम करते हैं जिसे आप डेवलपमेंट के लिए इस्तेमाल करते हैं। परिणाम बताएँ और एजेंट को समन्वय करने दें, उदाहरण के लिए:

कनेक्ट किए गए AWR Team प्रोजेक्ट का उपयोग करके issue API लागू करें। मौजूदा टास्क ताज़ा करें और मेरा मौजूदा काम फिर से शुरू करें, या इस अनुरोध से मेल खाता योग्य टास्क क्लेम करें। संपादन से पहले कॉन्ट्रैक्ट, निर्भरताएँ और नवीनतम चेकपॉइंट पढ़ें। प्रगति और साक्ष्य AWR में रखें, परखा हुआ बदलाव PR के रूप में सबमिट करें, और स्वतंत्र समीक्षा का अनुरोध करें।

एजेंट साझा काम पढ़ता है, योग्य टास्क क्लेम करता है और लोकल रूप से विकसित करते हुए प्रोजेक्ट को अपडेट रखता है। यदि उसे वास्तविक अनुमति, निर्भरता या स्वामित्व संघर्ष आता है, तो वह उसे दरकिनार करने के बजाय आपको रिपोर्ट करता है।

एजेंट आपके लिए क्या करता है

एजेंट Team सेवा से दो खोजे गए MCP टूल के माध्यम से बात करता है — रीड के लिए awr_team_query और लेखन के लिए awr_team_command। हर क्वेरी और कमांड आपकी मौजूदा अनुमतियों की पुनः जाँच करती है, इसलिए भूमिका बदलाव बिना किसी के लोकल कॉन्फ़िग संपादित किए प्रभावी होता है।

एक सामान्य सत्र इस तरह बहता है:

शुरू करें या रीकनेक्ट करें। एजेंट अपनी पहचान और अनुमतियों की पुष्टि के लिए capabilities क्वेरी करता है, फिर work.next से आपके अपने सत्र फिर से शुरू करता है या दिखाई देने वाला अधूरा काम खोजता है, लौटे next_query का पालन करते हुए। (work.next के बिना पुराने सर्वरों पर, वह workstreams.list और स्कोप्ड work.list / work.search पर वापस आता है।)
तैयारी। चुने गए टास्क के लिए, work.prepare वर्तमान कॉन्ट्रैक्ट, आवश्यक स्पेसिफ़िकेशन, निर्भरताएँ, रिकवरी स्थिति और एक कॉन्टेक्स्ट हैश लौटाता है — एक स्नैपशॉट जिसे एजेंट को संपादन से पहले वास्तव में उपभोग करना होगा। work.prepare और work.observe एक छोटा guidance आइटम भी लौटा सकते हैं (उसकी शर्त, तथ्यात्मक आधार, अगली कार्रवाई और पुनर्मूल्यांकन ट्रिगर); यह सलाह है, निष्पादन अधिकार नहीं।
क्लेम। एजेंट claim.inspect से मौजूदा क्लेम देखता है, फिर अपने सत्र के तहत लाइव क्लेम प्राप्त या नवीनीकृत करता है।
निष्पादन। execution.prepare और ताज़ा execution.start रिस्पॉन्स के साथ, जिसमें execution_authorized=true हो, एजेंट घोषित दायरे के भीतर एक निष्पादन कर सकता है। आपकी मशीन कोड और टूल चलाती है — सेवा स्वयं कुछ भी निष्पादित नहीं करती। केवल क्लेम निष्पादन की अनुमति नहीं है।
प्रगति रिपोर्ट करें। एजेंट उपभोग किए गए कॉन्टेक्स्ट हैश, अगली कार्रवाई, खुले लूप और एक छोटे progress सारांश के साथ session.checkpoint भेजता है, और अपडेट तब बैच करता है जब कोई फ़ेज़ या टेस्ट पूरा हो, बाधा बदले, आपके इनपुट की ज़रूरत हो, या डिलीवरी तैयार हो — हर टूल कॉल पर नहीं। ध्यान रखें कि चेकपॉइंट सारांश अधिकृत कार्य-पाठकों के साथ साझा होते हैं, इसलिए उनमें कच्चे संवेदनशील लॉग नहीं होने चाहिए।
समाप्त करें या रुकें। execution.report संस्करण-बंधे साक्ष्य के साथ एक टर्मिनल परिणाम दर्ज करता है। क्लेम रिलीज़ और सत्र समाप्त तभी होते हैं जब सक्रिय काम और अज्ञात परिणाम निपट चुके हों।

समीक्षा और स्वीकृति

जब काम तैयार हो, तो एजेंट साक्ष्य सबमिट करता है और delivery.submit_and_request_review या review.open के माध्यम से समीक्षा का अनुरोध करता है। कोई अधिकृत, स्वतंत्र व्यक्ति डिलीवरी की समीक्षा करता है, और अधिकृत अंतिमकरण प्रोजेक्ट की स्वीकृति नीति का पालन करता है।

इन्हें अलग-अलग तथ्यों के रूप में रखें: कार्यान्वयन, सत्यापन, GitHub मर्ज, और AWR स्वीकृति। PR मर्ज करना और AWR का टास्क स्वीकार करना एक ही बात नहीं है, और आपका अपना दूसरा एजेंट स्वतंत्र समीक्षक नहीं गिना जाता।

हैंडऑफ़ और रिकवरी

हैंडऑफ़ इसलिए काम करता है क्योंकि सत्र और चेकपॉइंट साझा प्रोजेक्ट पर रहते हैं, किसी एक व्यक्ति के चैट इतिहास में नहीं:

MCP रीकनेक्ट करना टिकाऊ वर्क सत्र समाप्त नहीं करता और न उसका लीज़ नवीनीकृत करता है।
रिकवरी स्थिति और पंजीकृत डिलीवरी पुराने चेकपॉइंट निर्देशों पर प्राथमिकता रखती हैं, इसलिए लौटता हुआ एजेंट उस पर भरोसा करता है जो वास्तव में हुआ।
यदि कोई लेखन टाइमआउट हो जाए, तो एजेंट ठीक-ठीक पुनः प्रयास से पहले मूल कमांड परिणाम का निरीक्षण करता है; दोहराई गई रसीदें ऐतिहासिक तथ्य हैं, प्रभाव दोबारा चलाने की अनुमति नहीं।
यदि निष्पादन प्रभाव अज्ञात हैं (टास्क के बीच में रुकावट), तो उन्हें निरीक्षण और अधिकृत मेल-मिलाप चाहिए। नया सत्र बनाना उस आवश्यकता को बायपास नहीं करता।

जानने लायक दो व्यावहारिक सीमाएँ: AWR किसी निष्क्रिय एजेंट को जगा नहीं सकता (लीज़ नवीनीकरण आपके होस्ट की शेड्यूलिंग का उपयोग करता है, चेकपॉइंट से अलग), और ब्लॉक्ड या प्रतीक्षारत फ़ेज़ एक रिपोर्ट है — वह स्वयं प्रतीक्षा आइटम नहीं बनाता और न क्लेम नवीनीकृत करता है।

Inspector: वैकल्पिक वर्कस्पेस व्यू

Inspector उसी प्रोजेक्ट का एक वेब व्यू है। वेबसाइट से साइन इन या क्लेम करना ऊपर की किसी भी चीज़ के लिए पूर्व-आवश्यकता नहीं है — एजेंट ही समन्वय सतह बना रहता है। Inspector तब इस्तेमाल करें जब आप चाहें:

टास्क संबंध, स्वामित्व, प्रगति और दर्ज परिणाम देखना।
Connect Agent से क्लाइंट-तटस्थ MCP सेटिंग्स और प्रोजेक्ट निर्देश, या प्रति-टास्क ब्रीफ़ कॉपी करना (टेक्स्ट कॉपी करने से कोई सत्र या क्लेम नहीं बनता)।
प्रशासक के रूप में, Members में सदस्य और प्रोजेक्ट-स्कोप्ड क्रेडेंशियल प्रबंधित करना।
Activity की समीक्षा करना, जो प्रमाणित एक्सेस रिकॉर्ड को कमिट किए गए डेवलपमेंट इतिहास से अलग करता है। साधारण सदस्य अपनी अधिकृत गतिविधि देखते हैं; प्रोजेक्ट ऑडिटर सदस्य या टास्क से फ़िल्टर कर सकते हैं। ऑडिट रिकॉर्ड में क्रेडेंशियल मान, वार्तालाप और मनमाने टूल इनपुट/आउटपुट शामिल नहीं होते, और रिक्वेस्ट मेटाडेटा की सीमित अवधारण अवधि होती है — यह स्थायी अनुपालन अभिलेखागार नहीं है।

प्रशासक और समीक्षा अनुमतियाँ केंद्रीय सेवा द्वारा लागू होती हैं, चाहे आप कोई भी क्लाइंट इस्तेमाल करें, इसलिए नियम तब भी बने रहते हैं जब कोई एजेंट, Inspector या दोनों के माध्यम से काम करे।

अगले कदम

AWR में नए हैं? What is AWR और Quickstart से शुरू करें।
MCP के माध्यम से अपने टूल जोड़ें: MCP।
रोज़मर्रा एजेंटों के साथ काम: Agents और आपका दैनिक वर्कफ़्लो।
कुछ काम नहीं कर रहा? ट्रबलशूटिंग देखें।