১. আপনি যা শিখবেন
ADK মাস্টার ক্লাসে স্বাগতম - মাল্টি-এজেন্ট সিস্টেমে আপনার যাত্রা
আপনি এআই এজেন্টের রোমাঞ্চকর জগতে প্রবেশ করতে চলেছেন। শুধু প্রশ্নের উত্তর দেয় এমন সাধারণ চ্যাটবটকে ভুলে যান। আমরা Agent Development Kit (ADK) এর গভীরে প্রবেশ করছি অত্যাধুনিক, স্বায়ত্তশাসিত সিস্টেম তৈরি করতে, যা যুক্তি দিয়ে ভাবতে, পরিকল্পনা করতে এবং জটিল কাজ সম্পন্ন করার জন্য বিভিন্ন টুল ব্যবহার করতে পারে।
এই টিউটোরিয়ালটি শেষে আপনি যা করতে সক্ষম হবেন:
- আপনার প্রথম এআই এজেন্ট তৈরি করুন : একেবারে শূন্য থেকে একটি সম্পূর্ণ কার্যকরী এজেন্ট তৈরি করুন যা ব্যবহারকারীর চাহিদা বুঝতে পারে, গুগল সার্চের মতো টুল ব্যবহার করতে পারে এবং বিস্তারিত ও সহায়ক প্রতিক্রিয়া জানাতে পারে।
- মাল্টি-এজেন্ট সিস্টেম তৈরি করুন : "এজেন্ট-অ্যাজ-এ-টুল" প্যাটার্নটি শিখুন, এটি একটি বৈপ্লবিক ধারণা যেখানে এজেন্টরা অন্যান্য বিশেষায়িত এজেন্টদের কাছে কাজ অর্পণ করে, যার ফলে একসাথে কাজ করার জন্য এআই বিশেষজ্ঞদের একটি দল তৈরি হয়।
- জটিল ওয়ার্কফ্লো পরিচালনা করুন : সাধারণ ডেলিগেশনের বাইরে যান এবং রাউটার , সিকোয়েনশিয়াল চেইন , লুপ এবং প্যারালাল এক্সিকিউশনের মতো উন্নত প্যাটার্নগুলো আয়ত্ত করে এমন শক্তিশালী, দক্ষ এবং বুদ্ধিমান অ্যাপ্লিকেশন তৈরি করুন যা প্রায় যেকোনো অনুরোধ সামলাতে পারে।
- আপনার এজেন্টদের স্মৃতিশক্তি দিন : কথোপকথনমূলক স্মৃতির গুরুত্বপূর্ণ ভূমিকা বুঝুন, যা আপনার এজেন্টদেরকে পরবর্তী প্রশ্ন সামলাতে, মতামত থেকে শিখতে এবং একাধিক ধাপের কাজ নির্বিঘ্নে পরিচালনা করতে সক্ষম করবে।
- MCP-এর সাথে সংযোগ করুন : MCP টুলবক্সের সাথে সংযোগ করুন।
চলুন শুরু করা যাক! 🚀
২. সেটআপ: আপনার এপিআই কী সংগ্রহ করুন
গুগল এআই স্টুডিও এপিআই কী সেটআপ
আপনার যা যা লাগবে:
- পাইথন ৩.৯ বা উচ্চতর সংস্করণ (যাচাই করতে
python3 --versionব্যবহার করুন) - একটি গুগল অ্যাকাউন্ট (এআই স্টুডিও কী তৈরি করার জন্য)
- একটি টার্মিনাল — আপনার লোকাল মেশিন অথবা ক্লাউড শেল, দুটোই কাজ করে।
- ~১০ মিনিট
আমাদের এআই এজেন্টগুলোকে সক্রিয় করতে গুগল এআই স্টুডিও থেকে একটি জেমিনি এপিআই কী প্রয়োজন। এটিই কাজ শুরু করার দ্রুততম উপায়।
ধাপ ১ — এআই স্টুডিও থেকে আপনার জেমিনি এপিআই কী সংগ্রহ করুন (১ মিনিট)
- একটি নতুন ব্রাউজার ট্যাবে https://aistudio.google.com/app/apikey খুলুন।
- আপনার গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করুন।
- 'Create API key'-তে (উপরে-ডানদিকে) ক্লিক করুন।
- একটি প্রজেক্ট ড্রপডাউন সহ একটি ডায়ালগ বক্স খোলে:
- আপনার যদি আগে থেকেই একটি গুগল প্রজেক্ট তৈরি করা থাকে: সেটি নির্বাচন করুন এবং 'বিদ্যমান প্রজেক্টে এপিআই কী তৈরি করুন' এ ক্লিক করুন।
- তালিকায় না থাকলে: "প্রজেক্ট তৈরি করুন" এ ক্লিক করুন।
- যে API কী-টি দেখা যাবে, সেটি কপি করুন । এটি
AIza...দিয়ে শুরু হয় এবং এতে প্রায় ৪০টি অক্ষর থাকে।
✏️ এটি একটি নিরাপদ জায়গায় লাগিয়ে রাখুন — নিচের ৪ নং ধাপে আপনার এটি প্রয়োজন হবে।
ধাপ ২ — রিপোজিটরি ক্লোন করুন (১ মিনিট)
👉💻 আপনার টার্মিনাল (বা ক্লাউড শেল) খুলুন এবং টিউটোরিয়াল রিপোটি ক্লোন করুন:
git clone https://github.com/cuppibla/adk_tutorial.git
cd ~/adk_tutorial
ধাপ ৩ — ভার্চুয়াল এনভায়রনমেন্ট তৈরি করুন এবং ডিপেন্ডেন্সিগুলো ইনস্টল করুন
👉💻 .adk_env নামের একটি ভার্চুয়াল এনভায়রনমেন্ট তৈরি ও সক্রিয় করুন, তারপর ডিপেন্ডেন্সিগুলো ইনস্টল করুন:
python3 -m venv .adk_env
source .adk_env/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
আপনার টার্মিনাল প্রম্পটের শুরুতে (.adk_env) দেখতে পাবেন।
ধাপ ৪ — 🔥 গুরুত্বপূর্ণ: আপনার API কী যোগ করুন
⚠️ Don't skip this step! Create a .env file in the root of the adk_tutorial folder. This one file powers every session in this codelab — the ADK Web sessions (1–5) and the command-line Memory and MCP sessions (6–7) all read it automatically.
👉💻 আপনার কী (key) দিয়ে .env ফাইলটি তৈরি করুন (এখানে your_actual_api_key_here এর জায়গায় ধাপ ১-এর কী-টি বসান):
cat > .env <<'EOF'
GOOGLE_GENAI_USE_VERTEXAI=FALSE
GOOGLE_API_KEY=your_actual_api_key_here
EOF
আপনার ~/adk_tutorial/.env এখন নিম্নলিখিত বিষয়গুলো থাকা উচিত:
GOOGLE_GENAI_USE_VERTEXAI=FALSE
GOOGLE_API_KEY=your_actual_api_key_here
🚨 অত্যন্ত গুরুত্বপূর্ণ : your_actual_api_key_here জায়গায় ধাপ ১ থেকে পাওয়া আপনার আসল API কী-টি বসান (এটি AIza... দিয়ে শুরু হয়)।
✅ চেকমার্ক: আপনার ~/adk_tutorial/.env এ একটি .env ফাইল আছে, যাতে আপনার AIza... কী-টি রয়েছে, এবং আপনার টার্মিনাল প্রম্পটে (.adk_env) দেখাচ্ছে। আপনি এজেন্ট বিল্ড করার জন্য প্রস্তুত!
৩. সেশন ১: ADK ওয়েবে আপনার প্রথম এজেন্ট
নিম্নলিখিত কমান্ডটি চালিয়ে ADK ওয়েব খুলুন:
cd ~/adk_tutorial
source .adk_env/bin/activate
adk web
কমান্ডগুলো চালানোর পর, আপনার টার্মিনালে এই ধরনের একটি আউটপুট দেখতে পাবেন যা নির্দেশ করবে যে ADK ওয়েব সার্ভারটি চালু হয়েছে:
+-----------------------------------------------------------------------------+
| ADK Web Server started |
| |
| For local testing, access at http://localhost:8000. |
+-----------------------------------------------------------------------------+
INFO: Application startup complete.
INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
👉 এরপর, ADK Dev UI অ্যাক্সেস করতে আপনার ব্রাউজারে http://localhost:8000 খুলুন।
👉 আপনার আহ্বান পর্ব সম্পন্ন হয়েছে এবং এজেন্টটি এখন চালু আছে। আপনার ব্রাউজারে থাকা ADK Dev UI-টিই হলো ফ্যামিলিয়ারের সাথে আপনার সরাসরি সংযোগ।
আপনার প্রথম এজেন্ট বেছে নিন। UI-এর উপরের ড্রপডাউন মেনু থেকে a_single_agent নির্বাচন করুন।
আপনি এখানে a_single_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art.
৪. সেশন ২: ওয়ার্কফ্লো এজেন্ট: সিকোয়েনশিয়াল এজেন্ট, প্যারালাল এজেন্ট, লুপ এজেন্ট
সমান্তরাল এজেন্ট
UI-এর উপরের ড্রপডাউন মেনু থেকে b2_parallel_agent নির্বাচন করুন b2_parallel_agent
👉 পরীক্ষার নির্দেশিকা:
Plan my trip to San Francisco, I want to find some good concert, restaurant and museum.
আপনি এখানে b2_parallel_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
ক্রমিক এজেন্ট
সিকোয়েনশিয়াল ওয়ার্কফ্লো এজেন্ট নির্বাচন করতে , UI-এর উপরের ড্রপডাউন মেনু থেকে b1_sequential_agent বেছে নিন।
👉 পরীক্ষার নির্দেশিকা:
Find a good sushi near Standford and tell me how to get there.
আপনি এখানে b1_sequential_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
লুপ এজেন্ট
UI-এর উপরের ড্রপডাউন মেনু থেকে b3_loop_agent নির্বাচন করুন b3_loop_agent
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco today.
আপনি এখানে b3_loop_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৫. সেশন ৩: কাস্টম এজেন্ট
আপনার ADK ওয়েব UI খুলে গেলে, ড্রপডাউন থেকে c_custom_agent নির্বাচন করুন।
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art. Make sure within budget of 100 dollars.
আপনি এখানে c_custom_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৬. সেশন ৪: অর্কেস্ট্রেটর প্যাটার্ন - রাউটিং এজেন্ট
আপনার ADK ওয়েব UI খুলে গেলে, ড্রপডাউন থেকে d_routing_agent নির্বাচন করুন।
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love concert, restaurant and museum.
আপনি এখানে d_routing_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৭. অধিবেশন ৫: হাতিয়ার হিসেবে এজেন্ট
আপনার ADK ওয়েব UI খুলে গেলে, ড্রপডাউন থেকে e_agent_as_tool নির্বাচন করুন।
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love concert, restaurant and museum.
আপনি এখানে e_agent_as_tool নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৮. অধিবেশন ৬: দীর্ঘমেয়াদী স্মৃতিসম্পন্ন এজেন্ট
👉💻 আপনার দীর্ঘমেয়াদী স্মৃতিশক্তি পরীক্ষা করতে ফোল্ডারটিতে যান এবং রানার ব্যবহার করে এজেন্টটিকে চালু করুন:
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/f_agent_with_memory
python main.py
👉 পরীক্ষার নির্দেশিকা:
I like Art and Italian food.
তারপর Ctrl+C চেপে সেশনটি শেষ করুন। সেশনটি পুনরায় চালু করুন:
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/f_agent_with_memory
python main.py
👉 পরীক্ষার নির্দেশিকা:
Plan a trip to San Francisco based on my preference.
৯. সেশন ৭: এমসিপি-এর মাধ্যমে আপনার এজেন্টকে ক্ষমতায়ন করুন
ধাপ ১: স্থানীয় ডেটাবেস প্রস্তুত করুন
👉💻 রিপো রুট থেকে, নমুনা ডেটাবেসটি তৈরি করুন:
cd ~/adk_tutorial
source .adk_env/bin/activate
chmod +x setup_trip_database.py
./setup_trip_database.py
এটি ~/adk_tutorial/ -এ destinations.db তৈরি করে।
ধাপ ২: এমসিপি টুলবক্স সার্ভার ইনস্টল এবং চালু করুন
👉💻 আপনার অপারেটিং সিস্টেমের জন্য MCP টুলবক্স বাইনারিটি ডাউনলোড করুন :
cd ~/adk_tutorial/mcp_tool_box
export VERSION=0.16.0
# Choose the line that matches your machine:
export OS=linux/amd64 # Cloud Shell or Linux (x86_64)
# export OS=darwin/arm64 # macOS Apple Silicon (M1/M2/M3)
# export OS=darwin/amd64 # macOS Intel
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/$OS/toolbox
ডাউনলোড শেষ হলে, এবং তারপর চালান
chmod +x toolbox
ধাপ ৩
একটি টার্মিনালে নিম্নলিখিত কমান্ডটি চালান (এটি চালু রাখুন — এজেন্টটি http://127.0.0.1:7001 ঠিকানায় এর সাথে সংযোগ স্থাপন করে):
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/mcp_tool_box
./toolbox --tools-file "trip_tools.yaml" --port 7001
অন্য একটি টার্মিনালে নিম্নলিখিত কমান্ডটি চালান।
cd ~/adk_tutorial
source .adk_env/bin/activate
cd ~/adk_tutorial/g_agents_mcp
python main.py
👉 পরীক্ষার প্রশ্ন (নমুনা ডেটাবেসে থাকা শহরগুলো ব্যবহার করুন — প্যারিস, রোম, নিউ ইয়র্ক, বা টোকিও):
What are the top-rated things to do in Tokyo?
Show me the museums in Rome.
What can I do in New York for under 25 dollars?