১. তুমি যা শিখবে
ADK মাস্টার ক্লাসে স্বাগতম - মাল্টি-এজেন্ট সিস্টেমে আপনার যাত্রা
তুমি এখন এআই এজেন্টদের রোমাঞ্চকর জগতে পা রাখতে যাচ্ছ। শুধু প্রশ্নের উত্তর দেওয়া সহজ চ্যাটবটগুলো ভুলে যাও। আমরা Agent Development Kit (ADK) এর গভীরে ডুব দিচ্ছি যাতে জটিল কাজ সম্পন্ন করার জন্য যুক্তি, পরিকল্পনা এবং সরঞ্জাম ব্যবহার করে অত্যাধুনিক, স্বায়ত্তশাসিত সিস্টেম তৈরি করা যায়।
এই টিউটোরিয়ালের শেষে, আপনি সক্ষম হবেন:
- আপনার প্রথম এআই এজেন্ট তৈরি করুন : শূন্য থেকে সম্পূর্ণরূপে কার্যকরী এজেন্টে যান যা ব্যবহারকারীর চাহিদা বুঝতে পারে, গুগল সার্চের মতো সরঞ্জাম ব্যবহার করতে পারে এবং বিস্তারিত, সহায়ক প্রতিক্রিয়া তৈরি করতে পারে।
- মাল্টি-এজেন্ট সিস্টেম তৈরি করুন : "এজেন্ট-অ্যাজ-এ-টুল" প্যাটার্নটি শিখুন, এটি একটি বিপ্লবী ধারণা যেখানে এজেন্টরা অন্যান্য বিশেষায়িত এজেন্টদের কাছে কাজ অর্পণ করে, এআই বিশেষজ্ঞদের একটি দল তৈরি করে যারা একসাথে কাজ করে।
- জটিল কর্মপ্রবাহ পরিচালনা করুন : সাধারণ প্রতিনিধিত্বের বাইরে যান এবং রাউটার , সিকোয়েন্সিয়াল চেইন , লুপ এবং প্যারালাল এক্সিকিউশনের মতো উন্নত প্যাটার্নগুলিতে দক্ষতা অর্জন করুন যাতে প্রায় যেকোনো অনুরোধ পরিচালনা করতে পারে এমন শক্তিশালী, দক্ষ এবং বুদ্ধিমান অ্যাপ্লিকেশন তৈরি করা যায়।
- আপনার এজেন্টদের স্মৃতি দিন : কথোপকথনমূলক স্মৃতির গুরুত্বপূর্ণ ভূমিকাটি বুঝুন, যা আপনার এজেন্টদের ফলো-আপ প্রশ্নগুলি পরিচালনা করতে, প্রতিক্রিয়া থেকে শিখতে এবং বহু-পদক্ষেপের কাজগুলি নির্বিঘ্নে পরিচালনা করতে সক্ষম করে।
- MCP এর সাথে সংযোগ করুন : MCP টুলবক্সের সাথে সংযোগ করুন।
চল শুরু করি! 🚀
2. GCP এবং Gemini API কী সেটআপ করুন
আপনার GCP প্রকল্প এবং জেমিনি API কী সেট আপ করা হচ্ছে
আমাদের এআই এজেন্টদের শক্তিশালী করার জন্য, আমাদের দুটি জিনিসের প্রয়োজন: ভিত্তি প্রদানের জন্য একটি গুগল ক্লাউড প্রজেক্ট এবং গুগলের শক্তিশালী মডেলগুলি অ্যাক্সেস করার জন্য একটি জেমিনি এপিআই কী।
ধাপ ১: বিলিং অ্যাকাউন্ট সক্ষম করুন
- ৫ ডলার ক্রেডিট দিয়ে আপনার বিলিং অ্যাকাউন্ট দাবি করার জন্য, আপনার এটি স্থাপনের জন্য প্রয়োজন হবে। আপনার জিমেইল অ্যাকাউন্টটি নিশ্চিত করুন।
ধাপ ২: একটি নতুন জিসিপি প্রকল্প তৈরি করুন
- গুগল ক্লাউড কনসোলে যান এবং একটি নতুন প্রকল্প তৈরি করুন।
- গুগল ক্লাউড কনসোলে যান এবং একটি নতুন প্রকল্প তৈরি করুন।
- বাম প্যানেলটি খুলুন,
Billingক্লিক করুন, বিলিং অ্যাকাউন্টটি এই জিসিপি অ্যাকাউন্টের সাথে লিঙ্ক করা আছে কিনা তা পরীক্ষা করুন।
যদি আপনি এই পৃষ্ঠাটি দেখেন, তাহলে manage billing account চেক করুন, Google Cloud Trial One নির্বাচন করুন এবং এর সাথে লিঙ্ক করুন।
ধাপ ৩: আপনার Google Cloud Project ID খুঁজুন
👉গুগল ক্লাউড কনসোলের উপরে অ্যাক্টিভেট ক্লাউড শেল-এ ক্লিক করুন (এটি ক্লাউড শেল প্যানের উপরে টার্মিনাল আকৃতির আইকন), 
👉"Open Editor" বোতামে ক্লিক করুন (এটি দেখতে পেন্সিল দিয়ে খোলা ফোল্ডারের মতো)। এটি উইন্ডোতে Cloud Shell Code Editor খুলবে। আপনি বাম দিকে একটি ফাইল এক্সপ্লোরার দেখতে পাবেন। 
👉আপনার গুগল ক্লাউড প্রজেক্ট আইডি খুঁজুন:
- গুগল ক্লাউড কনসোল খুলুন: লিঙ্ক
- পৃষ্ঠার উপরে প্রজেক্ট ড্রপ ডাউন থেকে এই কর্মশালার জন্য আপনি যে প্রকল্পটি ব্যবহার করতে চান তা নির্বাচন করুন।
- আপনার প্রজেক্ট আইডি ড্যাশবোর্ডের প্রজেক্ট তথ্য কার্ডে প্রদর্শিত হবে।
👉💻 টার্মিনালে, নিম্নলিখিত কমান্ড ব্যবহার করে যাচাই করুন যে আপনি ইতিমধ্যেই প্রমাণীকরণপ্রাপ্ত এবং প্রকল্পটি আপনার প্রকল্প আইডিতে সেট করা আছে:
gcloud auth list
👉💻 GitHub থেকে বুটস্ট্র্যাপ প্রকল্পটি ক্লোন করুন:
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 অ্যাক্সেস করতে:
ক্লাউড শেল টুলবারে (সাধারণত উপরে ডানদিকে) ওয়েব প্রিভিউ আইকন থেকে (প্রায়শই চোখ বা তীরযুক্ত বর্গক্ষেত্রের মতো দেখায়), পরিবর্তন পোর্ট নির্বাচন করুন। পপ-আপ উইন্ডোতে, পোর্টটি 8000 এ সেট করুন এবং " পরিবর্তন এবং পূর্বরূপ " এ ক্লিক করুন। ক্লাউড শেল এরপর ADK ডেভ UI প্রদর্শন করে একটি নতুন ব্রাউজার ট্যাব বা উইন্ডো খুলবে।
👉 আপনার তলব করার রীতি সম্পন্ন হয়েছে, এবং এজেন্ট এখন চলছে। আপনার ব্রাউজারে ADK ডেভ UI হল Familiar-এর সাথে আপনার সরাসরি সংযোগ।
সমান্তরাল ওয়ার্কফ্লো এজেন্ট নির্বাচন করুন UI এর শীর্ষে ড্রপডাউন মেনুতে, parallel_agent নির্বাচন করুন।
আপনি এখানে single_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিং দেখতে পারেন: 
👉 পরীক্ষার প্রম্পট:
Plan a trip from Sunnyvale to San Francisco this weekend, I love food and art.
৪. সেশন ২: ওয়ার্কফ্লো এজেন্ট: সিকোয়েন্সিয়াল এজেন্ট, প্যারালাল এজেন্ট, লুপ এজেন্ট
সমান্তরাল এজেন্ট
সমান্তরাল ওয়ার্কফ্লো এজেন্ট নির্বাচন করুন UI এর শীর্ষে ড্রপডাউন মেনুতে, parallel_agent নির্বাচন করুন।
👉 পরীক্ষার প্রম্পট:
Plan my trip to San Francisco, I want to find some good concert, restaurant and museum.
আপনি এখানে parallel_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিং দেখতে পারেন: 
সিকোয়েন্সিয়াল এজেন্ট
সিকুয়েন্সিয়াল ওয়ার্কফ্লো এজেন্ট নির্বাচন করুন। UI এর উপরে ড্রপডাউন মেনুতে, sequential_agent নির্বাচন করুন।
👉 পরীক্ষার প্রম্পট:
Find a good sushi near Standford and tell me how to get there.
আপনি এখানে sequential_agent নির্বাচন করতে পারেন: 
আপনি এখানে ট্রেসিং দেখতে পারেন: 
লুপ এজেন্ট
লুপ ওয়ার্কফ্লো এজেন্ট নির্বাচন করুন UI এর উপরের ড্রপডাউন মেনুতে, 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.
৯. সেশন ৭: MCP দিয়ে আপনার এজেন্টকে ক্ষমতায়িত করুন
ধাপ ১: স্থানীয় ডাটাবেস প্রস্তুত করুন
👉💻 আপনার টার্মিনালে নিম্নলিখিত কমান্ডটি চালান
cd ~/adk_tutorial
source .adk_env/bin/activate
chmod +x setup_trip_database.py
./setup_trip_database.py
ধাপ ২: MCP টুলবক্স সার্ভার ইনস্টল এবং চালান
👉💻 আপনার টার্মিনালে নিম্নলিখিত কমান্ডটি চালান
cd ~/adk_tutorial/mcp_tool_box
export VERSION=0.16.0
curl -O https://storage.googleapis.com/genai-toolbox/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