इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल
बार-बार की जाने वाली कॉल को सुरक्षित और पूर्वानुमेय बनाएँ।
इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल, CoddyKit पर MCP Academy का एक निःशुल्क पाठ है। यह 4 में से 3वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह MCP Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
मॉडल दो बार कॉल कर सकते हैं
कोई AI क्लाइंट टाइमआउट या कनेक्शन टूटने के बाद किसी टूल को फिर से चला सकता है। उपयोगकर्ता के अनुसार एक बार किए जाने वाले काम के लिए आपका टूल दो बार चल सकता है।
आइडेम्पोटेंट का अर्थ
कोई टूल आइडेम्पोटेंट तब होता है, जब उसी इनपुट के साथ उसे दोबारा कॉल करने पर आगे कोई बदलाव न हो। दूसरी कॉल सुरक्षित रूप से निष्क्रिय कार्य बन जाती है।
पठन स्वाभाविक रूप से सुरक्षित हैं
रिकॉर्ड प्राप्त करने जैसे शुद्ध पठन टूल पहले से ही आइडेम्पोटेंट होते हैं। उन्हें दोहराने पर बिना किसी नुकसान के वही उत्तर मिलता है।
@mcp.tool()
def get_user(id: int) -> dict:
return db.find(id)लेखन में सावधानी चाहिए
डेटा बनाने या पैसे लेने वाला टूल दोहराना खतरनाक है। बिना जाँच का दोबारा प्रयास डुप्लिकेट पंक्ति जोड़ सकता है या भुगतान दो बार कर सकता है।
क्लाइंट द्वारा दी गई कुंजी का उपयोग करें
कॉलर से एक आइडेम्पोटेंसी कुंजी माँगें। यदि उस कुंजी को पहले ही संसाधित किया जा चुका है, तो दोबारा कार्य करने के बजाय संग्रहीत परिणाम लौटाएँ।
if key in seen:
return seen[key]
seen[key] = do_work()Insert के बजाय Upsert को प्राथमिकता दें
Upsert स्थिर आईडी के आधार पर लिखता या अपडेट करता है, इसलिए उसे दो बार चलाने पर दो नहीं, बल्कि एक ही पंक्ति रहती है। यह दोबारा प्रयासों को एक ही स्थिति में समेट देता है।
INSERT ... ON CONFLICT (id)
DO UPDATE SET ...साइड इफ़ेक्ट स्पष्ट रूप से घोषित करें
टूल के विवरण में बताएँ कि वह डेटा बदलता है या नहीं। कॉल के विनाशकारी होने की जानकारी होने पर मॉडल अधिक समझदारी से निर्णय लेता है।
पठन और लेखन टूल अलग रखें
कभी-कभी लिखने वाले एक ही टूल के बजाय क्वेरी टूल और बदलाव करने वाले टूल को अलग रखें। स्पष्ट सीमाएँ आकस्मिक बदलावों को कम करती हैं।
परिणामों को नियतात्मक बनाएँ
जहाँ संभव हो, समान इनपुट के लिए वही आउटपुट लौटाएँ। पूर्वानुमेय परिणाम क्लाइंट को आपके टूल को कैश करने और उसके बारे में तर्क करने में सहायता करते हैं।
कार्य करने से पहले जाँचें
लेखन से पहले लक्ष्य की वर्तमान स्थिति की पुष्टि करें। यदि बदलाव पहले ही लागू हो चुका है, तो उसे दोहराए बिना सफलता की सूचना दें।
if order.status == "shipped":
return "already shipped"बहु-चरणीय काम को एक ट्रांज़ैक्शन में रखें
यदि कोई टूल कई पंक्तियों को प्रभावित करता है, तो उन्हें एक ही ट्रांज़ैक्शन में चलाएँ। तब दोबारा प्रयास या तो पूरी तरह लागू होगा या पूरी तरह वापस होगा, कभी आधा-अधूरा नहीं।
त्वरित जाँच
रिकॉर्ड बनाने वाले MCP टूल के लिए आइडेम्पोटेंसी महत्वपूर्ण क्यों है?
पुनरावलोकन: सुरक्षित दोहराव
कुंजियों या Upsert से लेखनों को आइडेम्पोटेंट बनाएँ, साइड इफ़ेक्ट घोषित करें, पठन को लेखन से अलग रखें और ट्रांज़ैक्शन का उपयोग करें। अगला विषय: संस्करण-निर्धारण। ♻️
एआई शिक्षक के साथ Python सीखें — निःशुल्क
अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।
- पाठ्यक्रम
- 30
- पाठ
- 120
अक्सर पूछे जाने वाले प्रश्न
क्या “इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल” पाठ निःशुल्क है?
हाँ — MCP Academy अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
“इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल” में मैं क्या सीखूँगा?
बार-बार की जाने वाली कॉल को सुरक्षित और पूर्वानुमेय बनाएँ। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ MCP Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।
क्या MCP Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?
पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर MCP Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 3वाँ पाठ है।
“इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल” पाठ पूरा करने में कितना समय लगता है?
CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।
क्या मैं इस MCP Academy पाठ में कोड लिख और चला सकता हूँ?
हाँ। हर MCP Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।
इस पाठ्यक्रम के सभी पाठ
- स्तरीकृत सर्वर आर्किटेक्चर
- पर्यावरण के माध्यम से कॉन्फ़िगरेशन और गुप्त जानकारी
- इडेम्पोटेंट, साइड-इफ़ेक्ट-सचेत टूल
- टूल और स्कीमा का संस्करण प्रबंधन