Gemini Enterprise AI এজেন্ট ব্যবহার করে Google Chat অ্যাপ তৈরি করা

এই পৃষ্ঠায় কীভাবে এমন Google Chat অ্যাপ তৈরি করতে হয় তা ব্যাখ্যা করা হয়েছে যা Gemini Enterprise AI এজেন্টের সাথে ইন্টারফেস করে।

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

চ্যাট অ্যাপ হিসেবে আইডিয়া জেনারেশন এজেন্ট।

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

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

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

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

উদ্দেশ্য

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

পূর্বশর্ত

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

Chat API চালু করুন

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

Google Cloud Console-এ, Google Chat 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-এ পরিষেবা অ্যাকাউন্ট তৈরি করা

এইসব ধাপ অনুসরণ করে Discovery Engine 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 ডকুমেন্টেশনে পরিষেবা অ্যাকাউন্ট দেখুন।

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

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

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

  2. প্রোজেক্ট নম্বর ও প্রোজেক্ট আইডি ফিল্ডে নজর দিন।

  3. Gemini Enterprise-এ যান:

    Gemini Enterprise খুলুন

  4. অ্যাপ্লিকেশনের লোকেশন ও আইডি মনে রাখবেন।

  5. GE AI এজেন্ট কুইকস্টার্ট অ্যাপ স্ক্রিপ্ট প্রজেক্ট খুলতে, নিচের বোতামে ক্লিক করুন।

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

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

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

    1. REASONING_ENGINE_RESOURCE_NAME Gemini Enterprise অ্যাপ রিসোর্স সহ আগের ধাপে উল্লেখ করা তথ্য দিয়ে কম্পোজ করা হয়েছে।

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID

    2. SERVICE_ACCOUNT_KEY-এর সাথে পরিষেবা অ্যাকাউন্ট থেকে JSON কী ডাউনলোড করা হয়েছে, যেমন { ... }।

  8. স্ক্রিপ্ট প্রপার্টি সেভ করুন বিকল্পে ক্লিক করুন

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

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

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

  12. প্রোজেক্ট সেট করুন বিকল্পে ক্লিক করুন। 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. অ্যাপের নাম ফিল্ডে, GE Quickstart লিখুন।
    2. অবতার URL ফিল্ডে, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
    3. বিবরণ ফিল্ডে, GE 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. অ্যাপের সাথে নতুন সরাসরি মেসেজে, I need to find ideas! টাইপ করেenter প্রেস করুন।

    Chat অ্যাপ ডিফল্ট আইডিয়া জেনারেশন এজেন্টের উত্তর দিয়ে রিপ্লাই করে।

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

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

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

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

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

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

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

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

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