Google Chat, Vertex AI, এবং Apps Script-এর মাধ্যমে ঘটনার প্রতিক্রিয়া জানান

এই টিউটোরিয়ালটি অনুমোদনের সুযোগ ব্যবহার করে যা https://www.googleapis.com/auth/chat.app.* দিয়ে শুরু হয় ।

ডেভেলপার প্রিভিউ: Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলভ্য, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস দেয়।

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

এই টিউটোরিয়ালটি দেখায় যে কীভাবে একটি Google চ্যাট অ্যাপ তৈরি করতে হয় যা বাস্তব সময়ে ঘটনাগুলির প্রতিক্রিয়া জানায়৷ একটি ঘটনার প্রতিক্রিয়া জানানোর সময়, অ্যাপটি একটি চ্যাট স্পেস তৈরি করে এবং পপুলেট করে, বার্তা, স্ল্যাশ কমান্ড এবং ডায়ালগগুলির সাহায্যে ঘটনার রেজোলিউশন সহজ করে এবং একটি Google ডক্স ডকুমেন্টে ঘটনার প্রতিক্রিয়া সংক্ষিপ্ত করতে AI ব্যবহার করে৷

একটি ঘটনা হল এমন একটি ঘটনা যা সমাধান করার জন্য মানুষের একটি দলের অবিলম্বে মনোযোগ প্রয়োজন। ঘটনার উদাহরণগুলির মধ্যে রয়েছে:

• কাস্টমার রিলেশনশিপ ম্যানেজমেন্ট (CRM) প্ল্যাটফর্মে একটি সময়-সংবেদনশীল কেস তৈরি করা হয়, একটি রেজোলিউশনে একটি পরিষেবা দলকে সহযোগিতা করতে হয়।
• একটি সিস্টেম অফলাইন হয়ে যায়, সাইটের নির্ভরযোগ্যতা ইঞ্জিনিয়ারদের (SREs) একটি গ্রুপকে সতর্ক করে যাতে তারা এটিকে অনলাইনে ফিরিয়ে আনতে একসাথে কাজ করতে পারে।
• একটি উচ্চ মাত্রার ভূমিকম্প হয়, এবং জরুরী কর্মীদের তাদের প্রতিক্রিয়া সমন্বয় করতে হবে।

এই টিউটোরিয়ালের উদ্দেশ্যে, ঘটনা সতর্কতা শুরু হয় যখন কেউ একটি ওয়েব পৃষ্ঠা থেকে একটি বোতাম ক্লিক করে ঘটনাটি রিপোর্ট করে। ওয়েব পৃষ্ঠাটি ব্যবহারকারীদের প্রাথমিক ঘটনার তথ্য লিখতে বলে একটি ঘটনা অনুকরণ করে: উত্তরদাতাদের শিরোনাম, বিবরণ এবং ইমেল ঠিকানা।

ইভেন্ট ম্যানেজমেন্ট চ্যাট অ্যাপটি কাজ করে দেখুন:

• 

  চিত্র 1. ওয়েবসাইট যেখানে কেউ একটি ঘটনা রিপোর্ট করতে পারে।

• 
  চিত্র 2. বিজ্ঞপ্তি যে ঘটনাটি চ্যাট স্পেস তৈরি করা হয়েছে।
• 
  চিত্র 3. ঘটনার প্রতিক্রিয়া চ্যাট স্পেস।
• 
  চিত্র 4. একটি স্ল্যাশ কমান্ড দিয়ে ঘটনার সমাধান করা।
• 
  চিত্র 5. ঘটনার রেজোলিউশন ডায়ালগ।
• 
  চিত্র 6. ঘটনার রেজোলিউশন Google ডক্স ডকুমেন্ট মহাকাশে শেয়ার করা হয়েছে।
• 
  চিত্র 7. এআই সারাংশ ঘটনার রেজোলিউশন গুগল ডক্স ডকুমেন্ট।

পূর্বশর্ত

আপনার প্রতিষ্ঠানের জন্য এই পূর্বশর্তগুলির মধ্যে যেকোনো একটি চালু করার প্রয়োজন হলে, আপনার Google Workspace অ্যাডমিনিস্ট্রেটরকে সেগুলি চালু করতে বলুন:

• Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
• Google Workspace-এর জন্য ডিরেক্টরি (যোগাযোগ শেয়ার করা) চালু করতে। ঘটনা অ্যাপটি ঘটনার উত্তরদাতাদের যোগাযোগের তথ্য, যেমন নাম এবং ইমেল ঠিকানা দেখতে ডিরেক্টরি ব্যবহার করে। ঘটনার উত্তরদাতাদের অবশ্যই আপনার Google Workspace সংস্থার Google Chat অ্যাকাউন্টের ব্যবহারকারী হতে হবে।

উদ্দেশ্য

• একটি চ্যাট অ্যাপ তৈরি করুন যা ঘটনাগুলির প্রতিক্রিয়া জানায়৷
• নিম্নলিখিতগুলি করে ব্যবহারকারীদের ঘটনার প্রতিক্রিয়া জানাতে সহায়তা করুন:
  • ঘটনার প্রতিক্রিয়া স্পেস তৈরি করা।
  • ঘটনা এবং প্রতিক্রিয়া সংক্ষিপ্ত বার্তা পোস্ট করা.
  • ইন্টারেক্টিভ চ্যাট অ্যাপের বৈশিষ্ট্যগুলির সাথে সহযোগিতার সহায়ক।
• Vertex AI এর সাথে কথোপকথন এবং রেজোলিউশনের সারসংক্ষেপ।

স্থাপত্য

নিম্নলিখিত চিত্রটিতে Google Workspace এবং Google ক্লাউড সংস্থানগুলির আর্কিটেকচার দেখানো হয়েছে যা Google Chat অ্যাপের ঘটনা প্রতিক্রিয়ার দ্বারা ব্যবহৃত হয়।

আর্কিটেকচারটি দেখায় কিভাবে ঘটনার প্রতিক্রিয়া Google Chat অ্যাপ একটি ঘটনা এবং রেজোলিউশন প্রক্রিয়া করে।

1. একজন ব্যবহারকারী অ্যাপস স্ক্রিপ্টে হোস্ট করা একটি বহিরাগত ওয়েবসাইট থেকে একটি ঘটনা শুরু করেন।

2. ওয়েবসাইটটি অ্যাপস স্ক্রিপ্টে হোস্ট করা Google চ্যাট অ্যাপে একটি অ্যাসিঙ্ক্রোনাস HTTP অনুরোধ পাঠায়।

3. ঘটনার প্রতিক্রিয়া Google Chat অ্যাপ অনুরোধটি প্রক্রিয়া করে:

   1. অ্যাপস স্ক্রিপ্ট অ্যাডমিন SDK পরিষেবা টিমের সদস্যদের তথ্য পায়, যেমন ব্যবহারকারী আইডি এবং ইমেল ঠিকানা।

   2. অ্যাপস স্ক্রিপ্ট অ্যাডভান্সড চ্যাট পরিষেবা ব্যবহার করে চ্যাট এপিআই-তে HTTP অনুরোধের একটি সেটের সাথে, ঘটনার প্রতিক্রিয়া Google Chat অ্যাপ একটি ঘটনা চ্যাট স্পেস তৈরি করে, দলের সদস্যদের সাথে এটিকে পপুলেট করে এবং স্পেসে একটি বার্তা পাঠায়।

4. দলের সদস্যরা চ্যাট স্পেসে ঘটনাটি নিয়ে আলোচনা করে।

5. একটি দলের সদস্য ঘটনার একটি রেজোলিউশন সংকেত একটি স্ল্যাশ কমান্ড আহ্বান.

   1. অ্যাপস স্ক্রিপ্ট অ্যাডভান্সড চ্যাট পরিষেবা ব্যবহার করে চ্যাট API-এ একটি HTTP কল চ্যাট স্পেসের সমস্ত বার্তা তালিকাভুক্ত করে।

   2. Vertex AI তালিকাভুক্ত বার্তাগুলি গ্রহণ করে এবং একটি সারাংশ তৈরি করে।

   3. Apps Script DocumentApp পরিষেবা একটি ডক্স ডকুমেন্ট তৈরি করে এবং ডকুমেন্টে Vertex AI এর সারাংশ যোগ করে।

   4. ঘটনার প্রতিক্রিয়া Google Chat অ্যাপটি Chat API-কে সারসংক্ষেপ ডক্স ডকুমেন্টের লিঙ্ক শেয়ার করে একটি বার্তা পাঠাতে কল করে।

পরিবেশ প্রস্তুত করুন

এই বিভাগটি দেখায় কিভাবে চ্যাট অ্যাপের জন্য একটি Google ক্লাউড প্রকল্প তৈরি এবং কনফিগার করতে হয়।

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

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

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Create a Project এ যান।

   একটি প্রকল্প তৈরি করুন এ যান

2. প্রকল্পের নাম ক্ষেত্রে, আপনার প্রকল্পের জন্য একটি বর্ণনামূলক নাম লিখুন।

   ঐচ্ছিক: প্রকল্প আইডি সম্পাদনা করতে, সম্পাদনা ক্লিক করুন। প্রোজেক্ট তৈরি হওয়ার পর প্রোজেক্ট আইডি পরিবর্তন করা যাবে না, তাই এমন একটি আইডি বেছে নিন যা প্রোজেক্টের জীবনকালের জন্য আপনার চাহিদা পূরণ করে।

3. অবস্থান ক্ষেত্রে, আপনার প্রকল্পের সম্ভাব্য অবস্থানগুলি প্রদর্শন করতে ব্রাউজ ক্লিক করুন। তারপর, নির্বাচন ক্লিক করুন.
   সতর্কতা: আপনার Google Workspace সংস্থা খুঁজে পাচ্ছেন না?
   এর মানে আপনি Google Workspace অ্যাকাউন্টে সাইন-ইন করেননি। Google Workspace ডেভেলপার ডকুমেন্টেশনে বর্ণিত কিছু বৈশিষ্ট্য শুধুমাত্র একটি প্রতিষ্ঠানের সাথে যুক্ত প্রকল্পের জন্য উপলব্ধ।
4. তৈরি করুন ক্লিক করুন। Google ক্লাউড কনসোল ড্যাশবোর্ড পৃষ্ঠায় নেভিগেট করে এবং আপনার প্রকল্পটি কয়েক মিনিটের মধ্যে তৈরি হয়।

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

নিম্নলিখিত উন্নয়ন পরিবেশগুলির মধ্যে একটিতে, Google ক্লাউড CLI ( gcloud ) অ্যাক্সেস করুন :

• ক্লাউড শেল : ইতিমধ্যেই সেট আপ করা gcloud CLI সহ একটি অনলাইন টার্মিনাল ব্যবহার করতে, ক্লাউড শেল সক্রিয় করুন।
  ক্লাউড শেল সক্রিয় করুন
• স্থানীয় শেল : একটি স্থানীয় উন্নয়ন পরিবেশ ব্যবহার করতে, gcloud CLI ইনস্টল এবং আরম্ভ করুন ।
  একটি ক্লাউড প্রকল্প তৈরি করতে, gcloud projects create কমান্ড ব্যবহার করুন:

  gcloud projects create PROJECT_ID

  আপনি যে প্রকল্পটি তৈরি করতে চান তার জন্য ID সেট করে PROJECT_ID প্রতিস্থাপন করুন।

ক্লাউড প্রকল্পের জন্য বিলিং সক্ষম করুন৷

আপনি একটি বিলিং অ্যাকাউন্ট লিঙ্ক করতে অক্ষম হলে, এই পরিবর্তন করার জন্য আপনার কাছে প্রয়োজনীয় অনুমতি নেই৷ আরও তথ্যের জন্য, বিলিং সক্ষম করতে প্রয়োজনীয় অনুমতিগুলি দেখুন।

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

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

   আমার প্রকল্পের জন্য বিলিং এ যান

2. একটি সংস্থা নির্বাচন করুন -এ, আপনার Google ক্লাউড প্রকল্পের সাথে যুক্ত সংস্থা নির্বাচন করুন৷
3. প্রকল্পের সারিতে, অ্যাকশন মেনু খুলুন ( ), বিলিং পরিবর্তন করুন এ ক্লিক করুন এবং ক্লাউড বিলিং অ্যাকাউন্ট বেছে নিন।
4. অ্যাকাউন্ট সেট করুন ক্লিক করুন।

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

1. উপলব্ধ বিলিং অ্যাকাউন্টের তালিকা করতে, চালান:

   gcloud billing accounts list

2. Google ক্লাউড প্রকল্পের সাথে একটি বিলিং অ্যাকাউন্ট লিঙ্ক করুন:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

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

   • PROJECT_ID হল ক্লাউড প্রকল্পের জন্য প্রকল্প আইডি যার জন্য আপনি বিলিং সক্ষম করতে চান৷
   • BILLING_ACCOUNT_ID হল Google ক্লাউড প্রকল্পের সাথে লিঙ্ক করার জন্য বিলিং অ্যাকাউন্ট আইডি ৷

APIs সক্রিয় করুন

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

1. Google ক্লাউড কনসোলে, Google Chat API, Google Docs API, Admin SDK API, Google Workspace Marketplace SDK এবং Vertex AI API সক্ষম করুন।

   APIs সক্রিয় করুন

2. নিশ্চিত করুন যে আপনি সঠিক ক্লাউড প্রকল্পে API গুলি সক্ষম করছেন, তারপর পরবর্তী ক্লিক করুন।

3. নিশ্চিত করুন যে আপনি সঠিক API গুলি সক্ষম করছেন, তারপর সক্ষম করুন ক্লিক করুন৷

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

1. প্রয়োজনে, বর্তমান ক্লাউড প্রজেক্টটিকে আপনার তৈরি করা একটিতে সেট করুন gcloud config set project কমান্ড:

   gcloud config set project PROJECT_ID

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

2. Google Chat API, Google Docs API, Admin SDK API, Google Workspace Marketplace SDK, এবং Vertex AI API চালু করুন gcloud services enable কমান্ড দিয়ে:

   gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com appsmarket-component.googleapis.com

প্রমাণীকরণ এবং অনুমোদন সেট আপ করুন

চ্যাট অ্যাপ চ্যাট অ্যাপের শংসাপত্র ব্যবহার করে Google Chat API অ্যাক্সেস করে। অ্যাপটি ব্যবহারকারীর শংসাপত্র সহ অ্যাডমিন SDK API এবং Google ডক্স API অ্যাক্সেস করে৷

ব্যবহারকারীর প্রমাণীকরণ এবং অনুমোদন সেট আপ করুন

প্রমাণীকরণ এবং অনুমোদনের মাধ্যমে Chat অ্যাপকে Google Workspace এবং Google ক্লাউড-এর রিসোর্স অ্যাক্সেস করার অনুমতি দেওয়া হয়। বিশেষভাবে, ব্যবহারকারীর প্রমাণীকরণ Google ডক্স API এবং অ্যাডমিন SDK API কল করতে ব্যবহৃত হয়।

এই টিউটোরিয়ালে, আপনি আপনার ওয়ার্কস্পেস ডোমেনে অভ্যন্তরীণভাবে অ্যাপটি প্রকাশ করেন, তাই এটি স্থানধারক তথ্য ব্যবহার করার জন্য গ্রহণযোগ্য। অ্যাপটি বাহ্যিকভাবে প্রকাশ করার আগে, সম্মতি স্ক্রিনে প্রকৃত তথ্য দিয়ে স্থানধারক তথ্য প্রতিস্থাপন করুন।

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

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

2. আপনি যদি ইতিমধ্যেই কনফিগার করে থাকেন, আপনি ব্র্যান্ডিং , দর্শক এবং ডেটা অ্যাক্সেসে নিম্নলিখিত OAuth সম্মতি স্ক্রীন সেটিংস কনফিগার করতে পারেন৷ আপনি যদি একটি বার্তা দেখতে পারেন যা বলে এখনো কনফিগার করা হয়নি , Get Started এ ক্লিক করুন:

   1. অ্যাপ তথ্যের অধীনে, অ্যাপের নামে , Incident Management টাইপ করুন।
   2. ব্যবহারকারী সমর্থন ইমেলে , আপনার ইমেল ঠিকানা বা একটি উপযুক্ত Google গ্রুপ নির্বাচন করুন।
   3. পরবর্তী ক্লিক করুন.
   4. দর্শকের অধীনে, অভ্যন্তরীণ নির্বাচন করুন। আপনি যদি অভ্যন্তরীণ নির্বাচন করতে না পারেন তবে বাহ্যিক নির্বাচন করুন।
   5. পরবর্তী ক্লিক করুন.
   6. যোগাযোগের তথ্যের অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনাকে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে অবহিত করা যেতে পারে।
   7. পরবর্তী ক্লিক করুন.
   8. সমাপ্তির অধীনে, Google API পরিষেবাগুলির ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং আপনি যদি সম্মত হন, নির্বাচন করুন আমি Google API পরিষেবাগুলির সাথে সম্মত: ব্যবহারকারী ডেটা নীতি ৷
   9. অবিরত ক্লিক করুন.
   10. তৈরি করুন ক্লিক করুন।
   11. আপনি যদি ব্যবহারকারীর প্রকারের জন্য বাহ্যিক নির্বাচন করেন, পরীক্ষা ব্যবহারকারীদের যোগ করুন:
       1. শ্রোতা ক্লিক করুন.
       2. টেস্ট ব্যবহারকারীদের অধীনে, ব্যবহারকারী যোগ করুন ক্লিক করুন।
       3. আপনার ইমেল ঠিকানা এবং অন্য কোন অনুমোদিত পরীক্ষা ব্যবহারকারীদের লিখুন, তারপর সংরক্ষণ করুন ক্লিক করুন।

3. ডেটা অ্যাক্সেস > স্কোপ যোগ করুন বা সরান ক্লিক করুন। আপনি আপনার Google ক্লাউড প্রকল্পে সক্ষম করেছেন এমন প্রতিটি API-এর জন্য স্কোপের তালিকা সহ একটি প্যানেল উপস্থিত হয়৷

   1. ম্যানুয়ালি স্কোপ যোগ করুন এর অধীনে, নিম্নলিখিত স্কোপগুলি পেস্ট করুন:

      • https://www.googleapis.com/auth/documents
      • https://www.googleapis.com/auth/admin.directory.user.readonly
      • https://www.googleapis.com/auth/script.external_request
      • https://www.googleapis.com/auth/userinfo.email
      • https://www.googleapis.com/auth/cloud-platform

   2. টেবিলে যোগ করুন ক্লিক করুন।

   3. আপডেট ক্লিক করুন.

   4. আপনার অ্যাপের জন্য প্রয়োজনীয় স্কোপগুলি নির্বাচন করার পরে, ডেটা অ্যাক্সেস পৃষ্ঠায়, সংরক্ষণ করুন ক্লিক করুন।

অ্যাপ প্রমাণীকরণ এবং অনুমোদন সেট আপ করুন

Google Chat API কল করতে অ্যাপ প্রমাণীকরণ ব্যবহার করা হয়।

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

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

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

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

   সার্ভিস অ্যাকাউন্টে যান

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

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

1. পরিষেবা অ্যাকাউন্ট তৈরি করুন:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. ঐচ্ছিক: আপনার Google ক্লাউড প্রকল্পের সংস্থানগুলিতে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা বরাদ্দ করুন৷ আরও বিশদ বিবরণের জন্য, সংস্থানগুলিতে অ্যাক্সেস মঞ্জুর করা, পরিবর্তন করা এবং প্রত্যাহার করা দেখুন।

পরিষেবা অ্যাকাউন্ট পরিষেবা অ্যাকাউন্ট পৃষ্ঠায় উপস্থিত হয়৷ পরবর্তী, পরিষেবা অ্যাকাউন্টের জন্য একটি ব্যক্তিগত কী তৈরি করুন।

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

সতর্কতা: এই উদাহরণটি সরলতার জন্য একটি রপ্তানি করা পরিষেবা অ্যাকাউন্ট কী ব্যবহার করে। প্রোডাকশনে একটি ব্যক্তিগত কী রপ্তানি করার পরামর্শ দেওয়া হয় না কারণ এটি উৎস নিয়ন্ত্রণের মতো একটি অনিরাপদ স্থানে সংরক্ষণ করা উচিত নয়।

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

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

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

   সার্ভিস অ্যাকাউন্টে যান

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

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

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

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

একটি Google Workspace Marketplace-এর সাথে সামঞ্জস্যপূর্ণ OAuth ক্লায়েন্ট তৈরি করুন

একটি Google Workspace Marketplace-সামঞ্জস্যপূর্ণ OAuth ক্লায়েন্ট তৈরি করতে, এই ধাপগুলি অনুসরণ করুন:

1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

   সার্ভিস অ্যাকাউন্টে যান

2. আপনার চ্যাট অ্যাপের জন্য তৈরি করা পরিষেবা অ্যাকাউন্টে ক্লিক করুন।

3. Advanced settings এ ক্লিক করুন।

4. Google Workspace Marketplace-সামঞ্জস্যপূর্ণ OAuth ক্লায়েন্ট তৈরি করুন- এ ক্লিক করুন।

5. অবিরত ক্লিক করুন.

একটি কনফার্মেশন মেসেজ দেখা যাচ্ছে যাতে বলা হয়েছে একটি Google Workspace Marketplace-এর সাথে সামঞ্জস্যপূর্ণ OAuth ক্লায়েন্ট তৈরি করা হয়েছে।

চ্যাট অ্যাপ তৈরি করুন এবং স্থাপন করুন

নিম্নলিখিত বিভাগে, আপনি একটি সম্পূর্ণ অ্যাপস স্ক্রিপ্ট প্রকল্প কপি এবং আপডেট করুন যাতে আপনার চ্যাট অ্যাপের জন্য প্রয়োজনীয় সমস্ত অ্যাপ্লিকেশন কোড রয়েছে, তাই প্রতিটি ফাইল কপি এবং পেস্ট করার প্রয়োজন নেই।

কিছু ফাংশন তাদের নামের শেষে আন্ডারস্কোর অন্তর্ভুক্ত করে, যেমন ChatApp.gs থেকে processSlashCommand_() । একটি ব্রাউজারে খোলা থাকলে আন্ডারস্কোর ঘটনাটি শুরুর ওয়েব পৃষ্ঠা থেকে ফাংশনটিকে লুকিয়ে রাখে। আরও তথ্যের জন্য, ব্যক্তিগত ফাংশন দেখুন।

Apps Script দুটি ধরনের ফাইল সমর্থন করে, .gs স্ক্রিপ্ট এবং .html ফাইল। এই সমর্থন মেনে চলার জন্য, অ্যাপটির ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট <script /> ট্যাগের মধ্যে অন্তর্ভুক্ত করা হয়েছে এবং এর CSS একটি HTML ফাইলের ভিতরে <style /> ট্যাগের মধ্যে অন্তর্ভুক্ত করা হয়েছে।

ঐচ্ছিকভাবে, আপনি GitHub-এ পুরো প্রকল্পটি দেখতে পারেন।

GitHub এ দেখুন

এখানে প্রতিটি ফাইলের একটি ওভারভিউ আছে:

Consts.gs

আপনার ক্লাউড প্রোজেক্ট আইডি, ভার্টেক্স এআই লোকেশন আইডি, পরিষেবা অ্যাকাউন্টের জন্য অ্যাপের শংসাপত্র এবং একটি ঘটনা বন্ধ করার জন্য স্ল্যাশ কমান্ড আইডি সহ অন্যান্য কোড ফাইলগুলির দ্বারা উল্লেখ করা ধ্রুবকগুলিকে সংজ্ঞায়িত করে৷

Consts.gs কোড দেখুন

apps-script/incident-response-app-auth/Consts.gs

GitHub এ দেখুন

const PROJECT_ID = 'replace-with-your-project-id';
const CLOSE_INCIDENT_COMMAND_ID = 1;
const APP_CREDENTIALS = 'replace-with-your-app-credentials';
const APP_CREDENTIALS_SCOPES = 'https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.app.spaces.create';
const VERTEX_AI_LOCATION_ID = 'us-central1';
const MODEL_ID = 'gemini-1.5-flash-002';

ChatApp.gs

বার্তা, কার্ড ক্লিক, স্ল্যাশ কমান্ড এবং ডায়ালগ সহ চ্যাট ইন্টারঅ্যাকশন ইভেন্টগুলি পরিচালনা করে। ঘটনার রেজোলিউশনের বিশদ সংগ্রহ করতে একটি ডায়ালগ খোলার মাধ্যমে /closeIncident স্ল্যাশ কমান্ডের প্রতিক্রিয়া জানায়। Chat API-এ spaces.messages.list পদ্ধতিতে কল করে স্পেস-এ বার্তা পড়ে। অ্যাপস স্ক্রিপ্টে অ্যাডমিন SDK ডিরেক্টরি পরিষেবা ব্যবহার করে ব্যবহারকারী আইডি পায়।

ChatApp.gs কোড দেখুন

apps-script/incident-response-app-auth/ChatApp.gs

GitHub এ দেখুন

/**
 * Responds to a MESSAGE event in Google Chat.
 *
 * This app only responds to a slash command with the ID 1 ("/closeIncident").
 * It will respond to any other message with a simple "Hello" text message.
 *
 * @param {Object} event the event object from Google Chat
 */
function onMessage(event) {
  if (event.message.slashCommand) {
    return processSlashCommand_(event);
  }
  return { "text": "Hello from Incident Response app!" };
}

/**
 * Responds to a CARD_CLICKED event in Google Chat.
 *
 * This app only responds to one kind of dialog (Close Incident).
 *
 * @param {Object} event the event object from Google Chat
 */
function onCardClick(event) {
  if (event.isDialogEvent) {
    if (event.dialogEventType == 'SUBMIT_DIALOG') {
      return processSubmitDialog_(event);
    }
    return {
      actionResponse: {
        type: "DIALOG",
        dialogAction: {
          actionStatus: "OK"
        }
      }
    };
  }
}

/**
 * Responds to a MESSAGE event with a Slash command in Google Chat.
 *
 * This app only responds to a slash command with the ID 1 ("/closeIncident")
 * by returning a Dialog.
 *
 * @param {Object} event the event object from Google Chat
 */
function processSlashCommand_(event) {
  if (event.message.slashCommand.commandId != CLOSE_INCIDENT_COMMAND_ID) {
    return {
      "text": "Command not recognized. Use the command `/closeIncident` to close the incident managed by this space."
    };
  }
  const sections = [
    {
      header: "Close Incident",
      widgets: [
        {
          textInput: {
            label: "Please describe the incident resolution",
            type: "MULTIPLE_LINE",
            name: "description"
          }
        },
        {
          buttonList: {
            buttons: [
              {
                text: "Close Incident",
                onClick: {
                  action: {
                    function: "closeIncident"
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ];
  return {
    actionResponse: {
      type: "DIALOG",
      dialogAction: {
        dialog: {
          body: {
            sections,
          }
        }
      }
    }
  };
}

/**
 * Responds to a CARD_CLICKED event with a Dialog submission in Google Chat.
 *
 * This app only responds to one kind of dialog (Close Incident).
 * It creates a Doc with a summary of the incident information and posts a message
 * to the space with a link to the Doc.
 *
 * @param {Object} event the event object from Google Chat
 */
function processSubmitDialog_(event) {
  const resolution = event.common.formInputs.description[""].stringInputs.value[0];
  const chatHistory = concatenateAllSpaceMessages_(event.space.name);
  const chatSummary = summarizeChatHistory_(chatHistory);
  const docUrl = createDoc_(event.space.displayName, resolution, chatHistory, chatSummary);
  return {
    actionResponse: {
      type: "NEW_MESSAGE",
    },
    text: `Incident closed with the following resolution: ${resolution}\n\nHere is the automatically generated post-mortem:\n${docUrl}`
  };
}

/**
 * Lists all the messages in the Chat space, then concatenate all of them into
 * a single text containing the full Chat history.
 *
 * For simplicity for this demo, it only fetches the first 100 messages.
 *
 * Messages with slash commands are filtered out, so the returned history will
 * contain only the conversations between users and not app command invocations.
 *
 * @return {string} a text containing all the messages in the space in the format:
 *          Sender's name: Message
 */
function concatenateAllSpaceMessages_(spaceName) {
  // Call Chat API method spaces.messages.list
  const response = Chat.Spaces.Messages.list(spaceName, { 'pageSize': 100 });
  const messages = response.messages;
  // Fetch the display names of the message senders and returns a text
  // concatenating all the messages.
  let userMap = new Map();
  return messages
    .filter(message => message.slashCommand === undefined)
    .map(message => `${getUserDisplayName_(userMap, message.sender.name)}: ${message.text}`)
    .join('\n');
}

/**
 * Obtains the display name of a user by using the Admin Directory API.
 *
 * The fetched display name is cached in the provided map, so we only call the API
 * once per user.
 *
 * If the user does not have a display name, then the full name is used.
 *
 * @param {Map} userMap a map containing the display names previously fetched
 * @param {string} userName the resource name of the user
 * @return {string} the user's display name
 */
function getUserDisplayName_(userMap, userName) {
  if (userMap.has(userName)) {
    return userMap.get(userName);
  }
  let displayName = 'Unknown User';
  try {
    const user = AdminDirectory.Users.get(
      userName.replace("users/", ""),
      { projection: 'BASIC', viewType: 'domain_public' });
    displayName = user.name.displayName ? user.name.displayName : user.name.fullName;
  } catch (e) {
    // Ignore error if the API call fails (for example, because it's an
    // out-of-domain user or Chat app)) and just use 'Unknown User'.
  }
  userMap.set(userName, displayName);
  return displayName;
}

ChatSpaceCreator.gs

ঘটনা প্রারম্ভিক ওয়েব পৃষ্ঠায় ব্যবহারকারীরা প্রবেশ করা ফর্ম ডেটা গ্রহণ করে এবং এটি তৈরি করে এবং পপুলেট করে একটি চ্যাট স্পেস সেট আপ করতে এটি ব্যবহার করে এবং তারপর ঘটনা সম্পর্কে একটি বার্তা পোস্ট করে৷

ChatSpaceCreator.gs কোড দেখুন

apps-script/incident-response-app-auth/ChatSpaceCreator.gs

GitHub এ দেখুন

/**
 * Handles an incident by creating a chat space, adding members, and posting a message.
 * All the actions are done using application credentials.
 *
 * @param {Object} formData - The data submitted by the user. It should contain the fields:
 *                           - title: The display name of the chat space.
 *                           - description: The description of the incident.
 *                           - users: A comma-separated string of user emails to be added to the space.
 * @return {string} The resource name of the new space.
 */
function handleIncident(formData) {
  const users = formData.users.trim().length > 0 ? formData.users.split(',') : [];
  const service = getService_();
  if (!service.hasAccess()) {
    console.error(service.getLastError());
    return;
   }
  const spaceName = createChatSpace_(formData.title, service);
  createHumanMembership_(spaceName, getUserEmail(), service);
  for (const user of users ){
    createHumanMembership_(spaceName, user, service);
  }
  createMessage_(spaceName, formData.description, service);
  return spaceName;
}
/**
 * Creates a chat space with application credentials.
 *
 * @param {string} displayName - The name of the chat space.
 * @param {object} service - The credentials of the service account.
 * @returns {string} The resource name of the new space.
*/
function createChatSpace_(displayName, service) {
  try {
    // For private apps, the alias can be used
    const my_customer_alias = "customers/my_customer";
    // Specify the space to create.
    const space = {
        displayName: displayName,
        spaceType: 'SPACE',                
        customer: my_customer_alias
    };
    // Call Chat API with a service account to create a message.
    const createdSpace = Chat.Spaces.create(
        space,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + service.getAccessToken()});
    return createdSpace.name;
  } catch (err) {
    // TODO (developer) - Handle exception.
    console.log('Failed to create space with error %s', err.message);
  }
}
/*
 * Creates a chat message with application credentials.
 *
 * @param {string} spaceName - The resource name of the space.
 * @param {string} message - The text to be posted.
 * @param {object} service - The credentials of the service account.
 * @return {string} the resource name of the new space.
 */
function createMessage_(spaceName, message, service) {
  try {
    // Call Chat API with a service account to create a message.
    const result = Chat.Spaces.Messages.create(
        {'text': message},
        spaceName,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + service.getAccessToken()});

  } catch (err) {
    // TODO (developer) - Handle exception.
    console.log('Failed to create message with error %s', err.message);
  }
}
/**
 * Creates a human membership in a chat space with application credentials.
 *
 * @param {string} spaceName - The resource name of the space.
 * @param {string} email - The email of the user to be added.
 * @param {object} service - The credentials of the service account.
 */
function createHumanMembership_(spaceName, email, service){
  try{
    const membership = {
      member: {
        name: 'users/'+email,
        // User type for the membership
        type: 'HUMAN'
      }
    };
    const result = Chat.Spaces.Members.create(
      membership,
      spaceName,
      {},
      {'Authorization': 'Bearer ' + service.getAccessToken()}
    );
  } catch (err){
    console.log('Failed to create membership with error %s', err.message)
  }

}

 /*
 * Creates a service for the service account.
 * @return {object}  - The credentials of the service account.
 */
function getService_() {
  return OAuth2.createService(APP_CREDENTIALS.client_email)
      .setTokenUrl('https://oauth2.googleapis.com/token')
      .setPrivateKey(APP_CREDENTIALS.private_key)
      .setIssuer(APP_CREDENTIALS.client_email)
      .setSubject(APP_CREDENTIALS.client_email)
      .setScope(APP_CREDENTIALS_SCOPES)
      .setPropertyStore(PropertiesService.getScriptProperties());
}

DocsApi.gs

ব্যবহারকারীর Google ড্রাইভে একটি Google ডক্স ডকুমেন্ট তৈরি করতে Google ডক্স API-কে কল করে এবং VertexAiApi.gs এ তৈরি ঘটনার তথ্যের একটি সারাংশ নথিতে লেখে।

DocsApi.gs কোড দেখুন

apps-script/incident-response-app-auth/DocsApi.gs

GitHub এ দেখুন

/**
 * Creates a Doc in the user's Google Drive and writes a summary of the incident information to it.
 *
 * @param {string} title The title of the incident
 * @param {string} resolution Incident resolution described by the user
 * @param {string} chatHistory The whole Chat history be included in the document
 * @param {string} chatSummary A summary of the Chat conversation to be included in the document
 * @return {string} the URL of the created Doc
 */
function createDoc_(title, resolution, chatHistory, chatSummary) {
  let doc = DocumentApp.create(title);
  let body = doc.getBody();
  body.appendParagraph(`Post-Mortem: ${title}`).setHeading(DocumentApp.ParagraphHeading.TITLE);
  body.appendParagraph("Resolution").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(resolution);
  body.appendParagraph("Summary of the conversation").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(chatSummary);
  body.appendParagraph("Full Chat history").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(chatHistory);
  return doc.getUrl();
}

VertexAiApi.gs

Vertex AI API ব্যবহার করে চ্যাট স্পেসে কথোপকথন সংক্ষিপ্ত করে। এই সারাংশটি DocsAPI.gs এ একটি বিশেষভাবে তৈরি নথিতে পোস্ট করা হয়েছে।

VertexAiApi.gs কোড দেখুন

apps-script/incident-response-app-auth/VertexAiApi.gs

GitHub এ দেখুন

/**
 * Summarizes a Chat conversation using the Vertex AI text prediction API.
 *
 * @param {string} chatHistory The Chat history that will be summarized.
 * @return {string} The content from the text prediction response.
 */


function summarizeChatHistory_(chatHistory) {

  const API_ENDPOINT = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}/publishers/google/models/${MODEL_ID}:generateContent`;
  const prompt = "Summarize the following conversation between Engineers resolving an incident"
      + " in a few sentences. Use only the information from the conversation.\n\n" + chatHistory;
  // Get the access token.
  const accessToken = ScriptApp.getOAuthToken();

  const headers = {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  };
  const payload = {
    'contents': {
      'role': 'user',
      'parts' : [
        {
          'text': prompt
        }
      ]
    }
  }
  const options = {
    'method': 'post',
    'headers': headers,
    'payload': JSON.stringify(payload),
    'muteHttpExceptions': true,
  };
  try {
    const response = UrlFetchApp.fetch(API_ENDPOINT, options);
    const responseCode = response.getResponseCode();
    const responseText = response.getContentText();

    if (responseCode === 200) {
      const jsonResponse = JSON.parse(responseText);
      console.log(jsonResponse)
      if (jsonResponse.candidates && jsonResponse.candidates.length > 0) {
        return jsonResponse.candidates[0].content.parts[0].text; // Access the summarized text
      } else {
        return "No summary found in response.";
      }

    } else {
      console.error("Vertex AI API Error:", responseCode, responseText);
      return `Error: ${responseCode} - ${responseText}`;
    }
  } catch (e) {
    console.error("UrlFetchApp Error:", e);
    return "Error: " + e.toString();
  }
}

WebController.gs

ঘটনা প্রারম্ভিক ওয়েবসাইট পরিবেশন করে.

WebController.gs কোড দেখুন

apps-script/incident-response-app-auth/WebController.gs

GitHub এ দেখুন

/**
 * Serves the web page from Index.html.
 */
function doGet() {
  return HtmlService
    .createTemplateFromFile('Index')
    .evaluate();
}

/**
 * Serves the web content from the specified filename.
 */
function include(filename) {
  return HtmlService
    .createHtmlOutputFromFile(filename)
    .getContent();
}

/**
 * Returns the email address of the user running the script.
 */
function getUserEmail() {
  return Session.getActiveUser().getEmail();
}

Index.html

এইচটিএমএল যার মধ্যে ঘটনা প্রারম্ভিক ওয়েবসাইট রয়েছে।

Index.html কোড দেখুন

apps-script/incident-response-app-auth/Index.html

GitHub এ দেখুন

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <link href='https://fonts.googleapis.com/css?family=Roboto' rel='stylesheet'>
    <?!= include('Stylesheet'); ?>
  </head>
  <body>
    <div class="container">
      <div class="content">
        <h1>Incident Manager</h1>
        <form id="incident-form" onsubmit="handleFormSubmit(this)">
          <div id="form">
            <p>
              <label for="title">Incident title</label><br/>
              <input type="text" name="title" id="title" />
            </p>
            <p>
              <label for="users">Incident responders</label><br/>
              <small>
                Please enter a comma-separated list of email addresses of the users
                that should be added to the space.
                Do not include <?= getUserEmail() ?> as it will be added automatically.
              </small><br/>
              <input type="text" name="users" id="users" />
            </p>
            <p>
              <label for="description">Initial message</label></br>
              <small>This message will be posted after the space is created.</small><br/>
              <textarea name="description" id="description"></textarea>
            </p>
            <p class="text-center">
              <input type="submit" value="CREATE CHAT SPACE" />
            </p>
          </div>
          <div id="output" class="hidden"></div>
          <div id="clear" class="hidden">
            <input type="reset" value="CREATE ANOTHER INCIDENT" onclick="onReset()" />
          </div>
        </form>
      </div>
    </div>
    <?!= include('JavaScript'); ?>
  </body>
</html>

JavaScript.html

ঘটনার শুরুর ওয়েবসাইটের জন্য জমা, ত্রুটি এবং ক্লিয়ার সহ ফর্ম আচরণ পরিচালনা করে। WebController.gs এ কাস্টম include ফাংশন দ্বারা এটি Index.html এ অন্তর্ভুক্ত করা হয়েছে।

JavaScript.html কোড দেখুন

apps-script/incident-response-app-auth/JavaScript.html

GitHub এ দেখুন

<script>
  var formDiv = document.getElementById('form');
  var outputDiv = document.getElementById('output');
  var clearDiv = document.getElementById('clear');

  function handleFormSubmit(formObject) {
    event.preventDefault();
    outputDiv.innerHTML = 'Please wait while we create the space...';
    hide(formDiv);
    show(outputDiv);
    google.script.run
      .withSuccessHandler(updateOutput)
      .withFailureHandler(onFailure)
      .handleIncident(formObject);
  }

  function updateOutput(response) {
    var spaceId = response.replace('spaces/', '');
    outputDiv.innerHTML =
      '<p>Space created!</p><p><a href="https://mail.google.com/chat/#chat/space/'
        + spaceId
        + '" target="_blank">Open space</a></p>';
    show(outputDiv);
    show(clearDiv);
  }

  function onFailure(error) {
    outputDiv.innerHTML = 'ERROR: ' + error.message;
    outputDiv.classList.add('error');
    show(outputDiv);
    show(clearDiv);
  }

  function onReset() {
    outputDiv.innerHTML = '';
    outputDiv.classList.remove('error');
    show(formDiv);
    hide(outputDiv);
    hide(clearDiv);
  }

  function hide(element) {
    element.classList.add('hidden');
  }

  function show(element) {
    element.classList.remove('hidden');
  }
</script>

Stylesheet.html

ঘটনা প্রারম্ভিক ওয়েবসাইট জন্য CSS. WebController.gs এ কাস্টম include ফাংশন দ্বারা এটি Index.html এ অন্তর্ভুক্ত করা হয়েছে।

Stylesheet.html কোড দেখুন

apps-script/incident-response-app-auth/Stylesheet.html৷

GitHub এ দেখুন

<style>
  * {
    box-sizing: border-box;
  }
  body {
    font-family: Roboto, Arial, Helvetica, sans-serif;
  }
  div.container {
    display: flex;
    justify-content: center;
    align-items: center;
    position: absolute;
    top: 0; bottom: 0; left: 0; right: 0;
  }
  div.content {
    width: 80%;
    max-width: 1000px;
    padding: 1rem;
    border: 1px solid #999;
    border-radius: 0.25rem;
    box-shadow: 0 2px 2px 0 rgba(66, 66, 66, 0.08), 0 2px 4px 2px rgba(66, 66, 66, 0.16);
  }
  h1 {
    text-align: center;
    padding-bottom: 1rem;
    margin: 0 -1rem 1rem -1rem;
    border-bottom: 1px solid #999;
  }
 #output {
    text-align: center;
    min-height: 250px;
  }
  div#clear {
    text-align: center;
    padding-top: 1rem;
    margin: 1rem -1rem 0 -1rem;
    border-top: 1px solid #999;
  }
  input[type=text], textarea {
    width: 100%;
    padding: 1rem 0.5rem;
    margin: 0.5rem 0;
    border: 0;
    border-bottom: 1px solid #999;
    background-color: #f0f0f0;
  }
  textarea {
    height: 5rem;
  }
  small {
    color: #999;
  }
  input[type=submit], input[type=reset] {
    padding: 1rem;
    border: none;
    background-color: #6200ee;
    color: #fff;
    border-radius: 0.25rem;
    width: 25%;
  }
  .hidden {
    display: none;
  }
  .text-center {
    text-align: center;
  }
  .error {
    color: red;
  }
</style>

আপনার ক্লাউড প্রকল্প নম্বর এবং আইডি খুঁজুন

1. Google ক্লাউড কনসোলে, আপনার ক্লাউড প্রকল্পে যান।

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

2. সেটিংস এবং ইউটিলিটি > প্রকল্প সেটিংস ক্লিক করুন।

3. প্রজেক্ট নম্বর এবং প্রোজেক্ট আইডি ক্ষেত্রের মানগুলি নোট করুন। আপনি নিম্নলিখিত বিভাগে তাদের ব্যবহার করুন.

অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন

একটি Apps স্ক্রিপ্ট প্রকল্প তৈরি করতে এবং এটিকে আপনার ক্লাউড প্রকল্পের সাথে সংযুক্ত করতে:

1. Google চ্যাট অ্যাপস স্ক্রিপ্ট প্রকল্পের সাথে ঘটনার প্রতিক্রিয়া জানাতে নিম্নলিখিত বোতামে ক্লিক করুন।
   প্রকল্প খুলুন
2. ওভারভিউ-এ ক্লিক করুন।
3. ওভারভিউ পৃষ্ঠায়, ক্লিক করুন একটি অনুলিপি তৈরি করুন ।

4. Apps স্ক্রিপ্ট প্রকল্পের আপনার কপির নাম দিন:

   1. Google চ্যাটের সাথে ঘটনাগুলির প্রতিক্রিয়ার অনুলিপিতে ক্লিক করুন।

   2. প্রকল্পের শিরোনামে , Incident Management Chat app টাইপ করুন।

   3. পুনঃনামকরণ ক্লিক করুন।

5. আপনার Apps স্ক্রিপ্ট প্রকল্পের অনুলিপিতে, Consts.gs ফাইলে যান এবং আপনার ক্লাউড প্রকল্পের ID দিয়ে YOUR_PROJECT_ID প্রতিস্থাপন করুন।

অ্যাপস স্ক্রিপ্ট প্রকল্পের ক্লাউড প্রকল্প সেট করুন

1. আপনার Apps স্ক্রিপ্ট প্রকল্পে, ক্লিক করুন প্রকল্প সেটিংস
2. Google ক্লাউড প্ল্যাটফর্ম (GCP) প্রকল্পের অধীনে, প্রকল্প পরিবর্তন করুন ক্লিক করুন।
3. GCP প্রকল্প নম্বরে , আপনার ক্লাউড প্রকল্পের প্রকল্প নম্বর পেস্ট করুন।
4. সেট প্রকল্প ক্লিক করুন. ক্লাউড প্রকল্প এবং Apps স্ক্রিপ্ট প্রকল্প এখন সংযুক্ত আছে.

একটি Apps স্ক্রিপ্ট স্থাপনা তৈরি করুন৷

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

1. অ্যাপস স্ক্রিপ্টে, ঘটনা প্রতিক্রিয়া অ্যাপের প্রকল্পটি খুলুন।

   Apps Script এ যান

2. Deploy > New deployment এ ক্লিক করুন।

3. যদি অ্যাড-অন এবং ওয়েব অ্যাপ ইতিমধ্যেই নির্বাচিত না থাকে, তাহলে নির্বাচন প্রকারের পাশে, স্থাপনার প্রকারগুলি ক্লিক করুন৷ এবং অ্যাড-অন এবং ওয়েব অ্যাপ নির্বাচন করুন।

4. বিবরণে , এই সংস্করণের জন্য একটি বিবরণ লিখুন, যেমন Complete version of incident management app ।

5. Execute as তে , User to access the web app নির্বাচন করুন

6. কার কাছে অ্যাক্সেস আছে , আপনার ওয়ার্কস্পেস সংস্থার মধ্যে যে কেউ নির্বাচন করুন, যেখানে "আপনার ওয়ার্কস্পেস সংস্থা" হল আপনার Google Workspace সংস্থার নাম।

7. ডিপ্লোয় ক্লিক করুন। অ্যাপস স্ক্রিপ্ট সফল স্থাপনার রিপোর্ট করে এবং ঘটনা প্রারম্ভিক ওয়েব পৃষ্ঠার জন্য একটি স্থাপনার আইডি এবং একটি URL প্রদান করে।

8. আপনি একটি ঘটনা শুরু করার সময় পরে দেখার জন্য ওয়েব অ্যাপের URL টি নোট করুন৷ ডিপ্লয়মেন্ট আইডি কপি করুন। Google ক্লাউড কনসোলে চ্যাট অ্যাপ কনফিগার করার সময় আপনি এই আইডি ব্যবহার করেন।

9. সম্পন্ন ক্লিক করুন.

Google ক্লাউড কনসোলে চ্যাট অ্যাপ কনফিগার করুন

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

1. Google ক্লাউড কনসোলে, মেনু > আরও প্রোডাক্ট > Google Workspace > প্রোডাক্ট লাইব্রেরি > Google Chat API > Manage > Configuration-এ ক্লিক করুন।

   চ্যাট এপিআই কনফিগারেশনে যান

2. অ্যাপের নামে , Incident Management টাইপ করুন।

3. Avatar URL- এ, https://developers.google.com/chat/images/quickstart-app-avatar.png টাইপ করুন।

4. বর্ণনায় , টাইপ করুন Responds to incidents. .

5. অন ​​পজিশনে টগল করে ইন্টারেক্টিভ ফিচার সক্ষম করুন ক্লিক করুন।

6. কার্যকারিতার অধীনে, 1:1 বার্তা গ্রহণ করুন , স্পেস এবং গ্রুপ কথোপকথনে যোগ দিন নির্বাচন করুন।

7. সংযোগ সেটিংসের অধীনে, অ্যাপস স্ক্রিপ্ট নির্বাচন করুন।

8. Deployment ID এ, Apps Script Deployment ID পেস্ট করুন যা আপনি Apps Script প্রজেক্ট ডিপ্লয়মেন্ট থেকে আগে কপি করেছেন।

9. একটি স্ল্যাশ কমান্ড নিবন্ধন করুন যা সম্পূর্ণরূপে বাস্তবায়িত চ্যাট অ্যাপ ব্যবহার করে:

   1. কমান্ডের অধীনে, একটি কমান্ড যোগ করুন ক্লিক করুন।

   2. কমান্ড আইডিতে , 1 টাইপ করুন।

   3. বর্ণনায় , Closes the incident being discussed in the space.

   4. কমান্ড প্রকারের অধীনে, স্ল্যাশ কমান্ড নির্বাচন করুন।

   5. স্ল্যাশ কমান্ডের নামে , /closeIncident টাইপ করুন।

   6. একটি ডায়ালগ খোলে নির্বাচন করুন।

   7. সম্পন্ন ক্লিক করুন. স্ল্যাশ কমান্ড নিবন্ধিত এবং তালিকাভুক্ত।

10. দৃশ্যমানতার অধীনে, আপনার ওয়ার্কস্পেস ডোমেনে নির্দিষ্ট ব্যক্তি এবং গোষ্ঠীর জন্য এই চ্যাট অ্যাপটি উপলব্ধ করুন নির্বাচন করুন এবং আপনার ইমেল ঠিকানা লিখুন।

11. লগের অধীনে, লগিং করতে লগ ত্রুটি নির্বাচন করুন।

12. সংরক্ষণ করুন ক্লিক করুন. একটি কনফিগারেশন সংরক্ষিত বার্তা উপস্থিত হয়, যার অর্থ অ্যাপটি পরীক্ষা করার জন্য প্রস্তুত৷

প্রশাসকের অনুমোদন পান

অ্যাডমিনিস্ট্রেটরের অনুমোদন পেতে, আপনাকে Google Workspace Marketplace SDK-এ Chat অ্যাপ কনফিগার করতে হবে।

Google Workspace Marketplace SDK-এ Chat অ্যাপ কনফিগার করুন

Google Workspace Marketplace SDK-এ Chat অ্যাপ কনফিগার করতে, এই ধাপগুলি অনুসরণ করুন:

1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Enabled APIs & Services > Google Workspace Marketplace SDK > অ্যাপ কনফিগারেশন- এ যান।

   অ্যাপ কনফিগারেশনে যান

2. অ্যাপ কনফিগারেশন পৃষ্ঠাটি সম্পূর্ণ করুন। আপনি কীভাবে আপনার চ্যাট অ্যাপটি কনফিগার করবেন তা নির্ভর করে আপনার অভিপ্রেত শ্রোতা কারা এবং অন্যান্য বিষয়ের উপর। অ্যাপ কনফিগারেশন পৃষ্ঠা সম্পূর্ণ করতে সাহায্যের জন্য, Google Workspace Marketplace SDK-এ আপনার অ্যাপ কনফিগার করুন দেখুন। এই গাইডের উদ্দেশ্যে, নিম্নলিখিত তথ্য লিখুন:

   1. অ্যাপের দৃশ্যমানতার অধীনে, ব্যক্তিগত নির্বাচন করুন।
   2. ইনস্টলেশন সেটিংসের অধীনে, অ্যাডমিন ইনস্টল নির্বাচন করুন।
   3. অ্যাপ ইন্টিগ্রেশনের অধীনে, চ্যাট অ্যাপ নির্বাচন করুন।
   4. OAuth স্কোপের অধীনে, নিম্নলিখিত স্কোপগুলি লিখুন:
      • https://www.googleapis.com/auth/chat.app.spaces
      • https://www.googleapis.com/auth/chat.app.memberships
   5. বিকাশকারী তথ্যের অধীনে, আপনার বিকাশকারীর নাম , বিকাশকারী ওয়েবসাইট URL এবং বিকাশকারী ইমেল লিখুন।
   6. খসড়া সংরক্ষণ করুন ক্লিক করুন.

অ্যাপটি কনফিগার করার পরে, স্টোর তালিকা আপডেট করুন:

1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Enabled APIs & Services > Google Workspace Marketplace SDK > স্টোর লিস্টিং- এ যান।
2. অ্যাপের বিবরণে , বিভাগ হিসেবে ওয়েব ডেভেলপমেন্ট নির্বাচন করুন।
3. গ্রাফিক সম্পদে , অনুরোধ করা ফরম্যাটে অ্যাপ্লিকেশন আইকন আপলোড করুন।
4. স্ক্রিনশটগুলিতে , অ্যাপ্লিকেশনটির একটি স্ক্রিনশট আপলোড করুন।
5. সমর্থন লিঙ্কগুলিতে , পরিষেবার শর্তাবলী URL, গোপনীয়তা URL এবং সমর্থন URL তৈরি করুন৷
6. ডিস্ট্রিবিউশনে , সেই অঞ্চলগুলি নির্বাচন করুন যেখানে এই অ্যাপ্লিকেশনটি উপলব্ধ হবে৷
7. প্রকাশ করুন ক্লিক করুন.

প্রশাসকের অনুমোদন পান

এখন যেহেতু আপনার পরিষেবা অ্যাকাউন্ট অ্যাডমিনিস্ট্রেটরের অনুমোদন পাওয়ার জন্য কনফিগার করা হয়েছে, Google Workspace অ্যাডমিনিস্ট্রেটরের কাছ থেকে এটি নিন যিনি Chat অ্যাপের অনুমোদন সেট-আপ করার ধাপগুলি অনুসরণ করে অনুমোদন দিতে পারেন।

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

ঘটনা ব্যবস্থাপনা চ্যাট অ্যাপটি পরীক্ষা করতে, ওয়েব পৃষ্ঠা থেকে একটি ঘটনা শুরু করুন এবং যাচাই করুন যে চ্যাট অ্যাপটি প্রত্যাশা অনুযায়ী কাজ করে:

1. অ্যাপস স্ক্রিপ্ট স্থাপনার ওয়েব অ্যাপ URL-এ যান।

2. যখন Apps স্ক্রিপ্ট আপনার ডেটা অ্যাক্সেস করার অনুমতি চায়, তখন অনুমতিগুলি পর্যালোচনা করুন ক্লিক করুন, আপনার Google Workspace ডোমেনে একটি উপযুক্ত Google অ্যাকাউন্ট দিয়ে সাইন ইন করুন এবং অনুমতি দিন ক্লিক করুন।

3. ঘটনা প্রারম্ভিক ওয়েব পৃষ্ঠা খোলে. পরীক্ষার তথ্য লিখুন:

   1. ঘটনার শিরোনামে , The First Incident টাইপ করুন।
   2. ঐচ্ছিকভাবে, ঘটনা উত্তরদাতাদের মধ্যে, আপনার সহকর্মী ঘটনার উত্তরদাতাদের ইমেল ঠিকানা লিখুন। তাদের অবশ্যই আপনার Google Workspace সংস্থার Google Chat অ্যাকাউন্টের ব্যবহারকারী হতে হবে অথবা স্পেস তৈরি করতে ব্যর্থ হবে। আপনার নিজের ইমেল ঠিকানা লিখবেন না কারণ এটি স্বয়ংক্রিয়ভাবে অন্তর্ভুক্ত।
   3. প্রাথমিক বার্তায় , Testing the incident management Chat app.

4. চ্যাট স্পেস তৈরি করুন ক্লিক করুন। একটি creating space বার্তা প্রদর্শিত হবে.

5. স্পেস তৈরি হওয়ার পর একটা Space created! বার্তা প্রদর্শিত হয়। Open Space-এ ক্লিক করুন, যা একটি নতুন ট্যাবে চ্যাটে স্পেস খোলে।

6. ঐচ্ছিকভাবে, আপনি এবং অন্যান্য ঘটনার উত্তরদাতারা স্পেসে বার্তা পাঠাতে পারেন। অ্যাপটি ভার্টেক্স এআই ব্যবহার করে এই বার্তাগুলিকে সংক্ষিপ্ত করে এবং একটি পূর্ববর্তী নথি শেয়ার করে৷

7. ঘটনার প্রতিক্রিয়া শেষ করতে এবং রেজোলিউশন প্রক্রিয়া শুরু করতে, চ্যাট স্পেসে, /closeIncident টাইপ করুন। একটি ঘটনা ব্যবস্থাপনা ডায়ালগ খোলে।

8. ক্লোজ ইভেন্টে , ঘটনার রেজোলিউশনের জন্য একটি বিবরণ লিখুন, যেমন Test complete ।

9. ঘটনা বন্ধ করুন ক্লিক করুন।

ইনসিডেন্ট ম্যানেজমেন্ট অ্যাপটি স্থানের বার্তাগুলিকে তালিকাভুক্ত করে, ভার্টেক্স এআই দিয়ে সেগুলিকে সংক্ষিপ্ত করে, একটি Google ডক্স ডকুমেন্টে সারাংশ পেস্ট করে এবং নথিটিকে স্পেসে শেয়ার করে।

পরিষ্কার করুন

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

সতর্কতা: একটি প্রকল্প মুছে ফেলার নিম্নলিখিত প্রভাব রয়েছে:

• প্রকল্পের সবকিছু মুছে ফেলা হয়েছে। আপনি যদি এই টিউটোরিয়ালের জন্য একটি বিদ্যমান প্রকল্প ব্যবহার করেন, আপনি এটি মুছে ফেললে, আপনি প্রকল্পে আপনার করা অন্য কোনো কাজও মুছে ফেলবেন।
• কাস্টম প্রকল্প আইডি হারিয়ে গেছে। আপনি যখন এই প্রকল্পটি তৈরি করেছেন, আপনি হয়ত একটি কাস্টম প্রকল্প আইডি তৈরি করেছেন যা আপনি ভবিষ্যতে ব্যবহার করতে চান৷ প্রজেক্ট আইডি ব্যবহার করে এমন ইউআরএল সংরক্ষণ করতে, যেমন appspot.com-এ একটি ইউআরএল, পুরো প্রোজেক্ট মুছে ফেলার পরিবর্তে প্রোজেক্টের মধ্যে নির্বাচিত রিসোর্স মুছে দিন।

আপনি যদি একাধিক টিউটোরিয়াল এবং কুইকস্টার্ট অন্বেষণ করার পরিকল্পনা করেন, প্রকল্পগুলি পুনঃব্যবহার করা আপনাকে প্রকল্পের কোটা সীমা অতিক্রম এড়াতে সাহায্য করতে পারে।

1. Google ক্লাউড কনসোলে, সম্পদ পরিচালনা পৃষ্ঠাতে যান। মেনু > আইএএম এবং অ্যাডমিন > সম্পদ পরিচালনা করুন ক্লিক করুন।

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

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

সম্পর্কিত বিষয়

• একটি Gemini AI Chat অ্যাপের সাথে চ্যাট কথোপকথনের উপর ভিত্তি করে প্রশ্নের উত্তর দিন
• Google Chat, Vertex AI, এবং Firestore-এর মাধ্যমে প্রজেক্ট পরিচালনা করুন
• Google Chat, Vertex AI, এবং Apps Script (ব্যবহারকারীর প্রমাণীকরণ) এর সাথে ঘটনার প্রতিক্রিয়া জানান
• ঘটনা প্রতিক্রিয়া অ্যাপটি API-কে কল করতে এবং চ্যাট API এবং Vertex AI API-এর মতো Google ক্লাউড পরিষেবাগুলি শুরু করার জন্য ব্যবহারকারীর শংসাপত্রগুলির সাথে প্রমাণীকরণ করে। এর মানে হল যে ব্যবহারকারীর একটি ঘটনা শুরু করা এই পরিষেবাগুলিতে অ্যাক্সেস থাকতে হবে। অ্যাপটিকে আরও শক্তিশালী করতে, /closeIncident স্ল্যাশ কমান্ড ব্যবহারকারী ব্যবহারকারীর ব্যবহারকারীর শংসাপত্রের পরিবর্তে পরিষেবা অ্যাকাউন্ট হিসাবে Vertex AI API-কে কল করার কথা বিবেচনা করুন। Vertex AI API-এর জন্য একটি পরিষেবা অ্যাকাউন্ট কনফিগার করতে সাহায্যের জন্য, একটি কাস্টম পরিষেবা অ্যাকাউন্ট ব্যবহার করুন দেখুন।