১. ভূমিকা
এই কোডল্যাবে, আপনি শিখবেন কীভাবে Agent Development Kit (ADK) ব্যবহার করে একটি প্রো-কোড AI এজেন্ট তৈরি করতে হয় যা সরাসরি অফিসিয়াল Google Workspace MCP সার্ভার-এর সাথে কানেক্ট করে।
মডেল কন্টেক্সট প্রোটোকল (MCP) হল একটি ওপেন স্ট্যান্ডার্ড যা AI মডেলকে রিমোট সার্ভারের মাধ্যমে প্রদান করা টুল নিরাপদে ব্যবহার করার সুবিধা দেয়। ADK হল অটোনোমাস এজেন্ট তৈরি করার জন্য Google-এর প্রো-কোড ফ্রেমওয়ার্ক। এগুলি একত্রিত করে, আপনি Gmail, Google Drive, Google Calendar, Google Chat এবং People ডেটার উপর ভিত্তি করে অত্যন্ত কাস্টমাইজ করা এজেন্ট তৈরি করতে পারেন।
উপলভ্য টুল ও কনফিগারেশন সম্পর্কে সম্পূর্ণ ডকুমেন্টেশন পেতে, Google Workspace MCP সার্ভার কনফিগার করুন দেখুন।
আপনি কী করবেন
- আপনার Google Cloud প্রোজেক্টে Google Workspace MCP পরিষেবা চালু করুন।
- OAuth-এর সম্মতি কনফিগার করুন এবং লোকাল টেস্টিং ও প্রোডাকশন ডিপ্লয়মেন্ট, দুটির জন্যই ক্রেডেনশিয়াল তৈরি করুন।
- স্ট্যাটিক টোকেন ব্যবহার করে Google Workspace MCP সার্ভারের সাথে কানেক্ট করে এমন লোকাল ADK এজেন্ট তৈরি করা।
- Gemini Enterprise Agent Platform (GEAP) Agent Runtime-এ প্রোডাকশন-রেডি ADK এজেন্ট তৈরি ও ডিপ্লয় করুন যা ডায়নামিক টোকেন ইনজেকশন ব্যবহার করে।
- Gemini Enterprise-এর মধ্যে নেটিভভাবে আপনার কাস্টম এজেন্ট রেজিস্টার ও টেস্ট করুন।
আপনার কী প্রয়োজন হবে
- একটি ওয়েব ব্রাউজার (যেমন, Chrome)।
- বিলিং চালু করা আছে এমন একটি Google Cloud প্রোজেক্ট।
- Google Workspace অ্যাকাউন্ট (স্মার্ট ফিচার চালু করা আছে)।
- আপনার লোকাল মেশিনে Python 3.11+ ইনস্টল করা আছে।
- Google Cloud CLI (
gcloud) ইনস্টল ও ইনিশিয়ালাইজ করা হয়েছে।
২. শুরু করার আগে
Google Cloud প্রোজেক্ট তৈরি বা বেছে নিন
কনসোল বিকল্প
Google Cloud Console-এ, Google Cloud প্রোজেক্ট বেছে নিন বা তৈরি করুন।
CLI বিকল্প
নতুন প্রোজেক্ট তৈরি করে সেটি অ্যাক্টিভ হিসেবে সেট করুন:
gcloud projects create YOUR_PROJECT_ID
gcloud config set project YOUR_PROJECT_ID
API চালু করুন
Google Workspace MCP সার্ভার ব্যবহার করতে, আপনাকে অবশ্যই স্ট্যান্ডার্ড Google Workspace API এবং ডেডিকেটেড MCP পরিষেবা দুটিই চালু করতে হবে।
কনসোল বিকল্প
ওয়েব ব্রাউজার ব্যবহার করে এগুলি চালু করতে নিম্নলিখিত বোতামে ক্লিক করুন:
CLI বিকল্প এই টার্মিনাল কমান্ডগুলি এক্সিকিউট করুন:
# Enable standard GWS APIs
gcloud services enable chat.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
people.googleapis.com \
gmail.googleapis.com
# Enable dedicated MCP services
gcloud services enable calendarmcp.googleapis.com \
chatmcp.googleapis.com \
drivemcp.googleapis.com \
gmailmcp.googleapis.com \
workspacemcp.googleapis.com
Chat অ্যাপ কনফিগার করুন
Google Chat MCP সার্ভার ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে একটি Chat অ্যাপ কনফিগার করতে হবে।
- Google Cloud কনসোলে, Google Chat API সার্চ করুন এবং Google Chat API > ম্যানেজ করুন > কনফিগারেশন বিকল্পে ক্লিক করুন।
- Chat অ্যাপ সেট-আপ করুন:
- অ্যাপের নাম:
ADK Workspace Agent - Avatar URL:
https://developers.google.com/chat/images/quickstart-app-avatar.png - বিবরণ:
MCP server connection for ADK Agent - ফাংশনালিটি বিকল্পের মধ্যে, ইন্টার্যাক্টিভ ফিচার চালু করুন বিকল্প বন্ধ করুন।
- লগ বিকল্পের অধীনে, লগিংয়ে লগ সংক্রান্ত সমস্যা বিকল্প বেছে নিন।
- অ্যাপের নাম:
- সেভ করুন বিকল্পে ক্লিক করুন।
৩. OAuth সম্মতি ও ক্লায়েন্ট কনফিগার করুন
Google Workspace MCP সার্ভার সুরক্ষিত যাচাইকরণের জন্য OAuth 2.0 ব্যবহার করে। আপনাকে অবশ্যই OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করতে হবে এবং দুটি আলাদা ক্লায়েন্ট আইডি তৈরি করতে হবে: একটি লোকাল ডেভেলপমেন্টের জন্য এবং একটি ডিপ্লয় করা এজেন্টের জন্য।
OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করা
- Google Cloud কনসোলে, উপরে বাঁদিকের কোণে নেভিগেশন মেনু (হ্যামবার্গার আইকন) বিকল্পে ক্লিক করুন। Google Auth প্ল্যাটফর্ম > ব্র্যান্ডিং (অথবা Google Auth প্ল্যাটফর্ম দেখা না গেলে API ও পরিষেবা > OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন) বেছে নিন।
- অ্যাপের তথ্য কনফিগার করুন:
- অ্যাপের নাম:
Workspace ADK Agent - ব্যবহারকারী সহায়তা ইমেল: আপনার ইমেল বেছে নিন।
- অ্যাপের নাম:
- দর্শক কনফিগার করুন: ইন্টার্নাল বিকল্প বেছে নিন।
- যোগাযোগের তথ্য কনফিগার করুন: আপনার ইমেল আইডি লিখুন, তারপর তৈরি করুন বিকল্পে ক্লিক করুন।
- ডেটা অ্যাক্সেস > স্কোপ যোগ করুন বা সরান বিকল্পে যান। ম্যানুয়ালি স্কোপ যোগ করুন বিকল্পের অধীনে, প্রয়োজনীয় পরিষেবা অ্যাক্সেস করার অনুমতি দিতে নিম্নলিখিত স্কোপ যোগ করুন:
https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/calendar.calendars https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/directory.readonly https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/cloud-platform - টেবিলে যোগ করুন, তারপর আপডেট করুন এবং শেষে সেভ করুন বিকল্পে ক্লিক করুন।
লোকাল ডেভেলপমেন্টের (ডেস্কটপ অ্যাপ) জন্য ক্লায়েন্ট আইডি তৈরি করুন
Google Workspace MCP সার্ভারের জন্য OAuth 2.0 ক্লায়েন্ট কনফিগার করার সময়, আপনাকে অবশ্যই AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিয়ে এজেন্টিক ক্লাসিফিকেশন সেটিং (is_agentic) চালু করতে হবে। এই সেটিং চালু না করা OAuth ক্লায়েন্টদের Google Workspace MCP এন্ডপয়েন্টে কল করা থেকে ব্লক করা হয়।
- Google Cloud কনসোলে, Google Auth Platform > ক্লায়েন্ট (অথবা API ও পরিষেবা > ক্রেডেনশিয়াল) বিকল্পে নেভিগেট করুন। ক্লায়েন্ট তৈরি করুন (অথবা ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি) বিকল্পে ক্লিক করুন।
- অ্যাপ্লিকেশনের ধরন হিসেবে ডেস্কটপ অ্যাপ বেছে নিন।
- এটির নাম
Workspace Agent Localদিন। - OAuth ক্লায়েন্টে
is_agenticক্লাসিফিকেশন ফ্ল্যাগ চালু করতে, AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন। - তৈরি করুন বিকল্পে ক্লিক করে JSON ফাইল ডাউনলোড করুন। এটি
client_secret.jsonহিসেবে লোকাল ড্রাইভে সেভ করুন।
৪. এজেন্ট ডেভেলপমেন্ট ও টেস্টিং
এই বিভাগে এজেন্ট এনভায়রনমেন্ট কীভাবে তৈরি করতে হয় তা বর্ণনা করা হয়েছে। আমরা পরীক্ষার জন্য স্ট্যাটিক টোকেন পদ্ধতি ব্যবহার করব, যেখানে আমরা gcloud ব্যবহার করে একটি OAuth টোকেন নিয়ে আসব এবং এটি ADK-এর McpToolset-এ পাস করব। আপনি লোকাল মেশিন বা Google Cloud Shell ব্যবহার করে এইসব ধাপ অনুসরণ করতে পারেন।
আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট-আপ করতে, আপনার এনভায়রনমেন্ট বেছে নিন: লোকাল মেশিন অথবা Google Cloud Shell। দুটি পদ্ধতিই প্ল্যাটফর্ম জুড়ে সামঞ্জস্য নিশ্চিত করতে যাচাইকরণের জন্য একটি শেয়ার করা Python স্ক্রিপ্ট ব্যবহার করবে।
১. এনভায়রনমেন্ট ডিরেক্টরি সেট-আপ করুন
প্রোজেক্ট ডিরেক্টরি তৈরি করতে এবং প্রয়োজনীয় প্যাকেজ ইনস্টল করতে আপনার টার্মিনালে নিম্নলিখিত কমান্ডগুলি এক্সিকিউট করুন।
- Google Cloud Shell-এর জন্য: প্রথমে, Google Cloud Console-এর উপরে ডানদিকের টুলবারে Cloud Shell অ্যাক্টিভেট করুন আইকনে (
>_) ক্লিক করুন। - লোকাল মেশিনের জন্য: আপনার স্ট্যান্ডার্ড টার্মিনাল খুলুন।
mkdir -p gws-adk-agent/workspace_agent
cd gws-adk-agent
python3 -m venv .venv
source .venv/bin/activate
pip install google-adk poetry google-auth-oauthlib
২. ক্রেডেনশিয়াল ফাইল তৈরি করুন
আগের ধাপে ডাউনলোড করা client_secret.json ফাইলটি আপনার gws-adk-agent ডিরেক্টরির রুটে রাখতে হবে।
- লোকাল মেশিন: ডাউনলোড করা
client_secret.jsonফাইলটিgws-adk-agentডিরেক্টরিতে সরান বা কপি করুন। - Google Cloud Shell: Cloud Shell-এ নিম্নলিখিত কমান্ড রান করে ফাইলটি তৈরি করুন (
[PASTE_JSON_HERE]-এর জায়গায় আপনার আসল JSON কন্টেন্ট লিখুন):
cat << 'EOF' > client_secret.json
[PASTE_JSON_HERE]
EOF
৩. যাচাই করুন এবং .env (auth.py) জেনারেট করুন
যাচাইকরণ ধারাবাহিকভাবে ম্যানেজ করতে এবং এনভায়রনমেন্ট-নির্দিষ্ট CLI রাউটিং সংক্রান্ত সমস্যা এড়াতে, আমরা অফিসিয়াল Google যাচাইকরণ লাইব্রেরি দ্বারা পরিচালিত একটি কাস্টম Python স্ক্রিপ্ট ব্যবহার করি। এই স্ক্রিপ্ট OAuth ফ্লো ম্যানেজ করে, লোকাল স্টোরেজে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) সেভ করে এবং প্রয়োজনীয় .env ফাইল তৈরি করে।
gws-adk-agent ডিরেক্টরিতে auth.py নামের একটি ফাইল তৈরি করুন এবং নিম্নলিখিত কোড যোগ করুন:
import json
import os
from urllib.parse import urlparse, parse_qs
import google.auth
from google_auth_oauthlib.flow import InstalledAppFlow
CLIENT_SECRET_FILE = 'client_secret.json'
SCOPES = [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/calendar",
"https://www.googleapis.com/auth/chat.spaces.readonly",
"https://www.googleapis.com/auth/chat.messages",
"https://www.googleapis.com/auth/drive.readonly",
"https://www.googleapis.com/auth/gmail.readonly",
"https://www.googleapis.com/auth/gmail.compose",
"https://www.googleapis.com/auth/directory.readonly",
"https://www.googleapis.com/auth/contacts.readonly"
]
# Initialize the flow from the client secrets JSON
flow = InstalledAppFlow.from_client_secrets_file(
CLIENT_SECRET_FILE,
scopes=SCOPES,
redirect_uri='http://localhost:8085/'
)
# Generate the Auth URL
auth_url, expected_state = flow.authorization_url(prompt='consent', access_type='offline')
print("\n=== GOOGLE OAUTH OFFICIAL LIBRARY FLOW ===")
print("1. Copy the following link and paste it into your browser (or click it if supported):\n")
print(auth_url)
print("\n2. Authorize the application.")
print("3. Your browser will redirect to a 'localhost' page (it will show a 'Site can't be reached' error, which is EXPECTED and normal).")
print("4. Copy the ENTIRE URL from your browser's address bar (including the http://localhost:8085/ part).\n")
# Get the redirected URL from the user
redirected_url = input("Paste the full localhost URL here: ").strip()
# Exchange the redirect URL for tokens
print("\nExchanging code for tokens...")
try:
parsed_url = urlparse(redirected_url)
query_params = parse_qs(parsed_url.query)
returned_state = query_params.get('state', [None])[0]
code = query_params.get('code', [None])[0]
if not code:
raise ValueError("No 'code' parameter found in the URL.")
if returned_state != expected_state:
raise ValueError("CSRF Warning! State mismatch.")
flow.fetch_token(code=code)
creds = flow.credentials
except Exception as e:
print(f"Authentication failed: {e}")
exit(1)
if not creds.refresh_token:
print("\nError: No refresh token returned. You may need to revoke access and try again.")
exit(1)
# Save Application Default Credentials
adc_data = {
"client_id": creds.client_id,
"client_secret": creds.client_secret,
"refresh_token": creds.refresh_token,
"type": "authorized_user"
}
adc_dir = os.path.expanduser("~/.config/gcloud")
os.makedirs(adc_dir, exist_ok=True)
adc_path = os.path.join(adc_dir, "application_default_credentials.json")
with open(adc_path, "w") as f:
json.dump(adc_data, f, indent=2)
# Detect Project ID
try:
_, project_id = google.auth.default()
except Exception:
project_id = None
project_id = project_id or os.environ.get("GOOGLE_CLOUD_PROJECT", "YOUR_PROJECT_ID")
# Save to .env for local development (relative to project root)
env_dir = "workspace_agent"
os.makedirs(env_dir, exist_ok=True)
env_path = os.path.join(env_dir, ".env")
with open(env_path, "w") as f:
f.write("GOOGLE_GENAI_USE_VERTEXAI=1\n")
f.write(f"GOOGLE_CLOUD_PROJECT={project_id}\n")
f.write("GOOGLE_CLOUD_LOCATION=us-central1\n")
print(f"\nSuccess! Application Default Credentials saved to: {adc_path}")
print(f"Environment variables saved to: {env_path}")
if project_id == "YOUR_PROJECT_ID":
print("NOTE: Could not automatically detect Project ID. Please update it manually in .env")
আপনার টার্মিনালে স্ক্রিপ্টটি রান করুন:
python3 auth.py
এজেন্ট কোড তৈরি করুন
আগের ধাপে আপনি যে এনভায়রনমেন্টই বেছে নিন না কেন, এজেন্ট কোড একই থাকে। আপনার আগে থেকে তৈরি করা workspace_agent সাবডিরেক্টরির মধ্যে agent.py নামের একটি ফাইল তৈরি করুন এবং নিম্নলিখিত কোড যোগ করুন। এই স্ক্রিপ্ট অনুমোদন প্রদান করতে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) ব্যবহার করে, যা ডায়নামিক হেডার প্রোভাইডারের মাধ্যমে মেমরিতে ক্রেডেনশিয়াল অটোমেটিক যাচাই ও রিফ্রেশ করে।
import os
import datetime
import google.auth
from google.auth.transport.requests import Request
from google.adk.agents.llm_agent import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
# Enable graceful error handling so timeouts return as tool outputs instead of crashing
os.environ["ADK_ENABLE_MCP_GRACEFUL_ERROR_HANDLING"] = "1"
MODEL = "gemini-2.5-flash"
# Inject User ADC path globally so both ADK and underlying GenAI SDKs
# load it safely, bypassing broken Compute Engine metadata fallbacks.
_adc_path = os.path.expanduser(
"~/.config/gcloud/application_default_credentials.json"
)
if not os.path.exists(_adc_path):
raise FileNotFoundError(
f"User ADC not found at {_adc_path}. "
"Please run 'python3 auth.py' first to generate credentials."
)
os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = _adc_path
creds, _ = google.auth.default()
class TokenRelay:
"""Manages in-memory caching of Google OAuth access tokens.
Decouples token refresh logic from credentials validation states to
prevent infinite refresh loops during automated tool retries.
"""
def __init__(self, credentials):
self._creds = credentials
self._cached_token: str | None = None
self._expiry: datetime.datetime | None = None
def get_token(self) -> str:
now = datetime.datetime.now()
# Refresh if no cache or expiring within 5 minutes
if (
self._cached_token is None
or self._expiry is None
or now >= (self._expiry - datetime.timedelta(minutes=5))
):
self._creds.refresh(Request())
self._cached_token = self._creds.token
# Token lives for 60 mins; cache for 50 mins safely
self._expiry = now + datetime.timedelta(minutes=50)
print("\n[Agent Runtime] Access token refreshed from ADC.")
return self._cached_token or ""
# Initialize auth relay and perform startup safety check
token_relay = TokenRelay(creds)
token_relay.get_token()
def auth_header_provider(tool_context=None) -> dict[str, str]:
return {"Authorization": f"Bearer {token_relay.get_token()}"}
# Initialize the Google Workspace MCP servers with dynamic runtime provider
calendar_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://calendarmcp.googleapis.com/mcp/v1",
),
header_provider=auth_header_provider
)
chat_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://chatmcp.googleapis.com/mcp/v1",
),
header_provider=auth_header_provider
)
drive_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://drivemcp.googleapis.com/mcp/v1",
),
header_provider=auth_header_provider
)
gmail_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://gmailmcp.googleapis.com/mcp/v1",
),
header_provider=auth_header_provider
)
people_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://people.googleapis.com/mcp/v1",
),
header_provider=auth_header_provider
)
universal_search_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://workspacemcp.googleapis.com/mcp/v1",
),
header_provider=auth_header_provider
)
current_date = datetime.datetime.now().strftime("%Y-%m-%d")
# Define the agent and attach all configured toolsets
root_agent = LlmAgent(
model=MODEL,
name='gws_adk_agent',
instruction=f"""You are a helpful assistant grounded in the user's Google Workspace data.
Today's current date is {current_date}. Always calculate relative dates (like 'this week' or 'upcoming meetings') using this reference.
Use the provided MCP tools to answer questions about their Calendar, Chat, Drive, Gmail, Contacts, and perform Universal Search.
If a tool returns an error indicating a timeout, inform the user that the service took too long to respond.""",
tools=[calendar_mcp, chat_mcp, drive_mcp, gmail_mcp, people_mcp, universal_search_mcp]
)
আপনার এজেন্ট রান ও টেস্ট করা
আপনি ইন্টার্যাক্টিভ ওয়েব UI অথবা সরাসরি আপনার টার্মিনাল/শেল-এর মধ্যে থেকে আপনার এজেন্টের সাথে ইন্টার্যাক্ট করতে পারবেন।
বিকল্প ১: ইন্টার্যাক্টিভ ওয়েব UI
আপনি লোকাল মেশিন ব্যবহার করলে:
- আপনার
gws-adk-agentপ্রোজেক্ট রুট ডিরেক্টরি থেকে, ADK ওয়েব ইন্টারফেস শুরু করুন:adk web - আপনার এজেন্টের সাথে চ্যাট করতে ব্রাউজারে
http://localhost:8000খুলুন।
আপনি Google Cloud Shell-এ থাকলে:
- আপনার
gws-adk-agentপ্রোজেক্ট রুট ডিরেক্টরি থেকে, ADK ওয়েব ইন্টারফেস শুরু করুন, যা স্পষ্টভাবে পোর্ট ৮০৮০ এনফোর্স করে:adk web --port 8080 --allow_origins=* - Cloud Shell টুলবারের উপরে ডানদিকে ওয়েব প্রিভিউ বোতামে ক্লিক করুন এবং নতুন ট্যাবে ইন্টারফেস খুলতে পোর্ট ৮০৮০-তে প্রিভিউ বিকল্প বেছে নিন।
বিকল্প ২: Terminal CLI মোড (বিকল্প)
আপনি যদি টার্মিনালে থাকতে চান বা ওয়েব ব্রাউজার প্রিভিউ সেট-আপ করা এড়াতে চান, তাহলে ADK একটি নেটিভ ইন্টার্যাক্টিভ REPL চ্যাট মোড প্রদান করে।
আপনার gws-adk-agent প্রোজেক্ট রুট ডিরেক্টরি থেকে, নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন (এটি লোকাল মেশিন এবং Google Cloud Shell, দুটিতেই একইভাবে কাজ করে):
adk run workspace_agent
আপনি সরাসরি আপনার শেলে একটি ইন্টার্যাক্টিভ চ্যাট সেশনে প্রবেশ করবেন:
Running agent gws_adk_agent, type exit to exit.
[user]:
আপনার এজেন্টকে প্রম্পট করে দেখুন
আপনি যে ইন্টারফেসই বেছে নিন না কেন, Workspace MCP টুল ব্যবহার করে এমন কোয়েরি দিয়ে এজেন্টকে টেস্ট করার চেষ্টা করুন:
What are my upcoming meetings this week?
Summarize the last 3 unread emails in my Gmail.
৫. প্রোডাকশন ডিপ্লয়মেন্ট
প্রোডাকশনে এজেন্ট ডিপ্লয় করতে, আমরা হার্ডকোড করা লোকাল টোকেন ব্যবহার করতে পারি না। পরিবর্তে, আমরা ADK-এর header_provider ব্যবহার করি যাতে কোনও ব্যবহারকারী এজেন্টের সাথে ইন্টার্যাক্ট করার সময় Gemini Enterprise প্ল্যাটফর্মের মাধ্যমে ইনজেক্ট করা OAuth অ্যাক্সেস টোকেন ডায়নামিকভাবে এক্সট্র্যাক্ট করা যায়।
প্রোডাকশন এজেন্ট কোড তৈরি করা
enterprise_ai নামের একটি ডিরেক্টরি প্যাকেজ তৈরি করুন এবং এর মধ্যে একটি agent.py ফাইল তৈরি করুন:
mkdir -p enterprise_ai
enterprise_ai/agent.py-এ নিম্নলিখিত কন্টেন্ট লিখুন:
import os
import datetime
import re
from google.adk.agents.llm_agent import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.tool_context import ToolContext
# Enable graceful error handling so timeouts return as tool outputs instead of crashing
os.environ["ADK_ENABLE_MCP_GRACEFUL_ERROR_HANDLING"] = "1"
MODEL = "gemini-2.5-flash"
# This name MUST match the Authorization Name used during Gemini Enterprise registration
CLIENT_AUTH_NAME = "workspace-adk-auth"
def _get_access_token_from_context(tool_context: ToolContext) -> str:
"""Dynamically parses the user bearer token injected into the ToolContext state."""
escaped_name = re.escape(CLIENT_AUTH_NAME)
pattern = re.compile(fr"^{escaped_name}_\d+$")
state_dict = tool_context.state.to_dict() if hasattr(tool_context.state, 'to_dict') else tool_context.state
matching_keys = [k for k in state_dict.keys() if pattern.match(k)]
if matching_keys:
return state_dict.get(matching_keys[0])
raise Exception(f"No bearer token found in ToolContext state matching pattern {pattern.pattern}")
def auth_header_provider(tool_context: ToolContext) -> dict[str, str]:
"""Provides the dynamic Authorization header for MCP requests."""
token = _get_access_token_from_context(tool_context)
return {"Authorization": f"Bearer {token}"}
# Initialize toolsets using the dynamic header_provider
calendar_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(url="https://calendarmcp.googleapis.com/mcp/v1"),
header_provider=auth_header_provider
)
chat_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(url="https://chatmcp.googleapis.com/mcp/v1"),
header_provider=auth_header_provider
)
drive_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(url="https://drivemcp.googleapis.com/mcp/v1"),
header_provider=auth_header_provider
)
gmail_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(url="https://gmailmcp.googleapis.com/mcp/v1"),
header_provider=auth_header_provider
)
people_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(url="https://people.googleapis.com/mcp/v1"),
header_provider=auth_header_provider
)
universal_search_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(url="https://workspacemcp.googleapis.com/mcp/v1"),
header_provider=auth_header_provider
)
current_date = datetime.datetime.now().strftime("%Y-%m-%d")
root_agent = LlmAgent(
model=MODEL,
name='enterprise_ai',
instruction=f"""You are an enterprise assistant grounded securely in the user's Workspace data.
Today's current date is {current_date}. Always calculate relative dates (like 'this week' or 'upcoming meetings') using this reference.
Always use the provided MCP tools to fetch context from Calendar, Chat, Drive, Gmail, People, and search for information across multiple Google Workspace products.
If a tool returns an error indicating a timeout, inform the user that the service took too long to respond.""",
tools=[calendar_mcp, chat_mcp, drive_mcp, gmail_mcp, people_mcp, universal_search_mcp]
)
GEAP এজেন্ট রানটাইমে ডিপ্লয় করুন
ADK CLI ব্যবহার করে আপনার প্রো-কোড এজেন্ট ডিপ্লয় করুন:
adk deploy agent_engine \
--project=$(gcloud config get-value project) \
--region=us-central1 \
--display_name="Workspace ADK Agent" \
enterprise_ai
ডিপ্লয়মেন্ট শেষ হওয়া পর্যন্ত অপেক্ষা করুন এবং টার্মিনাল আউটপুট (যেমন, projects/PROJECT_ID/locations/us-central1/reasoningEngines/ENGINE_ID) থেকে জেনারেট করা Reasoning Engine রিসোর্সের নাম কপি করুন।
৬. Gemini Enterprise-এ রেজিস্টার করুন
এখন, আমরা কাস্টম ADK এজেন্টকে Gemini Enterprise-এ নিয়ে এসেছি যাতে ব্যবহারকারীরা এটির সাথে নেটিভভাবে চ্যাট করতে পারেন।
প্রোডাকশনের জন্য ক্লায়েন্ট আইডি তৈরি করুন (ওয়েব অ্যাপ্লিকেশন)
প্রোডাকশনে আপনার এজেন্ট ডিপ্লয় করতে, আপনাকে অবশ্যই একটি ওয়েব অ্যাপ্লিকেশন ক্লায়েন্ট আইডি তৈরি করতে হবে। লোকাল টেস্টিংয়ের জন্য ব্যবহৃত ডেস্কটপ ক্লায়েন্টের মতো নয়, ওয়েব অ্যাপ্লিকেশন ক্লায়েন্ট একটি সুরক্ষিত, সার্ভার-সাইড OAuth ফ্লো চালু করে। এটি GEAP Agent Runtime-এ হোস্ট করা এজেন্টকে নির্দিষ্ট করা রিডাইরেক্ট URI ব্যবহার করে Gemini Enterprise-এর মাধ্যমে ফরওয়ার্ড করা ব্যবহারকারীর যাচাইকরণ টোকেন নিরাপদে গ্রহণ করার অনুমতি দেয়। প্রোডাকশন এনভায়রনমেন্টে ব্যবহারকারীর হয়ে এজেন্টের Google Workspace ডেটা নিরাপদে অ্যাক্সেস করার জন্য এই সেট-আপ প্রয়োজন।
- Google Cloud কনসোলে, উপরে বাঁদিকের কোণে নেভিগেশন মেনু (হ্যামবার্গার আইকন) বিকল্পে ক্লিক করুন। Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট (অথবা Google Auth প্ল্যাটফর্ম দেখতে না পেলে, API ও পরিষেবা > ক্রেডেনশিয়াল) বেছে নিন। ক্লায়েন্ট তৈরি করুন (অথবা ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি) বিকল্পে ক্লিক করুন।
- অ্যাপ্লিকেশনের ধরন হিসেবে ওয়েব অ্যাপ্লিকেশন বেছে নিন।
- এটির নাম
Workspace Agent Productionদিন। - অনুমোদিত রিডাইরেক্ট URI বিভাগে, নিম্নলিখিত URI যোগ করুন:
- URI যোগ করুন বিকল্পে ক্লিক করে
https://vertexaisearch.cloud.google.com/oauth-redirectলিখুন। - আবার URI যোগ করুন বিকল্পে ক্লিক করে
https://vertexaisearch.cloud.google.com/static/oauth/oauth.htmlলিখুন।
- URI যোগ করুন বিকল্পে ক্লিক করে
- OAuth ক্লায়েন্টে
is_agenticক্লাসিফিকেশন ফ্ল্যাগ চালু করতে, AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন। - তৈরি করুন বিকল্পে ক্লিক করুন। "OAuth ক্লায়েন্ট তৈরি করা হয়েছে" ডায়ালগে (অথবা ক্লায়েন্ট তালিকা থেকে), ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট কপি করুন। Gemini Enterprise-এ এজেন্ট রেজিস্টার করার সময় আপনার এগুলি প্রয়োজন হবে।
Gemini Enterprise অ্যাপ তৈরি করুন
- Google Cloud কনসোলে, Gemini Enterprise পৃষ্ঠায় যান:
- Gemini Enterprise কার্ডের অধীনে, ম্যানেজ করুন বিকল্পে ক্লিক করুন।
- অ্যাপ তৈরি করুন বিকল্পে ক্লিক করুন।
- Gemini Enterprise বিভাগে, তৈরি করুন বিকল্পে ক্লিক করুন।
- আপনার অ্যাপের নাম ফিল্ডে, আপনার অ্যাপের নাম লিখুন। অ্যাপের নামের নিচে আপনার অ্যাপ আইডি দেখা যাবে।
- আপনার কোম্পানি বা সংস্থার বাইরের নাম ফিল্ডে, কোম্পানি বা সংস্থার নাম লিখুন। এই টিউটোরিয়ালের জন্য, আপনি
Cymbal Bankব্যবহার করতে পারবেন। - আপনার অ্যাপের লোকেশন হিসেবে গ্লোবাল (গ্লোবাল) বেছে নিন।
- চালিয়ে যান বিকল্পে ক্লিক করুন।
কাস্টম এজেন্ট রেজিস্টার করা
- Gemini Enterprise কনসোল খুলুন:
- আপনার অ্যাক্টিভ অ্যাপ বেছে নিন, এজেন্ট বিকল্পে নেভিগেট করুন এবং + এজেন্ট যোগ করুন > এজেন্ট রানটাইমের মাধ্যমে কাস্টম এজেন্ট যোগ করুন বিকল্পে ক্লিক করুন।
- অনুমোদন বিভাগে, অনুমোদন যোগ করুন বিকল্পে ক্লিক করুন:
- অনুমোদনের নাম:
workspace-adk-auth(আপনার Python কোডে CLIENT_AUTH_NAME-এর সাথে হুবহু মিলতে হবে) - ক্লায়েন্ট আইডি: উপরে তৈরি করা প্রোডাকশন ওয়েব অ্যাপ্লিকেশন ক্লায়েন্ট আইডি পেস্ট করুন।
- ক্লায়েন্ট সিক্রেট: উপরে তৈরি করা প্রোডাকশন ওয়েব অ্যাপ্লিকেশন ক্লায়েন্ট সিক্রেট পেস্ট করুন।
- টোকেন URI:
https://oauth2.googleapis.com/token - অনুমোদন URI: উপরে ৫ নম্বর ধাপে কপি করা ক্লায়েন্ট আইডি দিয়ে
YOUR_CLIENT_IDপরিবর্তন করে URI তৈরি করুন:https://accounts.google.com/o/oauth2/v2/auth?client_id=YOUR_CLIENT_ID&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar.events%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar.calendars%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar.readonly%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fchat.spaces%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fchat.messages%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdrive.readonly%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdrive.file%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fgmail.readonly%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fgmail.compose%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdirectory.readonly%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.profile%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcontacts.readonly%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent
- অনুমোদনের নাম:
- হয়ে গেছে বিকল্পে ক্লিক করুন, তারপর পরবর্তী বিকল্পে ক্লিক করুন।
- কনফিগারেশন বিভাগে:
- এজেন্টের নাম:
Workspace Pro Agent - বিবরণ:
Use this agent to answer questions about your Google Workspace data, including Gmail, Google Drive, Google Calendar, Google Chat, and Contacts. It can find files, summarize emails, check your schedule, and look up contact information. - এজেন্ট রানটাইম রিজনিং ইঞ্জিন:
adk deployআউটপুট থেকে কপি করা ইঞ্জিন রিসোর্সের নাম পেস্ট করুন।
- এজেন্টের নাম:
- তৈরি করুন বিকল্পে ক্লিক করুন।
Gemini Enterprise-এ Agent ব্যবহার করে দেখুন
আপনি Google Cloud Console প্রিভিউ (ডেভেলপারদের জন্য সবচেয়ে দ্রুত) অথবা Gemini Enterprise ওয়েব অ্যাপ (ব্যবহারকারীর অভিজ্ঞতা) ব্যবহার করে আপনার এজেন্টের সাথে ইন্টার্যাক্ট করতে পারবেন।
বিকল্প ১: Google Cloud Console প্রিভিউ
- Google Cloud কনসোলে, Gemini Enterprise পৃষ্ঠায় যান:
- নেভিগেশন মেনুতে, অ্যাপ বিকল্পে ক্লিক করে আপনার তৈরি করা অ্যাপটি বেছে নিন।
- প্রিভিউ বিকল্পে ক্লিক করুন অথবা উপরে ডানদিকে প্রিভিউ খুলুন বিকল্পে ক্লিক করুন।
- সার্চ বারে, নিম্নলিখিত কোয়েরি লিখুন:
Search for files in Drive related to 'Project Milestone', summarize them, and tell me if I have any meetings with the project owner today. - কোয়েরি জমা দিতে এবং সরাসরি কনসোলে ফলাফল দেখতে Enter প্রেস করুন।
বিকল্প ২: Gemini Enterprise ওয়েব অ্যাপ
- আপনার Gemini Enterprise ওয়েব অ্যাপ ইন্টারফেস খুলুন।
- মেনু ☰ > এজেন্ট বিকল্পে যান এবং আপনার সংস্থা থেকে বিকল্পের অধীনে Workspace Pro Agent বেছে নিন।
- Google Cloud Console প্রিভিউ বিকল্পে যেমন আছে ঠিক সেই রকম কোয়েরি টাইপ করুন।
- OAuth ব্যবহারকারীর সম্মতি ফ্লো সম্পূর্ণ করার জন্য প্রম্পট করা হলে অনুমোদন করুন বিকল্পে ক্লিক করুন।
- এজেন্টটি MCP প্রোটোকল ব্যবহার করে একাধিক পরিষেবা জুড়ে নির্বিঘ্নে টাস্ক এক্সিকিউট করবে!
৭. অপ্রয়োজনীয়গুলি মুছুন
অপ্রয়োজনীয় চার্জ এড়াতে, আপনার রিসোর্স ক্লিন-আপ করুন:
কনসোল বিকল্প
API ও পরিষেবা ড্যাশবোর্ড-এ যান, আপনার চালু করা MCP পরিষেবা (যেমন, Calendar MCP, Gmail MCP) বেছে নিন এবং API বন্ধ করুন বিকল্পে ক্লিক করুন। Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট থেকে OAuth ক্লায়েন্ট আইডি মুছে দিন এবং Gemini Enterprise কনসোল থেকে রিজনিং ইঞ্জিন ডেপ্লয়মেন্ট মুছে দিন।
CLI বিকল্প
MCP পরিষেবা বন্ধ করতে নিম্নলিখিত টার্মিনাল কমান্ড এক্সিকিউট করুন:
# Disable Workspace MCP services
gcloud services disable calendarmcp.googleapis.com \
chatmcp.googleapis.com \
drivemcp.googleapis.com \
gmailmcp.googleapis.com \
workspacemcp.googleapis.com
৮. অভিনন্দন
অভিনন্দন! আপনি অফিসিয়াল Google Workspace MCP সার্ভারের সাথে সরাসরি কানেক্ট করা প্রো-কোড ADK AI এজেন্ট সফলভাবে বিল্ড, টেস্ট ও ডিপ্লয় করেছেন।
আপনি যা শিখেছেন
- Google Cloud-এ Google Workspace MCP পরিষেবা কীভাবে চালু করতে হয়।
- স্ট্যাটিক হেডার ব্যবহার করে লোকাল ADK টেস্টিংয়ের জন্য OAuth ক্রেডেনশিয়াল কীভাবে ম্যানেজ করতে হয়।
- প্রোডাকশন এজেন্টের জন্য
header_providerব্যবহার করে কীভাবে ডায়নামিক টোকেন ইনজেকশন প্রয়োগ করতে হয়। - কীভাবে GEAP Agent Runtime-এ ADK এজেন্ট ডিপ্লয় করবেন এবং Gemini Enterprise-এ রেজিস্টার করবেন।