Google Connected Console-এ আপনার কানেক্ট করা অ্যাপ পর্যালোচনার জন্য জমা দেওয়ার আগে, ইন্টার্যাক্টিভভাবে আপনার মডেল কন্টেক্সট প্রোটোকল (MCP) সার্ভার পরীক্ষা করতে, স্কিমা বা রানটাইম সমস্যা ডায়াগনসিস করতে এবং টুল কোয়ালিটি বেঞ্চমার্ক করতে Gemini অ্যাপ ডেভেলপার মোড ব্যবহার করুন।
এই নির্দেশিকায় নিম্নলিখিত টাস্কগুলি কভার করা হয়েছে:
- Gemini-তে Gemini অ্যাপ ডেভেলপার মোড চালু করুন, একটি কাস্টম MCP অ্যাপ তৈরি করুন এবং প্রাথমিক টুল ডিসকভারি যাচাই করুন।
- ব্যর্থ টুল কল ডিবাগ করুন, আপডেট করা স্কিমা সিঙ্ক করুন এবং যাচাইকরণ পরীক্ষা করুন।
- ব্যবহারকারীর পরিবেশের প্রসঙ্গ সিমুলেট ও ক্লায়েন্ট যাচাইকরণ কনফিগার করুন।
Workspace লেআউট ও ইন্সপেক্টর ট্যাব সম্পর্কে জানতে, Gemini অ্যাপ ডেভেলপার মোড ওভারভিউ দেখুন।
Gemini অ্যাপ ডেভেলপার মোড চালু করুন
আপনি Google Connected Console-এ আপনার MCP সার্ভার অনবোর্ড করলে, Gemini অ্যাপ ডেভেলপার মোড চালু করার সময় আপনার রেজিস্টার করা অ্যাপ আগে থেকেই উপলভ্য থাকে এবং আপনি ২ নম্বর ধাপ এড়িয়ে যেতে পারেন। আপনি যদি কনসোলে রেজিস্টার করার আগে সরাসরি Gemini-তে ডিপ্লয় করা HTTPS MCP সার্ভার এন্ডপয়েন্ট পরীক্ষা করতে চান, তাহলে Gemini অ্যাপ ডেভেলপার মোড চালু করতে এবং আপনার সার্ভারকে কাস্টম MCP অ্যাপ হিসেবে কানেক্ট করতে দুটি ধাপই অনুসরণ করুন।
ধাপ ১: Gemini অ্যাপ ডেভেলপার মোড চালু করা
- আপনার ওয়েব ব্রাউজারে Gemini খুলুন।
- সেটিংস > Gemini অ্যাপ ডেভেলপার মোড বিকল্পে ক্লিক করুন (অথবা সরাসরি gemini.google.com/devmode লিঙ্কে যান)।
(ঐচ্ছিক) ধাপ ২: কাস্টম MCP অ্যাপ তৈরি ও পরীক্ষা করা
Gemini অ্যাপ ডেভেলপার মোডে কাস্টম অ্যাপ হিসেবে আপনার MCP সার্ভার কানেক্ট করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- অ্যাপ বেছে নিন ডায়ালগে, + নতুন তৈরি করুন বিকল্পে ক্লিক করুন।
- MCP সার্ভারের সাথে কানেক্ট করুন ডায়ালগে, MCP সার্ভার URL-এ আপনার সার্ভারের পাবলিক HTTPS
এন্ডপয়েন্ট লিখুন (আপনার URL যেন
https://দিয়ে শুরু হয়, যেমন,https://your-app-link.com/mcp)। - আপনার সার্ভারে আগে থেকে রেজিস্টার করা OAuth ক্রেডেনশিয়াল প্রয়োজন হলে, অতিরিক্ত সেটিংস > আরও দেখুন বিকল্পে ক্লিক করে আপনার OAuth ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট লিখুন, তারপর পরবর্তী বিকল্পে ক্লিক করুন।
- সুরক্ষা ও গোপনীয়তা কনফার্মেশন ডায়ালগে, আপনার কাস্টম MCP সার্ভারের সাথে Gemini কীভাবে ইন্টার্যাক্ট করে তা পর্যালোচনা করুন:
- টুল এক্সিকিউশন: আপনার অনুরোধ ম্যানেজ করার জন্য উপলভ্য ফাংশন ট্রিগার ও রান করতে, Gemini আপনার MCP সার্ভারের টুল এক্সিকিউট করে।
- ডেটা ফিরিয়ে আনা ও শেয়ার করা: Gemini আপনার MCP সার্ভারের এন্ডপয়েন্ট দ্বারা প্রকাশ করা রিসোর্স, স্কিমা ও কন্টেক্সট ফিরিয়ে আনে ও ম্যানেজ করে এবং আপনার Google অ্যাকাউন্ট সেটিংসের ভিত্তিতে অথবা কানেক্ট করা অন্যান্য অ্যাপের সাথে ইন্টার্যাক্ট করার সময়, এটি অ্যাক্সেস করতে পারে এমন তথ্য শেয়ার করতে পারে।
- বিশ্বাস ও ডিসকানেক্ট করা: আপনি MCP সার্ভারকে বিশ্বাস করেন কিনা তা নিশ্চিত করুন এবং এগিয়ে যাওয়ার আগে এর গোপনীয়তা নীতি পর্যালোচনা করুন। আপনি যেকোনও সময় কানেক্ট করা অ্যাপের পৃষ্ঠা থেকে সার্ভার ডিসকানেক্ট করতে পারবেন অথবা আপনার Google অ্যাকাউন্ট কানেকশন থেকে এর লিঙ্ক মুছে দিতে পারবেন।
- আমি এই কাস্টম অ্যাপ কানেক্ট করার সুরক্ষা ও গোপনীয়তা সংক্রান্ত ঝুঁকি বুঝেছি এবং তাতে সম্মতি জানাচ্ছি বিকল্প বেছে নিন। তারপর, কানেক্ট করুন বিকল্পে ক্লিক করুন।
- আপনার কাস্টম অ্যাপ সেভ করুন ডায়ালগে, আপনার কাস্টম অ্যাপের জন্য একটি ডিসপ্লে নাম লিখুন, আপনার সার্ভারের টুল উপলভ্য অ্যাকশন তালিকায় দেখা যাচ্ছে কিনা তা যাচাই করুন এবং কানেক্ট করুন বিকল্পে ক্লিক করুন।
- Gemini অ্যাপ ডেভেলপার মোড সাইড প্যানেলে, আপনার কানেক্ট করা অ্যাপের প্রতিটি টুল সম্পর্কে তথ্য পর্যালোচনা করতে টুল স্কিমা ট্যাব বেছে নিন, যার মধ্যে প্যারামিটার সংজ্ঞা, নিরাপত্তা ব্যাজ (শুধুমাত্র-পড়ার-জন্য, ধ্বংসাত্মক, প্রমাণীকরণ-প্রয়োজন), র স্কিমা এবং উত্তরের স্ট্রাকচার অন্তর্ভুক্ত।
- বাঁদিকের চ্যাট প্যানে, ন্যাচারাল ল্যাঙ্গুয়েজ বা
@mentionপ্রম্পট (যেমন,@MyApp show my profile) লিখুন এবং আপনার টুল কীভাবে কাজ করছে তা দেখতে ইভেন্ট লগ ট্যাব মনিটর করুন।
ডিবাগ টুল কল
কোনও টুল কল ব্যর্থ হলে বা অপ্রত্যাশিত আর্গুমেন্ট তৈরি করলে, আপনি ডায়াগনস্টিক টেলিমেট্রি পরীক্ষা করতে, আপনার ব্যাকএন্ড MCP সার্ভার আপডেট করতে এবং আপনার কথোপকথনের ইতিহাস মুছে না ফেলে স্কিমা হট-রিলোড করতে পারেন।
ব্যর্থ টুল কল ডিবাগ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- ডানদিকের প্যানে, ইভেন্ট লগ ট্যাব বেছে নিন।
- টেলিমেট্রি তালিকায় ব্যর্থ ইভেন্টে ক্লিক করে তার বিবরণ বড় করে দেখুন এবং
Tool callঅনুরোধের পেলোড ওTool resultউত্তর দেখুন:- কানেকশন ও নেটওয়ার্ক সংক্রান্ত সমস্যা: আপনার এন্ডপয়েন্ট অ্যাক্সেস করা যাচ্ছে কিনা তা যাচাই করতে ত্রুটি মেসেজ ও লেটেন্সি চেক করুন।
- যাচাইকরণ সংক্রান্ত সমস্যা: ইভেন্ট
401বা403রিটার্ন করলে, যাচাইকরণ ট্যাবে আপনার OAuth টোকেন স্ট্যাটাস বা ক্লায়েন্ট ক্রেডেনশিয়াল যাচাই করুন। - স্কিমা যাচাইকরণ সংক্রান্ত অমিল: সার্ভার যদি MCP ভুল প্যারামিটার সংক্রান্ত সমস্যা (
-32602) দেখায়, তাহলেTool call-এ মডেল-জেনারেটেড JSON আর্গুমেন্ট, প্যারামিটার টাইপ, প্রয়োজনীয় প্রপার্টি এবং টুল স্কিমা ট্যাবে ফর্ম্যাট সংক্রান্ত নির্দেশাবলীর সাথে তুলনা করুন। - সার্ভার রানটাইম এক্সেপশন: ব্যাকএন্ড এক্সেপশন ডায়াগনসিস করতে JSON-RPC ত্রুটি কোড এবং
Tool result-এ মেসেজ দেখুন।
- সমস্যাটির সমাধান করতে, আপনার MCP সার্ভার প্রয়োগ করা সমাধান আপডেট করুন অথবা আপনার টুল এবং প্যারামিটারের বিবরণ রিফাইন করুন। স্পষ্ট টুল স্কিমা এবং সমস্যার উত্তর লেখার বিষয়ে নির্দেশিকার জন্য, MCP কানেক্ট করা অ্যাপ ইন্টিগ্রেশন স্ট্যান্ডার্ড দেখুন।
- টুল স্কিমা ট্যাবে, স্কিমা সিঙ্ক করুন বিকল্পে ক্লিক করুন। Gemini আপনার MCP সার্ভার থেকে
tools/listআবার ফেচ করে এবং বর্তমান চ্যাট থ্রেড বজায় রেখে অ্যাক্টিভ টুল ডেফিনেশন আপডেট করে। - আপনার কোয়েরি আবার চেষ্টা করুন। ইভেন্ট লগ ট্যাবে, রিপ্লে করা টুল কল
200 OKরিটার্ন করে এবং চ্যাট প্রিভিউতে প্রত্যাশিত উত্তর রেন্ডার করে কিনা তা কনফার্ম করুন।
এনভায়রনমেন্টের প্রসঙ্গ ও যাচাইকরণ সিমুলেট করুন
আপনার MCP টুলগুলি বিভিন্ন ব্যবহারকারীর লোকেশন, টাইম জোন, লোকেল এবং যাচাইকরণ পদ্ধতিতে কীভাবে প্রতিক্রিয়া জানায় তা আপনি সরাসরি ইন্সপেক্টর প্যানে পরীক্ষা করতে পারেন।
এনভায়রনমেন্ট কন্টেক্সট ওভাররাইড করুন
তারিখ-, সময়- বা লোকাল-সংবেদনশীল টুলের জন্য ব্যবহারকারীর প্রসঙ্গ সিমুলেট করতে, নিম্নলিখিত কাজগুলি করুন:
- ডানদিকের প্যানে, এনভায়রনমেন্ট ট্যাব বেছে নিন।
- তারিখ ও সময় বিকল্পের মধ্যে, সিমুলেট করা তারিখ ও সিমুলেট করা সময় বেছে নিন যাতে সময় সম্পর্কিত এক্সপ্রেশন (যেমন, "আগামীকাল সকাল" বা "এই শনিবার বিকেল") পরীক্ষা করা যায়।
- পছন্দ বিকল্পের অধীনে, ব্যবহারকারীর লোকেল সিমুলেট করতে একটি ভাষা বেছে নিন
(যেমন,
en-US)। - সিমুলেটেড কনটেক্সটের সাথে আপনার টুল মূল্যায়ন করতে চ্যাট প্যানে একটি টেস্ট প্রম্পট চালান।
- ডিফল্ট এনভায়রনমেন্ট সেটিংস ফিরিয়ে আনতে, রিসেট করুন বিকল্পে ক্লিক করুন।
ক্লায়েন্ট যাচাইকরণ কনফিগার করুন
আপনার Gemini অ্যাপ ডেভেলপার মোড সেশন চলাকালীন ব্যবহৃত যাচাইকরণ পদ্ধতি কনফিগার বা পরিবর্তন করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- ডানদিকের প্যানে, যাচাইকরণ ট্যাব বেছে নিন।
- ক্লায়েন্ট যাচাইকরণ কনফিগারেশন বিকল্পের অধীনে, নিম্নলিখিত যাচাইকরণ মোডগুলির মধ্যে থেকে
একটি বেছে নিন:
- Dynamic Client Registration: আপনার অথরাইজেশন সার্ভারের সাথে ক্রেডেনশিয়াল অটোমেটিক নেগোশিয়েট করতে OAuth ফ্লো ব্যবহার করে। আরও তথ্যের জন্য, OAuth 2.1 প্রয়োগ করার নির্দেশিকা দেখুন। প্রযোজ্য হলে, কাস্টম অ্যাপ লিঙ্ক যোগ করুন বিকল্পে আপনার এন্ডপয়েন্ট লিখুন।
- ম্যানুয়াল ক্লায়েন্ট রেজিস্ট্রেশন: আপনাকে ম্যানুয়ালি আগে থেকে রেজিস্টার করা ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট প্রদান করতে দেয়। অতিরিক্ত ফ্লো ওভাররাইড কনফিগার করতে উন্নত সেটিংস বড় করুন।
- সেভ করুন বিকল্পে ক্লিক করুন এবং সেভ করা হয়েছে মেসেজটি দেখা না যাওয়া পর্যন্ত অপেক্ষা করুন। তারপর, যাচাই করা টুল কাজ করছে কিনা তা যাচাই করতে একটি টেস্ট প্রম্পট রান করুন।