MCP का इस्तेमाल करके, एपीआई इंटिग्रेशन और कोड असिस्ट टूलकिट

अपनी पसंद के कोडिंग असिस्टेंट से, Merchant API के बारे में कॉन्टेक्स्ट के हिसाब से जानकारी पाएं. अब इंटिग्रेटेड डेवलपमेंट एनवायरमेंट (आईडीई) में, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सेवा का इस्तेमाल करके, डेवलपर दस्तावेज़ के इंटिग्रेशन को ऐक्सेस किया जा सकता है. यह सेवा, इंटिग्रेशन और माइग्रेशन के वर्कफ़्लो को तेज़ी से डेवलप करने में आपकी मदद करती है. इसके लिए, यह सेवा आपके कोडिंग असिस्टेंट को Google के आधिकारिक एपीआई दस्तावेज़ों से भरोसेमंद कॉन्टेक्स्ट उपलब्ध कराती है.

प्रोटोकॉल के बारे में ज़्यादा जानने के लिए, मॉडल कॉन्टेक्स्ट प्रोटोकॉल स्टैंडर्ड देखें.

खास जानकारी

Content API for Shopping से Merchant API पर माइग्रेट करते समय या नया इंटिग्रेशन बनाते समय, आपको नई सेवा के स्ट्रक्चर, संसाधन के नाम, और तरीकों के बारे में जानकारी होनी चाहिए. एमसीपी सेवा, आधिकारिक दस्तावेज़ और कोड के सैंपल उपलब्ध कराकर, इस प्रोसेस को आसान बनाती है.

यह सेवा, खास तौर पर तैयार किए गए Retrieval-Augmented Generation (RAG) बैकएंड का इस्तेमाल करती है. जब एमसीपी की सुविधा वाले आईडीई कोडिंग असिस्टेंट से Merchant API के बारे में कोई सवाल पूछा जाता है, तो यह सेवा Google के आधिकारिक संसाधनों से टेक्स्ट और कोड के सबसे काम के स्निपेट ढूंढती है. इसके बाद, इन्हें कोडिंग असिस्टेंट के संदर्भ के तौर पर दिखाती है. इससे आपकी Assistant, आपको डेवलपमेंट एनवायरमेंट से बाहर निकले बिना ही सटीक और अप-टू-डेट जवाब दे पाती है.

यह कैसे काम करता है

एमसीपी का इस्तेमाल करके डेवलपर दस्तावेज़ इंटिग्रेशन, एआई की मदद से काम करने वाले मॉडर्न डेवलपमेंट वर्कफ़्लो में इंटिग्रेट होता है:

  1. आपने एमसीपी के साथ काम करने वाले कोडिंग असिस्टेंट या एजेंट से कोई सवाल पूछा हो. यह कोई सामान्य भाषा में पूछा गया सवाल, Merchant API के कोड सैंपल का अनुरोध या सीधे तौर पर अपने कोड को Merchant API में अनुवाद करने का अनुरोध भी हो सकता है.
  2. आपका कोडिंग असिस्टेंट, एमसीपी एंडपॉइंट को कॉन्टेक्स्ट के लिए अनुरोध भेजता है.
  3. एमसीपी सेवा, Merchant API के आधिकारिक दस्तावेज़, गाइड, और कोड के सैंपल के इंडेक्स किए गए कलेक्शन में सबसे काम की जानकारी खोजती है.
  4. यह सेवा, कोडिंग में मदद करने वाले आपके टूल को कॉन्टेक्स्ट के तौर पर ये भरोसेमंद स्निपेट दिखाती है.
  5. आपका कोडिंग असिस्टेंट, इस अच्छी क्वालिटी के कॉन्टेक्स्ट का इस्तेमाल करके, आपके मूल सवाल का सटीक और मददगार जवाब जनरेट करता है. इसके अलावा, वह कोड ट्रांसलेट करने का टास्क भी पूरा करता है.

शुरू करना

एमसीपी का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

1. इस सुविधा के साथ काम करने वाले टूल का इस्तेमाल करना

कोई ऐसा IDE या कोडिंग असिस्टेंट खोलें जो स्ट्रीम किए जा सकने वाले एचटीटीपी ट्रांसपोर्ट के साथ, मॉडल कॉन्टेक्स्ट प्रोटोकॉल के साथ काम करता हो.

2. एंडपॉइंट कॉन्फ़िगरेशन

अपने आईडीई या कोडिंग असिस्टेंट को एमसीपी से कनेक्ट करने के लिए, दिए गए रिमोट एंडपॉइंट की जानकारी का इस्तेमाल करें. इसके लिए, आपको सीधे तौर पर सेवा का यूआरएल या एमसीपी की परिभाषा डालनी पड़ सकती है. यह आपके टूल के कॉन्फ़िगरेशन पर निर्भर करता है.

सेवा का यूआरएल यह है:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

3. एजेंट के लिए निर्देश जोड़ना (ज़रूरी नहीं)

अपने एजेंट को एमसीपी का इस्तेमाल करके सीधे कोड का अनुवाद करने की अनुमति देने के लिए, उसे सिस्टम के निर्देश: MerchantIntegrator एजेंट प्रोटोकॉल दें. इन निर्देशों में, एजेंट को कोड ट्रांसलेशन के लिए, एमसीपी का सही तरीके से इस्तेमाल करने का तरीका बताया गया है. अपने टूल के हिसाब से, इन निर्देशों को इनमें से किसी एक तरीके से दिया जा सकता है: सिस्टम के निर्देशों के कॉन्फ़िगरेशन में या एजेंट के लिए अतिरिक्त कॉन्टेक्स्ट फ़ाइल के तौर पर.

इस्तेमाल के उदाहरण

इन सामान्य इस्तेमाल के उदाहरणों में, एमसीपी आपके वर्कफ़्लो को बेहतर बना सकता है.

पहली स्थिति: products.insert कोड माइग्रेट करना

एजेंट से, Content API for Shopping products.insert इंटिग्रेशन कोड को सीधे Merchant API पर माइग्रेट करने के लिए कहा जा सकता है.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API पर products.insert कोड माइग्रेट करें"

अपने एजेंट को सिस्टम के निर्देश: MerchantIntegrator Agent Protocol और MCP का ऐक्सेस देकर, आपका एजेंट Content API for Shopping कोड को सीधे आपके आईडीई में Merchant API कोड में बदल सकता है. इस मामले में, यह productInputs.insert को मिलते-जुलते कॉल के तौर पर पहचान करेगा. साथ ही, प्रॉडक्ट एट्रिब्यूट को पुराने फ़ॉर्मैट से Merchant API के लिए ज़रूरी नए फ़ॉर्मैट में मैप करेगा. यह ज़रूरी इंपोर्ट और डिपेंडेंसी मैनेजमेंट फ़ाइल को भी अपडेट कर सकता है. उदाहरण के लिए, requirements.txt, pom.xml या package.json. एजेंट को बदलाव करने या नया फ़ोल्डर बनाने के लिए निर्देश दिए जा सकते हैं.

दूसरी स्थिति: मिलती-जुलती सुविधा ढूंढना

आपके पास Content API for Shopping का इस्तेमाल करने वाला कोई मौजूदा ऐप्लिकेशन है और आपको उसे अपडेट करना है. किसी लेगसी तरीके के बारे में पूछकर, लागू करने के नए तरीके और उससे जुड़े कोड के सैंपल के बारे में जानकारी पाई जा सकती है.

उपयोगकर्ता का प्रॉम्प्ट:

"Content API for Shopping में accountstatuses.get तरीके के लिए, Merchant API का कौनसा तरीका इस्तेमाल किया जाता है?"

एमसीपी सेवा, माइग्रेशन से जुड़ी आधिकारिक गाइड और रेफ़रंस दस्तावेज़ों से कॉन्टेक्स्ट उपलब्ध कराती है. इससे आपका असिस्टेंट, नए एपीआई के नाम accounts.issues के साथ-साथ अन्य जानकारी भी दे पाता है.

तीसरा विकल्प: कोड का सैंपल ढूंढना

आपको कोई नई सुविधा लागू करनी है और इसके लिए, आपको कोई व्यावहारिक उदाहरण चाहिए.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API का इस्तेमाल करके, शिपिंग की नई सेवा जोड़ने के लिए Python कोड का सैंपल दिखाओ."

MCP सेवा, Google के आधिकारिक GitHub डेटा स्टोर और डेवलपर गाइड से काम के कोड सैंपल ढूंढती है. इसके बाद, Assistant आपको कोड ब्लॉक का पूरा और इस्तेमाल के लिए तैयार वर्शन दिखा सकती है.

चौथा विकल्प: एपीआई के कॉन्सेप्ट समझना

आपको कोई नई अवधारणा समझनी है या किसी संसाधन के स्ट्रक्चर या Merchant API के पूरे पैटर्न को समझना है.

उपयोगकर्ता का प्रॉम्प्ट:

"मैं Merchant API का इस्तेमाल करके, किसी प्रॉडक्ट की इन्वेंट्री को कैसे अपडेट करूं?"

एमसीपी सेवा, प्रॉडक्ट रिसॉर्स के दस्तावेज़ और काम की गाइड से कॉन्टेक्स्ट दिखाती है. इसके बाद, आपका असिस्टेंट आपको accounts.productInputs.insert तरीके का इस्तेमाल करने का तरीका बता सकता है. साथ ही, प्रॉडक्ट के संसाधन का वह हिस्सा दे सकता है जिसमें सिर्फ़ productId और इन्वेंट्री से जुड़े वे फ़ील्ड शामिल हों जिन्हें आपको अपडेट करना है.

"मैं Merchant Center API के ज़रिए किए गए ऐप्लिकेशन कॉल को कैसे अनुमति दूँ?"

एमसीपी सेवा, पुष्टि करने से जुड़ी आधिकारिक गाइड से कॉन्टेक्स्ट वापस लाती है. इनमें अनुमति देने के अलग-अलग तरीके शामिल होते हैं. इसके बाद, आपकी Assistant उपलब्ध मुख्य विकल्पों के बारे में बता सकती है. जैसे, सर्वर-टू-सर्वर इंटरैक्शन के लिए सेवा खाते का इस्तेमाल करना या किसी उपयोगकर्ता की ओर से कार्रवाई करते समय OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करना.

पांचवां विकल्प: एपीआई में हुए बदलावों के मुताबिक खुद को ढालना

Merchant API में नए पैटर्न पेश किए गए हैं. जैसे, बैचिंग के अनुरोध. ये पैटर्न, Content API for Shopping से अलग हैं. Content API for Shopping में कुछ खास custombatch तरीकों का इस्तेमाल किया जाता है. वहीं, Merchant API में एचटीटीपी के लिए, एक से ज़्यादा अनुरोध एक साथ भेजने की सुविधा पहले से मौजूद होती है.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API में products.custombatch का इस्तेमाल करने का नया तरीका क्या है?"

MCP सेवा, एक साथ कई अनुरोधों के लिए कोड को फिर से फ़ैक्टर करें से कॉन्टेक्स्ट को वापस लाती है. इसमें बताया गया है कि Merchant API में, custombatch के लिए खास तरीके मौजूद नहीं हैं. इसके बजाय, यह multipart के Content-Type के साथ एचटीटीपी बैचिंग का इस्तेमाल करने के बारे में दस्तावेज़ उपलब्ध कराता है. इसके बाद, आपका असिस्टेंट यह बता सकता है कि https://merchantapi.googleapis.com/batch/{sub-api}/v1 एंडपॉइंट को भेजे गए, कई एपीआई कॉल वाले एक एचटीटीपी अनुरोध को कैसे बनाया जाए. साथ ही, कई हिस्सों वाले अनुरोध को स्ट्रक्चर करने का उदाहरण भी दे सकता है. इससे माइग्रेशन के मुश्किल टास्क को आसान बनाया जा सकता है.

नॉलेज बेस के सोर्स

एमसीपी सेवा, अपने नॉलेज बेस को सिर्फ़ सार्वजनिक और आधिकारिक स्रोतों से बनाती है, ताकि यह पक्का किया जा सके कि वह जो कॉन्टेक्स्ट उपलब्ध करा रही है वह सटीक और भरोसेमंद है. यह सेवा, डेवलपर की आधिकारिक साइट और कोड सैंपल रिपॉज़िटरी के पूरे कॉन्टेंट को इंडेक्स करती है. इसमें ये चीज़ें शामिल हैं:

पीछे जाएं
Client libraries
आगे बढ़ें
Overview