ADK AI এজেন্টের সাহায্যে Google Chat অ্যাপ তৈরি করা

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

AI এজেন্টরা তাদের পরিবেশ, যুক্তি ও জটিল, একাধিক ধাপের অ্যাকশনকে স্বতন্ত্রভাবে উপলব্ধি করে এবং একটি নির্দিষ্ট লক্ষ্য অর্জন করে। এই টিউটোরিয়ালে, আপনি ADK LLM অডিটর মাল্টি-এজেন্ট স্যাম্পেল ডেপ্লয় করবেন যা Gemini ও Google Search গ্রাউন্ডিং ব্যবহার করে ফ্যাক্ট মূল্যায়ন ও সংশোধন করে।

চ্যাট অ্যাপ হিসেবে LLM অডিটর মাল্টি-এজেন্ট স্যাম্পেল।

নিচের ডায়াগ্রামে আর্কিটেকচার ও মেসেজিং প্যাটার্ন দেখানো হয়েছে:

ADK AI এজেন্টের মাধ্যমে প্রয়োগ করা চ্যাট অ্যাপের আর্কিটেকচার।

আগের ডায়াগ্রামে, ADK AI এজেন্ট প্রয়োগ করা চ্যাট অ্যাপের সাথে ইন্টার‍্যাক্ট করা ব্যবহারকারীর কাছে তথ্যের নিম্নলিখিত ফ্লো থাকে:

  1. কোনও ব্যবহারকারী Chat অ্যাপে মেসেজ পাঠান, সেটি সরাসরি মেসেজ বা Chat স্পেস হতে পারে।
  2. Apps Script-এ অথবা HTTP এন্ডপয়েন্ট সহ ওয়েব সার্ভার হিসেবে ইমপ্লিমেন্ট করা Chat অ্যাপের লজিক মেসেজ পায় ও প্রসেস করে।
  3. ADK-এর মাধ্যমে প্রয়োগ করা এবং Vertex AI Agent Engine-এর মাধ্যমে হোস্ট করা AI এজেন্ট ইন্টার‍্যাকশন গ্রহণ করে ও প্রসেস করে।
  4. ঐচ্ছিকভাবে, Chat অ্যাপ বা AI এজেন্ট Google Workspace পরিষেবার সাথে ইন্টিগ্রেট করতে পারে, যেমন Calendar বা Sheets অথবা অন্যান্য Google পরিষেবা, যেমন Google Maps বা YouTube.
  5. AI এজেন্টের অগ্রগতি সম্পর্কে জানাতে, Chat অ্যাপ Google Chat API ব্যবহার করে অ্যাসিঙ্ক্রোনাসভাবে উত্তর পাঠায়।
  6. উত্তর ব্যবহারকারীকে ডেলিভার করা হয়।

উদ্দেশ্য

  • আপনার এনভায়রনমেন্ট সেট-আপ করুন।
  • ADK AI এজেন্ট ডিপ্লয় করুন।
  • Chat অ্যাপ ডেপ্লয় করুন।
  • Chat অ্যাপ কনফিগার করুন।
  • Chat অ্যাপ পরীক্ষা করুন।

পূর্বশর্ত

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

Google Cloud API চালু করুন

Google API ব্যবহার করার আগে, আপনাকে Google Cloud প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি Google Cloud প্রোজেক্টে এক বা একাধিক API চালু করতে পারবেন।
  • Google Cloud কনসোলে, Google Chat, Vertex AI এবং Cloud Resource Manager API চালু করুন।

    API চালু করুন

OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করা

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

  1. Google API Console-এ, 'মেনু > Google Auth প্ল্যাটফর্ম > ব্র্যান্ডিং' বিকল্পে যান।

    ব্র্যান্ডিংয়ে যান

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

Google Cloud Console-এ পরিষেবা অ্যাকাউন্ট তৈরি করা

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

Google Cloud Console

  1. Google Cloud Console-এ, 'মেনু > IAM ও অ্যাডমিন > পরিষেবা অ্যাকাউন্ট' বিকল্পে যান।

    পরিষেবা অ্যাকাউন্টে যান

    বাকি ধাপগুলি Google Cloud Console-এ দেখা যাবে।

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

    পরিষেবা অ্যাকাউন্টের ইমেল আইডি লিখে রাখুন।

gcloud CLI

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

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

প্রাইভেট কী তৈরি করা

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

  1. Google Cloud Console-এ, 'মেনু > IAM ও অ্যাডমিন > পরিষেবা অ্যাকাউন্ট' বিকল্পে যান।

    পরিষেবা অ্যাকাউন্টে যান

    বাকি ধাপগুলি Google Cloud Console-এ দেখা যাবে।

  2. Google Cloud প্রোজেক্ট বেছে নিন।
  3. আপনি যে পরিষেবা অ্যাকাউন্টের জন্য কী তৈরি করতে চান সেটির ইমেল আইডিতে ক্লিক করুন।
  4. কী ট্যাবে ক্লিক করুন।
  5. কী যোগ করুন ড্রপ-ডাউন মেনুতে ক্লিক করে নতুন কী তৈরি করুন বিকল্প বেছে নিন।
  6. কীয়ের ধরন হিসেবে JSON বেছে নিন এবং তৈরি করুন বিকল্পে ক্লিক করুন।

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

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

ADK AI এজেন্ট ডিপ্লয় করা

  1. Vertex AI Agent Garden-এ LLM অডিটর স্যাম্পেল খুলুন:

    নমুনা খুলুন

  2. ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

  3. জানতে চাওয়া হলে, আপনার Google Cloud প্রোজেক্ট বেছে নিন।

  4. Cloud Shell-এ ডিপ্লয় করুন বিকল্পে ক্লিক করুন।

  5. বলা হলে, অনুমোদন করুন বিকল্পে ক্লিক করুন এবং Cloud Shell-এর জন্য OAuth ফ্লো সম্পূর্ণ করুন।

  6. Cloud Shell সম্পূর্ণ লোড হয়ে গেলে, আগে থেকে লোড করা কমান্ড লাইন চালানোর জন্য Enter টিপুন এবং ডেপ্লয় করা শুরু করুন।

  7. অঞ্চল লিখতে বলা হলে, ডিফল্ট ব্যবহার করতে Enter টিপুন।

  8. সম্পূর্ণ হয়ে গেলে, Vertex AI Agent Engine-এ যান:

    Vertex AI Agent Engine খুলুন

  9. টেবিল থেকে নতুন ডেপ্লয় করা এজেন্টের রিসোর্স নাম কপি করতে কপি তৈরি করার আইকন আইকনে ক্লিক করুন।

Chat অ্যাপ প্রোজেক্ট তৈরি ও কনফিগার করা

  1. ADK AI এজেন্ট কুইকস্টার্ট Apps Script প্রজেক্ট খুলতে, নিচের বোতামে ক্লিক করুন।

    প্রোজেক্ট খুলুন

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

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

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

  5. Google API কনসোলে, 'মেনু > IAM ও অ্যাডমিন > সেটিংস' বিকল্পে যান।

    IAM ও অ্যাডমিন সেটিংসে যান

  6. প্রোজেক্ট নম্বর ফিল্ডে, ভ্যালু কপি করুন।

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

  8. Google Cloud Platform (GCP) প্রোজেক্ট বিকল্পের মধ্যে, প্রোজেক্ট পরিবর্তন করুন বিকল্পে ক্লিক করুন।

  9. GCP প্রোজেক্ট নম্বরে, আগের ধাপে কপি করা Google Cloud প্রোজেক্ট নম্বর পেস্ট করুন।

  10. প্রোজেক্ট সেট করুন বিকল্পে ক্লিক করুন। Cloud প্রোজেক্ট ও Apps Script প্রোজেক্ট এখন কানেক্ট করা হয়েছে।

টেস্ট ডিপ্লয়মেন্ট তৈরি করা

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

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

  1. Chat অ্যাপের Apps স্ক্রিপ্ট প্রোজেক্টে, ডিপ্লয় করুন > ডিপ্লয়মেন্ট পরীক্ষা করুন বিকল্পে ক্লিক করুন।
  2. হেড ডিপ্লয়মেন্ট ID-এর অধীনে, কপি তৈরি করার আইকন কপি করুন বিকল্পে ক্লিক করুন।
  3. হয়ে গেছে বিকল্পে ক্লিক করুন।

Chat অ্যাপ কনফিগার করা

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

  1. API কনসোলে, Google Chat API-এর জন্য সার্চ করুন এবং Google Chat API-তে ক্লিক করুন।
  2. ম্যানেজ করুন বিকল্পে ক্লিক করুন।
  3. কনফিগারেশন বিকল্পে ক্লিক করে Chat অ্যাপ সেট-আপ করুন:

    1. অ্যাপের নাম ফিল্ডে, ADK Quickstart লিখুন।
    2. অবতার URL ফিল্ডে, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
    3. বিবরণ ফিল্ডে, ADK Quickstart লিখুন।
    4. কার্যকারিতা বিকল্পের মধ্যে, স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।
    5. কানেকশন সেটিংসের মধ্যে, Apps Script প্রোজেক্ট বিকল্প বেছে নিন।
    6. ডেপ্লয়মেন্ট আইডি ফিল্ডে, হেড ডেপ্লয়মেন্ট আইডি পেস্ট করুন যেটি আপনি আগে কপি করেছিলেন।
    7. দৃশ্যমানতা বিকল্পের মধ্যে, আপনার ডোমেনের নির্দিষ্ট লোকজন ও গ্রুপ বিকল্প বেছে নিন এবং আপনার ইমেল আইডি লিখুন।
  4. সেভ করুন বিকল্পে ক্লিক করুন।

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

Chat অ্যাপ পরীক্ষা করা

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

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

    Google Chat-এ যান

  2. নতুন চ্যাট বিকল্পে ক্লিক করুন।
  3. ১ বা একাধিক লোকজনকে যোগ করুন ফিল্ডে, আপনার Chat অ্যাপের নাম টাইপ করুন।
  4. ফলাফল থেকে আপনার Chat অ্যাপ বেছে নিন। সরাসরি মেসেজ খুলে যায়।

  5. অ্যাপের সাথে নতুন সরাসরি মেসেজে, The Eiffel Tower was completed in 1900 টাইপ করেenter প্রেস করুন।

    Chat অ্যাপ সমালোচক ও সংশোধনকারী সাব-এজেন্টের উত্তর দেয়।

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

সমস্যার সমাধান করুন

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

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

অপ্রয়োজনীয়গুলি মুছুন

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

  1. Google API কনসোলে, রিসোর্স ম্যানেজ করুন পৃষ্ঠায় যান। মেনু > IAM ও অ্যাডমিন > রিসোর্স ম্যানেজ করুন বিকল্পে ক্লিক করুন।

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

  2. প্রোজেক্টের তালিকা থেকে, যে প্রোজেক্টটি মুছতে চান সেটি বেছে নিন এবং তারপরে মুছুন বিকল্পে ক্লিক করুন।
  3. ডায়ালগে, প্রোজেক্ট আইডি টাইপ করুন এবং তারপর প্রোজেক্ট মুছে দিতে বন্ধ করুন বিকল্পে ক্লিক করুন ।