Google Workspace জুড়ে অ্যাক্সেসযোগ্য একটি AI এজেন্টের সাথে ভ্রমণের পরিকল্পনা করুন

কোডিং স্তর : উন্নত
সময়কাল : ৪৫ মিনিট
প্রকল্পের ধরণ : Google Workspace অ্যাড-অন যা Chat , Gmail , Calendar , Drive , Docs, Sheets এবং Slides প্রসারিত করে।

এই টিউটোরিয়ালটি আপনাকে দেখাবে কিভাবে অ্যাপস স্ক্রিপ্ট বা HTTP এন্ডপয়েন্ট ব্যবহার করে Google Workspace-এ AI এজেন্টদের Google Workspace অ্যাড-অন হিসেবে প্রকাশ করতে হয়। আপনার অ্যাড-অন প্রকাশের পর, আপনার ব্যবহারকারীরা তাদের কর্মপ্রবাহের মধ্যে AI এজেন্টদের সাথে যোগাযোগ করতে পারবেন।

সংক্ষিপ্ত বিবরণ

এই টিউটোরিয়ালে, আপনি এজেন্ট ডেভেলপমেন্ট কিট (ADK) থেকে ট্র্যাভেল কনসিয়ারজ নমুনাটি স্থাপন করবেন। ট্র্যাভেল কনসিয়ারজ হল একটি কথোপকথনমূলক মাল্টি-এজেন্ট এআই যা গুগল ম্যাপস প্ল্যাটফর্ম প্লেস এপিআই, গুগল সার্চ গ্রাউন্ডিং এবং একটি মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভারের মতো সরঞ্জাম ব্যবহার করে।

ADK ডিফল্টরূপে ডেভেলপারদের জন্য চ্যাট এবং টেক্সট ইন্টারফেস প্রদান করে। এই টিউটোরিয়ালে, আপনি Google Workspace অ্যাপ্লিকেশনগুলিতে একটি গ্রাফিক্যাল ইউজার ইন্টারফেস (GUI) যোগ করবেন যা আপনার ব্যবহারকারীরা সরাসরি Chat, Gmail, Calendar, Drive, Docs, Sheets এবং Slides-এ অ্যাক্সেস করতে পারবেন।

  • ভ্রমণের ধারণা নিয়ে আলোচনা করার জন্য চ্যাটের এআই এজেন্ট ব্যবহার করা।
    চিত্র ১. ভ্রমণের ধারণা নিয়ে আলোচনা করার জন্য চ্যাটের এআই এজেন্ট ব্যবহার করা।
  • নির্বাচিত ইমেলের প্রেক্ষাপট থেকে ভ্রমণের পরিকল্পনা করতে Gmail থেকে AI এজেন্ট ব্যবহার করা।
    চিত্র ২. নির্বাচিত ইমেলের প্রেক্ষাপট থেকে ভ্রমণ পরিকল্পনা করতে Gmail থেকে AI এজেন্ট ব্যবহার করা।

উদ্দেশ্য

  • পরিবেশ ঠিক করুন।
  • এআই এজেন্ট মোতায়েন করুন।
  • প্রকল্পটি সেট আপ করুন।
  • Gmail, ক্যালেন্ডার, ড্রাইভ, ডক্স, শিট, স্লাইডে স্থাপন করুন।
  • চ্যাটে স্থাপন করুন।
  • সমাধানটি পরীক্ষা করুন।

এই সমাধান সম্পর্কে

এই সমাধানটি নিম্নলিখিত মূল প্রযুক্তির উপর নির্ভর করে: ADK, Google Cloud এবং Google Workspace API , Vertex AI Agent Engine , এবং Card ফ্রেমওয়ার্ক ।

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

ফিচার

ট্র্যাভেল কনসিয়ারজ অ্যাপ্লিকেশনের নিম্নলিখিত বৈশিষ্ট্যগুলি সমস্ত গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনগুলিতে সাধারণ:

  • স্থায়ী ব্যবহারকারীর সেশন: স্থায়ীত্বের জন্য সেশনগুলি Vertex AI দ্বারা পরিচালিত হয়। প্রতিটি ব্যবহারকারী সমস্ত Workspace অ্যাপ্লিকেশন জুড়ে একটি করে সেশন ভাগ করে নেয়। ব্যবহারকারীরা একটি নতুন কথোপকথন শুরু করতে ম্যানুয়ালি তাদের সেশনটি রিসেট করতে পারেন।

  • সমৃদ্ধ বার্তা: ব্যবহারকারীরা সমৃদ্ধ পাঠ্য এবং কার্ড উইজেটের মাধ্যমে পাঠ্য বার্তা পাঠান এবং প্রতিক্রিয়া গ্রহণ করেন।

  • ত্রুটি পরিচালনা: প্রতিক্রিয়াগুলিতে কনফিগারযোগ্য পুনঃপ্রচেষ্টা এবং স্ট্যাটাস ব্যবহার করে অপ্রত্যাশিত ত্রুটিগুলি সুন্দরভাবে পরিচালনা করা হয়।

চ্যাট অ্যাপটিতে নিম্নলিখিত অতিরিক্ত বৈশিষ্ট্য রয়েছে:

  • মাল্টিমোডাল ইউজার মেসেজিং: ব্যবহারকারীরা চ্যাট স্পেস থেকে সরাসরি রেকর্ড করা অডিও এবং ভিডিও সহ সংযুক্তি সহ বার্তা পাঠাতে পারেন।

  • আরও দৃশ্যমানভাবে উন্নত প্রতিক্রিয়া: কার্ড ফ্রেমওয়ার্কের চ্যাট-অনলি বৈশিষ্ট্য এবং আরও রেন্ডারিং স্পেসের উপর নির্ভর করে চিত্র সহ ক্যারোসেলের মতো আরও উন্নত উইজেটগুলির সাহায্যে প্রতিক্রিয়া তৈরি করা যেতে পারে।

অন্যান্য অ্যাপ্লিকেশনগুলিতে এই অতিরিক্ত বৈশিষ্ট্যগুলি রয়েছে:

  • গুগল প্রোফাইল প্রসঙ্গ: ব্যবহারকারীরা তাদের প্রোফাইল তথ্য সহ বার্তা পাঠাতে পারেন (এই নমুনায় জন্মদিনের মধ্যে সীমাবদ্ধ)।

  • জিমেইল প্রসঙ্গ: ব্যবহারকারীরা ইমেল সহ বার্তা পাঠাতে পারেন (এই নমুনায় একটি বিষয় এবং মূল অংশের মধ্যে সীমাবদ্ধ)।

  • এজেন্টের চ্যাট স্পেস অ্যাক্সেস: ব্যবহারকারীরা একটি বোতাম ক্লিক করে একটি নতুন ট্যাবে চ্যাট অ্যাপ ডাইরেক্ট মেসেজ (DM) স্পেস খুলতে পারবেন।

স্থাপত্য

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

নিম্নলিখিত চিত্রগুলি প্রধান ব্যবহারকারী প্রবাহ দেখায়: AI এজেন্টকে একটি বার্তা পাঠান।

HTTP সম্পর্কে

  • চ্যাট অ্যাপের জন্য আর্কিটেকচার ডায়াগ্রাম।
    চিত্র ৩. চ্যাট অ্যাপটি ব্যবহারকারীর বার্তা থেকে সংযুক্তি সহ প্রসঙ্গটি সম্পূর্ণ করে এবং সাব-এজেন্ট ইন্টারঅ্যাকশনের ইতিহাস এবং চূড়ান্ত সামগ্রিক উত্তর কালানুক্রমিক ক্রমে সহ বার্তাগুলির একটি সেট পাঠায়।
  • চ্যাট-বহির্ভূত অ্যাপ্লিকেশনগুলির জন্য স্থাপত্য চিত্র।
    চিত্র ৪. চ্যাটবিহীন অ্যাপ্লিকেশনগুলি ব্যবহারকারীর গুগল প্রোফাইল এবং আইটেম নির্বাচনের সাথে প্রসঙ্গটি সম্পূর্ণ করে এবং সাব-এজেন্ট ইন্টারঅ্যাকশনের ইতিহাস এবং চূড়ান্ত সামগ্রিক উত্তর বিপরীত কালানুক্রমিক ক্রমে প্রদর্শন করে।

অ্যাপস স্ক্রিপ্ট

  • চ্যাট অ্যাপের জন্য আর্কিটেকচার ডায়াগ্রাম।
    চিত্র ৩. চ্যাট অ্যাপটি ব্যবহারকারীর বার্তা থেকে সংযুক্তি সহ প্রসঙ্গটি সম্পূর্ণ করে এবং সাব-এজেন্ট ইন্টারঅ্যাকশনের ইতিহাস এবং চূড়ান্ত সামগ্রিক উত্তর কালানুক্রমিক ক্রমে সহ বার্তাগুলির একটি সেট পাঠায়।
  • চ্যাট-বহির্ভূত অ্যাপ্লিকেশনগুলির জন্য স্থাপত্য চিত্র।
    চিত্র ৪. চ্যাটবিহীন অ্যাপ্লিকেশনগুলি ব্যবহারকারীর গুগল প্রোফাইল এবং আইটেম নির্বাচনের সাথে প্রসঙ্গটি সম্পূর্ণ করে এবং সাব-এজেন্ট ইন্টারঅ্যাকশনের ইতিহাস এবং চূড়ান্ত সামগ্রিক উত্তর বিপরীত কালানুক্রমিক ক্রমে প্রদর্শন করে।

পূর্বশর্ত

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

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

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

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

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

    একটি প্রকল্প তৈরি করুন বিভাগে যান।

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

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

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

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

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

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

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

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

  1. গুগল ক্লাউড কনসোলে, বিলিং এ যান। মেনু > বিলিং > মাই প্রোজেক্টস এ ক্লিক করুন।

    আমার প্রকল্পের জন্য বিলিং বিভাগে যান।

  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 ক্লাউড প্রকল্পের সাথে লিঙ্ক করার জন্য বিলিং অ্যাকাউন্ট আইডি ।

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

HTTP সম্পর্কে

  1. গুগল ক্লাউড কনসোলে, ভার্টেক্স এআই, প্লেসেস, পিপল, গুগল চ্যাট, জিমেইল, ক্লাউড বিল্ড, ক্লাউড ফাংশন, ক্লাউড পাব/সাব, ক্লাউড লগিং, আর্টিফ্যাক্ট রেজিস্ট্রি, ক্লাউড রান এবং গুগল ওয়ার্কস্পেস অ্যাড-অন API সক্রিয় করুন।

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

  2. নিশ্চিত করুন যে আপনি সঠিক ক্লাউড প্রজেক্টে API গুলি সক্রিয় করছেন, তারপর Next এ ক্লিক করুন।

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

অ্যাপস স্ক্রিপ্ট

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

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

  2. নিশ্চিত করুন যে আপনি সঠিক ক্লাউড প্রজেক্টে API গুলি সক্রিয় করছেন, তারপর Next এ ক্লিক করুন।

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

একটি গুগল ম্যাপস প্ল্যাটফর্ম প্লেস এপিআই কী পান

  1. গুগল ক্লাউড কনসোলে, গুগল ম্যাপস প্ল্যাটফর্ম > কী এবং শংসাপত্র পৃষ্ঠায় যান।

    কী এবং শংসাপত্রগুলিতে যান

  2. "গুগল ম্যাপস প্ল্যাটফর্মে শুরু করুন " ডায়ালগটি আপনার নতুন তৈরি API কী, একটি আলফানিউমেরিক স্ট্রিং প্রদর্শন করবে। পরবর্তী বিভাগগুলিতে আপনার এই স্ট্রিংটির প্রয়োজন হবে।

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

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

Google Workspace অ্যাড-অনগুলির জন্য একটি সম্মতি স্ক্রিন কনফিগারেশন প্রয়োজন। আপনার অ্যাড-অনের OAuth সম্মতি স্ক্রিন কনফিগার করার মাধ্যমে Google ব্যবহারকারীদের কাছে কী প্রদর্শন করে তা নির্ধারণ করা হয়।

  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 সম্মতি নির্দেশিকাটি দেখুন।

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

  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. এই GitHub সংগ্রহস্থলটি ডাউনলোড করুন

    ডাউনলোড করুন

  3. আপনার পছন্দের স্থানীয় ডেভেলপমেন্ট পরিবেশে, ডাউনলোড করা আর্কাইভ ফাইলটি বের করুন এবং adk-samples/python/agents/travel-concierge ডিরেক্টরিটি খুলুন।

    unzip adk-samples-main.zip
cd adk-samples-main/python/agents/travel-concierge

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

    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=1
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
export GOOGLE_PLACES_API_KEY=PLACES_API_KEY
export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME
export TRAVEL_CONCIERGE_SCENARIO=travel_concierge/profiles/itinerary_empty_default.json

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

    1. আপনার তৈরি ক্লাউড প্রকল্পের আইডি সহ PROJECT_ID ।
    2. আপনার তৈরি ক্লাউড প্রকল্পের অবস্থান সহ PROJECT_LOCATION ।
    3. আপনার তৈরি করা API কী-এর স্ট্রিং সহ PLACES_API_KEY ।
    4. আপনার তৈরি বাকেটের নাম সহ CLOUD_STORAGE_BUCKET_NAME ।

  6. ADK AI এজেন্ট ইনস্টল এবং স্থাপন করুন।

    uv sync --group deployment
uv run python deployment/deploy.py --create

  7. শেষ মুদ্রিত লগ থেকে যথাক্রমে PROJECT_NUMBER এবং ENGINE_ID হিসাবে প্রকল্প নম্বর এবং ইঞ্জিন আইডি পুনরুদ্ধার করুন, আপনার প্রকল্পটি কনফিগার করার জন্য পরে উভয়েরই প্রয়োজন হবে। 

    Created remote agent: projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/ENGINE_ID

নমুনা কোডটি পর্যালোচনা করুন

ঐচ্ছিকভাবে, প্রকল্পটি সেট আপ করার আগে, GitHub-এ হোস্ট করা নমুনা কোডটি পর্যালোচনা করার জন্য এবং তার সাথে নিজেকে পরিচিত করার জন্য কিছুক্ষণ সময় নিন।

পাইথন

GitHub-এ দেখুন

অ্যাপস স্ক্রিপ্ট

GitHub-এ দেখুন

প্রকল্পটি তৈরি এবং কনফিগার করুন

পাইথন

  1. এই GitHub সংগ্রহস্থলটি ডাউনলোড করুন

    ডাউনলোড করুন

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

    unzip add-ons-samples-main.zip
cd add-ons-samples-main/python/travel-adk-ai-agent

  3. পূর্ববর্তী ধাপে ডাউনলোড করা পরিষেবা অ্যাকাউন্ট থেকে JSON কী ফাইল credentials.json প্রজেক্ট ডিরেক্টরিতে সরান।

  4. গুগল ক্লাউড কনসোলে, ক্লাউড রান এ যান:

    ক্লাউড রানে যান

  5. একটি ফাংশন লিখুন ক্লিক করুন।

  6. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট আপ করুন:

    1. পরিষেবার নাম ক্ষেত্রে, travel-concierge-app লিখুন।
    2. অঞ্চল তালিকায়, আপনার তৈরি ক্লাউড প্রকল্পের অবস্থান নির্বাচন করুন, PROJECT_LOCATION ।
    3. এন্ডপয়েন্ট URL এর অধীনে, ক্লিক করুন একটি কপি তৈরির আইকন .
    4. রানটাইম তালিকায়, পাইথনের সাম্প্রতিকতম সংস্করণটি নির্বাচন করুন।
    5. প্রমাণীকরণ বিভাগে, সর্বজনীন অ্যাক্সেসের অনুমতি দিন নির্বাচন করুন।
    6. কন্টেইনার, ভলিউম, নেটওয়ার্কিং, নিরাপত্তা বিভাগে, সম্পদের অধীনে:
      1. মেমোরি ক্ষেত্রে, 1 GiB নির্বাচন করুন।
      2. CPU ক্ষেত্রে, 2 নির্বাচন করুন।
    7. Create এ ক্লিক করুন, এবং Cloud Run পরিষেবা তৈরি করার জন্য অপেক্ষা করুন। কনসোল আপনাকে Source ট্যাবে পুনঃনির্দেশিত করে।

  7. আপনার পছন্দের স্থানীয় উন্নয়ন পরিবেশে, প্রকল্পের উৎস স্থাপন করুন: 

    gcloud run deploy travel-concierge-app --quiet --source . \
    --region PROJECT_LOCATION  \
    --function adk_ai_agent  \
    --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

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

    1. আপনার পূর্বে তৈরি করা ক্লাউড রান ফাংশনের অবস্থান সহ PROJECT_LOCATION ।
    2. LOCATION পূর্ববর্তী ধাপে তৈরি Google ক্লাউড প্রকল্পের অবস্থান সহ, PROJECT_LOCATION ।
    3. পূর্ববর্তী ধাপে মোতায়েন করা ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্টের প্রকল্প নম্বর সহ PROJECT_NUMBER ।
    4. পূর্ববর্তী ধাপে মোতায়েন করা ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্টের ইঞ্জিন আইডি সহ ENGINE_ID ।
    5. BASE_URL যেটি আপনি পূর্বে কপি করেছিলেন সেই এন্ডপয়েন্ট URL সহ।

অ্যাপস স্ক্রিপ্ট

একটি অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করতে এবং আপনার মোতায়েন করা ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্ট ব্যবহারের জন্য এটি কনফিগার করতে:

  1. ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্ট অ্যাপস স্ক্রিপ্ট প্রকল্পটি খুলতে নিম্নলিখিত বোতামটি ক্লিক করুন।
    প্রকল্পটি খুলুন

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

  3. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টের কপিটির নাম দিন:

    1. ট্রাভেল কনসিয়ারজ ADK AI এজেন্টের কপিতে ক্লিক করুন।
    2. প্রকল্পের শিরোনামে , টাইপ করুন Travel Concierge ADK AI Agent ।
    3. পুনঃনামকরণ ক্লিক করুন।

  4. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টে, ক্লিক করুন প্রকল্প সেটিংসের আইকন ফাইল অ্যাকশন ব্যবহার করে VertexAi.gs ফাইলটি এডিট করুন এবং AgentHandler.gs ফাইলের উপরে না আসা পর্যন্ত উপরে সরান।

  5. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টে, ক্লিক করুন প্রকল্প সেটিংসের আইকন প্রজেক্ট সেটিংস , Edit script properties এ ক্লিক করুন, তারপর নিম্নলিখিত স্ক্রিপ্ট প্রোপার্টি যোগ করতে Add script property এ ক্লিক করুন:

  6. ENGINE_ID পূর্ববর্তী ধাপে মোতায়েন করা ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্টের ইঞ্জিন আইডি সহ, ENGINE_ID ।

  7. LOCATION পূর্ববর্তী ধাপে তৈরি Google ক্লাউড প্রকল্পের অবস্থান সহ, PROJECT_LOCATION ।

  8. পূর্ববর্তী ধাপে মোতায়েন করা ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্টের প্রকল্প নম্বর সহ PROJECT_NUMBER , PROJECT_NUMBER ।

  9. পূর্ববর্তী ধাপে ডাউনলোড করা পরিষেবা অ্যাকাউন্ট থেকে JSON কী সহ SERVICE_ACCOUNT_KEY , যেমন { ... } ।

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

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

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

  13. GCP প্রজেক্ট নম্বরে , পূর্ববর্তী ধাপে মোতায়েন করা ট্র্যাভেল কনসিয়ারজ ADK AI এজেন্টের প্রজেক্ট নম্বর, PROJECT_NUMBER পেস্ট করুন।

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

Gmail, ক্যালেন্ডার, ড্রাইভ, ডক্স, শীট, স্লাইডে স্থাপন করুন

পাইথন

পরীক্ষা সক্ষম করতে সমস্ত Google Workspace অ্যাপ্লিকেশনে (গুগল চ্যাট ছাড়া) নমুনা প্রকল্পটি ইনস্টল করতে একটি Google Workspace অ্যাড-অন ডিপ্লয়মেন্ট ব্যবহার করুন।

  1. আপনার পছন্দের স্থানীয় ডেভেলপমেন্ট পরিবেশে, প্রকল্পের কোড উৎস থেকে deployment.json ফাইলটি খুলুন এবং $BASE_URL এর সমস্ত ঘটনাকে BASE_URL এর মান দিয়ে প্রতিস্থাপন করুন, যা পূর্ববর্তী ধাপগুলিতে আপনি যে Endpoint URL টি অনুলিপি করেছিলেন।

  2. travel-concierge-addon নামে একটি Google Workspace অ্যাড-অন ডিপ্লয়মেন্ট তৈরি করুন : 

    gcloud workspace-add-ons deployments create travel-concierge-addon \
    --deployment-file=deployment.json

  3. Google Workspace অ্যাড-অন ডিপ্লয়মেন্ট ইনস্টল করুন: 

    gcloud workspace-add-ons deployments install travel-concierge-addon

অ্যাপস স্ক্রিপ্ট

টেস্টিং সক্ষম করতে সমস্ত Google Workspace অ্যাপ্লিকেশনে (গুগল চ্যাট ছাড়া) অ্যাপস স্ক্রিপ্ট প্রজেক্ট ইনস্টল করুন।

  1. আপনার Apps Script প্রজেক্টে, Deploy > Test deployments এ ক্লিক করুন, তারপর Install এ ক্লিক করুন।

অ্যাড-অনটি এখন গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনের সাইডবার থেকে অ্যাক্সেসযোগ্য।

চ্যাটে স্থাপন করুন

পাইথন

পরীক্ষা সক্ষম করতে এন্ডপয়েন্ট URL ব্যবহার করে Chat-এ নমুনা প্রকল্পটি ইনস্টল করুন।

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

    Google Chat API কনফিগারেশন পৃষ্ঠায় যান

  2. চ্যাট অ্যাপ সেট আপ করুন:

    1. অ্যাপের নামের ক্ষেত্রে, Travel ADK AI Agent লিখুন।
    2. Avatar URL ফিল্ডে, https://goo.gle/3SfMkjb লিখুন।
    3. বর্ণনা ক্ষেত্রে, Travel ADK AI Agent লিখুন।
    4. সংযোগ সেটিংসের অধীনে, HTTP এন্ডপয়েন্ট URL নির্বাচন করুন।
    5. ট্রিগারের অধীনে, সকল ট্রিগারের জন্য একটি সাধারণ HTTP এন্ডপয়েন্ট URL ব্যবহার করুন নির্বাচন করুন।
    6. HTTP এন্ডপয়েন্ট URL ক্ষেত্রে, আপনার পূর্বে কপি করা এন্ডপয়েন্ট URL , BASE_URL , পেস্ট করুন।
    7. সম্পূর্ণরূপে বাস্তবায়িত চ্যাট অ্যাপটি ব্যবহার করে এমন একটি দ্রুত কমান্ড নিবন্ধন করুন:
      1. কমান্ডের অধীনে, একটি কমান্ড যোগ করুন ক্লিক করুন।
      2. কমান্ড আইডিতে , 1 টাইপ করুন।
      3. Description- এ, Reset session টাইপ করুন।
      4. কমান্ড টাইপের অধীনে, দ্রুত কমান্ড নির্বাচন করুন।
      5. Name তে, Reset session টাইপ করুন।
      6. সম্পন্ন ক্লিক করুন। দ্রুত কমান্ডটি নিবন্ধিত এবং তালিকাভুক্ত।
    8. দৃশ্যমানতার অধীনে, আপনার কর্মক্ষেত্র ডোমেনের নির্দিষ্ট ব্যক্তি এবং গোষ্ঠীর জন্য এই চ্যাট অ্যাপটি উপলব্ধ করুন নির্বাচন করুন এবং আপনার ইমেল ঠিকানা লিখুন।
    9. লগস এর অধীনে, লগ ত্রুটি থেকে লগিং নির্বাচন করুন।
    10. সংরক্ষণ করুন ক্লিক করুন।

অ্যাপস স্ক্রিপ্ট

টেস্টিং সক্ষম করতে হেড ডিপ্লয়মেন্ট আইডি ব্যবহার করে চ্যাটে অ্যাপস স্ক্রিপ্ট প্রজেক্ট ইনস্টল করুন।

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

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

    Google Chat API কনফিগারেশন পৃষ্ঠায় যান

  3. চ্যাট অ্যাপ সেট আপ করুন:

    1. অ্যাপের নামের ক্ষেত্রে, Travel ADK AI Agent লিখুন।
    2. Avatar URL ফিল্ডে, https://goo.gle/3SfMkjb লিখুন।
    3. বর্ণনা ক্ষেত্রে, Travel ADK AI Agent লিখুন।
    4. সংযোগ সেটিংসের অধীনে, অ্যাপস স্ক্রিপ্ট নির্বাচন করুন।
    5. ডিপ্লয়মেন্ট আইডি ফিল্ডে, আপনার পূর্বে কপি করা হেড ডিপ্লয়মেন্ট আইডিটি পেস্ট করুন।
    6. সম্পূর্ণরূপে বাস্তবায়িত চ্যাট অ্যাপটি ব্যবহার করে এমন একটি দ্রুত কমান্ড নিবন্ধন করুন:
      1. কমান্ডের অধীনে, একটি কমান্ড যোগ করুন ক্লিক করুন।
      2. কমান্ড আইডিতে , 1 টাইপ করুন।
      3. Description- এ, Reset session টাইপ করুন।
      4. কমান্ড টাইপের অধীনে, দ্রুত কমান্ড নির্বাচন করুন।
      5. Name তে, Reset session টাইপ করুন।
      6. সম্পন্ন ক্লিক করুন। দ্রুত কমান্ডটি নিবন্ধিত এবং তালিকাভুক্ত।
    7. দৃশ্যমানতার অধীনে, আপনার কর্মক্ষেত্র ডোমেনের নির্দিষ্ট ব্যক্তি এবং গোষ্ঠীর জন্য এই চ্যাট অ্যাপটি উপলব্ধ করুন নির্বাচন করুন এবং আপনার ইমেল ঠিকানা লিখুন।
    8. লগস এর অধীনে, লগ ত্রুটি থেকে লগিং নির্বাচন করুন।
    9. সংরক্ষণ করুন ক্লিক করুন।

অ্যাপটি এখন গুগল চ্যাট থেকে অ্যাক্সেসযোগ্য।

  1. গুগল চ্যাট খুলুন।

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

  2. চ্যাট ডিএম স্পেস তৈরি করুন:

    1. নতুন চ্যাট এ ক্লিক করুন।
    2. অনুসন্ধানে Travel ADK AI Agent অ্যাপটি টাইপ করুন এবং নির্বাচন করুন।
    3. Install app ডায়ালগে, Install app এ ক্লিক করুন।
    4. Install app ডায়ালগটি বন্ধ হয়ে যায় এবং নতুন তৈরি চ্যাট ডিএম স্পেসটি নির্বাচন করা হয়।

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

এজেন্ট পরীক্ষা করুন

  1. জিমেইল খুলুন।

    জিমেইলে যান

  2. নিম্নলিখিত ইমেলটি নিজেকে পাঠান:

    • বিষয়: You need to travel to Paris
    • মূল বক্তব্য: Please be there between 11/25/2025 and 11/30/2025!

  3. সাইডবার থেকে ট্র্যাভেল ADK AI এজেন্ট অ্যাড-অনটি খুলুন।

  4. অ্যাড-অন সেট আপ সম্পূর্ণ করতে অনুমতি প্রদান করুন -এ ক্লিক করুন।

  5. এজেন্টের কাছে নিম্নলিখিত অনুরোধটি কনফিগার করার পরে পাঠান ক্লিক করুন:

    • বার্তা: Please help me plan this travel!
    • প্রসঙ্গ: বর্তমান ইমেল নির্বাচন করুন

    এজেন্টের প্রতিক্রিয়ার সাথে সাইডবারটি আপডেট করা হয়েছে।

    Gmail থেকে ভ্রমণের পরিকল্পনা করুন

  6. চ্যাট ডিএম স্পেসে পুনঃনির্দেশিত করতে "চ্যাট খুলুন" এ ক্লিক করুন।

  7. + > সেশন রিসেট করুন এ ক্লিক করুন।

    আপনি একটি নতুন বার্তা পাবেন যা নিশ্চিত করে যে এটি সম্পন্ন হয়েছে: OK, let's start from the beginning, what can I help you with?

  8. বার্তাটি পাঠান। Give me ideas ।

    আপনি এজেন্টের প্রতিক্রিয়া সহ নতুন বার্তা পাবেন।

    চ্যাট থেকে ব্রেনস্টর্ম

  9. আইফেল টাওয়ারের মতো যেকোনো স্থানের ছবি আপলোড করার পর I want to go there! বার্তাটি পাঠান।

    আপনি এজেন্টের প্রতিক্রিয়া সহ নতুন বার্তা পাবেন।

    চ্যাট অ্যাটাচমেন্ট থেকে লোকেশনের বিবরণ পান

সীমাবদ্ধতা

HTTP সম্পর্কে

চ্যাট ছাড়া অন্যান্য Google Workspace অ্যাপ্লিকেশনগুলিতে, AI এজেন্টের নিম্নলিখিত সীমাবদ্ধতা রয়েছে:

  • এটি সিঙ্ক্রোনাস: সাইডবারগুলি শুধুমাত্র ব্যবহারকারীর মিথস্ক্রিয়ার প্রতিক্রিয়ায় আপডেট করা যেতে পারে, তাই AI এজেন্টের প্রতিক্রিয়াগুলি সম্পূর্ণ সমাপ্তির পরেই প্রদর্শিত হয় (কোনও স্ট্রিমিং নেই)।

  • এটির সময় শেষ হতে পারে: সাইডবারটি সময় শেষ হতে কয়েক মিনিটের বেশি সময় নিলে আপডেট করে।

চ্যাটে এই সীমাবদ্ধতাগুলি বিদ্যমান নেই।

অ্যাপস স্ক্রিপ্ট

সমস্ত Google Workspace অ্যাপ্লিকেশনে, AI এজেন্ট UrlFetchApp ব্যবহার করে Vertex AI REST API গুলিকে কল করে, যার ফলে নিম্নলিখিত সীমাবদ্ধতাগুলি দেখা দেয়:

  • এটি সিঙ্ক্রোনাস: এআই এজেন্টের প্রতিক্রিয়াগুলি সম্পূর্ণ সমাপ্তির পরেই ফেরত পাঠানো হয় (কোনও স্ট্রিমিং নেই)।

  • এটির সময় শেষ হতে পারে: এআই এজেন্ট যখন প্রায় এক মিনিটেরও বেশি সময় নেয় তখন তারা সময় শেষ করার অনুরোধ করে।

কাস্টমাইজেশন

এই সমাধানটি Vertex AI Agent Engine-এ হোস্ট করা ADK AI এজেন্টদের সমর্থন করে, যা Google Workspace অ্যাপ্লিকেশন UI-এর একটি উপসেট, এবং Travel Concierge নমুনার প্রতিক্রিয়াগুলির জন্য নির্দিষ্ট প্রতিক্রিয়া রেন্ডারিং। সমাধানটি একটি এক্সটেনসিবল ফ্রেমওয়ার্ক ব্যবহার করে, তাই আপনি নিম্নলিখিত ফাইলগুলি পরিবর্তন করে এটি কাস্টমাইজ করতে পারেন:

পাইথন

  • main.py: প্রধান UI এবং ব্যবহারকারীর ইন্টারঅ্যাকশন লজিক (গুগল ওয়ার্কস্পেস ইভেন্ট হ্যান্ডলার) সংজ্ঞায়িত করে। একটি সাধারণ এক্সটেনশন হল ড্রাইভ অ্যাপ্লিকেশনের জন্য ড্রাইভ ডকুমেন্টগুলিকে প্রসঙ্গ বৈশিষ্ট্য হিসাবে সক্ষম করা, যা Gmail অ্যাপ্লিকেশনের জন্য Gmail বার্তাগুলির সাথে করা হয়।

  • vertex_ai.py: AI এজেন্ট সেশন, প্রতিক্রিয়া, ত্রুটি পরিচালনা করে এবং এজেন্ট ইন্টারঅ্যাকশন এবং প্রতিক্রিয়া রেন্ডারিং সমর্থন করার জন্য বাস্তবায়নের জন্য Vertex AI-নির্দিষ্ট ইন্টারফেসগুলি সংজ্ঞায়িত করে। সাধারণ এক্সটেনশনগুলি হল পৃথক ব্যবহারকারী কথোপকথনের জন্য বহু-সেশনের জন্য সমর্থন যোগ করা, এবং অন্যান্য AI এজেন্ট পরিচালনা প্ল্যাটফর্ম।

  • agent_handler.py: চ্যাট এবং নন-চ্যাট অ্যাপ্লিকেশনের নির্দিষ্ট ক্ষেত্রে vertex_ai.py তে সংজ্ঞায়িত Vertex AI-নির্দিষ্ট ইন্টারফেস প্রয়োগ করে। একটি সাধারণ এক্সটেনশন হল ব্যবহারকারীদের AI এজেন্ট প্রতিক্রিয়া সম্পর্কে প্রতিক্রিয়া পাঠানোর জন্য বোতাম যুক্ত করা।

  • google_workspace.py: API কল ব্যবহার করে নন-এআই এজেন্ট ম্যানেজমেন্ট-প্ল্যাটফর্ম ইন্টারঅ্যাকশন বাস্তবায়ন করে। এই নমুনায় কেবলমাত্র Google Workspace API গুলি ব্যবহার করা হয়েছে প্রসঙ্গ বিবরণ সংগ্রহ করতে এবং পদক্ষেপ নিতে। একটি সাধারণ এক্সটেনশন হল Google ক্যালেন্ডার বা গ্রাহক সম্পর্ক ব্যবস্থাপনা (CRM) থেকে ব্যবসায়িক ডেটা পুনরুদ্ধার করার জন্য ফাংশন যোগ করা।

  • travel_agent_ui_render.gs: সাব-এজেন্ট এবং ওয়ার্কস্পেস অ্যাপ্লিকেশনের জন্য ট্র্যাভেল কনসিয়ারজ-নির্দিষ্ট প্রতিক্রিয়া রেন্ডারিং বাস্তবায়ন করে। সাধারণ এক্সটেনশনগুলি হল ফ্লাইট বিকল্পগুলি এবং অন্যান্য এআই এজেন্টগুলিকে গ্রাফিক্যালি প্রদর্শনের জন্য নতুন প্রতিক্রিয়া রেন্ডারিংয়ের জন্য সমর্থন যোগ করা।

অ্যাপস স্ক্রিপ্ট

  • Code.gs: প্রধান UI এবং ব্যবহারকারীর ইন্টারঅ্যাকশন লজিক (Google Workspace ইভেন্ট হ্যান্ডলার) সংজ্ঞায়িত করে। একটি সাধারণ এক্সটেনশন হল ড্রাইভ অ্যাপ্লিকেশনের জন্য ড্রাইভ ডকুমেন্টগুলিকে প্রসঙ্গ বৈশিষ্ট্য হিসাবে সক্ষম করা, যেমনটি Gmail অ্যাপ্লিকেশনের জন্য Gmail বার্তাগুলির সাথে করা হয়।

  • VertexAi.gs: AI এজেন্ট সেশন, প্রতিক্রিয়া, ত্রুটি পরিচালনা করে এবং এজেন্ট ইন্টারঅ্যাকশন এবং প্রতিক্রিয়া রেন্ডারিং সমর্থন করার জন্য বাস্তবায়নের জন্য Vertex AI-নির্দিষ্ট ইন্টারফেসগুলি সংজ্ঞায়িত করে। সাধারণ এক্সটেনশনগুলি হল পৃথক ব্যবহারকারী কথোপকথনের জন্য বহু-সেশনের জন্য সমর্থন যোগ করা, এবং অন্যান্য AI এজেন্ট পরিচালনা প্ল্যাটফর্ম।

  • AgentHandler.gs: চ্যাট এবং নন-চ্যাট অ্যাপ্লিকেশনের নির্দিষ্ট ক্ষেত্রে VertexAi.gs- এ সংজ্ঞায়িত Vertex AI-নির্দিষ্ট ইন্টারফেস প্রয়োগ করে। একটি সাধারণ এক্সটেনশন হল ব্যবহারকারীদের AI এজেন্ট প্রতিক্রিয়া সম্পর্কে প্রতিক্রিয়া পাঠানোর জন্য বোতাম যুক্ত করা।

  • GoogleWorkspace.gs: API কল ব্যবহার করে নন-এআই এজেন্ট ম্যানেজমেন্ট-প্ল্যাটফর্ম ইন্টারঅ্যাকশন বাস্তবায়ন করে। এই নমুনায় কেবলমাত্র Google Workspace API গুলি ব্যবহার করা হয়েছে প্রসঙ্গ বিবরণ সংগ্রহ করতে এবং পদক্ষেপ নিতে। একটি সাধারণ এক্সটেনশন হল Google ক্যালেন্ডার বা গ্রাহক সম্পর্ক ব্যবস্থাপনা (CRM) থেকে ব্যবসায়িক ডেটা পুনরুদ্ধার করার জন্য ফাংশন যোগ করা।

  • TravelAgentUiRender.gs: সাব-এজেন্ট এবং ওয়ার্কস্পেস অ্যাপ্লিকেশনের জন্য ট্র্যাভেল কনসিয়ারজ-নির্দিষ্ট প্রতিক্রিয়া রেন্ডারিং বাস্তবায়ন করে। সাধারণ এক্সটেনশনগুলি হল ফ্লাইট বিকল্পগুলি এবং অন্যান্য AI এজেন্টগুলিকে গ্রাফিক্যালি প্রদর্শনের জন্য নতুন প্রতিক্রিয়া রেন্ডারিংয়ের জন্য সমর্থন যোগ করা।

পরিষ্কার করা

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

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

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

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