কোডল্যাব: ক্লাউড রান ডে 2025 - সেটআপ

1. ভূমিকা

আপনি এমন একটি এজেন্ট তৈরি করবেন যিনি সংবাদ সম্পর্কিত যেকোনো প্রশ্নের উত্তর দিতে পারবেন এবং ক্লাউড রানে এটি স্থাপন করতে পারবেন। সংবাদটি কেবলমাত্র একটি অবস্থান 'বেঙ্গালুরু' সম্পর্কিত যেকোনো বিষয় সম্পর্কে হতে পারে। কিছু প্রশ্ন হতে পারে:

  • বেঙ্গালুরুর কিছু সাম্প্রতিক খবর সম্পর্কে বলতে পারেন?
  • বেঙ্গালুরু ট্র্যাফিক সম্পর্কিত কিছু সাম্প্রতিক খবর আমাকে দিন।

আপনি ক্লাউড রানে এজেন্ট স্থাপন করতে পারেন। আমরা একটি সাধারণ এজেন্ট তৈরি করব যা মডেল এবং একটি স্থানীয় টুল ব্যবহার করবে, তারপর এটি স্থাপন করবে।

তুমি কি শিখবে

  • ক্লাউড রানের জন্য গুগল ক্লাউড প্রজেক্ট কীভাবে সেট আপ করবেন।
  • গুগল এডিকে ব্যবহার করে কীভাবে একটি সাধারণ এআই এজেন্ট তৈরি করবেন।
  • এজেন্টের মধ্যে স্থানীয় সরঞ্জামগুলি কীভাবে সংজ্ঞায়িত এবং ব্যবহার করবেন।
  • ডকার ব্যবহার করে এজেন্ট কীভাবে প্যাকেজ করবেন।
  • গুগল ক্লাউড রানে এজেন্টকে কীভাবে পরিষেবা হিসেবে স্থাপন করবেন।
  • ওয়েব UI এর মাধ্যমে মোতায়েন করা এজেন্টের সাথে কীভাবে ইন্টারঅ্যাক্ট করবেন।

আপনার যা প্রয়োজন হবে

  • একটি জিমেইল অ্যাকাউন্ট
  • ক্রোম ব্রাউজার

২. গুগল ক্লাউড এনভায়রনমেন্ট সেটআপ করুন

ক্লাউড ক্রেডিট পাওয়া

আপনার গিফট ক্রেডিট দাবি করুন, আপনার ডিপ্লয়মেন্টের জন্য এটির প্রয়োজন হবে। আপনার জিমেইল অ্যাকাউন্ট ব্যবহার করতে ভুলবেন না।

একটি প্রকল্প তৈরি করুন

  1. গুগল ক্লাউড কনসোলে , প্রজেক্ট সিলেক্টর পৃষ্ঠায়, একটি গুগল ক্লাউড প্রজেক্ট নির্বাচন করুন বা তৈরি করুন।
  2. আপনার ক্লাউড প্রোজেক্টের জন্য বিলিং সক্ষম আছে কিনা তা নিশ্চিত করুন। কোনও প্রোজেক্টে বিলিং সক্ষম আছে কিনা তা কীভাবে পরীক্ষা করবেন তা শিখুন।
  3. এই লিঙ্কে ক্লিক করে ক্লাউড শেল সক্রিয় করুন।
  4. সক্রিয় অ্যাকাউন্ট সেট করতে, ক্লাউড শেলে নিম্নলিখিত কমান্ডটি চালান:
gcloud config set account <ACCOUNT>

মনে রাখবেন ACCOUNT হল আপনার জিমেইল যা আপনি গুগল ক্লাউডে সাইন ইন করার জন্য ব্যবহার করেছিলেন।

  1. ক্লাউড শেলে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার প্রমাণীকরণ পরীক্ষা করুন:
gcloud auth list
  1. নিম্নলিখিত কমান্ড ব্যবহার করে প্রকল্প আইডি নিশ্চিত করুন:
gcloud config list project
  1. প্রজেক্ট আইডি ভেরিয়েবল সেট করুন। <YOUR_PROJECT_ID> এর পরিবর্তে পূর্ববর্তী ধাপের আইডিটি ব্যবহার করুন:
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
  1. গুগল এপিআই কী সেট করুন:

https://aistudio.google.com/app/apikey ব্যবহার করে আপনার API কী তৈরি করুন এবং এখানে কীটি পেস্ট করুন:

export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
  1. প্রয়োজনীয় API গুলি সক্ষম করুন:
gcloud services enable cloudresourcemanager.googleapis.com \
    servicenetworking.googleapis.com \
    run.googleapis.com \
    cloudbuild.googleapis.com \
    artifactregistry.googleapis.com \
    aiplatform.googleapis.com \
    compute.googleapis.com \
    storage.googleapis.com

(এটি কয়েক মিনিট সময় নিতে পারে।)

ক্লাউড রান ডে ওয়ার্কশপের জন্য ক্লোন কোড নমুনা

সমস্ত কর্মশালার নমুনা কোড অ্যাক্সেস করতে, সম্পূর্ণ সংগ্রহস্থলটি ক্লোন করুন:

git clone https://github.com/shrutimantri/first-adk-agent5.git

৩. ক্লাউড রানে এজেন্ট মোতায়েন করুন

আপনার ক্লাউড শেল এডিটরে সমস্ত ফাইল প্রস্তুত হয়ে গেলে, ক্লাউড রানে পরিষেবাটি স্থাপন করতে ক্লাউড শেল টার্মিনালে নিম্নলিখিত কমান্ডগুলি কার্যকর করুন:

gcloud run deploy news-assistant-agent \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars="GOOGLE_GENAI_USE_VERTEXAI=$GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_API_KEY=$GOOGLE_API_KEY"

(প্রস্তাবিত হলে/প্রস্তাবিত হলে 'Y' টাইপ করে স্থাপনা নিশ্চিত করুন।)

৪. এজেন্ট পরীক্ষা করুন

সফলভাবে স্থাপনের পর, ক্লাউড শেল স্থাপন করা ক্লাউড রান পরিষেবার URL আউটপুট দেবে।

ক্লাউড রান সার্ভিস URL আউটপুটের স্ক্রিনশট

লিঙ্কটি খুললে, আপনি ADK ওয়েব UI ব্যবহার করে সরাসরি আপনার এজেন্টের সাথে যোগাযোগ করতে পারবেন:

ADK ওয়েব UI এর স্ক্রিনশট

৫. পরিষ্কার-পরিচ্ছন্নতা

ভবিষ্যতে চার্জ এড়াতে, আপনার তৈরি করা ক্লাউড রান পরিষেবাটি মুছে ফেলুন।

gcloud run services delete news-assistant-agent --region $REGION $GOOGLE_CLOUD_LOCATION  --quiet

৬. অভিনন্দন!

আপনি গুগল ক্লাউড রানে একটি এআই নিউজ এজেন্ট সফলভাবে তৈরি এবং স্থাপন করেছেন!