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

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

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

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

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

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

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

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

উদ্দেশ্য

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

পূর্বশর্ত

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

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

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

    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 ডকুমেন্টেশনে পরিষেবা অ্যাকাউন্টগুলি দেখুন।

ADK AI এজেন্ট মোতায়েন করুন

  1. ভার্টেক্স এআই এজেন্ট গার্ডেনে এলএলএম অডিটর নমুনা খুলুন:

    নমুনাটি খুলুন

  2. স্থাপন করুন ক্লিক করুন।

  3. যদি জিজ্ঞাসা করা হয়, তাহলে আপনার গুগল ক্লাউড প্রজেক্টটি নির্বাচন করুন।

  4. ক্লাউড শেলে ডিপ্লয় ক্লিক করুন।

  5. যদি জিজ্ঞাসা করা হয়, তাহলে Authorize-এ ক্লিক করুন এবং Cloud Shell-এর জন্য OAuth প্রবাহটি দেখুন।

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

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

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

    ওপেন ভার্টেক্স এআই এজেন্ট ইঞ্জিন

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

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

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

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

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

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

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

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

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

  5. অ্যাপের নতুন সরাসরি বার্তায়, The Eiffel Tower was completed in 1900 টাইপ করুন এবং enter টিপুন।

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

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

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

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

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

পরিষ্কার করা

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

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

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

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