Agent2UI এজেন্ট দিয়ে একটি Google Chat অ্যাপ তৈরি করুন

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কিভাবে একটি Google Workspace অ্যাড-অন তৈরি করবেন যা Google Chat-এ কাজ করে এবং Agent2UI (A2UI) প্রোটোকল ব্যবহার করে এমন একটি AI এজেন্টের সাথে ইন্টারফেস করে। আপনি Agent Development Kit (ADK) ব্যবহার করে এজেন্টটি তৈরি করেন এবং Vertex AI Agent Engine- এ হোস্ট করেন।

এআই এজেন্টরা স্বায়ত্তশাসিতভাবে তাদের পরিবেশ, যুক্তি উপলব্ধি করে এবং একটি নির্ধারিত লক্ষ্য অর্জনের জন্য জটিল, বহু-পদক্ষেপের ক্রিয়া সম্পাদন করে। এই টিউটোরিয়ালে, আপনি একটি মৌলিক এআই এজেন্ট স্থাপন করবেন যা একটি টুল থেকে প্রাপ্ত স্ট্যাটিক প্রোফাইল তথ্য ফেরত দেয়।

A2UI AI এজেন্টদেরকে অভিযোজিত, সমৃদ্ধ, ইন্টারেক্টিভ UI তৈরি করতে সক্ষম করে যা নেটিভভাবে রেন্ডার করে। এরপর আপনি UI গুলির পরিবর্তে AI এজেন্টদের যুক্তির উপর মনোযোগ দিতে পারেন।

  • A2UI এজেন্ট ব্যবহারকারীকে একটি বার্তার মাধ্যমে উত্তর দেয় যেখানে টেক্সট এবং প্রোফাইলের নাম, ছবি এবং LinkedIn বোতাম সম্বলিত একটি কার্ড থাকে।
    চিত্র ১. A2UI এজেন্ট ব্যবহারকারীকে টেক্সট এবং নাম, ছবি এবং LinkedIn বোতাম সম্বলিত একটি কার্ড দিয়ে সাড়া দেয়।
  • A2UI এজেন্টটি প্রোফাইল শিরোনামটিও ফিরিয়ে আনার জন্য আপডেট করা হয়েছে।
    চিত্র ২। A2UI এজেন্টটি প্রোফাইল শিরোনামটিও ফিরিয়ে আনার জন্য আপডেট করা হয়েছে।
  • A2UI এজেন্ট ব্যবহারকারীকে একটি বার্তার মাধ্যমে সাড়া দেয় যা কার্ডে প্রোফাইলের নাম প্রদর্শন করে।
    চিত্র ৩। A2UI এজেন্ট ব্যবহারকারীকে একটি বার্তার মাধ্যমে সাড়া দেয় যা কার্ডে প্রোফাইলের নাম প্রদর্শন করে।

নিম্নলিখিত চিত্রটি স্থাপত্য এবং বার্তাপ্রেরণের ধরণ দেখায়:

A2UI AI এজেন্টের সাহায্যে বাস্তবায়িত চ্যাট অ্যাপের স্থাপত্য।

চিত্রটিতে, একজন ব্যবহারকারী A2UI এজেন্টের সাথে বাস্তবায়িত একটি চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করছেন, তার তথ্যের প্রবাহ নিম্নরূপ:

  1. একজন ব্যবহারকারী চ্যাট অ্যাপে একটি বার্তা পাঠান, হয় সরাসরি বার্তায় অথবা চ্যাট স্পেসে।
  2. অ্যাপস স্ক্রিপ্টে অথবা HTTP এন্ডপয়েন্ট সহ একটি ওয়েব সার্ভার হিসেবে প্রয়োগ করা চ্যাট অ্যাপ লজিক বার্তাটি গ্রহণ করে এবং প্রক্রিয়া করে।
  3. Vertex AI Agent Engine এর সাথে হোস্ট করা A2UI এজেন্ট ইন্টারঅ্যাকশন গ্রহণ করে এবং প্রক্রিয়া করে।
  4. ঐচ্ছিকভাবে, চ্যাট অ্যাপ বা এআই এজেন্ট গুগল ওয়ার্কস্পেস পরিষেবা, যেমন ক্যালেন্ডার বা শিট, অথবা গুগল ম্যাপ বা ইউটিউবের মতো অন্যান্য গুগল পরিষেবার সাথে একীভূত হতে পারে।
  5. চ্যাট অ্যাপটি এআই এজেন্টের অগ্রগতি জানাতে গুগল চ্যাট এপিআই ব্যবহার করে অ্যাসিঙ্ক্রোনাসভাবে অভিযোজিত প্রতিক্রিয়া তৈরি করে এবং পাঠায়।
  6. উত্তরগুলি ব্যবহারকারীর কাছে পৌঁছে দেওয়া হয়।

উদ্দেশ্য

  • তোমার পরিবেশ ঠিক করো।
  • A2UI এজেন্ট স্থাপন করুন।
  • চ্যাট অ্যাপটি ব্যবহার করুন।
  • চ্যাট অ্যাপটি কনফিগার করুন।
  • চ্যাট অ্যাপটি পরীক্ষা করে দেখুন।

পূর্বশর্ত

আপনার পরিবেশ সেট আপ করুন

গুগল ক্লাউড এপিআই সক্ষম করুন

গুগল এপিআই ব্যবহার করার আগে, আপনাকে গুগল ক্লাউড প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি গুগল ক্লাউড প্রোজেক্টে এক বা একাধিক এপিআই চালু করতে পারেন।

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

    API গুলি সক্ষম করুন

OAuth সম্মতি স্ক্রিন কনফিগার করুন

OAuth 2.0 ব্যবহার করা সমস্ত অ্যাপের জন্য একটি সম্মতি স্ক্রিন কনফিগারেশন প্রয়োজন। আপনার অ্যাপের OAuth সম্মতি স্ক্রিন কনফিগার করার মাধ্যমে ব্যবহারকারী এবং অ্যাপ পর্যালোচকদের কাছে কী প্রদর্শিত হবে তা সংজ্ঞায়িত করা হয় এবং আপনার অ্যাপটি নিবন্ধিত হয় যাতে আপনি পরে এটি প্রকাশ করতে পারেন।

  1. গুগল ক্লাউড কনসোলে, মেনু > এ যানGoogle Auth platform > ব্র্যান্ডিং ।

    ব্র্যান্ডিং-এ যান

  2. যদি আপনি ইতিমধ্যেই কনফিগার করে থাকেন Google Auth platform, আপনি ব্র্যান্ডিং , অডিয়েন্স এবং ডেটা অ্যাক্সেসে নিম্নলিখিত OAuth কনসেন্ট স্ক্রিন সেটিংস কনফিগার করতে পারেন। যদি আপনি এমন একটি বার্তা দেখতে পান যা বলে Google Auth platform এখনও কনফিগার করা হয়নি , শুরু করুন ক্লিক করুন:
    1. অ্যাপ তথ্য এর অধীনে, অ্যাপের নামে , অ্যাপটির জন্য একটি নাম লিখুন।
    2. ব্যবহারকারীর সহায়তা ইমেল বিভাগে, এমন একটি সহায়তা ইমেল ঠিকানা বেছে নিন যেখানে ব্যবহারকারীদের সম্মতি সম্পর্কে প্রশ্ন থাকলে তারা আপনার সাথে যোগাযোগ করতে পারবেন।
    3. পরবর্তী ক্লিক করুন।
    4. অডিয়েন্স এর অধীনে, অভ্যন্তরীণ নির্বাচন করুন।
    5. পরবর্তী ক্লিক করুন।
    6. যোগাযোগের তথ্য এর অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে অবহিত করা যেতে পারে।
    7. পরবর্তী ক্লিক করুন।
    8. Finish এর অধীনে, Google API পরিষেবা ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে আমি Google API পরিষেবাগুলিতে সম্মত: ব্যবহারকারীর ডেটা নীতি নির্বাচন করুন।
    9. চালিয়ে যান ক্লিক করুন।
    10. তৈরি করুন ক্লিক করুন।
  3. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace সংস্থার বাইরে ব্যবহারের জন্য একটি অ্যাপ তৈরি করবেন, তখন আপনাকে ব্যবহারকারীর ধরণটি External এ পরিবর্তন করতে হবে। তারপর আপনার অ্যাপের জন্য প্রয়োজনীয় অনুমোদনের স্কোপগুলি যোগ করুন। আরও জানতে, সম্পূর্ণ Configure OAuth সম্মতি নির্দেশিকাটি দেখুন।

গুগল ক্লাউড কনসোলে একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন

এই পদক্ষেপগুলি অনুসরণ করে Vertex AI User ভূমিকা সহ একটি নতুন পরিষেবা অ্যাকাউন্ট তৈরি করুন:

গুগল ক্লাউড কনসোল

  1. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > পরিষেবা অ্যাকাউন্ট এ যান।

    পরিষেবা অ্যাকাউন্টগুলিতে যান।

  2. পরিষেবা অ্যাকাউন্ট তৈরি করুন ক্লিক করুন।
  3. পরিষেবা অ্যাকাউন্টের বিবরণ পূরণ করুন, তারপর তৈরি করুন এবং চালিয়ে যান ক্লিক করুন।
  4. ঐচ্ছিক: আপনার Google ক্লাউড প্রোজেক্টের রিসোর্সে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা নির্ধারণ করুন। আরও বিস্তারিত জানার জন্য, রিসোর্সে অ্যাক্সেস প্রদান, পরিবর্তন এবং প্রত্যাহার দেখুন।
  5. চালিয়ে যান ক্লিক করুন।
  6. ঐচ্ছিক: এই পরিষেবা অ্যাকাউন্টের মাধ্যমে পরিচালনা এবং কার্য সম্পাদন করতে পারে এমন ব্যবহারকারী বা গোষ্ঠীগুলি লিখুন। আরও বিস্তারিত জানার জন্য, পরিষেবা অ্যাকাউন্ট ছদ্মবেশ পরিচালনা দেখুন।
  7. সম্পন্ন ক্লিক করুন। পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানাটি লিখে রাখুন।

জিক্লাউড সিএলআই

  1. পরিষেবা অ্যাকাউন্ট তৈরি করুন: 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. ঐচ্ছিক: আপনার Google ক্লাউড প্রোজেক্টের রিসোর্সে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা নির্ধারণ করুন। আরও বিস্তারিত জানার জন্য, রিসোর্সে অ্যাক্সেস প্রদান, পরিবর্তন এবং প্রত্যাহার দেখুন।

পরিষেবা অ্যাকাউন্টটি পরিষেবা অ্যাকাউন্ট পৃষ্ঠায় প্রদর্শিত হবে।

একটি ব্যক্তিগত কী তৈরি করুন

পরিষেবা অ্যাকাউন্টের জন্য একটি ব্যক্তিগত কী তৈরি এবং ডাউনলোড করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

  1. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > পরিষেবা অ্যাকাউন্ট এ যান।

    পরিষেবা অ্যাকাউন্টগুলিতে যান।

  2. আপনার পরিষেবা অ্যাকাউন্ট নির্বাচন করুন।
  3. কী > কী যোগ করুন > নতুন কী তৈরি করুন ক্লিক করুন।
  4. JSON নির্বাচন করুন, তারপর Create এ ক্লিক করুন।

    আপনার নতুন পাবলিক/প্রাইভেট কী জোড়া তৈরি করা হয়েছে এবং আপনার মেশিনে একটি নতুন ফাইল হিসেবে ডাউনলোড করা হয়েছে। ডাউনলোড করা JSON ফাইলটি আপনার কার্যকরী ডিরেক্টরিতে credentials.json হিসেবে সংরক্ষণ করুন। এই ফাইলটি এই কী-এর একমাত্র কপি। আপনার কী কীভাবে নিরাপদে সংরক্ষণ করবেন সে সম্পর্কে তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট কী পরিচালনা করা দেখুন।

  5. বন্ধ করুন ক্লিক করুন।

পরিষেবা অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, Google Cloud IAM ডকুমেন্টেশনে পরিষেবা অ্যাকাউন্টগুলি দেখুন।

A2UI এজেন্ট স্থাপন করুন

  1. যদি আপনি তা না করে থাকেন, তাহলে আপনার Google Cloud অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করুন এবং আপনার Google Cloud প্রকল্পটি ব্যবহার করার জন্য Google Cloud CLI কনফিগার করুন।

    gcloud auth application-default login
gcloud config set project PROJECT_ID
gcloud auth application-default set-quota-project PROJECT_ID

    আপনার ক্লাউড প্রোজেক্টের আইডি দিয়ে PROJECT_ID প্রতিস্থাপন করুন।

  2. এই বোতামটি ব্যবহার করে googleworkspace/add-ons-samples GitHub সংগ্রহস্থলটি ডাউনলোড করুন:

    সংগ্রহস্থল ডাউনলোড করুন

  3. আপনার পছন্দের স্থানীয় ডেভেলপমেন্ট পরিবেশে, ডাউনলোড করা আর্কাইভ ফাইলটি বের করুন এবং add-ons-samples/apps-script/chat/a2ui-ai-agent/a2ui ডিরেক্টরিটি খুলুন।

    unzip add-ons-samples-main.zip
cd add-ons-samples/apps-script/chat/a2ui-ai-agent/a2ui

  4. ADK এজেন্টের জন্য নিবেদিত একটি নতুন ক্লাউড স্টোরেজ বাকেট তৈরি করুন।

    gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

    নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    1. CLOUD_STORAGE_BUCKET_NAME একটি অনন্য বাকেট নাম সহ যা আপনি ব্যবহার করতে চান।
    2. আপনার ক্লাউড প্রোজেক্টের আইডি সহ PROJECT_ID ।
    3. আপনার ক্লাউড প্রকল্পের অবস্থান সহ PROJECT_LOCATION ।

  5. নিম্নলিখিত পরিবেশ ভেরিয়েবলগুলি সেট করুন:

    export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME

    নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    1. আপনার তৈরি বাকেটের নাম সহ CLOUD_STORAGE_BUCKET_NAME ।
    2. আপনার ক্লাউড প্রোজেক্টের আইডি সহ PROJECT_ID ।
    3. আপনার ক্লাউড প্রকল্পের অবস্থান সহ PROJECT_LOCATION ।

  6. ভার্চুয়াল পরিবেশ থেকে ADK এজেন্ট ইনস্টল এবং স্থাপন করুন।

    python3 -m venv myenv
source myenv/bin/activate
poetry install --with deployment
python3 deployment/deploy.py --create

  7. এজেন্ট আইডিটি পুনরুদ্ধার করুন। চ্যাট অ্যাপটি কনফিগার করার পরে এটি আপনার প্রয়োজন হবে।

    python3 deployment/deploy.py --list

চ্যাট অ্যাপ প্রজেক্ট তৈরি এবং কনফিগার করুন

  1. A2UI AI Agent Quickstart Apps Script প্রকল্পটি খুলতে নিম্নলিখিত বোতামটি ক্লিক করুন।

    প্রকল্পটি খুলুন

  2. ওভারভিউ > এ ক্লিক করুন। একটি কপি তৈরির আইকন একটি কপি তৈরি করুন ।

  3. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টে, ক্লিক করুন প্রকল্প সেটিংসের আইকন প্রজেক্ট সেটিংস > স্ক্রিপ্ট প্রোপার্টি সম্পাদনা করুন > স্ক্রিপ্ট প্রোপার্টি যোগ করুন নিম্নলিখিত স্ক্রিপ্ট প্রোপার্টি যোগ করতে:

    1. পূর্ববর্তী ধাপগুলিতে Vertex AI এজেন্ট রিসোর্স নাম সহ REASONING_ENGINE_RESOURCE_NAME কপি করা হয়েছে।
    2. পূর্ববর্তী ধাপে ডাউনলোড করা পরিষেবা অ্যাকাউন্ট থেকে JSON কী সহ SERVICE_ACCOUNT_KEY , যেমন { ... } ।

  4. স্ক্রিপ্টের বৈশিষ্ট্য সংরক্ষণ করুন ক্লিক করুন।

  5. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > সেটিংস এ যান।

    IAM এবং অ্যাডমিন সেটিংসে যান।

  6. প্রজেক্ট নম্বর ক্ষেত্রে, মানটি অনুলিপি করুন।

  7. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টে, ক্লিক করুন প্রকল্প সেটিংসের আইকন প্রকল্প সেটিংস ।

  8. গুগল ক্লাউড প্ল্যাটফর্ম (জিসিপি) প্রজেক্টের অধীনে, প্রজেক্ট পরিবর্তন করুন এ ক্লিক করুন।

  9. GCP প্রজেক্ট নম্বরে , পূর্ববর্তী ধাপগুলিতে কপি করা Google ক্লাউড প্রজেক্ট নম্বরটি পেস্ট করুন।

  10. Set project এ ক্লিক করুন। ক্লাউড প্রজেক্ট এবং অ্যাপস স্ক্রিপ্ট প্রজেক্ট এখন সংযুক্ত।

একটি পরীক্ষামূলক স্থাপনা তৈরি করুন

এই অ্যাপস স্ক্রিপ্ট প্রজেক্টের জন্য আপনার একটি ডিপ্লয়মেন্ট আইডি প্রয়োজন, যাতে আপনি পরবর্তী ধাপে এটি ব্যবহার করতে পারেন।

হেড ডিপ্লয়মেন্ট আইডি পেতে, নিম্নলিখিতগুলি করুন:

  1. চ্যাট অ্যাপ অ্যাপস স্ক্রিপ্ট প্রজেক্টে, Deploy > Test deployments এ ক্লিক করুন।
  2. হেড ডিপ্লয়মেন্ট আইডি এর অধীনে, ক্লিক করুন একটি কপি তৈরির আইকন কপি ।
  3. সম্পন্ন ক্লিক করুন।

চ্যাট অ্যাপ কনফিগার করুন

আপনার অ্যাপস স্ক্রিপ্ট ডিপ্লয়মেন্ট ব্যবহার করে, পরীক্ষার জন্য গুগল চ্যাট অ্যাপটি ডিপ্লয় করতে এই ধাপগুলি অনুসরণ করুন:

  1. কনসোলে , Google Chat API অনুসন্ধান করুন এবং Google Chat API এ ক্লিক করুন।
  2. পরিচালনা করুন- এ ক্লিক করুন।

  3. কনফিগারেশনে ক্লিক করুন এবং চ্যাট অ্যাপ সেট আপ করুন:

    1. অ্যাপের নাম ক্ষেত্রে, A2UI Quickstart লিখুন।
    2. Avatar URL ক্ষেত্রে, https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png লিখুন।
    3. বর্ণনা ক্ষেত্রে, A2UI Quickstart লিখুন।
    4. কার্যকারিতার অধীনে, Join spaces and group conversations নির্বাচন করুন।
    5. সংযোগ সেটিংসের অধীনে, অ্যাপস স্ক্রিপ্ট প্রজেক্ট নির্বাচন করুন।
    6. ডিপ্লয়মেন্ট আইডি ফিল্ডে, আপনার পূর্বে কপি করা হেড ডিপ্লয়মেন্ট আইডিটি পেস্ট করুন।
    7. দৃশ্যমানতার অধীনে, আপনার ডোমেনের নির্দিষ্ট ব্যক্তি এবং গোষ্ঠী নির্বাচন করুন এবং আপনার ইমেল লিখুন।

  4. সংরক্ষণ করুন ক্লিক করুন।

চ্যাট অ্যাপটি মেসেজের উত্তর দেওয়ার জন্য প্রস্তুত।

চ্যাট অ্যাপটি পরীক্ষা করুন

আপনার চ্যাট অ্যাপটি পরীক্ষা করতে, চ্যাট অ্যাপের মাধ্যমে একটি সরাসরি বার্তা স্থান খুলুন এবং একটি বার্তা পাঠান:

  1. বিশ্বস্ত পরীক্ষক হিসেবে নিজেকে যোগ করার সময় যে Google Workspace অ্যাকাউন্টটি দিয়েছিলেন, সেটি ব্যবহার করে Google Chat খুলুন।

    গুগল চ্যাটে যান

  2. নতুন চ্যাট এ ক্লিক করুন।
  3. ১ বা তার বেশি লোক যোগ করুন ফিল্ডে, আপনার চ্যাট অ্যাপের নাম টাইপ করুন।

  4. ফলাফল থেকে আপনার চ্যাট অ্যাপটি নির্বাচন করুন। একটি সরাসরি বার্তা খুলবে।

  5. অ্যাপের নতুন সরাসরি বার্তায়, Hello! টাইপ করুন এবং enter টিপুন।

    চ্যাট অ্যাপটি শুভেচ্ছা বার্তা এবং প্রোফাইল নাম, ছবি এবং লিঙ্কডইন বোতাম সম্বলিত একটি কার্ড সহ একটি বার্তার উত্তর দেয়।

  6. প্রোফাইল শিরোনামটিও ফেরত দিতে A2UI এজেন্টের বাস্তবায়ন আপডেট করুন।

    আপনার স্থানীয় ডেভেলপমেন্ট পরিবেশে, a2ui/agent.py ফাইলটি খুলুন এবং যে টুলটি ফেরত পাঠানো ডেটাতে শিরোনাম যোগ করে সেই লাইনটি আনকমেন্ট করুন।

    অ্যাপস-স্ক্রিপ্ট/চ্যাট/a2ui-ai-এজেন্ট/a2ui/a2ui/agent.py
    # Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""A2UI agent."""

from google.adk.agents import LlmAgent
from google.adk.tools.tool_context import ToolContext
import json

# The schema for any A2UI message. This never changes.
from .a2ui_schema import A2UI_SCHEMA

def get_user_profile(tool_context: ToolContext) -> str:
    """Call this tool to get the current user profile."""
    return json.dumps({
        "name": "Pierrick Voulet",
        # "title": "DevRel Engineer @ Google Workspace | Gen AI & AI Agents & Agentic AI | Automation & Digital Transformation",
        "imageUrl": "https://io.google/2024/speakers/3ea87822-3160-4d54-89dd-57e185085f79_240.webp",
        "linkedin": "https://www.linkedin.com/in/pierrick-voulet/"
    })

AGENT_INSTRUCTION="""
You are a user profile assistant. Your goal is to help users get their profile information using a rich UI.

To achieve this, you MUST follow these steps to answer user requests:

1.  You MUST call the `get_user_profile` tool and extract all the user profile information from the result.
2.  You MUST generate a final a2ui UI JSON based on the user profile information extracted in the previous step."""

A2UI_AND_AGENT_INSTRUCTION = AGENT_INSTRUCTION + f"""

To generate a valid a2ui UI JSON, you MUST follow these rules:
1.  Your response MUST be in two parts, separated by the delimiter: `---a2ui_JSON---`.
2.  The first part is your conversational text response.
3.  The second part is a single, raw JSON object which is a list of A2UI messages.
4.  The JSON part MUST validate against the A2UI JSON SCHEMA provided below.

To represent the user profile, you MUST use the following A2UI message types:
1.  Buttons MUST be used to represent links (e.g., LinkedIn profile link).
2.  Image MUST be used to represent the user's profile picture.

---BEGIN A2UI JSON SCHEMA---
{A2UI_SCHEMA}
---END A2UI JSON SCHEMA---
"""

root_agent = LlmAgent(
    name="user_profile",
    model="gemini-2.5-flash",
    instruction=A2UI_AND_AGENT_INSTRUCTION,
    description="An agent that returns the current user profile.",
    tools=[get_user_profile]
)

  7. বাস্তবায়নের নতুন সংস্করণের সাথে পূর্বে মোতায়েন করা ADK আপডেট করুন।

    python3 deployment/deploy.py --update --resource_id=RESOURCE_ID

    পূর্ববর্তী ধাপে কপি করা Vertex AI এজেন্ট রিসোর্স নাম দিয়ে RESOURCE_ID প্রতিস্থাপন করুন।

  8. অ্যাপের সরাসরি বার্তায়, Hello again! টাইপ করুন এবং enter টিপুন।

    চ্যাট অ্যাপটি কিছু টেক্সট এবং প্রোফাইল শিরোনাম সম্বলিত একটি কার্ড সহ একটি বার্তার উত্তর দেয়।

বিশ্বস্ত পরীক্ষক যোগ করতে এবং ইন্টারেক্টিভ বৈশিষ্ট্যগুলি পরীক্ষা করার বিষয়ে আরও জানতে, Google Chat অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্যগুলি পরীক্ষা করুন দেখুন।

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

যখন কোনও Google Chat অ্যাপ বা কার্ড কোনও ত্রুটি ফেরত দেয়, তখন Chat ইন্টারফেসটি "কিছু ভুল হয়েছে" বা "আপনার অনুরোধ প্রক্রিয়া করতে অক্ষম" বলে একটি বার্তা প্রকাশ করে। কখনও কখনও Chat UI কোনও ত্রুটির বার্তা প্রদর্শন করে না, তবে Chat অ্যাপ বা কার্ড একটি অপ্রত্যাশিত ফলাফল তৈরি করে; উদাহরণস্বরূপ, একটি কার্ড বার্তা প্রদর্শিত নাও হতে পারে।

যদিও চ্যাট UI তে কোনও ত্রুটির বার্তা প্রদর্শিত নাও হতে পারে, চ্যাট অ্যাপের জন্য ত্রুটি লগিং চালু থাকলে বর্ণনামূলক ত্রুটির বার্তা এবং লগ ডেটা আপনাকে ত্রুটিগুলি ঠিক করতে সাহায্য করার জন্য উপলব্ধ। ত্রুটিগুলি দেখা, ডিবাগ করা এবং ঠিক করার জন্য, Google Chat ত্রুটিগুলির সমস্যা সমাধান এবং সমাধান দেখুন।

পরিষ্কার কর

এই টিউটোরিয়ালে ব্যবহৃত রিসোর্সের জন্য আপনার Google ক্লাউড অ্যাকাউন্টে চার্জ এড়াতে, আমরা আপনাকে ক্লাউড প্রকল্পটি মুছে ফেলার পরামর্শ দিচ্ছি।

  1. গুগল ক্লাউড কনসোলে, রিসোর্স পরিচালনা পৃষ্ঠায় যান। মেনু > IAM & Admin > রিসোর্স পরিচালনা করুন এ ক্লিক করুন।

    রিসোর্স ম্যানেজারে যান

  2. প্রকল্পের তালিকায়, আপনি যে প্রকল্পটি মুছতে চান তা নির্বাচন করুন এবং তারপরে মুছুন মুছে ফেলুন করুন।
  3. ডায়ালগে, প্রজেক্ট আইডি টাইপ করুন এবং তারপর প্রজেক্টটি মুছে ফেলতে Shut down এ ক্লিক করুন।