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

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

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

खास जानकारी

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. इस सुविधा के साथ काम करने वाले टूल का इस्तेमाल करना

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

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

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

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

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

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

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

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

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

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

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

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

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

अपने एजेंट को सिस्टम के निर्देश: MerchantIntegrator Agent Protocol और एमसीपी का ऐक्सेस देकर, आपका एजेंट सीधे आपके आईडीई में 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 का कौनसा तरीका इस्तेमाल किया जाता है?"

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

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

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

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

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

एमसीपी सेवा, 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 का इस्तेमाल करने का नया तरीका क्या है?"

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

छठा विकल्प: रिपोर्टिंग क्वेरी का अनुवाद करना

एजेंट से, Content API for Shopping की रिपोर्टिंग क्वेरी को Merchant API में अनुवाद करने के लिए कहा जा सकता है.

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

"इस रिपोर्टिंग क्वेरी को Content API से Merchant API पर माइग्रेट करें: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

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

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

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

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