১. আপনি যা শিখবেন
ADK মাস্টার ক্লাসে স্বাগতম - মাল্টি-এজেন্ট সিস্টেমে আপনার যাত্রা
আপনি এআই এজেন্টের রোমাঞ্চকর জগতে প্রবেশ করতে চলেছেন। শুধু প্রশ্নের উত্তর দেয় এমন সাধারণ চ্যাটবটকে ভুলে যান। আমরা Agent Development Kit (ADK) এর গভীরে প্রবেশ করছি অত্যাধুনিক, স্বায়ত্তশাসিত সিস্টেম তৈরি করতে, যা যুক্তি দিয়ে ভাবতে, পরিকল্পনা করতে এবং জটিল কাজ সম্পন্ন করার জন্য বিভিন্ন টুল ব্যবহার করতে পারে।
এই টিউটোরিয়ালটি শেষে আপনি যা করতে সক্ষম হবেন:
- আপনার প্রথম এআই এজেন্ট তৈরি করুন : একেবারে শূন্য থেকে একটি সম্পূর্ণ কার্যকরী এজেন্ট তৈরি করুন যা ব্যবহারকারীর চাহিদা বুঝতে পারে, গুগল সার্চের মতো টুল ব্যবহার করতে পারে এবং বিস্তারিত ও সহায়ক প্রতিক্রিয়া জানাতে পারে।
- মাল্টি-এজেন্ট সিস্টেম তৈরি করুন : "এজেন্ট-অ্যাজ-এ-টুল" প্যাটার্নটি শিখুন, এটি একটি বৈপ্লবিক ধারণা যেখানে এজেন্টরা অন্যান্য বিশেষায়িত এজেন্টদের কাছে কাজ অর্পণ করে, যার ফলে একসাথে কাজ করার জন্য এআই বিশেষজ্ঞদের একটি দল তৈরি হয়।
- জটিল ওয়ার্কফ্লো পরিচালনা করুন : সাধারণ ডেলিগেশনের বাইরে যান এবং রাউটার , সিকোয়েনশিয়াল চেইন , লুপ এবং প্যারালাল এক্সিকিউশনের মতো উন্নত প্যাটার্নগুলো আয়ত্ত করে এমন শক্তিশালী, দক্ষ এবং বুদ্ধিমান অ্যাপ্লিকেশন তৈরি করুন যা প্রায় যেকোনো অনুরোধ সামলাতে পারে।
- আপনার এজেন্টদের স্মৃতিশক্তি দিন : কথোপকথনমূলক স্মৃতির গুরুত্বপূর্ণ ভূমিকা বুঝুন, যা আপনার এজেন্টদেরকে পরবর্তী প্রশ্ন সামলাতে, মতামত থেকে শিখতে এবং একাধিক ধাপের কাজ নির্বিঘ্নে পরিচালনা করতে সক্ষম করবে।
- MCP-এর সাথে সংযোগ করুন : MCP টুলবক্সের সাথে সংযোগ করুন।
চলুন শুরু করা যাক! 🚀
২. GCP ও Gemini API Key সেটআপ করুন
আপনার GCP প্রজেক্ট এবং জেমিনি এপিআই কী সেট আপ করা
আমাদের এআই এজেন্টদের সক্রিয় করতে দুটি জিনিস প্রয়োজন: ভিত্তি স্থাপনের জন্য একটি গুগল ক্লাউড প্রজেক্ট এবং গুগলের শক্তিশালী মডেলগুলো অ্যাক্সেস করার জন্য একটি জেমিনি এপিআই কী।
ধাপ ১: বিলিং অ্যাকাউন্ট সক্রিয় করুন
এই কোডল্যাবটি চালানোর জন্য আপনার কিছু ক্রেডিট সহ একটি বিলিং অ্যাকাউন্ট প্রয়োজন। শুরু করার জন্য এই কোডল্যাবের উপরের ব্যানার থেকে ক্রেডিট ব্যবহার করুন। আপনি যদি ইতিমধ্যেই একটি বিলিং অ্যাকাউন্টের সাথে সংযুক্ত থাকেন, তাহলে আপনি এই ধাপটি এড়িয়ে যেতে পারেন।
ধাপ ২: একটি নতুন GCP প্রজেক্ট তৈরি করুন
- গুগল ক্লাউড কনসোলে গিয়ে একটি নতুন প্রজেক্ট তৈরি করুন।
- গুগল ক্লাউড কনসোলে গিয়ে একটি নতুন প্রজেক্ট তৈরি করুন।
- বাম প্যানেল খুলুন,
Billingক্লিক করুন এবং বিলিং অ্যাকাউন্টটি এই জিসিপি অ্যাকাউন্টের সাথে লিঙ্ক করা আছে কিনা তা পরীক্ষা করুন।
আপনি যদি এই পৃষ্ঠাটি দেখতে পান, তাহলে manage billing account চেক করুন, 'Google Cloud Trial One' বেছে নিন এবং এটিকে লিঙ্ক করুন।
ধাপ ৩: আপনার গুগল ক্লাউড প্রজেক্ট আইডি খুঁজুন।
👉Google Cloud কনসোলের উপরে থাকা Activate Cloud Shell-এ ক্লিক করুন (এটি Cloud Shell পেনের উপরে থাকা টার্মিনাল আকৃতির আইকন), 
👉'ওপেন এডিটর' বোতামে (এটি দেখতে পেন্সিলসহ একটি খোলা ফোল্ডারের মতো) ক্লিক করুন। এটি উইন্ডোতে ক্লাউড শেল কোড এডিটর খুলে দেবে। আপনি বাম দিকে একটি ফাইল এক্সপ্লোরার দেখতে পাবেন। 
👉আপনার গুগল ক্লাউড প্রজেক্ট আইডি খুঁজুন:
- গুগল ক্লাউড কনসোল খুলুন: লিঙ্ক
- পৃষ্ঠার শীর্ষে থাকা প্রজেক্ট ড্রপ-ডাউন থেকে এই কর্মশালার জন্য আপনি যে প্রজেক্টটি ব্যবহার করতে চান, সেটি নির্বাচন করুন।
- আপনার প্রজেক্ট আইডি ড্যাশবোর্ডের প্রজেক্ট ইনফো কার্ডে প্রদর্শিত হয়।
👉💻 টার্মিনালে, নিম্নলিখিত কমান্ডটি ব্যবহার করে যাচাই করুন যে আপনি ইতিমধ্যেই প্রমাণীকৃত এবং প্রজেক্টটি আপনার প্রজেক্ট আইডিতে সেট করা আছে:
gcloud auth list
👉💻 গিটহাব থেকে বুটস্ট্র্যাপ প্রজেক্টটি ক্লোন করুন:
git clone https://github.com/cuppibla/adk_tutorial.git
👉💻 ইনিশিয়ালাইজেশন স্ক্রিপ্টটি চালান, এই স্ক্রিপ্টটি আপনাকে আপনার গুগল ক্লাউড প্রজেক্ট আইডি লিখতে বলবে। এবং setup_venv.sh স্ক্রিপ্টটি যখন আপনাকে আইডি লিখতে বলবে, তখন আগের ধাপে পাওয়া গুগল ক্লাউড প্রজেক্ট আইডিটি লিখুন।
cd ~/adk_tutorial
./setup_venv.sh
gcloud services enable compute.googleapis.com \
artifactregistry.googleapis.com \
run.googleapis.com \
iam.googleapis.com \
aiplatform.googleapis.com \
cloudresourcemanager.googleapis.com
৩. সেশন ১: 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 অ্যাক্সেস করতে:
ক্লাউড শেল টুলবারে (সাধারণত উপরের ডানদিকে) থাকা ওয়েব প্রিভিউ আইকন (যা প্রায়শই একটি চোখ বা তীর চিহ্নসহ একটি বর্গক্ষেত্রের মতো দেখতে হয়) থেকে 'Change port' নির্বাচন করুন। পপ-আপ উইন্ডোতে, পোর্টটি 8000-এ সেট করুন এবং ' Change and Preview'-এ ক্লিক করুন। এরপর ক্লাউড শেল একটি নতুন ব্রাউজার ট্যাব বা উইন্ডো খুলবে যেখানে ADK Dev UI প্রদর্শিত হবে।
👉 আপনার আহ্বান পর্ব সম্পন্ন হয়েছে এবং এজেন্টটি এখন চালু আছে। আপনার ব্রাউজারে থাকা ADK Dev UI-টিই হলো ফ্যামিলিয়ারের সাথে আপনার সরাসরি সংযোগ।
UI-এর উপরের ড্রপডাউন মেনু থেকে parallel_agent নির্বাচন করুন parallel_agent
আপনি এখানে single_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art.
৪. সেশন ২: ওয়ার্কফ্লো এজেন্ট: সিকোয়েনশিয়াল এজেন্ট, প্যারালাল এজেন্ট, লুপ এজেন্ট
সমান্তরাল এজেন্ট
UI-এর উপরের ড্রপডাউন মেনু থেকে parallel_agent নির্বাচন করুন parallel_agent
👉 পরীক্ষার নির্দেশিকা:
Plan my trip to San Francisco, I want to find some good concert, restaurant and museum.
আপনি এখানে parallel_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
ক্রমিক এজেন্ট
UI-এর উপরের ড্রপডাউন মেনু থেকে sequential_agent নির্বাচন করুন sequential_agent
👉 পরীক্ষার নির্দেশিকা:
Find a good sushi near Standford and tell me how to get there.
আপনি এখানে sequential_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
লুপ এজেন্ট
UI-এর উপরের ড্রপডাউন মেনু থেকে loop_agent নির্বাচন করুন loop_agent
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco today.
আপনি এখানে loop_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৫. সেশন ৩: কাস্টম এজেন্ট
আপনার ADK ওয়েব UI খুলে গেলে, আপনি Custom_Agent এজেন্টটি নির্বাচন করতে পারবেন।
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art. Make sure within budget of 100 dollars.
আপনি এখানে Custom_Agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৬. সেশন ৪: অর্কেস্ট্রেটর প্যাটার্ন - রাউটিং এজেন্ট
একবার আপনার ADK ওয়েব UI খুলে গেলে, আপনি routing_agent নির্বাচন করতে পারবেন।
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love concert, restaurant and museum.
আপনি এখানে routing_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিংটি দেখতে পারেন: 
৭. অধিবেশন ৫: হাতিয়ার হিসেবে এজেন্ট
একবার আপনার ADK ওয়েব UI খুলে গেলে, আপনি Agent_as_tool এজেন্টটি নির্বাচন করতে পারবেন।
👉 পরীক্ষার নির্দেশিকা:
Plan a trip from Sunnyvale to San Francisco this weekend, I love concert, restaurant and museum.
আপনি এখানে 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.
তারপর "crtl+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
ধাপ ২: এমসিপি টুলবক্স সার্ভার ইনস্টল এবং চালু করুন
👉💻 আপনার টার্মিনালে নিম্নলিখিত কমান্ডটি চালান
cd ~/adk_tutorial/mcp_tool_box
export VERSION=0.16.0
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox
ডাউনলোড শেষ হলে, এবং তারপর চালান
chmod +x toolbox
ধাপ ৩
একটি টার্মিনালে নিম্নলিখিত কমান্ডটি চালান।
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