ADK এর সাথে এআই এজেন্ট তৈরি করা: ফাউন্ডেশন

1. আপনি শুরু করার আগে

"বিল্ডিং এআই এজেন্ট উইথ ADK" সিরিজের প্রথম অংশে স্বাগতম! এই হ্যান্ডস-অন কোডল্যাব সিরিজে, আপনি Google এর এজেন্ট ডেভেলপমেন্ট কিট (ADK) ব্যবহার করে আপনার নিজস্ব বুদ্ধিমান এআই এজেন্ট তৈরি করতে একটি উত্তেজনাপূর্ণ যাত্রা শুরু করবেন।

আমরা নিখুঁত প্রয়োজনীয় বিষয়গুলি দিয়ে শুরু করব, আপনার বিকাশের পরিবেশ সেট আপ করার এবং একটি মৌলিক কথোপকথন এজেন্ট তৈরি করার মাধ্যমে আপনাকে গাইড করব। এই কোডল্যাবের শেষ নাগাদ, আপনি আপনার প্রথম ইন্টারেক্টিভ এআই তৈরি করবেন, এই সিরিজের পরবর্তী অংশগুলিতে প্রসারিত করার জন্য প্রস্তুত কারণ আমরা এটিকে একটি পরিশীলিত মাল্টি-এজেন্ট সিস্টেম (MAS) এ রূপান্তরিত করব।

আপনি আপনার স্থানীয় পরিবেশে বা Google ক্লাউডে এই কোডল্যাবটি সম্পূর্ণ করতে পারেন। সবচেয়ে সামঞ্জস্যপূর্ণ অভিজ্ঞতার জন্য, আমরা Google ক্লাউড পরিবেশ থেকে ক্লাউড শেল ব্যবহার করার পরামর্শ দিই। ক্লাউড শেল $HOME ডিরেক্টরিতে 5 গিগাবাইট স্থায়ী স্টোরেজ প্রদান করে। এটি স্ক্রিপ্ট, কনফিগারেশন ফাইল বা ক্লোন করা সংগ্রহস্থল সংরক্ষণ করার জন্য দরকারী।

পূর্বশর্ত

আপনি কি শিখবেন

  • কিভাবে একটি পাইথন পরিবেশ সেট আপ করবেন
  • কিভাবে ADK ব্যবহার করে একটি সাধারণ ব্যক্তিগত সহকারী এজেন্ট তৈরি করবেন
  • কিভাবে এজেন্ট চালাতে, পরীক্ষা করতে এবং ডিবাগ করতে হয়

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

  • একটি কার্যকরী কম্পিউটার এবং নির্ভরযোগ্য ওয়াইফাই
  • একটি ব্রাউজার, যেমন Chrome , Google ক্লাউড কনসোল অ্যাক্সেস করতে
  • একটি কৌতূহলী মন এবং শেখার আগ্রহ

একটি ট্রায়াল বিলিং অ্যাকাউন্ট রিডিম করুন

এই কোডল্যাবটি সম্পূর্ণ করতে, আপনার একটি সক্রিয় Google ক্লাউড বিলিং অ্যাকাউন্টও প্রয়োজন৷ আপনার যদি এখনও একটি না থাকে, তাহলে একটি ট্রায়াল বিলিং অ্যাকাউন্ট রিডিম করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. আপনার ব্রাউজারে একটি ছদ্মবেশী উইন্ডো খুলুন
  2. এই রিডেম্পশন পোর্টালে নেভিগেট করুন
  3. আপনার ব্যক্তিগত জিমেইল অ্যাকাউন্ট ব্যবহার করে লগ ইন করুন
  4. পোর্টাল থেকে ধাপে ধাপে নির্দেশাবলী অনুসরণ করুন

2. ভূমিকা

জেনারেটিভ এআই (জেনাআই) এর বিশ্ব দ্রুত বিকশিত হচ্ছে এবং এআই এজেন্ট বর্তমানে একটি আলোচিত বিষয়। একজন এআই এজেন্ট হল একটি স্মার্ট কম্পিউটার প্রোগ্রাম যা আপনার পক্ষে কাজ করার জন্য ডিজাইন করা হয়েছে, অনেকটা একজন ব্যক্তিগত সহকারীর মতো। এটি তার ডিজিটাল পরিবেশ উপলব্ধি করতে পারে, সিদ্ধান্ত নিতে পারে এবং মানুষের সরাসরি নিয়ন্ত্রণ ছাড়াই নির্দিষ্ট লক্ষ্য অর্জনের জন্য পদক্ষেপ নিতে পারে। এটিকে একটি সক্রিয়, স্বায়ত্তশাসিত সত্তা হিসাবে ভাবুন যা শিখতে পারে এবং কাজগুলি করার জন্য মানিয়ে নিতে পারে।

এর মূল অংশে, একটি AI এজেন্ট একটি বৃহৎ ভাষা মডেল (LLM) তার "মস্তিষ্ক" হিসাবে বোঝা এবং যুক্তি ব্যবহার করে। এটি এটিকে বিভিন্ন উত্স থেকে তথ্য প্রক্রিয়া করার অনুমতি দেয়, যেমন পাঠ্য, চিত্র এবং শব্দ৷ এজেন্ট তারপর একটি পরিকল্পনা তৈরি করতে এবং একটি পূর্বনির্ধারিত লক্ষ্যে পৌঁছানোর জন্য একাধিক কাজ সম্পাদন করতে এই বোঝাপড়া ব্যবহার করে।

এজেন্ট ডেভেলপমেন্ট কিট (ADK) এর মতো রেডি-টু-ব্যবহারের ফ্রেমওয়ার্কের কারণে আপনি এখন সহজেই আপনার নিজস্ব AI এজেন্ট তৈরি করতে পারেন, এমনকি গভীর দক্ষতা ছাড়াই। আপনার কাজগুলিতে আপনাকে সাহায্য করার জন্য আমরা একটি ব্যক্তিগত সহকারী এজেন্ট তৈরি করে এই যাত্রা শুরু করব। শুরু করা যাক!

3. Google ক্লাউড পরিষেবাগুলি কনফিগার করুন৷

একটি Google ক্লাউড প্রকল্প তৈরি করুন

একটি নতুন Google ক্লাউড প্রকল্প তৈরি করে শুরু করুন যাতে এই কোডল্যাব থেকে ক্রিয়াকলাপগুলি শুধুমাত্র এই নতুন প্রকল্পের মধ্যে বিচ্ছিন্ন হয়৷

  1. console.cloud.google.com/projectcreate- এ নেভিগেট করুন
  2. প্রয়োজনীয় তথ্য লিখুন:
  • প্রকল্পের নাম - আপনি আপনার পছন্দসই যেকোনো নাম ইনপুট করতে পারেন (যেমন জেনাই-ওয়ার্কশপ)
  • অবস্থান - কোন সংস্থা হিসাবে এটি ছেড়ে দিন
  • বিলিং অ্যাকাউন্ট - আপনি যদি এই বিকল্পটি দেখতে পান, তাহলে Google ক্লাউড প্ল্যাটফর্ম ট্রায়াল বিলিং অ্যাকাউন্ট নির্বাচন করুন। আপনি যদি এই বিকল্পটি দেখতে না পান তবে চিন্তা করবেন না। শুধু পরবর্তী ধাপে এগিয়ে যান.
  1. জেনারেট করা প্রোজেক্ট আইডিটি কপি করুন, আপনার এটি পরে প্রয়োজন হবে।

c3988d2f9ea7b7c3.png

  1. সবকিছু ঠিক থাকলে Create বাটনে ক্লিক করুন

ক্লাউড শেল কনফিগার করুন

আপনার প্রকল্প সফলভাবে তৈরি হয়ে গেলে, ক্লাউড শেল সেট আপ করতে নিম্নলিখিত পদক্ষেপগুলি করুন৷

1. ক্লাউড শেল চালু করুন

shell.cloud.google.com- এ নেভিগেট করুন এবং আপনি যদি একটি পপআপ দেখতে পান যা আপনাকে অনুমোদন করতে বলছে, তাহলে অনুমোদন এ ক্লিক করুন।

d5e271ec814f5769.png

2. প্রজেক্ট আইডি সেট করুন

সঠিক প্রজেক্ট আইডি সেট করতে ক্লাউড শেল টার্মিনালে নিম্নলিখিত কমান্ডটি চালান। <your-project-id> প্রতিস্থাপন করুন উপরের প্রকল্প তৈরির ধাপ থেকে কপি করা আপনার প্রকৃত প্রকল্প আইডি দিয়ে।

gcloud config set project <your-project-id>

আপনার এখন দেখতে হবে যে ক্লাউড শেল টার্মিনালের মধ্যে সঠিক প্রকল্পটি নির্বাচন করা হয়েছে। নির্বাচিত প্রকল্প আইডি হলুদ রঙে হাইলাইট করা হয়েছে।

a596b7d3cb052d07.png

3. প্রয়োজনীয় API সক্রিয় করুন

Google ক্লাউড পরিষেবাগুলি ব্যবহার করতে, আপনাকে প্রথমে আপনার প্রকল্পের জন্য তাদের নিজ নিজ API সক্রিয় করতে হবে৷ এই কোডল্যাবের জন্য পরিষেবাগুলি সক্ষম করতে ক্লাউড শেল টার্মিনালে নীচের কমান্ডগুলি চালান:

gcloud services enable aiplatform.googleapis.com

অপারেশন সফল হলে, আপনি দেখতে পাবেন Operation/... finished successfully

4. একটি পাইথন ভার্চুয়াল পরিবেশ তৈরি করুন

পাইথন প্রকল্প শুরু করার আগে, একটি ভার্চুয়াল পরিবেশ তৈরি করা ভাল অনুশীলন। এটি প্রকল্পের নির্ভরতাকে বিচ্ছিন্ন করে, অন্যান্য প্রকল্প বা সিস্টেমের গ্লোবাল পাইথন প্যাকেজগুলির সাথে দ্বন্দ্ব প্রতিরোধ করে।

1. প্রকল্প ডিরেক্টরি তৈরি করুন এবং এটিতে নেভিগেট করুন:

mkdir ai-agents-adk
cd ai-agents-adk

2. একটি ভার্চুয়াল পরিবেশ তৈরি এবং সক্রিয় করুন:

uv venv --python 3.12
source .venv/bin/activate

আপনি দেখতে পাবেন ( ai-agents-adk ) আপনার টার্মিনাল প্রম্পট প্রিফিক্স করে, ভার্চুয়াল এনভায়রনমেন্ট সক্রিয় আছে।

aa915af1d8379132.png

3. adk পৃষ্ঠা ইনস্টল করুন

uv pip install google-adk

5. একটি এজেন্ট তৈরি করুন

আপনার পরিবেশ প্রস্তুত হলে, আপনার এআই এজেন্টের ভিত্তি তৈরি করার সময় এসেছে। আপনার এজেন্টের যুক্তি এবং কনফিগারেশন সংজ্ঞায়িত করার জন্য ADK-এর কয়েকটি ফাইলের প্রয়োজন:

  • agent.py : আপনার এজেন্টের প্রাথমিক পাইথন কোড ধারণ করে, এর নাম, এটি যে LLM ব্যবহার করে এবং মূল নির্দেশাবলী সংজ্ঞায়িত করে।
  • __init__.py : ডিরেক্টরিটিকে পাইথন প্যাকেজ হিসাবে চিহ্নিত করে, ADK কে আপনার এজেন্ট সংজ্ঞা আবিষ্কার ও লোড করতে সহায়তা করে।
  • .env : এপিআই কী, প্রজেক্ট আইডি এবং অবস্থানের মতো সংবেদনশীল তথ্য এবং কনফিগারেশন ভেরিয়েবল সংরক্ষণ করে।

এই কমান্ডটি তিনটি প্রয়োজনীয় ফাইল ধারণকারী personal_assistant নামে একটি নতুন ডিরেক্টরি তৈরি করবে।

adk create personal_assistant

কমান্ডটি কার্যকর করা হলে, আপনাকে আপনার এজেন্ট কনফিগার করার জন্য কয়েকটি বিকল্প বেছে নিতে বলা হবে।

প্রথম ধাপের জন্য, gemini-2.5-flash মডেল ব্যবহার করার জন্য বিকল্প 1 চয়ন করুন, একটি দ্রুত এবং দক্ষ মডেল কথোপকথনমূলক কাজের জন্য উপযুক্ত।

Choose a model for the root agent:
1. gemini-2.5-flash
2. Other models (fill later)
Choose model (1, 2): 1

দ্বিতীয় ধাপের জন্য, ব্যাকএন্ড পরিষেবা প্রদানকারী হিসেবে Google ক্লাউডের শক্তিশালী, পরিচালিত AI প্ল্যাটফর্ম, Vertex AI (বিকল্প 2) বেছে নিন।

1. Google AI
2. Vertex AI
Choose a backend (1, 2): 2

এর পরে, আপনাকে যাচাই করতে হবে যে বন্ধনীতে দেখানো প্রকল্প আইডি [...] সঠিকভাবে সেট করা আছে। যদি এটি হয়, এন্টার টিপুন । যদি না হয়, নিচের প্রম্পটে সঠিক প্রজেক্ট আইডিতে কী দিন:

Enter Google Cloud project ID [your-project-id]:

অবশেষে, এই কোডল্যাবের জন্য অঞ্চল হিসাবে us-central1 ব্যবহার করতে পরবর্তী প্রশ্নে Enter টিপুন

Enter Google Cloud region [us-central1]:

আপনি আপনার টার্মিনালে একটি অনুরূপ আউটপুট দেখতে হবে.

Agent created in /home/<your-username>/ai-agent-adk/personal_assistant:
- .env
- __init__.py
- agent.py

6. এজেন্ট কোড অন্বেষণ করুন

তৈরি করা ফাইলগুলি দেখতে, ক্লাউড শেল এডিটরে ai-agents-adk ফোল্ডারটি খুলুন।

  • উপরের মেনুতে ফাইল > ফোল্ডার খুলুন... এ ক্লিক করুন।
  • ai-agents-adk ফোল্ডারটি খুঁজুন এবং নির্বাচন করুন
  • ওকে ক্লিক করুন।

যদি উপরের মেনু বারটি আপনার জন্য উপস্থিত না হয়, আপনি ফোল্ডার আইকনে ক্লিক করতে পারেন এবং ফোল্ডার খুলুন নির্বাচন করতে পারেন।

733f215484b2ee7d.png

এডিটর উইন্ডো সম্পূর্ণরূপে লোড হয়ে গেলে, ব্যক্তিগত-সহকারী ফোল্ডারে নেভিগেট করুন। আপনি উপরে উল্লিখিত প্রয়োজনীয় ফাইলগুলি দেখতে পাবেন ( agent.py , __init__.py , এবং .env )।

.env ফাইলটি প্রায়ই ডিফল্টরূপে লুকানো থাকে। ক্লাউড শেল এডিটরে এটি দৃশ্যমান করতে:

  • উপরের মেনু বারে যান,
  • ভিউ এ ক্লিক করুন, এবং
  • লুকানো ফাইল টগল করুন নির্বাচন করুন।

a3a4e5587e8ed302.png

প্রতিটি ফাইলের বিষয়বস্তু অন্বেষণ করুন.

agent.py

এই ফাইলটি google.adk.agents লাইব্রেরি থেকে Agent ক্লাস ব্যবহার করে আপনার এজেন্টকে ইনস্ট্যান্টিয়েট করে।

from google.adk.agents import Agent

root_agent = Agent(
    model='gemini-2.5-flash',
    name='root_agent',
    description='A helpful assistant for user questions.',
    instruction='Answer user questions to the best of your knowledge',
)
  • from google.adk.agents import Agent : এই লাইনটি ADK লাইব্রেরি থেকে প্রয়োজনীয় Agent ক্লাস আমদানি করে।
  • root_agent = Agent(...) : এখানে, আপনি আপনার AI এজেন্টের একটি উদাহরণ তৈরি করছেন।
  • name="root_agent" : আপনার এজেন্টের জন্য একটি অনন্য শনাক্তকারী। এইভাবে ADK চিনবে এবং আপনার এজেন্টকে রেফার করবে।
  • model="gemini-2.5-flash" : এই গুরুত্বপূর্ণ প্যারামিটারটি নির্দিষ্ট করে যে কোন বড় ভাষা মডেল (LLM) আপনার এজেন্ট বুঝতে, যুক্তি এবং প্রতিক্রিয়া তৈরি করার জন্য তার অন্তর্নিহিত "মস্তিষ্ক" হিসাবে ব্যবহার করবে৷ gemini-2.5-flash কথোপকথনমূলক কাজের জন্য উপযুক্ত একটি দ্রুত এবং দক্ষ মডেল।
  • description="..." : এটি এজেন্টের উদ্দেশ্য বা ক্ষমতার একটি সংক্ষিপ্ত সারাংশ প্রদান করে। বর্ণনাটি মানুষের বোঝার জন্য বা মাল্টি-এজেন্ট সিস্টেমে অন্যান্য এজেন্টদের জন্য এই বিশেষ এজেন্ট কী করে তা বোঝার জন্য আরও বেশি। এটি প্রায়ই লগিং, ডিবাগিং বা এজেন্ট সম্পর্কে তথ্য প্রদর্শনের জন্য ব্যবহৃত হয়।
  • instruction="..." : এটি হল সিস্টেম প্রম্পট যা আপনার এজেন্টের আচরণ নির্দেশ করে এবং তার ব্যক্তিত্বকে সংজ্ঞায়িত করে। এটি এলএলএমকে বলে যে এটি কীভাবে কাজ করবে এবং এর প্রাথমিক উদ্দেশ্য কী। এই ক্ষেত্রে, এটি এজেন্টকে "সহায়ক সহকারী" হিসাবে প্রতিষ্ঠা করে। এই নির্দেশটি এজেন্টের কথোপকথন শৈলী এবং ক্ষমতা গঠনের চাবিকাঠি।

init .py

ADK কে আপনার agent.py ফাইলটি সঠিকভাবে ইম্পোর্ট করার অনুমতি দিয়ে প্যাকেজ হিসাবে personal-assistant চিনতে পাইথনের জন্য এই ফাইলটি প্রয়োজনীয়।

from . import agent
  • from . import agent : এই লাইনটি একটি আপেক্ষিক আমদানি সম্পাদন করে, পাইথনকে বর্তমান প্যাকেজের মধ্যে agent (যা agent.py এর সাথে মিলে যায়) নামের একটি মডিউল খুঁজতে বলে ( personal-assistant )। এই সাধারণ লাইনটি নিশ্চিত করে যে যখন ADK আপনার personal-assistant এজেন্ট লোড করার চেষ্টা করে, তখন এটি agent.py এ সংজ্ঞায়িত root_agent খুঁজে পেতে এবং শুরু করতে পারে। খালি থাকলেও, __init__.py py-এর উপস্থিতি যা ডিরেক্টরিটিকে একটি পাইথন প্যাকেজ করে তোলে।

.env

এই ফাইলটিতে পরিবেশ-নির্দিষ্ট কনফিগারেশন এবং সংবেদনশীল শংসাপত্র রয়েছে।

GOOGLE_GENAI_USE_VERTEXAI=1
GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
GOOGLE_CLOUD_LOCATION=YOUR_PROJECT_LOCATION
  • GOOGLE_GENAI_USE_VERTEXAI : এটি ADK কে বলে যে আপনি আপনার জেনারেটিভ AI অপারেশনের জন্য Google এর Vertex AI পরিষেবা ব্যবহার করতে চান৷ এটি Google ক্লাউডের পরিচালিত পরিষেবা এবং উন্নত মডেলগুলির সুবিধার জন্য গুরুত্বপূর্ণ৷
  • GOOGLE_CLOUD_PROJECT : এই ভেরিয়েবলটি আপনার Google ক্লাউড প্রকল্পের অনন্য শনাক্তকারীকে ধরে রাখবে৷ আপনার ক্লাউড সংস্থানগুলির সাথে আপনার এজেন্টকে সঠিকভাবে যুক্ত করতে এবং বিলিং সক্ষম করতে ADK এর এটি প্রয়োজন৷
  • GOOGLE_CLOUD_LOCATION : এটি Google ক্লাউড অঞ্চলটি নির্দিষ্ট করে যেখানে আপনার Vertex AI সংস্থানগুলি অবস্থিত (যেমন, us-central1 )৷ সঠিক অবস্থান ব্যবহার করা নিশ্চিত করে যে আপনার এজেন্ট সেই অঞ্চলের Vertex AI পরিষেবার সাথে কার্যকরভাবে যোগাযোগ করতে পারে।

7. টার্মিনালে এজেন্ট চালান

তিনটি ফাইলের জায়গায়, আপনি সরাসরি টার্মিনাল থেকে এজেন্ট চালানোর জন্য প্রস্তুত। এটি করার জন্য, টার্মিনালে নিম্নলিখিত adk run কমান্ডটি চালান:

adk run personal_assistant

সবকিছু সঠিকভাবে সেট আপ করা হলে, আপনি আপনার টার্মিনালে অনুরূপ আউটপুট দেখতে পাবেন। আপাতত সতর্কতা সম্পর্কে চিন্তা করবেন না, যতক্ষণ আপনি [user]: আপনি এগিয়ে যাওয়া ভাল।

...
Running agent personal_assistant, type exit to exit.
[user]: 
...

এগিয়ে যান এবং এজেন্টের সাথে চ্যাট করুন! "হ্যালো। আপনি আমার জন্য কি করতে পারেন?" এর মত কিছু টাইপ করুন। এবং আপনি একটি উত্তর ফিরে পেতে হবে.

...
Running agent personal_assistant, type exit to exit.
[user]: hello. What can you do for me?
[personal_assistant]: Hello! I am a large language model, trained by Google. I can do many things to help you, such as:
...

আপনি লক্ষ্য করবেন যে আউটপুট মাঝে মাঝে মার্কডাউন দিয়ে ফর্ম্যাট করা হয়, যা টার্মিনালে পড়া কঠিন হতে পারে। পরবর্তী ধাপে, আমরা আরও সমৃদ্ধ, চ্যাট-অ্যাপ্লিকেশন-এর মতো অভিজ্ঞতার জন্য ডেভেলপমেন্ট UI ব্যবহার করব।

সমস্যা সমাধান

এই API পদ্ধতির জন্য বিলিং সক্ষম করা প্রয়োজন৷

আপনি যদি একটি বার্তা পান {'message': 'This API method requires billing to be enabled'} , নিম্নলিখিতগুলি করুন:

  1. আপনি .env ফাইলে সঠিক প্রজেক্ট আইডি ব্যবহার করছেন কিনা তা পরীক্ষা করুন
  2. লিঙ্ক করা বিলিং অ্যাকাউন্টের পৃষ্ঠায় যান এবং দেখুন বিলিং অ্যাকাউন্টটি ইতিমধ্যেই লিঙ্ক করা আছে কিনা
  3. যদি না হয়, বিকল্প থেকে Google ক্লাউড প্ল্যাটফর্ম ট্রায়াল বিলিং অ্যাকাউন্ট বেছে নিন

ac71beafc7f645e.png

61c3fca79c772230.png

Vertex AI API প্রকল্পে ব্যবহার করা হয়নি

আপনি যদি {'message': 'Vertex AI API has not been used in project...'} , তাহলে টার্মিনালে এটি টাইপ করে Vertex AI API সক্রিয় করুন:

gcloud services enable aiplatform.googleapis.com

অপারেশন সফল হলে, আপনি দেখতে পাবেন Operation/... finished successfully

অন্যান্য ত্রুটি

আপনি যদি উপরে উল্লিখিত অন্য কোনো ত্রুটি পান, তাহলে ব্রাউজারে ক্লাউড শেল ট্যাবটি পুনরায় লোড করার চেষ্টা করুন (এবং অনুরোধ করা হলে পুনরায় অনুমোদন করুন)।

8. ডেভেলপমেন্ট ওয়েব UI এ এজেন্ট চালান

এজেন্ট ডেভেলপমেন্ট কিট আপনার এজেন্টকে এর ডেভেলপমেন্ট UI ব্যবহার করে একটি চ্যাট অ্যাপ্লিকেশন হিসেবে চালু করার একটি সুবিধাজনক উপায়ও অফার করে। adk run. পরিবর্তে adk web কমান্ডটি ব্যবহার করুন।

যদি আপনার টার্মিনাল এখনও adk run চালু থাকে, তাহলে এই কমান্ডটি টাইপ করার আগে এটি বন্ধ করতে exit টাইপ করুন:

adk web

আপনি টার্মিনালে একটি অনুরূপ আউটপুট দেখতে হবে:

...
INFO:     Started server process [4978]
INFO:     Waiting for application startup.

+------------------------------------------------------+
| ADK Web Server started                               |
|                                                      |
| For local testing, access at http://localhost:8000.  |
+------------------------------------------------------+

INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

বিকাশ UI অ্যাক্সেস করার জন্য আপনার কাছে দুটি বিকল্প রয়েছে:

  1. টার্মিনালের মাধ্যমে খুলুন
  • Ctrl + ক্লিক বা Cmd + লিঙ্কে ক্লিক করুন (যেমন, http://localhost:8000 ) টার্মিনালে দেখানো হয়েছে।
  1. ওয়েব প্রিভিউ এর মাধ্যমে খুলুন
  • ওয়েব প্রিভিউ বোতামে ক্লিক করুন,
  • পোর্ট পরিবর্তন নির্বাচন করুন।
  • পোর্ট নম্বর লিখুন (যেমন, 8000 )
  • পরিবর্তন এবং পূর্বরূপ ক্লিক করুন

9af437bf60562635.png

তারপরে আপনি আপনার ব্রাউজারে চ্যাট অ্যাপ্লিকেশনের মতো UI দেখতে পাবেন। এগিয়ে যান এবং এই ইন্টারফেসের মাধ্যমে আপনার ব্যক্তিগত সহকারীর সাথে চ্যাট করুন!

আপনি লক্ষ্য করবেন যে মার্কডাউন ফর্ম্যাটিং এখন সঠিকভাবে প্রদর্শিত হচ্ছে এবং এই UI আপনাকে প্রতিটি মেসেজিং ইভেন্ট, এজেন্টের অবস্থা, ব্যবহারকারীর অনুরোধ এবং আরও অনেক কিছু ডিবাগ এবং তদন্ত করতে দেয়। শুভ চ্যাটিং!

7b779b9601941a12.png

9. পরিষ্কার করুন (ঐচ্ছিক)

যেহেতু এই কোডল্যাবে কোনো দীর্ঘ-চলমান পণ্য জড়িত নয়, তাই টার্মিনালে Ctrl + C বা Cmd + C টিপে আপনার সক্রিয় এজেন্ট সেশনগুলি (যেমন, আপনার টার্মিনালে adk web ইন্সট্যান্স) বন্ধ করাই যথেষ্ট।

এজেন্ট প্রকল্প ফোল্ডার এবং ফাইল মুছুন

আপনি যদি শুধুমাত্র আপনার ক্লাউড শেল পরিবেশ থেকে কোডটি সরাতে চান তবে নিম্নলিখিত কমান্ডগুলি ব্যবহার করুন:

cd ~
rm -rf ai-agents-adk

Vertex AI API অক্ষম করুন

আগে সক্রিয় করা ভার্টেক্স AI API নিষ্ক্রিয় করতে, এই কমান্ডটি চালান:

gcloud services disable aiplatform.googleapis.com

সম্পূর্ণ Google ক্লাউড প্রকল্প বন্ধ করুন

আপনি যদি আপনার Google ক্লাউড প্রকল্প সম্পূর্ণরূপে বন্ধ করতে চান, বিস্তারিত নির্দেশাবলীর জন্য অফিসিয়াল গাইড পড়ুন।

10. উপসংহার

অভিনন্দন! আপনি সফলভাবে এজেন্ট ডেভেলপমেন্ট কিট (ADK) ব্যবহার করে একটি সাধারণ ব্যক্তিগত সহকারী এজেন্ট তৈরি করেছেন। আপনি এখন একটি ADK এজেন্টের মূল উপাদানগুলির একটি শক্ত ভিত্তি এবং বোঝার অধিকারী।

পরবর্তী পদক্ষেপ হিসেবে, আপনি আপনার এজেন্টকে রিয়েল-টাইম তথ্য অ্যাক্সেস করতে এবং বাহ্যিক পরিষেবাগুলির সাথে ইন্টারঅ্যাক্ট করার সরঞ্জামগুলি দিয়ে উল্লেখযোগ্যভাবে প্রসারিত করতে পারেন। আপনি যদি আপনার যাত্রা চালিয়ে যেতে চান, এই সিরিজের পরবর্তী কোডল্যাব, বিল্ডিং এআই এজেন্টস উইথ ADK: Epowering with Tools , আপনাকে এই প্রক্রিয়ার মাধ্যমে গাইড করবে।