प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ
ट्रांसपोर्ट संबंधी दोषों को व्यावसायिक-तर्क की त्रुटियों से अलग पहचानें।
प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ, CoddyKit पर MCP Academy का एक निःशुल्क पाठ है। यह 4 में से 2वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह MCP Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
दो बिल्कुल अलग विफलताएँ
MCP में विफलता के दो प्रकार हैं: स्वयं wire में होने वाली protocol error और आपके व्यावसायिक तर्क के अंदर होने वाली tool की विफलता। इन्हें अलग-अलग ढंग से संभाला जाता है।
Protocol errors JSON-RPC में होती हैं
protocol error का अर्थ है कि संदेश को बिल्कुल संसाधित नहीं किया जा सका, जैसे अज्ञात method या गलत प्रारूप वाले params। यह JSON-RPC के error field में आती है।
{"jsonrpc": "2.0", "id": 7,
"error": {"code": -32601,
"message": "Method not found"}}Tool की विफलताएँ परिणाम में होती हैं
tool की विफलता का अर्थ है कि कॉल आपके function तक पहुँची, लेकिन काम गलत हो गया। यह isError true से चिह्नित सामान्य परिणाम लौटाती है।
यह विभाजन क्यों महत्वपूर्ण है
मॉडल को tool की विफलताएँ देखनी और उन पर प्रतिक्रिया देनी चाहिए, लेकिन protocol errors आम तौर पर ऐसी bug का संकेत देती हैं जिसे client को संभालना होता है, न कि AI दोबारा प्रयास कर सकता है।
मानक JSON-RPC कोड
Protocol codes ऋणात्मक और मानकीकृत होते हैं: -32601 का अर्थ method नहीं मिला, -32602 का अर्थ invalid params और -32700 का अर्थ parse error है।
Tool की विफलताएँ मॉडल तक पहुँचती हैं
क्योंकि tool की विफलता केवल एक result है, मॉडल उसे संदर्भ के रूप में पढ़ सकता है और दोबारा प्रयास करने, input बदलने या उसे समझाने का निर्णय ले सकता है। 🔁
Tool के अंदर raise करना
जब आप किसी tool में exception को raise करते हैं, तो FastMCP उसे protocol error में नहीं, बल्कि tool की विफलता वाले परिणाम में बदल देता है। आपका सर्वर चलता रहता है।
@mcp.tool()
def fetch(url: str) -> str:
if not url.startswith("http"):
raise ValueError("url must be http")अज्ञात tool protocol-स्तर की समस्या है
यदि client ऐसे tool के लिए पूछता है जो मौजूद नहीं है, तो वह protocol error है। अनुरोध आपके किसी भी function तक नहीं पहुँचता।
गलत arguments दोनों में से कुछ भी हो सकते हैं
Schema-स्तर के type mismatch protocol की invalid-params error के रूप में सामने आते हैं, जबकि सही type के साथ गलत value होना tool की विफलता के रूप में संभालना बेहतर है।
विफलता को सही श्रोता तक पहुँचाएँ
पूछिए कि प्रतिक्रिया किसे देनी चाहिए। यदि model इसे ठीक कर सकता है, तो इसे tool की विफलता बनाएँ। यदि केवल developer ही इसे ठीक कर सकता है, तो protocol error उचित है।
Transport को स्वस्थ रखें
व्यावसायिक समस्याओं को कभी protocol errors के रूप में बाहर न जाने दें। ऐसा करने से clients भ्रमित होते हैं और वह session बंद हो सकता है जिसे जारी रहना चाहिए।
त्वरित जाँच
आपके tool function के अंदर होने वाली विफलता कहाँ रिपोर्ट की जाती है?
पुनरावलोकन
Protocol errors का अर्थ है कि संदेश स्वयं विफल हुआ; tool की विफलताओं का अर्थ है कि आपका तर्क विफल हुआ। प्रत्येक को उस व्यक्ति तक पहुँचाएँ जो उस पर कार्रवाई कर सकता है और transport को स्वस्थ रखें। ✅
एआई शिक्षक के साथ Python सीखें — निःशुल्क
अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।
- पाठ्यक्रम
- 30
- पाठ
- 120
अक्सर पूछे जाने वाले प्रश्न
क्या “प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ” पाठ निःशुल्क है?
हाँ — MCP Academy अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
“प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ” में मैं क्या सीखूँगा?
ट्रांसपोर्ट संबंधी दोषों को व्यावसायिक-तर्क की त्रुटियों से अलग पहचानें। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ MCP Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।
क्या MCP Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?
पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर MCP Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 2वाँ पाठ है।
“प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ” पाठ पूरा करने में कितना समय लगता है?
CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।
क्या मैं इस MCP Academy पाठ में कोड लिख और चला सकता हूँ?
हाँ। हर MCP Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।
इस पाठ्यक्रम के सभी पाठ
- वे टूल त्रुटियाँ जिन्हें मॉडल देख सकता है
- प्रोटोकॉल त्रुटियाँ बनाम टूल विफलताएँ
- कार्रवाई से पहले इनपुट मान्य करें
- सुरक्षित रूप से विफल हों, कभी अटकें नहीं