MCP ব্যবহার করে API ইন্টিগ্রেশন এবং কোড অ্যাসিস্ট টুলকিট

আপনার পছন্দের কোডিং অ্যাসিস্ট্যান্ট থেকে মার্চেন্ট এপিআই (Merchant API) সম্পর্কে প্রাসঙ্গিক তথ্য জানুন। আপনার ইন্টিগ্রেটেড ডেভেলপমেন্ট এনভায়রনমেন্ট (IDE)-এর মধ্যে, আপনি এখন মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভিস ব্যবহার করে ডেভেলপার ডকুমেন্টেশন ইন্টিগ্রেশন অ্যাক্সেস করতে পারবেন। এই সার্ভিসটি আপনার কোডিং অ্যাসিস্ট্যান্টকে অফিসিয়াল গুগল এপিআই ডকুমেন্টেশন থেকে নির্ভরযোগ্য তথ্য সরবরাহ করে ইন্টিগ্রেশন এবং মাইগ্রেশন ওয়ার্কফ্লোর জন্য আপনার ডেভেলপমেন্টকে ত্বরান্বিত করে।

প্রোটোকলটি সম্পর্কে আরও তথ্যের জন্য, মডেল কনটেক্সট প্রোটোকল স্ট্যান্ডার্ডটি দেখুন।

সংক্ষিপ্ত বিবরণ

Content API for Shopping থেকে Merchant API-তে স্থানান্তরিত হওয়ার সময় বা একটি নতুন ইন্টিগ্রেশন তৈরি করার সময়, আপনাকে নতুন সার্ভিস স্ট্রাকচার, রিসোর্স নেম এবং মেথডগুলো বুঝতে হবে। MCP সার্ভিসটি আপনার কোডিং সহকারীকে অফিশিয়াল ডকুমেন্টেশন এবং কোড স্যাম্পল সরবরাহ করে এই প্রক্রিয়াটিকে সহজ করে তোলে।

এই পরিষেবাটি একটি অত্যন্ত বিশেষায়িত রিট্রিভাল-অগমেন্টেড জেনারেশন (RAG) ব্যাকএন্ড ব্যবহার করে। যখন আপনি আপনার MCP-সক্ষম IDE কোডিং অ্যাসিস্ট্যান্টকে মার্চেন্ট এপিআই (Merchant API) সম্পর্কে কোনো প্রশ্ন করেন, তখন পরিষেবাটি গুগলের অফিসিয়াল রিসোর্স থেকে সবচেয়ে প্রাসঙ্গিক টেক্সট এবং কোডের অংশগুলো সংগ্রহ করে এবং সেগুলোকে আপনার কোডিং অ্যাসিস্ট্যান্টের কাছে কনটেক্সট হিসেবে ফেরত পাঠায়। এর ফলে, আপনাকে আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট থেকে বের না হয়েই আপনার অ্যাসিস্ট্যান্ট সঠিক ও হালনাগাদ উত্তর প্রদান করতে পারে।

এটি কীভাবে কাজ করে

MCP ব্যবহার করে ডেভেলপার ডকুমেন্টেশন ইন্টিগ্রেশন একটি আধুনিক, এআই-সহায়তাযুক্ত ডেভেলপমেন্ট ওয়ার্কফ্লোর সাথে একীভূত হয়:

1. আপনি আপনার MCP-উপযোগী কোডিং অ্যাসিস্ট্যান্ট বা এজেন্টে একটি প্রশ্ন জিজ্ঞাসা করেন। এটি একটি স্বাভাবিক ভাষার প্রশ্ন, মার্চেন্ট এপিআই কোড স্যাম্পলের জন্য অনুরোধ, অথবা এমনকি আপনার কোডকে সরাসরি মার্চেন্ট এপিআই-তে অনুবাদ করার অনুরোধও হতে পারে।
2. আপনার কোডিং অ্যাসিস্ট্যান্ট MCP এন্ডপয়েন্টে প্রাসঙ্গিক তথ্যের জন্য একটি অনুরোধ পাঠায়।
3. MCP পরিষেবাটি সবচেয়ে প্রাসঙ্গিক তথ্য খুঁজে বের করার জন্য তার সূচীবদ্ধ অফিসিয়াল মার্চেন্ট এপিআই ডকুমেন্টেশন, গাইড এবং কোড স্যাম্পলের সংগ্রহে অনুসন্ধান করে।
4. পরিষেবাটি আপনার কোডিং সহকারীকে প্রাসঙ্গিক তথ্য হিসেবে এই প্রামাণিক কোড অংশগুলো ফেরত দেয়।
5. আপনার কোডিং অ্যাসিস্ট্যান্ট এই উচ্চ-মানের প্রেক্ষাপট ব্যবহার করে আপনার মূল প্রশ্নের একটি নির্ভুল ও সহায়ক উত্তর তৈরি করে অথবা কোড অনুবাদের কাজ সম্পাদন করে।

শুরু করা হচ্ছে

এমসিপি ব্যবহার করতে, এই ধাপগুলো অনুসরণ করুন:

১. একটি উপযুক্ত সরঞ্জাম ব্যবহার করুন

এমন একটি IDE বা কোডিং অ্যাসিস্ট্যান্ট খুলুন যা স্ট্রিমেবল HTTP ট্রান্সপোর্ট সহ মডেল কনটেক্সট প্রোটোকল সমর্থন করে।

২. এন্ডপয়েন্ট কনফিগারেশন

আপনার IDE বা কোডিং অ্যাসিস্ট্যান্টকে MCP-এর সাথে সংযুক্ত করতে, প্রদত্ত রিমোট এন্ডপয়েন্টের বিবরণ ব্যবহার করুন, যার জন্য আপনাকে সরাসরি সার্ভিস URL অথবা MCP ডেফিনিশন (আপনার টুলের কনফিগারেশনের উপর নির্ভর করে) ইনপুট করতে হতে পারে।

পরিষেবা URL হল:

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

কনফিগারেশন সেটআপ:

{
    "mcpServers": {
        "mapi-devdocs": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://merchantapi.googleapis.com/devdocs/mcp"
            ]
        }
    }
}

{
    "servers": {
        "mapi-devdocs": {
            "type": "http",
            "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
        }
    }
}

৩. এজেন্ট নির্দেশাবলী যোগ করুন (ঐচ্ছিক)

আপনার এজেন্টকে MCP ব্যবহার করে সরাসরি কোড অনুবাদ করতে সক্ষম করার জন্য, এটিকে ‘ সিস্টেম নির্দেশাবলী: মার্চেন্টইন্টিগ্রেটর এজেন্ট প্রোটোকল’ প্রদান করুন। এই নির্দেশাবলী এজেন্টকে কোড অনুবাদের জন্য MCP সঠিকভাবে ব্যবহার করার বিষয়ে পথ দেখায়। আপনার টুলের উপর নির্ভর করে, আপনি এই নির্দেশাবলী সিস্টেম নির্দেশাবলী কনফিগারেশনে অথবা এজেন্টের জন্য একটি অতিরিক্ত কনটেক্সট ফাইল হিসাবে প্রদান করতে পারেন।

ব্যবহারের উদাহরণ পরিস্থিতি

এই সাধারণ ব্যবহারের ক্ষেত্রগুলিতে MCP আপনার কর্মপ্রবাহকে ত্বরান্বিত করতে পারে।

দৃশ্যকল্প ১: products.insert স্থানান্তর করুন। কোড সন্নিবেশ করুন

আপনি এজেন্টকে শপিং products.insert জন্য কন্টেন্ট এপিআই সরাসরি মার্চেন্ট এপিআই-তে মাইগ্রেট করতে বলতে পারেন এবং ইন্টিগ্রেশন কোডটি সেখানে যুক্ত করতে পারেন।

ব্যবহারকারীর জন্য নির্দেশিকা:

" products.insert কোডটি মার্চেন্ট এপিআই-তে স্থানান্তর করুন"

আপনার এজেন্টকে সিস্টেম নির্দেশাবলী: মার্চেন্টইন্টিগ্রেটর এজেন্ট প্রোটোকল (System Instructions: MerchantIntegrator Agent Protocol) এবং এমসিপি (MCP)-তে অ্যাক্সেস প্রদান করার মাধ্যমে, আপনার এজেন্ট সরাসরি আপনার আইডিই (IDE)-তে শপিং-এর জন্য কন্টেন্ট এপিআই (Content API for Shopping) কোডকে মার্চেন্ট এপিআই (Merchant API) কোডে অনুবাদ করতে পারে। এক্ষেত্রে, এটি productInputs.insert সমতুল্য কল হিসেবে শনাক্ত করবে এবং পণ্যের অ্যাট্রিবিউটগুলোকে পুরোনো ফরম্যাট থেকে মার্চেন্ট এপিআই-এর জন্য প্রয়োজনীয় নতুন ফরম্যাটে ম্যাপ করবে। এটি প্রয়োজনীয় ইম্পোর্ট এবং ডিপেন্ডেন্সি ম্যানেজমেন্ট ফাইলও (যেমন requirements.txt , pom.xml বা package.json ) আপডেট করতে পারে। আপনি এজেন্টকে পরিবর্তনগুলো যথাস্থানে করতে অথবা একটি নতুন ফোল্ডার তৈরি করতে নির্দেশ দিতে পারেন।

দৃশ্যকল্প ২: সমতুল্য কার্যকারিতা খুঁজুন

আপনার একটি বিদ্যমান অ্যাপ্লিকেশন আছে যা কেনাকাটার জন্য কন্টেন্ট এপিআই ব্যবহার করে এবং আপনাকে এটি আপডেট করতে হবে। নতুন ইমপ্লিমেন্টেশন এবং একটি প্রাসঙ্গিক কোড স্যাম্পলের বিশদ বিবরণ পেতে আপনি একটি নির্দিষ্ট লিগ্যাসি মেথড সম্পর্কে জিজ্ঞাসা করতে পারেন।

ব্যবহারকারীর জন্য নির্দেশিকা:

শপিং-এর কন্টেন্ট এপিআই-তে থাকা accountstatuses.get মেথডটির মার্চেন্ট এপিআই সমতুল্য কী?

MCP পরিষেবাটি অফিসিয়াল মাইগ্রেশন গাইড এবং রেফারেন্স ডকুমেন্টেশন থেকে প্রাসঙ্গিক তথ্য প্রদান করে, যার ফলে আপনার অ্যাসিস্ট্যান্ট নতুন API নাম, accounts.issues সহ একটি বিস্তারিত উত্তর দিতে পারে।

দৃশ্যকল্প ৩: একটি কোড নমুনা খোঁজা

আপনি একটি নতুন ফিচার চালু করছেন এবং অনুসরণ করার জন্য একটি বাস্তব উদাহরণ প্রয়োজন।

ব্যবহারকারীর জন্য নির্দেশিকা:

মার্চেন্ট এপিআই ব্যবহার করে একটি নতুন শিপিং পরিষেবা যোগ করার জন্য আমাকে একটি পাইথন কোড নমুনা দেখান।

এমসিপি পরিষেবাটি গুগলের অফিসিয়াল গিটহাব রিপোজিটরি এবং ডেভেলপার গাইড থেকে প্রাসঙ্গিক কোড স্যাম্পল সংগ্রহ করে। এরপর আপনার অ্যাসিস্ট্যান্ট একটি সম্পূর্ণ, অভিযোজনের জন্য প্রস্তুত কোড ব্লক উপস্থাপন করতে পারে।

দৃশ্যকল্প ৪: এপিআই ধারণা বোঝা

আপনি কোনো নতুন ধারণার সম্মুখীন হন অথবা কোনো রিসোর্সের গঠন বা সামগ্রিক মার্চেন্ট এপিআই প্যাটার্ন বুঝতে চান।

ব্যবহারকারীর জন্য নির্দেশিকা:

মার্চেন্ট এপিআই ব্যবহার করে একটি পণ্যের ইনভেন্টরি কীভাবে আপডেট করব?

এমসিপি সার্ভিসটি প্রোডাক্ট রিসোর্স ডকুমেন্টেশন এবং প্রাসঙ্গিক গাইড থেকে কনটেক্সট ফেরত দেয়। এরপর আপনার অ্যাসিস্ট্যান্ট আপনাকে accounts.productInputs.insert মেথডটি কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করতে পারবেন এবং শুধুমাত্র productId ও আপনার আপডেট করার জন্য প্রয়োজনীয় ইনভেন্টরি-সম্পর্কিত ফিল্ডগুলো সম্বলিত আংশিক প্রোডাক্ট রিসোর্সটি সরবরাহ করতে পারবেন।

মার্চেন্ট এপিআই ব্যবহার করে আমি কীভাবে আমার অ্যাপ্লিকেশন কলগুলোকে অনুমোদন করব?

এমসিপি পরিষেবাটি অফিসিয়াল প্রমাণীকরণ নির্দেশিকা থেকে প্রাসঙ্গিক তথ্য সংগ্রহ করে, যেখানে বিভিন্ন অনুমোদন পদ্ধতি সম্পর্কে আলোচনা করা হয়েছে। এরপর আপনার সহকারী উপলব্ধ প্রধান বিকল্পগুলো ব্যাখ্যা করতে পারে, যেমন সার্ভার-টু-সার্ভার যোগাযোগের জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করা অথবা কোনো ব্যবহারকারীর পক্ষ থেকে কাজ করার সময় একটি OAuth 2.0 ক্লায়েন্ট আইডি ব্যবহার করা।

দৃশ্যকল্প ৫: এপিআই পরিবর্তনের সাথে খাপ খাইয়ে নেওয়া

মার্চেন্ট এপিআই নতুন কিছু প্যাটার্ন—যেমন রিকোয়েস্ট ব্যাচিং—প্রবর্তন করে, যা শপিং-এর জন্য কন্টেন্ট এপিআই থেকে ভিন্ন। শপিং-এর জন্য কন্টেন্ট এপিআই নির্দিষ্ট custombatch মেথড ব্যবহার করে, অন্যদিকে মার্চেন্ট এপিআই একটি বিল্ট-ইন, জেনেরিক এইচটিটিপি ব্যাচিং ফিচার ব্যবহার করে।

ব্যবহারকারীর জন্য নির্দেশিকা:

মার্চেন্ট এপিআই-তে products.custombatch করার নতুন উপায় কী?

MCP সার্ভিসটি কনকারেন্ট রিকোয়েস্টের জন্য রিফ্যাক্টর কোড থেকে কনটেক্সট সংগ্রহ করে এবং ব্যাখ্যা করে যে মার্চেন্ট এপিআই-তে কোনো ডেডিকেটেড custombatch মেথড নেই। এর পরিবর্তে, এটি multipart Content-Type সহ HTTP ব্যাচিং ব্যবহারের উপর ডকুমেন্টেশন প্রদান করে। এরপর আপনার অ্যাসিস্ট্যান্ট ব্যাখ্যা করতে পারে কীভাবে https://merchantapi.googleapis.com/batch/{sub-api}/v1 এন্ডপয়েন্টে একাধিক এপিআই কল সম্বলিত একটি একক HTTP রিকোয়েস্ট তৈরি করতে হয় এবং মাল্টিপার্ট রিকোয়েস্টটি কীভাবে গঠন করতে হয় তার একটি উদাহরণও দিতে পারে। এটি একটি সম্ভাব্য বিভ্রান্তিকর মাইগ্রেশন টাস্ককে একটি নির্দেশিত প্রক্রিয়ায় পরিণত করে।

দৃশ্যকল্প ৬: একটি রিপোর্টিং কোয়েরি অনুবাদ করুন

আপনি এজেন্টকে শপিং-এর জন্য কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআই-তে একটি রিপোর্টিং কোয়েরি অনুবাদ করতে বলতে পারেন।

ব্যবহারকারীর জন্য নির্দেশিকা:

এই রিপোর্টিং কোয়েরিটি কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআই-তে স্থানান্তর করুন: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'

এমসিপি সার্ভিসটি সর্বশেষ রিপোর্টিং রেফারেন্স ডকুমেন্টেশন, ডেভেলপার গাইড এবং মাইগ্রেশন গাইড সংগ্রহ করে। এই তথ্যের উপর ভিত্তি করে, এটি কোয়েরিটিকে নতুন কাঠামোতে রূপান্তরিত করে এবং ফিল্ডগুলোকে তাদের নতুন নাম ও মান দিয়ে আপডেট করে।

জ্ঞানভান্ডারের উৎস

এমসিপি পরিষেবাটি তার প্রদত্ত তথ্যের নির্ভুলতা ও নির্ভরযোগ্যতা নিশ্চিত করার জন্য শুধুমাত্র সর্বজনীন এবং প্রাতিষ্ঠানিক উৎস থেকে তার জ্ঞানভান্ডার তৈরি করে। এই পরিষেবাটি প্রাতিষ্ঠানিক ডেভেলপার সাইট এবং কোড স্যাম্পল রিপোজিটরির সম্পূর্ণ বিষয়বস্তু সূচীবদ্ধ করে, যার মধ্যে অন্তর্ভুক্ত রয়েছে:

• মার্চেন্ট এপিআই ডেভেলপার সাইট : সকল নির্দেশিকা, তথ্যসূত্র এবং ডকুমেন্টেশন।
• মার্চেন্ট এপিআই অ্যাপস স্ক্রিপ্ট পরিষেবা : অ্যাপস স্ক্রিপ্ট থেকে মার্চেন্ট এপিআই ব্যবহারের উদাহরণ।
• অফিসিয়াল কোড স্যাম্পল : গিটহাব রিপোজিটরি থেকে মার্চেন্ট এপিআই-এর জন্য গুগল-প্রদত্ত সকল অফিসিয়াল কোড স্যাম্পল।
• ক্লায়েন্ট লাইব্রেরি : মার্চেন্ট দ্বারা সমর্থিত সকল অফিসিয়াল ক্লায়েন্ট লাইব্রেরি