उप-एजेंट
उप-एजेंट विशेषीकृत AI सहायक हैं, जिन्हें Cursor का एजेंट कार्य सौंप सकता है। हर उप-एजेंट अपनी कॉन्टेक्स्ट विंडो में काम करता है, खास तरह के कार्य संभालता है और अपना परिणाम पैरेंट एजेंट को देता है। जटिल कार्यों को छोटे हिस्सों में बाँटने, समानांतर रूप से काम करने और मुख्य बातचीत में संदर्भ बनाए रखने के लिए उप-एजेंट्स का उपयोग करें।
आप एडिटर, CLI और क्लाउड एजेंट्स में उप-एजेंट्स का उपयोग कर सकते हैं।
संदर्भ पृथक्करण
हर उप-एजेंट की अपनी कॉन्टेक्स्ट विंडो होती है। लंबे शोध या अन्वेषण कार्य मुख्य बातचीत में जगह नहीं लेते।
समानांतर निष्पादन
एक साथ कई उप-एजेंट शुरू करें। क्रमिक पूर्णता की प्रतीक्षा किए बिना अपने कोडबेस के अलग-अलग हिस्सों पर काम करें।
विशेषीकृत विशेषज्ञता
डोमेन-विशिष्ट कार्यों के लिए उप-एजेंट्स को कस्टम प्रॉम्प्ट्स, टूल एक्सेस और मॉडलों के साथ कॉन्फ़िगर करें।
पुन: उपयोगिता
कस्टम उप-एजेंट्स परिभाषित करें और उन्हें अलग-अलग प्रोजेक्ट्स में उपयोग करें।
उप-एजेंट कैसे काम करते हैं
जब एजेंट को कोई जटिल कार्य मिलता है, तो वह स्वचालित रूप से एक उप-एजेंट शुरू कर सकता है। उप-एजेंट को सभी आवश्यक संदर्भ वाला प्रॉम्प्ट मिलता है, वह स्वायत्त रूप से काम करता है और परिणामों के साथ एक अंतिम संदेश भेजता है।
उप-एजेंट साफ़ संदर्भ के साथ शुरू होते हैं। चूँकि उप-एजेंट्स के पास पिछले वार्तालाप इतिहास की पहुंच नहीं होती, पैरेंट एजेंट प्रॉम्प्ट में प्रासंगिक जानकारी शामिल करता है।
अग्रभूमि बनाम पृष्ठभूमि
उप-एजेंट दो मोड में चल सकते हैं:
| मोड | व्यवहार | इनके लिए उपयुक्त |
|---|---|---|
| अग्रभूमि | उप-एजेंट के पूरा होने तक प्रतीक्षा करता है। परिणाम तुरंत देता है। | क्रमिक कार्य, जिनमें आपको आउटपुट चाहिए। |
| पृष्ठभूमि | तुरंत परिणाम देता है। उप-एजेंट स्वतंत्र रूप से कार्य करता है। | लंबे समय तक चलने वाले कार्य या समानांतर कार्यप्रवाह। |
अंतर्निहित उप-एजेंट
Cursor में तीन अंतर्निहित उप-एजेंट शामिल हैं, जो अधिक संदर्भ वाली कार्रवाइयों को स्वचालित रूप से संभालते हैं। इन उप-एजेंट्स को उन एजेंट बातचीत के विश्लेषण के आधार पर डिज़ाइन किया गया है, जिनमें कॉन्टेक्स्ट विंडो की सीमाएँ पहुँच गई थीं।
| उप-एजेंट | उद्देश्य | यह उप-एजेंट क्यों है |
|---|---|---|
| खोजें | कोडबेस खोजता और उसका विश्लेषण करता है | कोडबेस एक्सप्लोरेशन से बड़ा मध्यवर्ती आउटपुट बनता है, जो मुख्य संदर्भ को अनावश्यक रूप से भर देगा। कई समानांतर खोज चलाने के लिए यह तेज़ मॉडल का उपयोग करता है। |
| Bash | शेल कमांड्स की श्रृंखला चलाता है | कमांड आउटपुट अक्सर बहुत विस्तृत होता है। इसे अलग रखने से पैरेंट लॉग्स के बजाय निर्णयों पर केंद्रित रहता है। |
| ब्राउज़र | MCP टूल्स के ज़रिए ब्राउज़र नियंत्रित करता है | ब्राउज़र इंटरैक्शन से शोरयुक्त DOM स्नैपशॉट और स्क्रीनशॉट बनते हैं। उप-एजेंट इन्हें फ़िल्टर करके प्रासंगिक परिणामों तक सीमित करता है। |
ये उप-एजेंट क्यों हैं
इन तीन कार्यों में कुछ सामान्य विशेषताएँ हैं: ये शोरयुक्त मध्यवर्ती आउटपुट उत्पन्न करते हैं, विशेषीकृत प्रॉम्प्ट्स और उपकरणों से लाभ उठाते हैं, और काफी संदर्भ का उपयोग कर सकते हैं। इन्हें उप-एजेंट के रूप में चलाने से कई समस्याएँ हल होती हैं:
- संदर्भ पृथक्करण — मध्यवर्ती आउटपुट उप-एजेंट में ही रहता है। पैरेंट को केवल अंतिम सारांश दिखाई देता है।
- मॉडल लचीलापन — एक्सप्लोर उप-एजेंट डिफ़ॉल्ट रूप से तेज़ मॉडल का उपयोग करता है। इससे मुख्य एजेंट द्वारा एक खोज में लगने वाले समय में 10 समानांतर खोजें चलाई जा सकती हैं।
- विशेषीकृत कॉन्फ़िगरेशन — प्रत्येक उप-एजेंट के पास उसके विशिष्ट कार्य के लिए अनुकूलित प्रॉम्प्ट्स और टूल एक्सेस होता है।
- लागत दक्षता — तेज़ मॉडल की लागत कम होती है। उपयुक्त मॉडल विकल्पों के साथ टोकन-भारी कार्य को उप-एजेंट में अलग रखने से कुल लागत कम होती है।
आपको इन उप-एजेंट को कॉन्फ़िगर करने की आवश्यकता नहीं है। एजेंट जब उपयुक्त हो, इनका स्वचालित रूप से उपयोग करता है।
उप-एजेंट का उपयोग कब करें
| उप-एजेंट का उपयोग करें जब... | कौशल का उपयोग करें जब... |
|---|---|
| आपको लंबे शोध कार्यों के लिए संदर्भ पृथक्करण चाहिए | कार्य एकल उद्देश्य वाला हो (चेंजलॉग बनाना, प्रारूपित करना) |
| आपको कई कार्यप्रवाह समानांतर रूप से चलाने हों | आपको त्वरित, दोहराई जा सकने वाली कार्रवाई चाहिए |
| कार्य के लिए कई चरणों में विशेषीकृत विशेषज्ञता चाहिए | कार्य एक ही बार में पूरा हो |
| आपको कार्य का स्वतंत्र सत्यापन चाहिए | आपको अलग कॉन्टेक्स्ट विंडो की आवश्यकता न हो |
अगर आप "चेंजलॉग बनाना" या "आयात को प्रारूपित करना" जैसे सरल, एकल-उद्देश्यीय कार्य के लिए उप-एजेंट बना रहे हैं, तो इसके बजाय कौशल का उपयोग करने पर विचार करें।
त्वरित शुरुआत
एजेंट जब उपयुक्त हो, स्वचालित रूप से उप-एजेंट्स का उपयोग करता है। आप एजेंट से कहकर कस्टम उप-एजेंट भी बना सकते हैं:
.cursor/agents/verifier.md में YAML फ्रंटमैटर (नाम, विवरण) के बाद प्रॉम्प्ट के साथ एक उप-एजेंट फ़ाइल बनाएं। सत्यापनकर्ता उप-एजेंट को पूरा किए गए कार्य को सत्यापित करना चाहिए, जाँचना चाहिए कि कार्यान्वयन कार्यशील हैं, परीक्षण चलाने चाहिए और बताना चाहिए कि क्या पास हुआ है और क्या अधूरा है।
Try in Cursorअधिक नियंत्रण के लिए, अपने प्रोजेक्ट या उपयोगकर्ता डायरेक्टरी में कस्टम उप-एजेंट्स मैन्युअल रूप से बनाएं।
कस्टम उप-एजेंट्स
विशेषीकृत ज्ञान शामिल करने, टीम के मानक लागू करने या दोहराए जाने वाले वर्कफ़्लो को स्वचालित करने के लिए कस्टम उप-एजेंट्स परिभाषित करें।
फ़ाइल के स्थान
| प्रकार | स्थान | स्कोप |
|---|---|---|
| प्रोजेक्ट उप-एजेंट | .cursor/agents/ | केवल मौजूदा प्रोजेक्ट |
.claude/agents/ | केवल मौजूदा प्रोजेक्ट (Claude संगतता) | |
.codex/agents/ | केवल मौजूदा प्रोजेक्ट (Codex संगतता) | |
| उपयोगकर्ता उप-एजेंट | ~/.cursor/agents/ | मौजूदा उपयोगकर्ता के सभी प्रोजेक्ट |
~/.claude/agents/ | मौजूदा उपयोगकर्ता के सभी प्रोजेक्ट (Claude संगतता) | |
~/.codex/agents/ | मौजूदा उपयोगकर्ता के सभी प्रोजेक्ट (Codex संगतता) |
नामों में टकराव होने पर प्रोजेक्ट उप-एजेंट को प्राथमिकता मिलती है। जब कई स्थानों पर एक ही नाम के उप-एजेंट हों, तो .cursor/ को .claude/ या .codex/ से प्राथमिकता मिलती है।
फ़ाइल प्रारूप
हर उप-एजेंट एक मार्कडाउन फ़ाइल होता है, जिसमें YAML फ्रंटमैटर होता है:
---name: security-auditordescription: Security specialist. Use when implementing auth, payments, or handling sensitive data.model: inheritreadonly: true---You are a security expert auditing code for vulnerabilities.When invoked:1. Identify security-sensitive code paths2. Check for common vulnerabilities (injection, XSS, auth bypass)3. Verify secrets are not hardcoded4. Review input validation and sanitizationReport findings by severity:- Critical (must fix before deploy)- High (fix soon)- Medium (address when possible)कॉन्फ़िगरेशन फ़ील्ड
| फ़ील्ड | प्रकार | आवश्यक | डिफ़ॉल्ट | विवरण |
|---|---|---|---|---|
name | string | नहीं | फ़ाइल नाम से प्राप्त | डिस्प्ले नाम और पहचानकर्ता। लोअरकेस अक्षरों और हाइफ़न का उपयोग करें। |
description | string | नहीं | — | Task टूल के संकेतों में दिखाया जाने वाला संक्षिप्त विवरण। एजेंट प्रत्यायोजन तय करने के लिए इसे पढ़ता है। |
model | string | नहीं | inherit | उपयोग किया जाने वाला मॉडल: inherit या कोई विशिष्ट मॉडल ID। मॉडल कॉन्फ़िगरेशन देखें। |
readonly | boolean | नहीं | false | यदि true है, तो उप-एजेंट सीमित लेखन अनुमतियों के साथ चलता है (कोई फ़ाइल संपादन नहीं, कोई स्थिति बदलने वाले शेल कमांड्स नहीं)। |
is_background | boolean | नहीं | false | यदि true है, तो उप-एजेंट पैरेंट को ब्लॉक किए बिना पृष्ठभूमि में चलता है। |
मॉडल कॉन्फ़िगरेशन
model फ़ील्ड तय करता है कि उप-एजेंट किस मॉडल का उपयोग करेगा। दो विकल्प हैं:
| मान | व्यवहार |
|---|---|
inherit | पैरेंट एजेंट के समान मॉडल का उपयोग करता है। यह डिफ़ॉल्ट है। |
| एक विशिष्ट मॉडल ID | आपके द्वारा निर्दिष्ट सटीक मॉडल का उपयोग करता है, जैसे composer-2 या gpt-5.6-sol। उपलब्ध IDs के लिए मॉडल संदर्भ देखें। |
जब उप-एजेंट को पैरेंट के समान तर्क क्षमता चाहिए, तो inherit चुनें। पैरेंट द्वारा उपयोग किए जा रहे मॉडल की परवाह किए बिना किसी विशेष मॉडल की क्षमताएँ चाहिए हों, तो एक विशिष्ट मॉडल ID का उपयोग करें।
मॉडल पैरामीटर
गति, तर्क प्रयास और कॉन्टेक्स्ट विंडो जैसे प्रति-मॉडल विकल्प सेट करने के लिए मॉडल ID के बाद वर्ग कोष्ठक जोड़ें। विकल्पों को id=value युग्म के रूप में लिखें और एक से अधिक विकल्पों को अल्पविराम से अलग करें।
| उदाहरण | व्यवहार |
|---|---|
composer-2.5[] | बेस मॉडल को Pin करता है। खाली कोष्ठक तेज़ प्रकार के बजाय Standard प्रकार चुनते हैं। |
composer-2.5[fast=false] | Standard (गैर-तेज़) प्रकार को स्पष्ट रूप से चुनता है। |
claude-opus-5[effort=high] | तर्क प्रयास को high पर सेट करता है। |
claude-opus-5[context=300k] | कॉन्टेक्स्ट विंडो को 300k टोकन पर सेट करता है। |
claude-opus-5[effort=high,context=300k] | विकल्पों को संयोजित करता है। |
उपलब्ध विकल्प मॉडल पर निर्भर करते हैं और SDK के मॉडल पैरामीटर की तरह ही id=value युग्मों का उपयोग करते हैं।
---name: plannerdescription: Plans complex changes before implementation.model: claude-opus-5[effort=high]---Break the task into a clear, ordered implementation plan.कॉन्फ़िगर किया गया मॉडल कब उपयोग नहीं किया जाएगा
Cursor आपके उप-एजेंट फ्रंटमैटर में model फ़ील्ड का उपयोग करता है, जब तक कि इनमें से कोई शर्त लागू न हो:
- टीम एडमिन प्रतिबंध — आपके संगठन के एडमिन ने निर्दिष्ट मॉडल को ब्लॉक कर दिया है।
- लीगेसी मैक्स मोड सेटिंग — लीगेसी अनुरोध-आधारित प्लान पर, मॉडल के लिए मैक्स मोड आवश्यक है और आपने इसे सक्षम नहीं किया है।
- प्लान सीमाएँ — मॉडल आपके मौजूदा प्लान में उपलब्ध नहीं है।
इन मामलों में, Cursor किसी संगत मॉडल का उपयोग करता है। अगर मॉडल का व्यवहार अपेक्षा के अनुरूप नहीं है, तो अपने प्लान और मॉडल सेटिंग्स जाँचें।
---name: code-reviewerdescription: Reviews code for correctness and style.model: inherit---Review the code changes for bugs, style issues, and edge cases.---name: search-agentdescription: Searches the codebase for relevant files and symbols.model: inherit---Search the codebase and return relevant file paths and code snippets.---name: reasoning-agentdescription: Handles complex architectural decisions.model: gpt-5.6-sol---Analyze the architecture and recommend changes with detailed reasoning.उप-एजेंट्स का उपयोग
स्वचालित प्रत्यायोजन
एजेंट इन आधारों पर सक्रिय रूप से कार्य सौंपता है:
- कार्य की जटिलता और स्कोप
- आपके प्रोजेक्ट में कस्टम उप-एजेंट के विवरण
- वर्तमान संदर्भ और उपलब्ध उपकरण
स्वचालित प्रत्यायोजन को बढ़ावा देने के लिए अपने विवरण फ़ील्ड में "सक्रिय रूप से उपयोग करें" या "के लिए हमेशा उपयोग करें" जैसे वाक्यांश शामिल करें।
स्पष्ट इनवोकेशन
अपने प्रॉम्प्ट में /name वाक्यविन्यास का उपयोग करके किसी विशिष्ट उप-एजेंट को अनुरोध भेजें:
> /verifier confirm the auth flow is complete> /debugger investigate this error> /security-auditor review the payment moduleआप उप-एजेंट्स का सामान्य रूप से उल्लेख करके भी उन्हें सक्रिय कर सकते हैं:
> auth प्रवाह पूरा होने की पुष्टि करने के लिए सत्यापनकर्ता उप-एजेंट का उपयोग करें> डिबगर उप-एजेंट से इस त्रुटि की जाँच करवाएँ> भुगतान मॉड्यूल पर सुरक्षा-ऑडिटर उप-एजेंट चलाएँसमानांतर निष्पादन
अधिकतम थ्रूपुट के लिए एकाधिक उप-एजेंट्स को एक साथ चलाएँ:
> API परिवर्तनों की समीक्षा करें और प्रलेखन को समानांतर रूप से अपडेट करेंएजेंट एक ही संदेश में कई Task टूल कॉल भेजता है, जिससे उप-एजेंट एक साथ चलते हैं।
क्लाउड उप-एजेंट
स्थानीय एजेंट सत्र से, आप काम किसी क्लाउड उप-एजेंट को सौंप सकते हैं, जो अपनी VM और ब्रांच पर चलता है। लंबे समय तक चलने वाला या समानांतर काम क्लाउड में होने पर भी आपका स्थानीय कार्यस्थान साफ़ और उत्तरदायी बना रहता है। पैरेंट एजेंट बिना बाधित हुए स्थानीय रूप से या क्लाउड में चलता रहता है। क्लाउड उप-एजेंट Cursor डेस्कटॉप ऐप में Agents Window से चलाए जाते हैं।
/in-cloud से क्लाउड उप-एजेंट शुरू करें
/in-cloud टाइप करें और आपके द्वारा सबमिट किया गया अगला कार्य क्लाउड उप-एजेंट के रूप में चलेगा। यह कार्य करने के लिए अपना VM और ब्रांच बनाता है।
यह लंबे समय तक चलने वाले या समानांतर कार्यों को अलग रखने के लिए उपयोगी है, जैसे CI ठीक करना, किसी समस्या की जाँच करना या स्थानीय रूप से काम जारी रखते हुए कोडबेस को एक्सप्लोर करना।
/babysit से PR की निगरानी करें
/babysit का उपयोग करके या त्वरित कार्रवाई पिल पर क्लिक करके किसी क्लाउड उप-एजेंट से पुल रिक्वेस्ट की निगरानी करवाएँ। क्लाउड एजेंट आपके स्थानीय सत्र को व्यस्त किए बिना PR को मर्ज के लिए तैयार करने हेतु रिमोट रूप से लगातार काम करता है।
क्लाउड उप-एजेंट आपके रेपो के लिए कॉन्फ़िगर किए गए परिवेश का उपयोग करते हैं और अन्य क्लाउड एजेंट्स जैसे ही मॉडल और क्षमता नियमों का पालन करते हैं। चूँकि वे क्लाउड VM पर चलते हैं, उनके MCP सर्वर आपके स्थानीय सत्र से नहीं, बल्कि cursor.com/agents पर आपकी टीम के कॉन्फ़िगरेशन से आते हैं।
उप-एजेंट्स को फिर से शुरू करना
पिछली बातचीत जारी रखने के लिए उप-एजेंट्स को फिर से शुरू किया जा सकता है। यह कई इनवोकेशन तक चलने वाले लंबे समय के कार्यों के लिए उपयोगी है।
हर उप-एजेंट निष्पादन एक एजेंट ID लौटाता है। पूरा संदर्भ सुरक्षित रखते हुए उप-एजेंट को फिर से शुरू करने के लिए यह ID पास करें:
> एजेंट abc123 को फिर से शुरू करें और शेष परीक्षण विफलताओं का विश्लेषण करेंपृष्ठभूमि में चल रहे उप-एजेंट चलते समय अपनी स्थिति सहेजते हैं। पूरा होने के बाद, संरक्षित संदर्भ के साथ बातचीत जारी रखने के लिए आप किसी उप-एजेंट को फिर से शुरू कर सकते हैं।
सामान्य पैटर्न
सत्यापन एजेंट
सत्यापन एजेंट स्वतंत्र रूप से जाँचता है कि बताया गया कार्य वास्तव में पूरा हुआ है या नहीं। इससे उस सामान्य समस्या का समाधान होता है, जिसमें AI कार्यों को पूरा चिह्नित कर देता है, लेकिन कार्यान्वयन अधूरे या खराब होते हैं।
---name: verifierdescription: Validates completed work. Use after tasks are marked done to confirm implementations are functional.---You are a skeptical validator. Your job is to verify that work claimed as complete actually works.When invoked:1. Identify what was claimed to be completed2. Check that the implementation exists and is functional3. Run relevant tests or verification steps4. Look for edge cases that may have been missedBe thorough and skeptical. Report:- What was verified and passed- What was claimed but incomplete or broken- Specific issues that need to be addressedDo not accept claims at face value. Test everything..cursor/agents/verifier.md में नाम और विवरण वाला YAML फ्रंटमैटर शामिल करते हुए एक उप-एजेंट फ़ाइल बनाएं। विवरण होना चाहिए 'पूर्ण किए गए कार्य को सत्यापित करता है। कार्यों को पूर्ण चिह्नित करने के बाद, कार्यान्वयन कार्यशील हैं या नहीं इसकी पुष्टि करने के लिए इसका उपयोग करें।' प्रॉम्प्ट बॉडी में इसे संशयपूर्ण रहने, परीक्षण चलाकर यह सत्यापित करने कि कार्यान्वयन वास्तव में काम करते हैं, और एज केस खोजने का निर्देश होना चाहिए।
Try in Cursorयह पैटर्न इनके लिए उपयोगी है:
- टिकट को पूर्ण चिह्नित करने से पहले यह सत्यापित करना कि सुविधाएँ शुरू से अंत तक काम करती हैं
- आंशिक रूप से लागू की गई कार्यक्षमता को पकड़ना
- यह सुनिश्चित करना कि परीक्षण वास्तव में पास होते हैं (सिर्फ़ परीक्षण फ़ाइलों के मौजूद होने से नहीं)
ऑर्केस्ट्रेटर पैटर्न
जटिल वर्कफ़्लो में, एक पैरेंट एजेंट कई विशेषज्ञ उप-एजेंट्स का क्रमवार समन्वय कर सकता है:
- प्लानर आवश्यकताओं का विश्लेषण करता है और तकनीकी प्लान बनाता है
- इम्प्लीमेंटर प्लान के आधार पर सुविधा बिल्ड करता है
- सत्यापनकर्ता पुष्टि करता है कि कार्यान्वयन आवश्यकताओं से मेल खाता है
हर हैंडऑफ़ में संरचित आउटपुट शामिल होता है, ताकि अगले एजेंट को स्पष्ट संदर्भ मिल सके।
उप-एजेंट्स के उदाहरण
डिबगर
---name: debuggerdescription: Debugging specialist for errors and test failures. Use when encountering issues.---You are an expert debugger specializing in root cause analysis.When invoked:1. Capture error message and stack trace2. Identify reproduction steps3. Isolate the failure location4. Implement minimal fix5. Verify solution worksFor each issue, provide:- Root cause explanation- Evidence supporting the diagnosis- Specific code fix- Testing approachFocus on fixing the underlying issue, not symptoms.नाम और विवरण वाले YAML फ्रंटमैटर के साथ .cursor/agents/debugger.md में एक उप-एजेंट फ़ाइल बनाएं। debugger उप-एजेंट मूल कारण विश्लेषण में विशेषज्ञ हो: stack trace कैप्चर करे, रीप्रोडक्शन चरण पहचाने, विफलताओं को अलग करे, न्यूनतम सुधार लागू करे और समाधानों को सत्यापित करे।
Try in Cursorपरीक्षण रनर
---name: test-runnerdescription: परीक्षण स्वचालन विशेषज्ञ। परीक्षण चलाने और विफलताओं को ठीक करने के लिए सक्रिय रूप से उपयोग करें।---आप परीक्षण स्वचालन विशेषज्ञ हैं।कोड में परिवर्तन दिखने पर, सक्रिय रूप से उचित परीक्षण चलाएँ।यदि परीक्षण विफल होते हैं:1. विफलता आउटपुट का विश्लेषण करें2. मूल कारण पहचानें3. परीक्षण के इरादे को बनाए रखते हुए समस्या ठीक करें4. सत्यापित करने के लिए पुनः चलाएँपरीक्षण परिणामों की रिपोर्ट में शामिल करें:- पास/विफल हुए परीक्षणों की संख्या- किसी भी विफलता का सारांश- समस्याओं को ठीक करने के लिए किए गए परिवर्तननाम और विवरण (जिसमें 'सक्रिय रूप से उपयोग करें' का उल्लेख हो) वाले YAML फ्रंटमैटर के साथ .cursor/agents/test-runner.md में एक उप-एजेंट फ़ाइल बनाएं। test-runner उप-एजेंट कोड परिवर्तन दिखने पर सक्रिय रूप से परीक्षण चलाए, विफलताओं का विश्लेषण करे, परीक्षण का आशय बनाए रखते हुए समस्याएँ ठीक करे और परिणामों की रिपोर्ट करे।
Try in Cursorसर्वोत्तम प्रथाएँ
- केंद्रित उप-एजेंट लिखें — हर उप-एजेंट की एक स्पष्ट ज़िम्मेदारी होनी चाहिए। सामान्य "helper" एजेंट बनाने से बचें।
- विवरण पर ध्यान दें —
descriptionफ़ील्ड तय करता है कि एजेंट आपके उप-एजेंट को कब काम सौंपेगा। इसे बेहतर बनाने में समय दें। अलग-अलग प्रॉम्प्ट्स देकर जाँचें कि सही उप-एजेंट ट्रिगर हो रहा है या नहीं। - प्रॉम्प्ट्स संक्षिप्त रखें — लंबे और भटके हुए प्रॉम्प्ट्स फोकस कम करते हैं। स्पष्ट और सीधे रहें।
- उप-एजेंट्स को वर्ज़न कंट्रोल में शामिल करें —
.cursor/agents/को अपनी रिपॉज़िटरी में जोड़ें, ताकि पूरी टीम को इसका लाभ मिले। - एजेंट-जनरेट किए गए एजेंट्स से शुरुआत करें — शुरुआती कॉन्फ़िगरेशन का मसौदा तैयार करने के लिए एजेंट की मदद लें, फिर उसे अनुकूलित करें।
- फ़ाइल आउटपुट के लिए हुक्स का उपयोग करें — अगर आपको उप-एजेंट्स से संरचित आउटपुट फ़ाइलें बनवानी हैं, तो उनके परिणामों को लगातार प्रोसेस और सहेजने के लिए हुक्स के उपयोग पर विचार करें।
बचने योग्य एंटी-पैटर्न
दर्जनों सामान्य उप-एजेंट न बनाएं। "कोडिंग में मदद करता है" जैसे अस्पष्ट निर्देशों वाले 50+ उप-एजेंट रखना प्रभावी नहीं है। एजेंट को पता नहीं होगा कि उनका उपयोग कब करना है, और उनके रखरखाव में आपका समय बर्बाद होगा।
- अस्पष्ट विवरण — "सामान्य कार्यों के लिए उपयोग करें" से एजेंट को यह नहीं पता चलता कि कब सौंपना है। स्पष्ट रहें: "OAuth प्रदाताओं के साथ प्रमाणीकरण फ़्लो लागू करते समय उपयोग करें।"
- बहुत लंबे प्रॉम्प्ट्स — 2,000 शब्दों का प्रॉम्प्ट उप-एजेंट को अधिक बुद्धिमान नहीं बनाता। इससे वह धीमा हो जाता है और उसका रखरखाव कठिन हो जाता है।
- स्लैश कमांड्स की नकल करना — अगर कोई कार्य एक ही उद्देश्य के लिए है और उसे संदर्भ पृथक्करण की जरूरत नहीं है, तो कौशल या कमांड का उपयोग करें।
- बहुत अधिक उप-एजेंट — 2-3 केंद्रित उप-एजेंट्स से शुरू करें। और जोड़ें, केवल तब जब आपके पास स्पष्ट और अलग उपयोग के मामले हों।
उप-एजेंट्स का प्रबंधन
उप-एजेंट बनाना
उप-एजेंट बनाने का सबसे आसान तरीका है कि आप Agent से अपने लिए एक बनाने को कहें:
.cursor/agents/security-reviewer.md में नाम और विवरण वाले YAML फ्रंटमैटर के साथ एक उप-एजेंट फ़ाइल बनाएं। security-reviewer उप-एजेंट को इंजेक्शन, XSS और हार्डकोड किए गए सीक्रेट्स जैसी सामान्य कमजोरियों के लिए कोड की जाँच करनी चाहिए।
Try in Cursorआप .cursor/agents/ (प्रोजेक्ट) या ~/.cursor/agents/ (उपयोगकर्ता) में मार्कडाउन फ़ाइलें जोड़कर मैन्युअल रूप से भी उप-एजेंट बना सकते हैं।
उप-एजेंट देखना
एजेंट के उपलब्ध टूल में सभी कस्टम उप-एजेंट शामिल होते हैं। आपके प्रोजेक्ट की .cursor/agents/ डायरेक्टरी में देखकर पता लगाया जा सकता है कि कौन-से उप-एजेंट कॉन्फ़िगर किए गए हैं।
प्रदर्शन और लागत
उप-एजेंट्स के कुछ फायदे और नुकसान हैं। इन्हें समझने से आपको यह तय करने में मदद मिलती है कि उनका उपयोग कब करना चाहिए।
| लाभ | नुकसान |
|---|---|
| संदर्भ पृथक्करण | स्टार्टअप ओवरहेड (हर उप-एजेंट अपना संदर्भ एकत्र करता है) |
| समानांतर निष्पादन | अधिक टोकन उपयोग (कई संदर्भ एक साथ चल रहे हैं) |
| विशेषीकृत फोकस | विलंब (सरल कार्यों के लिए मुख्य एजेंट से धीमा हो सकता है) |
टोकन और लागत संबंधी बातें
- उप-एजेंट स्वतंत्र रूप से टोकन इस्तेमाल करते हैं — हर उप-एजेंट की अपनी कॉन्टेक्स्ट विंडो और टोकन उपयोग होता है। पाँच उप-एजेंट को समानांतर चलाने पर एक एजेंट की तुलना में लगभग पाँच गुना टोकन लगते हैं।
- अतिरिक्त लागत का आकलन करें — त्वरित और सरल कार्यों के लिए मुख्य एजेंट अक्सर तेज़ होता है। उप-एजेंट जटिल, लंबे समय तक चलने वाले या समानांतर कार्यों में बेहतर होते हैं।
- उप-एजेंट धीमे हो सकते हैं — उनका लाभ संदर्भ पृथक्करण है, गति नहीं। सरल कार्य करने वाला उप-एजेंट नए सिरे से शुरू होने के कारण मुख्य एजेंट से धीमा हो सकता है।
अक्सर पूछे जाने वाले सवाल
Cursor में तीन अंतर्निहित सबएजेंट शामिल हैं: कोडबेस खोज के लिए explore, शेल कमांड्स चलाने के लिए bash, और MCP के ज़रिए ब्राउज़र स्वचालन के लिए browser। ये संदर्भ-प्रधान कार्यों को अपने-आप संभालते हैं। आपको इन्हें कॉन्फ़िगर करने की ज़रूरत नहीं है।
हाँ, नेस्टिंग सीमा के भीतर। Cursor 2.5 से, उप-एजेंट समन्वित कार्यों का ट्री बनाने के लिए चाइल्ड उप-एजेंट शुरू कर सकते हैं। मुख्य एजेंट और उसके प्रत्यक्ष उप-एजेंट उप-एजेंट शुरू कर सकते हैं, लेकिन किसी दूसरे उप-एजेंट द्वारा शुरू किया गया उप-एजेंट आगे कोई उप-एजेंट शुरू नहीं कर सकता। नेस्टेड लॉन्च के लिए मौजूदा मोड में Task टूल का एक्सेस भी चाहिए, और हुक या टूल नीतियाँ इन्हें शुरू होने से रोक सकती हैं।
पृष्ठभूमि उप-एजेंट आउटपुट को ~/.cursor/subagents/ में लिखते हैं। पैरेंट एजेंट प्रगति जाँचने के लिए इन फ़ाइलों को पढ़ सकता है।
उप-एजेंट पैरेंट एजेंट को त्रुटि स्थिति लौटाता है। पैरेंट फिर से कोशिश कर सकता है, अतिरिक्त संदर्भ के साथ काम फिर से शुरू कर सकता है या विफलता को अलग तरीके से संभाल सकता है।
हाँ। उप-एजेंट पैरेंट के सभी उपकरण इनहेरिट करते हैं, जिनमें कॉन्फ़िगर किए गए सर्वर के MCP टूल्स भी शामिल हैं। क्लाउड उप-एजेंट अपवाद हैं: वे क्लाउड VM पर चलते हैं और आपके स्थानीय सत्र के सर्वर के बजाय cursor.com/agents पर आपकी टीम के लिए कॉन्फ़िगर किए गए MCP सर्वर का उपयोग करते हैं।
उप-एजेंट का विवरण और प्रॉम्प्ट जाँचें। सुनिश्चित करें कि निर्देश विशिष्ट और स्पष्ट हों। आप किसी सरल कार्य के साथ उप-एजेंट को स्पष्ट रूप से शुरू करके उसका परीक्षण भी कर सकते हैं।
अगर आपकी टीम एडमिन मॉडल को ब्लॉक करता है, आपके प्लान में वह शामिल नहीं है, या किसी लीगेसी अनुरोध-आधारित प्लान में मैक्स मोड ज़रूरी है और वह सक्षम नहीं है, तो Cursor कॉन्फ़िगर किए गए मॉडल को ओवरराइड कर देता है। मैक्स मोड के बिना लीगेसी अनुरोध-आधारित प्लान पर, किसी भी model कॉन्फ़िगरेशन की परवाह किए बिना उप-एजेंट Composer का उपयोग करके चलते हैं। अगर आपकी टीम एडमिन ने Composer को ब्लॉक किया है, तो उप-एजेंट केवल मैक्स मोड सक्षम होने पर ही चल सकते हैं। उपयोग-आधारित प्लान और मैक्स मोड वाले लीगेसी अनुरोध-आधारित प्लान पर, उप-एजेंट डिफ़ॉल्ट रूप से पैरेंट मॉडल का उपयोग करते हैं। विवरण के लिए मॉडल कॉन्फ़िगरेशन देखें।