Maps Grounding Lite

Google Maps Platform Grounding Lite হল Model Context Protocol (MCP) সাপোর্ট সহ একটি পরিষেবা যা Google Maps থেকে বিশ্বস্ত জিওস্পেশিয়াল ডেটার মাধ্যমে আপনার AI অ্যাপ্লিকেশনকে সহজে গ্রাউন্ড করে। MCP সার্ভার এমন টুল প্রদান করে যা LLM-কে জায়গা, আবহাওয়া ও রুটের জন্য ক্ষমতা অ্যাক্সেস করতে এবং লোকেশন নাম ও Google Maps URL-কে প্লেস আইডিতে সমাধান করতে দেয়। আপনি Maps Grounding Lite ব্যবহার করে দেখতে পারেন, এর জন্য MCP সার্ভার কাজ করে এমন যেকোনও টুলে এটি চালু করতে হবে।

টুল

Maps Grounding Lite এমন টুল প্রদান করে যা LLM-কে নিম্নলিখিত Google Maps-এর ক্ষমতা অ্যাক্সেস করার অনুমতি দেয়:

  • জায়গা সার্চ করা: জায়গা সম্পর্কে তথ্য জানতে চাওয়া এবং AI-জেনারেটেড জায়গার ডেটার সারসংক্ষেপ পাওয়া, সেইসাথে সারসংক্ষেপে অন্তর্ভুক্ত প্রতিটি জায়গার জন্য প্লেস আইডি, অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক এবং Google Maps লিঙ্ক পাওয়া। আপনি ম্যাপে জায়গা দেখাতে অন্যান্য Google Maps Platform API-এর সাথে ফেরত পাওয়া জায়গার আইডি এবং অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক ব্যবহার করতে পারবেন।
  • আবহাওয়া দেখুন: আবহাওয়ার তথ্য জানতে চান এবং বর্তমান পরিস্থিতি, প্রতি ঘণ্টার পূর্বাভাস ও দৈনিক পূর্বাভাস জানুন।

  • রুট গণনা করা: দুটি লোকেশনের মধ্যে গাড়ি চালানো বা হাঁটার রুট সম্পর্কে তথ্য অনুরোধ করুন এবং রুটের দূরত্ব ও সময়কাল সংক্রান্ত তথ্য ফেরত দিন।

  • নাম রিজলভ করা এবং Maps URL রিজলভ করা: লোকেশন আইডি, ঠিকানা এবং Google Maps URL-কে প্লেস আইডিতে রিজলভ করা। আরও তথ্যের জন্য, Resolution API দেখুন।

Maps Grounding Lite MCP সার্ভার চালু করলে, LLM-কে সার্ভারের মাধ্যমে প্রকাশ করা নতুন টুল কল করার অনুমতি দেয়, যাতে উপরে তালিকাভুক্ত ডেটার ধরনের জন্য অতিরিক্ত গ্রাউন্ডিং তথ্য ফেরত দেওয়া যায়। LLM এই অতিরিক্ত তথ্য কন্টেক্সটের জন্য ব্যবহার করতে পারলেও, LLM শেষ পর্যন্ত যে উত্তর তৈরি করে তাতে MCP সার্ভার থেকে পাওয়া সঠিক তথ্য নাও থাকতে পারে। জেনারেট করা উত্তরের নির্ভুলতা আপনাকে যাচাই করতে হবে।

Resolution API

Maps Grounding Lite, Resolution API প্রদান করে, যা আপনাকে ফ্রি-ফর্ম লোকেশন টেক্সট এবং URL-কে স্ট্রাকচার্ড Google Maps প্লেস আইডেন্টিফায়ারে সমাধান করতে দেয়। Resolution API, REST পদ্ধতি এবং Maps Grounding Lite MCP সার্ভারে টুল হিসেবে উপলভ্য:

  • নাম সমাধান করুন (REST, MCP): Google Maps-এ নির্দিষ্ট জায়গার এন্টিটিতে লোকেশনের নাম বা ঠিকানার ব্যাচ সমাধান করুন। এটি অসংগঠিত ব্যবহারকারীর কোয়েরিগুলিকে স্থিতিশীল প্লেস আইডিতে গ্রাউন্ডিং করার জন্য উপযোগী।
  • Maps URL সমাধান করা (REST, MCP): নির্দিষ্ট জায়গার এন্টিটির জন্য Google Maps URL-এর ব্যাচ সমাধান করুন। কাজ করে এমন ফর্ম্যাটের মধ্যে স্ট্যান্ডার্ড জায়গার URL ও সংক্ষিপ্ত URL অন্তর্ভুক্ত।

আপনি অন্যান্য Google Maps Platform API-এর সাথে ফেরত পাওয়া জায়গার আইডি ব্যবহার করতে পারবেন। প্রতিটি উত্তরে একটি লিঙ্কও অন্তর্ভুক্ত থাকে যা সমাধান করা জায়গাগুলিকে Google Maps-এ একটি তালিকা হিসেবে সেভ করে।

আরও তথ্যের জন্য, Maps Tools Resolution API দেখুন।

Maps Grounding Lite স্যাম্পেল অ্যাপ ব্যবহার করে দেখুন (নতুন ট্যাবে খুলুন)

বিলিং ও কোটা

আপনাকে কীভাবে বিল করা হয়

Google Maps Platform-এর 'যখন ব্যবহার করবেন তখন পেমেন্ট করুন' প্রাইসিং মডেলের মাধ্যমে, প্রতিটি অনুরোধের জন্য Maps Grounding Lite-এর ব্যবহার গণনা করা হয়, যেখানে প্রতিটি অনুরোধ একটি বিলিং ইভেন্টকে উপস্থাপন করে। প্রতিটি প্রোডাক্ট SKU-এর জন্য ব্যবহার ট্র্যাক করা হয়। আপনার বিলে মোট চার্জের পাশাপাশি প্রতিটি SKU-এর জন্য একটি লাইন আইটেম দেখানো হয়। আরও জানতে রিপোর্টিং ওভারভিউ দেখুন।

মূল্য সংক্রান্ত বিবরণের জন্য মূল মূল্য সারণী এবং ভারতের মূল্য সারণী দেখুন।

Resolution API (ResolveNames এবং ResolveMapsUrls)-তে করা অনুরোধের জন্য Places API Text Search Essentials (শুধুমাত্র আইডি) SKU-এর অধীনে কোনও চার্জ নেওয়া হয় না।

এছাড়াও, Essentials ও Pro সাবস্ক্রাইব করে সেভ করুন প্যাকেজের মাধ্যমে Maps Grounding Lite অফার করা হয়।

কোটা

Maps-এর মাধ্যমে প্রদান করা টুল ও API-এর ক্ষেত্রে নিম্নলিখিত কোটা প্রযোজ্য হয় Grounding Lite:

  • জায়গা সার্চ করা: প্রোজেক্ট পিছু প্রতি মিনিটে ৩০০টি কোয়েরি।
  • আবহাওয়া লুকআপ: প্রতি প্রোজেক্টে প্রতি মিনিটে ৩০০টি কোয়েরি।
  • রুট কম্পিউট করা: প্রতি প্রোজেক্টে প্রতি মিনিটে ৩০০টি কোয়েরি।
  • নামের সমাধান করা: প্রতি প্রোজেক্টে প্রতি মিনিটে ৬০০টি কোয়েরি।
  • Maps URL সমাধান করা: প্রতি প্রোজেক্টে প্রতি মিনিটে ৬০০টি কোয়েরি।

প্রতিটি Resolution API অনুরোধ একটি কোয়েরি হিসেবে গণনা করা হয়, এতে কতগুলি আইটেম আছে তা বিবেচনা করা হয় না।

নীতি ও পরিষেবার শর্তাবলী

Maps Grounding Lite, Google Maps Platform পরিষেবার শর্তাবলী অনুযায়ী পরিচালিত হয়, যার মধ্যে এই পরিষেবার জন্য পরিষেবা-নির্দিষ্ট শর্তাবলী অন্তর্ভুক্ত। এই বিভাগে Maps Grounding Lite-এর জন্য অতিরিক্ত পরিষেবা ব্যবহারের প্রয়োজনীয়তা বর্ণনা করা হয়েছে, যার মধ্যে মানানসই LLM এবং সোর্স অ্যাট্রিবিউশনের প্রয়োজনীয়তা অন্তর্ভুক্ত রয়েছে।

মানানসই LLM-এর জন্য প্রয়োজনীয়তা

আপনি শুধুমাত্র এমন LLM-এর সাথে Maps Grounding Lite ব্যবহার করতে পারবেন যা Google Maps Platform পরিষেবার শর্তাবলী মেনে চলে।

যেমন, আপনি যে LLM ব্যবহার করার জন্য বেছে নিয়েছেন, সেটি যাতে Google Maps কন্টেন্ট ক্যাশে, স্টোর বা উন্নত করার জন্য ব্যবহার না করে, তা নিশ্চিত করার দায়িত্ব আপনার। Maps Grounding Lite ব্যবহার করার আগে, Maps Grounding Lite-এর সাথে আপনি যে মডেল ব্যবহার করতে চান, সেটির পরিষেবার শর্তাবলী আপনাকে পর্যালোচনা করতে হবে। আপনি Maps Grounding Lite-এর সাথে এমন কোনও মডেল ব্যবহার করবেন না যা মডেল ট্রেনিং বা উন্নতির জন্য মডেলে ইনপুট করা ডেটা ব্যবহার করে। আপনি মডেলটি যেভাবে ব্যবহার করছেন তা Google Maps Platform-এর পরিষেবার শর্তাবলীতে Google Maps কন্টেন্টের উপর বিধিনিষেধের সাথে সম্পূর্ণভাবে সঙ্গতিপূর্ণ কিনা তা নিশ্চিত করার দায়িত্ব আপনার। এর মধ্যে পরিষেবা-নির্দিষ্ট শর্তাবলীও অন্তর্ভুক্ত।

Google Maps সোর্সের জন্য অ্যাট্রিবিউশন সংক্রান্ত প্রয়োজনীয়তা

Maps Grounding Lite থেকে প্রতিটি টুল উত্তরে সোর্স অন্তর্ভুক্ত থাকে। Maps Grounding Lite-এর প্রদান করা টুল ব্যবহার করে ফলাফল দেখানোর সময়, আপনাকে অবশ্যই নিম্নলিখিত প্রয়োজনীয়তা পূরণ করে এমনভাবে সংশ্লিষ্ট Google Maps সোর্স অন্তর্ভুক্ত করতে হবে:

  • Google Maps-এর সোর্সগুলি অবশ্যই তৈরি করা কন্টেন্টের ঠিক পরেই থাকতে হবে যা সোর্সগুলি সমর্থন করে। এই জেনারেট করা কন্টেন্টকে গ্রাউন্ডেড আউটপুট হিসেবেও উল্লেখ করা হয়।
  • Google Maps সোর্স অবশ্যই একটি ব্যবহারকারী ইন্টারঅ্যাকশনের মধ্যে দেখার যোগ্য হতে হবে।

Search places টুলের জন্য সোর্স

search_places টুলের places ফিল্ডে এমন সোর্স দেওয়া থাকে যা summary-কে সমর্থন করে। places-এর জন্য, নিম্নলিখিত মেটাডেটা পাওয়া গেছে:

  • place (রিসোর্সের নাম)
  • id
  • location
  • googleMapsLinks

প্রতিটি জায়গার জন্য, আপনাকে এমন একটি লিঙ্ক প্রিভিউ তৈরি করতে হবে যা এইসব প্রয়োজনীয়তা পূরণ করে:

MCP সার্ভার ব্যবহার করার জন্য LLM কনফিগার করা

Maps Grounding Lite ব্যবহার করতে, প্রথমে আপনার একটি Google Cloud প্রোজেক্ট থাকতে হবে, যেখানে Maps Grounding Lite API পরিষেবা চালু করা আছে, এবং একটি API কী বা OAuth ক্লায়েন্ট আইডি আছে। তারপর, আপনি MCP সার্ভার অ্যাক্সেস করার জন্য LLM কনফিগার করতে পারবেন। Grounding Lite MCP সার্ভার স্ট্রিমেবল HTTP ট্রান্সপোর্ট ব্যবহার করে।

আপনার Google Cloud প্রোজেক্টে Maps Grounding Lite পরিষেবা চালু করুন

আপনার প্রোজেক্টে API চালু করতে:

  1. Google Cloud Console-এ, Maps Grounding Lite-এর জন্য আপনি যে প্রোজেক্ট ব্যবহার করতে চান সেটি বেছে নিন।
  2. Google Cloud Console-এ প্রোজেক্টের জন্য বিলিং চালু করুন।
  3. Google Cloud Console API লাইব্রেরি থেকে Maps Grounding Lite চালু করুন।

API key ব্যবহার করে যাচাইকরণ করা

আপনি Maps Grounding Lite-এর সাথে আগে থেকে থাকা API কী ব্যবহার করতে পারেন অথবা নতুন একটি তৈরি করতে পারেন, যতক্ষণ না আপনি Google Cloud প্রোজেক্ট এবং কী, দুটিতেই Maps Grounding Lite API পরিষেবা চালু করছেন।

API key ব্যবহার করে যাচাইকরণ করতে:

  1. Google Maps Platform-এর সাথে শুরু করা-এর ধাপগুলি অনুসরণ করে API কী তৈরি বা কনফিগার করুন।
  2. X-Goog-Api-Key হেডার ব্যবহার করে MCP সার্ভারে 'কী' পাস করুন। আপনাকে LLM-এর MCP টুল কনফিগারেশনে এটি কাস্টম HTTP হেডার হিসেবে উল্লেখ করতে হবে।

OAuth ব্যবহার করে যাচাইকরণ করুন

আপনি OAuth ক্রেডেনশিয়াল তৈরি করে এবং সেগুলি MCP হোস্ট বা MCP সার্ভার অ্যাপ্লিকেশনে পাস করে OAuth ব্যবহার করে যাচাই করতে পারেন।

OAuth ব্যবহার করে যাচাই করতে:

  1. Google Cloud Console-এ, Maps Grounding Lite-এর জন্য আপনি যে প্রোজেক্ট ব্যবহার করতে চান সেটি বেছে নিন।
  2. API ও পরিষেবা মেনু থেকে ক্রেডেনশিয়াল বিকল্প বেছে নিন।
  3. উপরের মেনু থেকে, ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি বিকল্প বেছে নিন।
  4. প্রজেক্টে কনফিগার করা সম্মতি সংক্রান্ত স্ক্রিন না থাকলে, সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন বিকল্পে ক্লিক করে অন-স্ক্রিন নির্দেশাবলী অনুসরণ করুন।
  5. মেট্রিক বিভাগে, OAuth ক্লায়েন্ট তৈরি করুন বিকল্পে ক্লিক করুন।
  6. OAuth ক্লায়েন্ট আইডি তৈরি করুন স্ক্রিনে, অ্যাপ্লিকেশনের ধরন বেছে নিন এবং ক্লায়েন্ট আইডির জন্য একটি নাম লিখুন।
  7. আপনার আবেদনের ধরনের সাথে প্রাসঙ্গিক অতিরিক্ত বিবরণ উল্লেখ করুন। যেমন, আপনি কোনও ওয়েব অ্যাপ্লিকেশন তৈরি করলে, ব্রাউজার ও সার্ভার অনুরোধের জন্য অনুমোদিত URI যোগ করুন।
  8. আপনার ক্লায়েন্ট তৈরি হয়ে গেলে, ক্লায়েন্ট আইডি ও সিক্রেট সেভ করুন।
  9. Maps Grounding Lite অ্যাক্সেস করার জন্য আপনার MCP হোস্ট বা MCP সার্ভার অ্যাপ্লিকেশন কনফিগার করার সময়, আপনার OAuth ক্লায়েন্ট আইডি এবং সিক্রেট পাস করুন। আপনাকে এই স্কোপের জন্যও অনুরোধ করতে হবে: https://www.googleapis.com/auth/maps-platform.mapstools.

আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।

Maps Grounding Lite MCP সার্ভার অ্যাক্সেস করতে LLM কনফিগার করুন

Maps Grounding Lite API পরিষেবা চালু থাকা Google Cloud প্রোজেক্ট এবং API কী বা OAuth ক্লায়েন্ট আইডি ও সিক্রেটের মতো সঠিক ক্রেডেনশিয়াল থাকলে, আপনি সংশ্লিষ্ট MCP কনফিগারেশন ডকুমেন্টেশন অনুসরণ করে এবং Maps Grounding Lite MCP সার্ভার URL: https://mapstools.googleapis.com/mcp ব্যবহার করে MCP সার্ভার অ্যাক্সেস করার জন্য LLM কনফিগার করতে পারবেন।

আরও তথ্যের জন্য, AI অ্যাপ্লিকেশনে MCP কনফিগার করুন দেখুন।

Gemini CLI-এর মাধ্যমে Maps Grounding Lite কনফিগার করা

এই বিভাগে, Gemini CLI ব্যবহার করে Maps Grounding Lite MCP সার্ভার কীভাবে কনফিগার করতে হয় তার উদাহরণ দেওয়া হয়েছে। আরও জানতে, Gemini CLI-এর সাথে MCP সার্ভার দেখুন।

  1. Gemini CLI ইনস্টল করার পরে, Maps Grounding Lite MCP সার্ভার কনফিগার করতে আপনি add কমান্ড ব্যবহার করতে পারবেন:

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

    কনফিগারেশন সফল হলে, আপনার ব্যবহারকারী সেটিংসে সার্ভার যোগ করা হয়েছে বলে একটি কনফার্মেশন দেখতে পাবেন।

  2. সার্ভার সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে, /mcp list কমান্ড রান করুন:

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (5 tools)
Tools:
-   compute_routes
-   lookup_weather
-   resolve_maps_urls
-   resolve_names
-   search_places

  3. CLI-এর মাধ্যমে Maps সম্পর্কিত প্রশ্ন জিজ্ঞাসা করা শুরু করুন। যেমন, "আমাকে Mountain View-এর কিছু রেস্তোরাঁর সাজেশন দাও" বলে দেখুন, যা আপনার হয়ে search_places টুলকে কল করবে।

Agent Development Kit (ADK)-এর মাধ্যমে Grounding Lite কনফিগার করা

এই বিভাগে, Agent Development Kit (ADK) এবং Python, Java বা TypeScript-এর মধ্যে যেকোনও একটি ব্যবহার করে কীভাবে Grounding Lite MCP সার্ভার কনফিগার করতে হয় তার উদাহরণ দেওয়া হয়েছে।

Python

আপনি GitHub-এ এই উদাহরণের সম্পূর্ণ প্রয়োগ adk-samples রিপোজিটরি-তে দেখতে পাবেন।

ধাপ ১: Google Maps Grounding Lite-এর জন্য McpToolset-এর মাধ্যমে আপনার এজেন্টকে সংজ্ঞায়িত করুন

আপনার agent.py ফাইল পরিবর্তন করুন। YOUR_GOOGLE_MAPS_API_KEY-এর জায়গায় আপনার আসল API key লিখুন।

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)
ধাপ ২: __init__.py আছে কিনা তা নিশ্চিত করুন

আপনার agent.py-এর মতো একই ডিরেক্টরিতে __init__.py আছে কিনা তা নিশ্চিত করুন:

from . import agent
ধাপ ৩: adk web রান ও ইন্টার‌্যাক্ট করা
  1. এনভায়রনমেন্ট ভেরিয়েবল সেট করা:
    আপনার Google Maps API কী আপনার টার্মিনালে এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেট করুন: 
    export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
  2. adk web রান করুন:
    ADK ওয়েব ইন্টারফেস চালু করতে নিম্নলিখিত কমান্ড রান করুন: 
    adk web
  3. UI-তে ইন্টার‍্যাক্ট করুন:
    • travel_planner_agent বেছে নিন।
    • এই ধরনের প্রম্পট ব্যবহার করে দেখুন:
      • "আমি আগামীকাল সান ফ্রান্সিসকোতে থাকব। আবহাওয়া কেমন?"
      • "গোল্ডেন গেট পার্কের কাছাকাছি কফি শপ খোঁজো।"
      • "GooglePlex থেকে SFO যাওয়ার দিকনির্দেশ দাও।"

Java

Java-তে McpToolset শুরু করে এমন একটি এজেন্টকে সংজ্ঞায়িত করুন। আপনি এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার না করলে, YOUR_GOOGLE_MAPS_API_KEY_HERE-এর জায়গায় আপনার পাওয়া আসল API কী লিখুন।

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

TypeScript

TypeScript-এ MCPToolset ইনিশিয়ালাইজ করে এমন এজেন্টকে সংজ্ঞায়িত করুন:

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});

মতামত শেয়ার করা হচ্ছে

Maps Grounding Lite সম্পর্কে মতামত শেয়ার করতে, নিম্নলিখিত ফর্ম ব্যবহার করুন: