Gemini Apps के डेवलपर मोड का इस्तेमाल करके, अपने मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर को इंटरैक्टिव तरीके से टेस्ट करें. साथ ही, स्कीमा या रनटाइम से जुड़ी गड़बड़ियों का पता लगाएं और टूल की क्वालिटी की जांच करें. इसके बाद, कनेक्ट किए गए अपने ऐप्लिकेशन को समीक्षा के लिए Google Connected Console में सबमिट करें.
इस गाइड में इन टास्क के बारे में बताया गया है:
- Gemini में Gemini Apps डेवलपर मोड चालू करें, एक कस्टम एमसीपी ऐप्लिकेशन बनाएं, और टूल की शुरुआती खोज की पुष्टि करें.
- टूल कॉल न होने की समस्या को डीबग करना, अपडेट किए गए स्कीमा को सिंक करना, और पुष्टि करने की प्रोसेस को टेस्ट करना.
- उपयोगकर्ता के एनवायरमेंट के कॉन्टेक्स्ट को सिम्युलेट करना और क्लाइंट की पुष्टि करने की सुविधा को कॉन्फ़िगर करना.
वर्कस्पेस के लेआउट और इंस्पेक्टर टैब के बारे में जानने के लिए, Gemini Apps के डेवलपर मोड के बारे में खास जानकारी देखें.
Gemini Apps का डेवलपर मोड चालू करना
अगर Google Connected Console में एमसीपी सर्वर को शामिल किया जा रहा है, तो Gemini Apps के डेवलपर मोड को चालू करने पर, आपका रजिस्टर किया गया ऐप्लिकेशन पहले से ही उपलब्ध होगा. ऐसे में, दूसरा चरण छोड़ा जा सकता है. अगर आपको डिप्लॉय किए गए एचटीटीपीएस एमसीपी सर्वर एंडपॉइंट को कंसोल में रजिस्टर करने से पहले, सीधे Gemini में टेस्ट करना है, तो Gemini Apps डेवलपर मोड को चालू करने और अपने सर्वर को कस्टम एमसीपी ऐप्लिकेशन के तौर पर कनेक्ट करने के लिए, दोनों चरणों को पूरा करें.
पहला चरण: Gemini Apps का डेवलपर मोड चालू करना
- अपने वेब ब्राउज़र में Gemini खोलें.
- सेटिंग > Gemini Apps का डेवलपर मोड पर क्लिक करें या सीधे gemini.google.com/devmode पर जाएँ.
(ज़रूरी नहीं) दूसरा चरण: कस्टम एमसीपी ऐप्लिकेशन बनाना और उसकी जाँच करना
Gemini Apps के डेवलपर मोड में, अपने एमसीपी सर्वर को कस्टम ऐप्लिकेशन के तौर पर कनेक्ट करने के लिए, यह तरीका अपनाएं:
- कोई ऐप्लिकेशन चुनें डायलॉग बॉक्स में, + नया बनाएं पर क्लिक करें.
- किसी एमसीपी सर्वर से कनेक्ट करें डायलॉग बॉक्स में, एमसीपी सर्वर का यूआरएल में अपने सर्वर का सार्वजनिक एचटीटीपीएस एंडपॉइंट डालें. पक्का करें कि आपका यूआरएल
https://से शुरू हो. उदाहरण के लिए,https://your-app-link.com/mcp. - अगर आपके सर्वर को पहले से रजिस्टर किए गए OAuth क्रेडेंशियल की ज़रूरत है, तो अपना OAuth क्लाइंट आईडी और क्लाइंट सीक्रेट डालने के लिए, अन्य सेटिंग > ज़्यादा दिखाएं पर क्लिक करें. इसके बाद, आगे बढ़ें पर क्लिक करें.
- सुरक्षा और निजता की पुष्टि करने वाले डायलॉग बॉक्स में, यह देखें कि Gemini आपके कस्टम एमसीपी सर्वर के साथ कैसे इंटरैक्ट करता है:
- टूल का इस्तेमाल: Gemini आपके अनुरोधों को पूरा करने के लिए, आपके एमसीपी सर्वर के टूल इस्तेमाल करता है, ताकि उपलब्ध फ़ंक्शन ट्रिगर किए जा सकें और उन्हें चलाया जा सके.
- डेटा वापस लाना और शेयर करना: Gemini, आपके एमसीपी सर्वर के एंडपॉइंट से मिले संसाधनों, स्कीमा, और कॉन्टेक्स्ट को वापस लाता है और उन्हें मैनेज करता है. साथ ही, वह उस जानकारी को शेयर कर सकता है जिसका ऐक्सेस उसके पास है. ऐसा आपके Google खाते की सेटिंग के आधार पर या कनेक्ट किए गए अन्य ऐप्लिकेशन के साथ इंटरैक्ट करते समय किया जा सकता है.
- भरोसा और डिसकनेक्ट करना: आगे बढ़ने से पहले, पक्का करें कि आपको एमसीपी सर्वर पर भरोसा हो और आपने उसकी निजता नीति पढ़ ली हो. 'कनेक्ट किए गए ऐप्लिकेशन' पेज पर जाकर, सर्वर को किसी भी समय डिसकनेक्ट किया जा सकता है. इसके अलावा, अपने Google खाते से कनेक्ट किए गए ऐप्लिकेशन और सेवाओं से इसका लिंक मिटाया जा सकता है.
- मुझे इस कस्टम ऐप्लिकेशन को कनेक्ट करने से होने वाले सुरक्षा और निजता के जोखिमों के बारे में पता है और मुझे ये स्वीकार भी हैं को चुनें. इसके बाद, कनेक्ट करें पर क्लिक करें.
- अपना कस्टम ऐप्लिकेशन सेव करें डायलॉग बॉक्स में, अपने कस्टम ऐप्लिकेशन के लिए डिसप्ले नेम डालें. इसके बाद, पुष्टि करें कि आपके सर्वर के टूल, उपलब्ध कार्रवाइयां सूची में दिख रहे हैं. इसके बाद, कनेक्ट करें पर क्लिक करें.
- Gemini Apps के डेवलपर मोड वाले साइड पैनल में, टूल स्कीमा टैब को चुनें. इससे कनेक्ट किए गए ऐप्लिकेशन में मौजूद हर टूल के बारे में जानकारी देखी जा सकती है. इसमें पैरामीटर की परिभाषाएँ, सुरक्षा बैज (सिर्फ़ पढ़ने के लिए, डेटा मिटाने वाला, पुष्टि करना ज़रूरी है), रॉ स्कीमा, और जवाब का स्ट्रक्चर शामिल है.
- बाईं ओर मौजूद चैट पैनल में, नैचुरल लैंग्वेज या
@mentionप्रॉम्प्ट डालें (उदाहरण के लिए,@MyApp show my profile). इसके बाद, गतिविधियों का ब्यौरा टैब पर नज़र रखें, ताकि यह देखा जा सके कि आपका टूल कैसे काम कर रहा है.
टूल कॉल डीबग करना
जब कोई टूल कॉल फ़ेल हो जाता है या अनचाहे आर्ग्युमेंट जनरेट करता है, तो आपके पास गड़बड़ी की जानकारी देने वाली टेलीमेट्री की जांच करने, अपने बैकएंड एमसीपी सर्वर को अपडेट करने, और स्कीमा को हॉट-रीलोड करने का विकल्प होता है. इसके लिए, आपको बातचीत का इतिहास मिटाने की ज़रूरत नहीं पड़ती.
टूल कॉल के फ़ेल होने की समस्या को डीबग करने के लिए, यह तरीका अपनाएं:
- दाईं ओर मौजूद पैनल में, गतिविधियों का ब्यौरा टैब को चुनें.
- टेलीमेट्री की सूची में, फ़ेल हुए इवेंट पर क्लिक करें. इससे उसकी जानकारी को बड़ा करके देखा जा सकेगा. साथ ही,
Tool callअनुरोध के पेलोड औरTool resultरिस्पॉन्स की जांच की जा सकेगी:- कनेक्शन और नेटवर्क की गड़बड़ी: गड़बड़ी के मैसेज और इंतज़ार का समय देखें, ताकि यह पुष्टि की जा सके कि आपका एंडपॉइंट ऐक्सेस किया जा सकता है.
- पुष्टि करने से जुड़ी गड़बड़ियां: अगर इवेंट
401या403दिखाता है, तो पुष्टि करें टैब में जाकर, अपने OAuth टोकन की स्थिति या क्लाइंट क्रेडेंशियल की पुष्टि करें. - स्कीमा की पुष्टि न होना: अगर सर्वर, एमसीपी के अमान्य पैरामीटर की गड़बड़ी (
-32602) दिखाता है, तोTool callमें मॉडल से जनरेट किए गए JSON आर्ग्युमेंट की तुलना, पैरामीटर टाइप, ज़रूरी प्रॉपर्टी, और टूल स्कीमा टैब में फ़ॉर्मैट के निर्देशों से करें. - सर्वर रनटाइम से जुड़ी गड़बड़ियां: बैकएंड से जुड़ी गड़बड़ियों का पता लगाने के लिए,
Tool resultमें JSON-RPC गड़बड़ी का कोड और मैसेज देखें.
- इस समस्या को हल करने के लिए, एमसीपी सर्वर को लागू करने के तरीके को अपडेट करें या टूल और पैरामीटर के ब्यौरे को बेहतर बनाएं. टूल स्कीमा और गड़बड़ी के जवाबों को साफ़ तौर पर लिखने के बारे में जानने के लिए, एमसीपी से कनेक्ट किए गए ऐप्लिकेशन के इंटिग्रेशन स्टैंडर्ड देखें.
- टूल स्कीमा टैब में, स्कीमा सिंक करें पर क्लिक करें. Gemini, आपके एमसीपी सर्वर से
tools/listको फिर से फ़ेच करता है और मौजूदा चैट थ्रेड को सेव रखते हुए, चालू टूल की परिभाषाओं को अपडेट करता है. - अपनी क्वेरी फिर से करें. गतिविधियों का ब्यौरा टैब में, पुष्टि करें कि फिर से चलाए गए टूल कॉल से
200 OKमिलता है और चैट की झलक में उम्मीद के मुताबिक जवाब दिखता है.
एनवायरमेंट कॉन्टेक्स्ट और पुष्टि करने की प्रोसेस को सिम्युलेट करना
इंस्पेक्टर पैनल में जाकर, यह टेस्ट किया जा सकता है कि आपके एमसीपी टूल, उपयोगकर्ता की अलग-अलग जगहों, टाइम ज़ोन, स्थान-भाषा, और पुष्टि करने के तरीकों के हिसाब से कैसे काम करते हैं.
एनवायरमेंट कॉन्टेक्स्ट को बदलना
तारीख, समय या स्थान-संवेदनशील टूल के लिए उपयोगकर्ता के संदर्भ को सिम्युलेट करने के लिए, यह तरीका अपनाएं:
- दाईं ओर मौजूद पैनल में, एनवायरमेंट टैब चुनें.
- तारीख और समय में जाकर, सिम्युलेट की गई तारीख और सिम्युलेट किया गया समय चुनें. इससे, समय से जुड़े मिलते-जुलते एक्सप्रेशन (जैसे, "कल सुबह" या "इस शनिवार दोपहर") की जांच की जा सकती है.
- प्राथमिकताएं में जाकर, उपयोगकर्ता की स्थानीय भाषा को सिम्युलेट करने के लिए कोई भाषा चुनें (उदाहरण के लिए,
en-US). - सिम्युलेट किए गए कॉन्टेक्स्ट के साथ अपने टूल का आकलन करने के लिए, चैट पैनल में टेस्ट प्रॉम्प्ट चलाएं.
- एनवायरमेंट की डिफ़ॉल्ट सेटिंग वापस लाने के लिए, रीसेट करें पर क्लिक करें.
क्लाइंट की पुष्टि करने की सुविधा को कॉन्फ़िगर करना
Gemini Apps के डेवलपर मोड सेशन के दौरान, पुष्टि करने के लिए इस्तेमाल किए गए तरीके को कॉन्फ़िगर करने या उसे बदलने के लिए, यह तरीका अपनाएं:
- दाईं ओर मौजूद पैनल में, Authentication टैब को चुनें.
- क्लाइंट ऑथेंटिकेशन कॉन्फ़िगरेशन में जाकर, पुष्टि करने के इन मोड में से कोई एक चुनें:
- Dynamic Client Registration: यह अनुमति देने वाले आपके सर्वर के साथ क्रेडेंशियल की अपने-आप पुष्टि करने के लिए, OAuth फ़्लो का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, OAuth 2.1 को लागू करने के बारे में जानकारी देखें. अगर लागू हो, तो कस्टम ऐप्लिकेशन का लिंक जोड़ें में जाकर अपना एंडपॉइंट डालें.
- मैन्युअल क्लाइंट रजिस्ट्रेशन: इससे आपको पहले से रजिस्टर किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट, मैन्युअल तरीके से देने की सुविधा मिलती है. अतिरिक्त फ़्लो ओवरराइड को कॉन्फ़िगर करने के लिए, ऐडवांस सेटिंग को बड़ा करें.
- सेव करें पर क्लिक करें. इसके बाद, सेव किया गया मैसेज दिखने का इंतज़ार करें. इसके बाद, एक टेस्ट प्रॉम्प्ट चलाकर पुष्टि करें कि जिन टूल को अनुमति दी गई है वे सही तरीके से काम कर रहे हैं.