प्रकार संकेतों के साथ पैरामीटर घोषित करें
टूल की स्कीमा निर्धारित करने के लिए Python के प्रकार संकेतों का उपयोग करें।
प्रकार संकेतों के साथ पैरामीटर घोषित करें, CoddyKit पर MCP Academy का एक निःशुल्क पाठ है। यह 4 में से 2वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह MCP Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
पैरामीटर एक स्कीमा बन जाते हैं
आपके tool फ़ंक्शन का हर आर्ग्युमेंट उस इनपुट स्कीमा का हिस्सा बन जाता है, जिसका पालन मॉडल को tool बुलाते समय करना होता है। 🧩
प्रकार संकेत यह काम करते हैं
FastMCP आपके Python के प्रकार संकेत पढ़कर JSON स्कीमा अपने-आप बनाता है, इसलिए आपको स्कीमा बहुत कम ही हाथ से लिखना पड़ता है।
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
मूल प्रकार आसानी से मैप होते हैं: str से string, int और float से number, तथा bool से schema में boolean बनता है।
बिना प्रकार के अर्थ अस्पष्ट होते हैं
प्रकार संकेत छोड़ देने पर मॉडल को बिना किसी नियम के केवल एक ढीला-ढाला मान दिखाई देता है, जिससे गलत या अमान्य इनपुट की संभावना बढ़ती है।
def add(a, b):
return a + bडिफ़ॉल्ट रूप से आवश्यक
जिस पैरामीटर का कोई डिफ़ॉल्ट मान नहीं होता, उसे आवश्यक माना जाता है। इसलिए tool बुलाते समय मॉडल को उसे हमेशा देना पड़ता है।
डिफ़ॉल्ट से यह वैकल्पिक बनता है
किसी पैरामीटर को डिफ़ॉल्ट मान दें और वह वैकल्पिक हो जाता है। मॉडल उसे छोड़ सकता है और आपका फ़ंक्शन fallback मान का उपयोग करता है।
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...सूचियाँ और डिक्शनरी
आप संग्रहों के लिए भी संकेत दे सकते हैं। list आर्ग्युमेंट JSON array में मैप होता है और dict ऐसे object में, जिसे मॉडल भर सकता है।
def tag(items: list[str]) -> int:
return len(items)वैकल्पिक मान
Optional का उपयोग तब करें जब कोई आर्ग्युमेंट किसी मान या None में से एक हो सकता है। इससे पता चलता है कि मॉडल उसे जानबूझकर खाली छोड़ सकता है।
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...पैरामीटर के नाम स्पष्ट रखें
मॉडल schema में हर पैरामीटर का नाम देखता है, इसलिए c की जगह city और arg2 की जगह start_date बेहतर हैं। स्पष्ट नाम बेहतर कॉल का मार्गदर्शन करते हैं।
संकेत सत्यापन को सक्षम करते हैं
संकेत schema निर्धारित करते हैं, इसलिए MCP आपका कोड चलने से पहले गलत प्रकार वाले कॉल अस्वीकार कर सकता है और गलतियाँ जल्दी पकड़ सकता है।
हस्ताक्षर छोटा रखें
कम और सही प्रकार वाले पैरामीटर मॉडल के लिए ढीले-ढाले, आपस में कम जुड़े आर्ग्युमेंट की लंबी सूची की तुलना में सही ढंग से भरना आसान होते हैं।
त्वरित जाँच
FastMCP में किसी tool पैरामीटर को वैकल्पिक क्या बनाता है?
पुनरावलोकन
आपके प्रकार संकेत tool schema बनाते हैं: मूल प्रकार सीधे मैप होते हैं, डिफ़ॉल्ट मान पैरामीटर को वैकल्पिक बनाते हैं और स्पष्ट नाम मॉडल का मार्गदर्शन करते हैं। ✅
एआई शिक्षक के साथ Python सीखें — निःशुल्क
अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।
- पाठ्यक्रम
- 30
- पाठ
- 120
अक्सर पूछे जाने वाले प्रश्न
क्या “प्रकार संकेतों के साथ पैरामीटर घोषित करें” पाठ निःशुल्क है?
हाँ — MCP Academy अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “प्रकार संकेतों के साथ पैरामीटर घोषित करें” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।
“प्रकार संकेतों के साथ पैरामीटर घोषित करें” में मैं क्या सीखूँगा?
टूल की स्कीमा निर्धारित करने के लिए Python के प्रकार संकेतों का उपयोग करें। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ MCP Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।
क्या MCP Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?
पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर MCP Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 2वाँ पाठ है।
“प्रकार संकेतों के साथ पैरामीटर घोषित करें” पाठ पूरा करने में कितना समय लगता है?
CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।
क्या मैं इस MCP Academy पाठ में कोड लिख और चला सकता हूँ?
हाँ। हर MCP Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।
इस पाठ्यक्रम के सभी पाठ
- टूल का नाम और विवरण सही ढंग से दें
- प्रकार संकेतों के साथ पैरामीटर घोषित करें
- उपयोगी परिणाम लौटाएँ
- कैलकुलेटर टूल, शुरू से अंत तक