API पर एजेंट बनाना
- परिभाषित करें कि एजेंट वास्तव में क्या है: एक लूप में चलने वाला मॉडल
- सिंगल कॉल बनाम वर्कफ़्लो बनाम एजेंट चुनने के लिए निर्णय परीक्षण लागू करें
- सही गार्डरेल्स के साथ एक न्यूनतम एजेंट लूप डिज़ाइन करें
- जानें कि खुद से हाथ से बनाने के बजाय Claude Agent SDK का सहारा कब लेना है
- एजेंट को मज़बूत बनाएँ: इसे सीमित करें, विफलताओं को संभालें, विशेषाधिकार प्रतिबंधित करें, इसका मूल्यांकन करें
एक एजेंट एक लूप में चलने वाला मॉडल है: यह टूल कॉल करके, परिणामों का अवलोकन करके, और काम पूरा होने तक अगला कदम तय करके किसी लक्ष्य का पीछा करता है। इसे बनाने से पहले, सबसे सरल चीज़ जो काम करे चुनें।
निर्णय परीक्षण (ज़रूरत से ज़्यादा न बनाएँ)
हर काम के लिए एजेंट की ज़रूरत नहीं होती। पहले इस पेड़ पर चलें — ज़्यादातर काम शीर्ष पर ही रुक जाते हैं।
तीन विकल्प, सबसे सरल पहले:
- सिंगल कॉल — एक ही प्रॉम्प्ट से जवाब मिल जाता है। ज़्यादातर काम। सबसे सस्ता, सबसे विश्वसनीय।
- वर्कफ़्लो — आप कोड में कॉल्स का एक निश्चित क्रम ऑर्केस्ट्रेट करते हैं (डिटरमिनिस्टिक कंट्रोल फ़्लो)। तब उपयोग करें जब चरण ज्ञात हों।
- एजेंट — मॉडल चरणों को गतिशील रूप से तय करता है। केवल तभी उपयोग करें जब रास्ते को वास्तव में हार्डकोड नहीं किया जा सकता।
एजेंट तब चुनें जब अनुकूलनशीलता ही मुद्दा हो — इसलिए नहीं कि यह प्रभावशाली लगता है। आपके नियंत्रण वाला वर्कफ़्लो परखना और डीबग करना आसान होता है।
लूप डिज़ाइन करना
एक न्यूनतम कस्टम एजेंट केवल चार गतिशील भागों से बना होता है। उन्हें इसी क्रम में बनाएँ:
- लक्ष्य, बाधाएँ, और उपलब्ध टूल बताएँ। यही वह है जिसके विरुद्ध मॉडल हर बारी पर तर्क करता है।
- संदेश भेजें → यदि प्रतिक्रिया एक tool_use है, तो टूल चलाएँ, एक tool_result जोड़ें, और दोहराएँ → जब तक कोई अंतिम उत्तर या रुकने की शर्त न आ जाए।
- एक अधिकतम-इटरेशन सीमा, एक टोकन/लागत बजट, और कुछ भी चलने से पहले टूल इनपुट का सत्यापन जोड़ें।
- जैसे-जैसे इतिहास बढ़े, सारांशित करें या छँटाई करें — वही विचार जो कॉन्टेक्स्ट प्रबंधन (/docs/claude-code/context-management) में शामिल है।
Claude Agent SDK आपको यह लूप देता है — टूल, अनुमतियाँ, कॉन्टेक्स्ट हैंडलिंग — सब कुछ शामिल, ताकि आपको इसे खुद से हाथ से न बनाना पड़े।
अपना खुद का लूप लिखने से पहले, पूछें कि क्या Agent SDK इसे पहले से कवर करता है। यह लूप, अनुमतियाँ, और कॉन्टेक्स्ट हैंडलिंग के साथ आता है ताकि आप टूल और लक्ष्य पर ध्यान केंद्रित कर सकें।
इसे मज़बूत बनाएँ
जो लूप टूल कॉल कर सकता है, वह गलत व्यवहार भी कर सकता है। चार आदतें एजेंट को भरोसेमंद बनाए रखती हैं:
- हर चीज़ को सीमित करें: इटरेशन, समय, लागत। एजेंट लूप में फँस सकते हैं।
- टूल विफलताओं को सहजता से संभालें (त्रुटि को परिणाम के रूप में लौटाएँ)।
- जोखिमपूर्ण क्रियाओं के लिए न्यूनतम विशेषाधिकार + ह्यूमन-इन-द-लूप — देखें एजेंट सुरक्षित करना।
- भरोसा करने से पहले इसे वास्तविक मामलों पर मूल्यांकित करें — देखें Evals।
- एक एजेंट एक लूप में चलने वाला मॉडल है जो किसी लक्ष्य की ओर टूल कॉल करता है — इसका उपयोग केवल तभी करें जब रास्ते को हार्डकोड न किया जा सके
- निर्णय क्रम: सिंगल कॉल → वर्कफ़्लो → एजेंट → मैनेज्ड एजेंट; सबसे सरल विकल्प को प्राथमिकता दें जो काम करे
- एक न्यूनतम लूप = सिस्टम प्रॉम्प्ट + tool_use/tool_result लूप + गार्डरेल्स + कॉन्टेक्स्ट प्रबंधन
- Claude Agent SDK आपके लिए लूप, टूल, अनुमतियाँ, और कॉन्टेक्स्ट हैंडलिंग के साथ आता है
- मज़बूती = इटरेशन/समय/लागत को सीमित करना, टूल विफलताओं को संभालना, न्यूनतम विशेषाधिकार + ह्यूमन-इन-द-लूप, और भरोसा करने से पहले मूल्यांकन करना