১. শুরু করার আগে
ভার্টেক্স এআই কী?
ভার্টেক্স এআই হলো গুগল ক্লাউডের একটি সমন্বিত ডেভেলপমেন্ট প্ল্যাটফর্ম, যা এন্টারপ্রাইজ-গ্রেড এআই এজেন্ট ও অ্যাপ্লিকেশন তৈরি, স্থাপন এবং স্কেল করার জন্য ব্যবহৃত হয়। এটি ডেভেলপার এবং ডেটা সায়েন্টিস্টদের এমন সব অত্যাধুনিক টুলস সরবরাহ করে, যা দিয়ে তারা বৈশ্বিক পরিকাঠামোর সাথে গভীরভাবে সমন্বিত কাস্টম এজেন্টিক ওয়ার্কফ্লো ডিজাইন করতে পারেন।
- মডেল গার্ডেন অ্যাক্সেস করুন: এজেন্টের নির্দিষ্ট কাজের জন্য সঠিক মডেলটি খুঁজে পেতে সম্পূর্ণ জেমিনি ফ্যামিলি, থার্ড-পার্টি মডেল এবং বিশেষায়িত ওপেন-সোর্স মডেল সহ ১৫০টিরও বেশি ফাউন্ডেশন মডেল থেকে বেছে নিন।
- জটিল অর্কেস্ট্রেশন ডিজাইন করুন: ভার্টেক্স এআই এমন একটি ফ্রেমওয়ার্ক প্রদান করে, যার মাধ্যমে যুক্তিনির্ভর স্বয়ংক্রিয় এজেন্ট ডিজাইন করা যায়, যারা পরিকল্পনা করতে, বহু-ধাপের কাজ সম্পাদন করতে এবং বাহ্যিক এপিআই কল করতে পারে।
- এন্টারপ্রাইজ-গ্রেড গ্রাউন্ডিং: বিভ্রম দূর করতে এবং তথ্যের নির্ভুলতা নিশ্চিত করতে এজেন্টদের উচ্চ-পারফরম্যান্স RAG (রিট্রিভাল-অগমেন্টেড জেনারেশন) সহ লাইভ ব্যবসায়িক ডেটার সাথে সংযুক্ত করুন।
- ডেভঅপ্স: শক্তিশালী SDK, API, এবং মূল্যায়ন টুলের সাহায্যে বিদ্যমান CI/CD পাইপলাইনে এজেন্ট ডেভেলপমেন্টকে নির্বিঘ্নে একীভূত করুন, যা বৃহৎ পরিসরে এজেন্টের পারফরম্যান্স ও নিরাপত্তা পরিমাপ করতে সাহায্য করে।
- উচ্চমানের নিরাপত্তা: ভার্টেক্স এআই নিশ্চিত করে যে প্রশিক্ষণ বা গ্রাউন্ডিংয়ের জন্য ব্যবহৃত গ্রাহকের ডেটা গোপন, এনক্রিপ্টেড এবং বৈশ্বিক রেসিডেন্সি প্রয়োজনীয়তা মেনে চলে।
- অপ্টিমাইজড ইনফ্রাস্ট্রাকচার: গুগলের বিশ্বমানের TPU এবং GPU ক্লাস্টার জুড়ে অনায়াসে এজেন্টিক ওয়ার্কলোড স্কেল করুন, যা সবচেয়ে চাহিদাসম্পন্ন গ্লোবাল অ্যাপ্লিকেশনগুলির জন্যও লো-ল্যাটেন্সি পারফরম্যান্স নিশ্চিত করে।
গুগল ওয়ার্কস্পেস কী?
গুগল ওয়ার্কস্পেস হলো ব্যক্তি, স্কুল এবং ব্যবসার জন্য ডিজাইন করা ক্লাউড-ভিত্তিক উৎপাদনশীলতা ও সহযোগিতামূলক সমাধানসমূহের একটি সংগ্রহ:
- যোগাযোগ: পেশাদার ইমেল পরিষেবা (Gmail), ভিডিও কনফারেন্সিং (Meet), এবং টিম মেসেজিং (Chat)।
- কন্টেন্ট তৈরি: ডকুমেন্ট (Docs) লেখার, স্প্রেডশিট (Sheets) তৈরির এবং প্রেজেন্টেশন (Slides) ডিজাইন করার টুল।
- সংগঠন: শেয়ার করা ক্যালেন্ডার (Calendars) এবং ডিজিটাল নোট নেওয়া (Keep)।
- স্টোরেজ: ফাইল নিরাপদে সংরক্ষণ ও শেয়ার করার জন্য কেন্দ্রীভূত ক্লাউড স্পেস (ড্রাইভ)।
- ব্যবস্থাপনা: ব্যবহারকারী ও নিরাপত্তা সেটিংস পরিচালনার জন্য প্রশাসনিক নিয়ন্ত্রণ (ওয়ার্কস্পেস অ্যাডমিন কনসোল)।
কী ধরনের কাস্টম ইন্টিগ্রেশন?
গুগল ওয়ার্কস্পেস এবং ভার্টেক্স এআই একটি শক্তিশালী ফিডব্যাক লুপ তৈরি করে, যেখানে ওয়ার্কস্পেস রিয়েল-টাইম ডেটা এবং কোলাবোরেশন কনটেক্সট প্রদান করে, আর ভার্টেক্স এআই ইন্টেলিজেন্ট ওয়ার্কফ্লো স্বয়ংক্রিয় করার জন্য প্রয়োজনীয় মডেল, এজেন্টিক রিজনিং এবং অর্কেস্ট্রেশন সরবরাহ করে।
- স্মার্ট কানেক্টিভিটি: গুগল-পরিচালিত ডেটা স্টোর, এপিআই, এবং এমসিপি সার্ভার (গুগল-পরিচালিত ও কাস্টম) এজেন্টদেরকে নিরাপদে ও নির্বিঘ্নে ওয়ার্কস্পেস ডেটা অ্যাক্সেস করতে এবং ব্যবহারকারীদের পক্ষ থেকে বিভিন্ন পদক্ষেপ গ্রহণ করতে সক্ষম করে।
- কাস্টম এজেন্ট: নো-কোড ডিজাইনার বা প্রো-কোড ফ্রেমওয়ার্ক ব্যবহার করে, টিমগুলো অ্যাডমিন-পরিচালিত ওয়ার্কস্পেস ডেটা এবং অ্যাকশনের উপর ভিত্তি করে বিশেষায়িত এজেন্ট তৈরি করতে পারে।
- নেটিভ ইন্টিগ্রেশন: ওয়ার্কস্পেস অ্যাড-অনগুলো ডেডিকেটেড UI কম্পোনেন্ট বা ব্যাকগ্রাউন্ড প্রসেসের মাধ্যমে AI সিস্টেম এবং চ্যাট ও জিমেইলের মতো অ্যাপ্লিকেশনগুলোর মধ্যেকার সংযোগ স্থাপন করে। এর ফলে এজেন্টরা ব্যবহারকারীদের ঠিক যেখানে তারা আছেন, সেখানেই তাৎক্ষণিক ও প্রাসঙ্গিক সহায়তা প্রদান করতে পারেন।
গুগল ওয়ার্কস্পেসের শক্তিশালী প্রোডাক্টিভিটি ইকোসিস্টেমের সাথে ভার্টেক্স এআই-এর উন্নত এজেন্টিক ক্ষমতাকে একত্রিত করে, প্রতিষ্ঠানগুলো কাস্টম ও ডেটা-ভিত্তিক এআই এজেন্টের মাধ্যমে তাদের কার্যক্রমকে রূপান্তরিত করতে পারে। এই এজেন্টগুলো তাদের টিমের প্রতিদিন ব্যবহৃত টুলগুলোর মধ্যেই সরাসরি জটিল ওয়ার্কফ্লো স্বয়ংক্রিয় করে তোলে।
পূর্বশর্ত
আপনি যদি আপনার নিজের পরিবেশে সমস্ত ধাপ অনুসরণ করতে চান, তাহলে আপনার প্রয়োজন হবে:
- গুগল ক্লাউড ও পাইথন সম্পর্কে প্রাথমিক জ্ঞান।
- আপনার মালিকানাধীন একটি Google Cloud প্রজেক্ট, যেটিতে বিলিং চালু আছে। কোনো বিদ্যমান প্রজেক্টে বিলিং চালু আছে কিনা তা পরীক্ষা করতে, আপনার প্রজেক্টগুলোর বিলিং স্ট্যাটাস যাচাই করুন দেখুন। একটি প্রজেক্ট তৈরি করতে এবং বিলিং সেট আপ করতে, একটি Google Cloud প্রজেক্ট তৈরি করুন দেখুন। প্রজেক্টের মালিকানা পরিবর্তন করতে, প্রজেক্টের সদস্যদের পরিচালনা করুন বা প্রজেক্টের মালিকানা পরিবর্তন করুন দেখুন।
- একটি বিজনেস বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট, যেখানে গুগল চ্যাট এবং স্মার্ট ফিচারগুলো চালু করা আছে ।
- আপনার গুগল ক্লাউড প্রজেক্টের জন্য গুগল ক্লাউড সিএলআই ইনস্টল এবং চালু করা হয়েছে ।
- পাইথন ৩.১১ বা তার পরবর্তী সংস্করণ ইনস্টল করা থাকতে হবে, নির্দেশাবলীর জন্য পাইথনের অফিসিয়াল ওয়েবসাইট দেখুন।
আপনি যা তৈরি করবেন
এই কোডল্যাবে, আমরা গুগল ওয়ার্কস্পেসের সাথে নিবিড়ভাবে সমন্বিত ভার্টেক্স এআই এজেন্ট ব্যবহার করে তিনটি সলিউশন তৈরি করব। এগুলোর মাধ্যমে এমন কিছু আর্কিটেকচারাল প্যাটার্ন দেখানো হবে, যা ডেটা, অ্যাকশন এবং ইউআই-এর সাথে ইন্টারঅ্যাক্ট করতে ব্যবহার করা যেতে পারে।
ভার্টেক্স এআই সার্চ অ্যাপ
এই এজেন্টটি ব্যবহারকারীদের তাদের স্বাভাবিক ভাষায় ওয়ার্কস্পেসের জন্য ডেটা অনুসন্ধান করতে এবং বিভিন্ন পদক্ষেপ নিতে সাহায্য করে। এটি নিম্নলিখিত উপাদানগুলোর উপর নির্ভর করে:
- মডেল: মিথুন।
- ডেটা ও কার্যক্রম: গুগল ওয়ার্কস্পেস (ক্যালেন্ডার, জিমেইল, ড্রাইভ)-এর জন্য ভার্টেক্স এআই ডেটা স্টোর।
- এজেন্ট হোস্ট: ভার্টেক্স এআই সার্চ।
- UI: ভার্টেক্স এআই সার্চ ওয়েব উইজেট।

কাস্টম এজেন্ট
এই এজেন্টটি ব্যবহারকারীদের নিজস্ব টুল ও নিয়ম ব্যবহার করে তাদের স্বাভাবিক ভাষায় ওয়ার্কস্পেসের জন্য ডেটা অনুসন্ধান করতে এবং বিভিন্ন পদক্ষেপ নিতে সাহায্য করে। এটি নিম্নলিখিত উপাদানগুলোর উপর নির্ভর করে:
- মডেল: মিথুন।
- ডেটা ও কার্যক্রম: গুগল ওয়ার্কস্পেসের (ক্যালেন্ডার, জিমেইল, ড্রাইভ) জন্য ভার্টেক্স এআই ডেটা স্টোর, গুগল-পরিচালিত ভার্টেক্স এআই সার্চ মডেল কনটেক্সট প্রোটোকল (এমসিপি) সার্ভার, গুগল চ্যাট মেসেজ পাঠানোর জন্য কাস্টম টুল ফাংশন (গুগল চ্যাট এপিআই-এর মাধ্যমে)।
- এজেন্ট তৈরির সরঞ্জাম: এজেন্ট ডেভেলপমেন্ট কিট (ADK)।
- এজেন্ট হোস্ট: ভার্টেক্স এআই এজেন্ট ইঞ্জিন।
- UI: ADK Web.


গুগল ওয়ার্কস্পেস অ্যাড-অন হিসেবে একটি এজেন্ট
এই এজেন্টটি ব্যবহারকারীদের ওয়ার্কস্পেস অ্যাপ UI-এর প্রেক্ষাপটে তাদের স্বাভাবিক ভাষায় ওয়ার্কস্পেসের ডেটা অনুসন্ধান করার সুযোগ দেয়। এটি নিম্নলিখিত উপাদানগুলোর উপর নির্ভর করে:
- মডেল: মিথুন।
- ডেটা ও কার্যক্রম: গুগল ওয়ার্কস্পেসের (ক্যালেন্ডার, জিমেইল, ড্রাইভ) জন্য ভার্টেক্স এআই ডেটা স্টোর, গুগল-পরিচালিত ভার্টেক্স এআই সার্চ মডেল কনটেক্সট প্রোটোকল (এমসিপি) সার্ভার, গুগল চ্যাট মেসেজ পাঠানোর জন্য কাস্টম টুল ফাংশন (গুগল চ্যাট এপিআই-এর মাধ্যমে)।
- এজেন্ট তৈরির সরঞ্জাম: এজেন্ট ডেভেলপমেন্ট কিট (ADK)।
- এজেন্ট হোস্ট: ভার্টেক্স এআই এজেন্ট ইঞ্জিন।
- ইউজার ইন্টারফেস: চ্যাট এবং জিমেইলের জন্য গুগল ওয়ার্কস্পেস অ্যাড-অন (সহজেই ক্যালেন্ডার, ড্রাইভ, ডক্স, শিটস এবং স্লাইডস পর্যন্ত সম্প্রসারণযোগ্য)।
- গুগল ওয়ার্কস্পেস অ্যাড-অন: অ্যাপস স্ক্রিপ্ট, ভার্টেক্স এআই এজেন্ট ইঞ্জিন এপিআই, প্রাসঙ্গিক (নির্বাচিত জিমেইল বার্তা)।


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

২. স্থাপন করুন
সলিউশন তৈরি করার আগে, আমাদের প্রজেক্টের Vertex AI Applications সেটিংস ইনিশিয়ালাইজ করতে হবে, প্রয়োজনীয় API-গুলো এনাবল করতে হবে এবং Vertex AI Workspace ডেটা স্টোর তৈরি করতে হবে।
ধারণা পর্যালোচনা করুন
ভার্টেক্স এআই অ্যাপ্লিকেশন
ভার্টেক্স এআই অ্যাপ্লিকেশন হলো গুগল ক্লাউডে পরিচালিত একটি এন্ড-টু-এন্ড সমাধান, যা সিমান্টিক সার্চ, কন্টেন্ট জেনারেশন বা স্বয়ংক্রিয় গ্রাহক যোগাযোগের মতো জটিল কাজ সম্পাদনের জন্য মেশিন লার্নিং মডেল (যেমন জেনারেটিভ এআই এজেন্ট বা সার্চ ইঞ্জিন), এন্টারপ্রাইজ ডেটা এবং বিশেষায়িত টুলকে একীভূত করে।
ভার্টেক্স এআই ডেটা স্টোর
ভার্টেক্স এআই ডেটা স্টোর হলো এমন একটি সত্তা যা গুগল ওয়ার্কস্পেসের মতো ফার্স্ট-পার্টি ডেটা সোর্স অথবা জিরা বা শপিফাইয়ের মতো থার্ড-পার্টি অ্যাপ্লিকেশন থেকে গৃহীত ডেটা ধারণ করে। যে ডেটা স্টোরগুলো থার্ড-পার্টি অ্যাপ্লিকেশন থেকে ডেটা ধারণ করে, সেগুলোকে ডেটা কানেক্টরও বলা হয়।
ভার্টেক্স এআই অ্যাপ্লিকেশন সেটিংস শুরু করুন
এজেন্ট তৈরি সক্ষম করতে ভার্টেক্স এআই অ্যাপ্লিকেশন সেটিংস শুরু করুন।
একটি নতুন ট্যাবে গুগল ক্লাউড কনসোল খুলুন, তারপর এই ধাপগুলো অনুসরণ করুন:
- আপনার প্রকল্পটি নির্বাচন করুন।
- গুগল ক্লাউড সার্চ ফিল্ডে, এআই অ্যাপ্লিকেশন- এ যান।
- শর্তাবলী পর্যালোচনা করে তাতে সম্মত হওয়ার পর 'চালিয়ে যান'-এ ক্লিক করুন এবং এপিআইটি সক্রিয় করুন ।
- সেটিংসে যান।
- Authentication ট্যাবে, global সম্পাদনা করুন।

- Google Identity নির্বাচন করুন, তারপর Save-এ ক্লিক করুন।

এপিআই সক্ষম করুন
Vertex AI Workspace ডেটা স্টোরগুলির জন্য API সক্রিয় করা প্রয়োজন:
- গুগল ক্লাউড কনসোলে ক্যালেন্ডার, জিমেইল এবং পিপল এপিআইগুলো সক্রিয় করুন:

- মেনু ☰ > এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা- তে ক্লিক করুন এবং তারপরে নিশ্চিত করুন যে Google Calendar API , Gmail API , এবং People API তালিকায় রয়েছে।
ডেটা স্টোর তৈরি করুন
গুগল ড্রাইভ ডেটা স্টোর তৈরি করুন:
- গুগল ক্লাউড কনসোলে, AI Applications- এ যান, তারপর Data Stores- এ নেভিগেট করুন।
- ডেটা স্টোর তৈরি করতে ক্লিক করুন।
- Source- এ, Google Drive-এর অধীনে, Select-এ ক্লিক করুন।

- Data- তে, All নির্বাচন করুন এবং Continue-তে ক্লিক করুন।

- কনফিগারেশন- এ, ডেটা কানেক্টরের নাম ‘
driveহিসেবে সেট করুন এবং প্রযোজ্য চার্জগুলো পর্যালোচনা করে তাতে সম্মত হওয়ার পর ‘চালিয়ে যান’ (Continue) বোতামে ক্লিক করুন।

- প্রাইসিং- এ, আপনার পছন্দের প্রাইসিং মডেলটি নির্বাচন করুন এবং ক্রিয়েট-এ ক্লিক করুন। এই কোডল্যাবের প্রেক্ষাপটে জেনারেল প্রাইসিং ব্যবহার করার পরামর্শ দেওয়া হচ্ছে।
- আপনাকে স্বয়ংক্রিয়ভাবে ডেটা স্টোর- এ পুনঃনির্দেশিত করা হবে, যেখানে আপনি নতুন যুক্ত হওয়া ডেটা স্টোরটি দেখতে পাবেন।
গুগল ক্যালেন্ডার ডেটা স্টোর তৈরি করুন:
- ডেটা স্টোর তৈরি করতে ক্লিক করুন।
- সোর্স- এ, গুগল ক্যালেন্ডার অনুসন্ধান করুন এবং সিলেক্ট-এ ক্লিক করুন।
- অ্যাকশন সেকশনে, স্কিপ-এ ক্লিক করুন।
- কনফিগারেশন বিভাগে, ডেটা কানেক্টরের নাম
calendarহিসেবে সেট করুন। - তৈরি করুন- এ ক্লিক করুন।
- আপনাকে স্বয়ংক্রিয়ভাবে ডেটা স্টোর- এ পুনঃনির্দেশিত করা হবে, যেখানে আপনি নতুন যুক্ত হওয়া ডেটা স্টোরটি দেখতে পাবেন।
গুগল জিমেইল ডেটা স্টোর তৈরি করুন:
- নতুন ডেটা স্টোরে ক্লিক করুন।
- সোর্স -এ Google Gmail অনুসন্ধান করুন এবং সিলেক্ট-এ ক্লিক করুন।
- অ্যাকশন সেকশনে, স্কিপ-এ ক্লিক করুন।
- কনফিগারেশন বিভাগে, ডেটা কানেক্টরের নাম
gmailএ সেট করুন। - তৈরি করুন- এ ক্লিক করুন।
- আপনাকে স্বয়ংক্রিয়ভাবে ডেটা স্টোর- এ পুনঃনির্দেশিত করা হবে, যেখানে আপনি নতুন যুক্ত হওয়া ডেটা স্টোরটি দেখতে পাবেন।
৩. ভার্টেক্স এআই সার্চ অ্যাপ
এই এজেন্টটি ব্যবহারকারীদের তাদের স্বাভাবিক ভাষায় ওয়ার্কস্পেসের জন্য ডেটা অনুসন্ধান করতে এবং বিভিন্ন পদক্ষেপ নিতে সাহায্য করে। এটি নিম্নলিখিত উপাদানগুলোর উপর নির্ভর করে:
- মডেল: মিথুন।
- ডেটা ও কার্যক্রম: গুগল ওয়ার্কস্পেস (ক্যালেন্ডার, জিমেইল, ড্রাইভ)-এর জন্য ভার্টেক্স এআই ডেটা স্টোর।
- এজেন্ট হোস্ট: ভার্টেক্স এআই সার্চ।
- UI: ভার্টেক্স এআই সার্চ ওয়েব উইজেট।
ধারণা পর্যালোচনা করুন
ভার্টেক্স এআই সার্চ অ্যাপ
একটি ভার্টেক্স এআই সার্চ অ্যাপ আপনার ব্যবহারকারীদের কাছে অনুসন্ধানের ফলাফল, অ্যাকশন এবং এজেন্ট সরবরাহ করে। এপিআই (API)-এর ক্ষেত্রে 'অ্যাপ' শব্দটি 'ইঞ্জিন' শব্দের পরিবর্তে ব্যবহার করা যেতে পারে। অনুসন্ধানের ফলাফল, উত্তর বা অ্যাকশন পরিবেশন করার জন্য কোনো ডেটা স্টোর থেকে ডেটা ব্যবহার করতে হলে, একটি অ্যাপকে অবশ্যই সেই ডেটা স্টোরের সাথে সংযুক্ত থাকতে হবে।
ভার্টেক্স এআই সার্চ ওয়েব উইজেট
ভার্টেক্স এআই সার্চ ওয়েব উইজেট হলো একটি পূর্ব-নির্মিত, কাস্টমাইজযোগ্য ইউআই কম্পোনেন্ট যা ডেভেলপারদেরকে ন্যূনতম কোডিংয়ের মাধ্যমে সরাসরি একটি ওয়েবসাইটে এআই-চালিত সার্চ বার এবং ফলাফল ইন্টারফেস এম্বেড করার সুযোগ দেয়।
ভার্টেক্স এআই সার্চ প্রিভিউ
ভার্টেক্স এআই সার্চ প্রিভিউ হলো গুগল ক্লাউড কনসোলের অন্তর্নির্মিত একটি টেস্টিং পরিবেশ, যা ডেভেলপারদেরকে প্রোডাকশন-রেডি ভার্টেক্স এআই সার্চ ওয়েব উইজেটে সেই একই সেটিংস নির্বিঘ্নে স্থাপন করার আগে সার্চ কনফিগারেশন এবং জেনারেটিভ উত্তরগুলো যাচাই করার সুযোগ দেয়।
সমাধান স্থাপত্য পর্যালোচনা করুন

অ্যাপ তৈরি করুন
আপনার ডেটা স্টোরগুলোকে স্থিতিশীল করতে একটি নতুন সার্চ অ্যাপ তৈরি করুন।
এআই অ্যাপ্লিকেশন > ক্লাউড কনসোল থেকে অ্যাপস খুলুন, তারপর এই ধাপগুলো অনুসরণ করুন:
- + অ্যাপ তৈরি করুন -এ ক্লিক করুন।
- Type- এর মধ্যে Custom search (general)- এর অধীনে Create-এ ক্লিক করুন।

- মূল্য পর্যালোচনা করে তাতে সম্মত হওয়ার পর, কনফিগারেশন- এ এন্টারপ্রাইজ সংস্করণের বৈশিষ্ট্য এবং জেনারেটিভ রেসপন্স চেক করুন।
- অ্যাপের নাম '
codelabসেট করুন। - নামের উপর ভিত্তি করে একটি আইডি তৈরি হয় এবং তা ফিল্ডের নিচে প্রদর্শিত হয়, সেটি কপি করুন।
- কোম্পানির নাম
Codelabএ সেট করুন। - মাল্টি-রিজিওন
global (Global)এ সেট করুন। - চালিয়ে যান-এ ক্লিক করুন।

- ডেটা- তে, ডেটা স্টোর ড্রাইভ , জিমেইল এবং ক্যালেন্ডার নির্বাচন করুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

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

ওয়েব উইজেট কনফিগার করুন
সার্চ উইজেটের বাহ্যিক রূপ ও আচরণ নির্ধারণ করুন।
- কনফিগারেশন -এ যান।
- ট্যাব UI- তে, সার্চ টাইপটি ‘ সার্চ উইথ ফলো-আপস’ -এ সেট করুন, তারপর ‘সেভ অ্যান্ড পাবলিশ’-এ ক্লিক করুন।

অ্যাপটি ব্যবহার করে দেখুন
সরাসরি গুগল ক্লাউড কনসোলে সার্চ অ্যাপটি পরীক্ষা করুন।
- প্রিভিউ -তে যান, ওয়েব উইজেটটি প্রদর্শিত হবে।
- চ্যাটে “
Do I have any meetings today?টাইপ করুন এবংenterচাপুন। - চ্যাটে,
Did I receive an email on March 1st 2026?টাইপ করুন এবংenterচাপুন। - চ্যাটে,
Give me the title of the latest Drive file I createdটাইপ করুন এবংenterচাপুন।

৪. কাস্টম এজেন্ট
এই এজেন্টটি ব্যবহারকারীদের নিজস্ব টুল ও নিয়ম ব্যবহার করে তাদের স্বাভাবিক ভাষায় ওয়ার্কস্পেসের জন্য ডেটা অনুসন্ধান করতে এবং বিভিন্ন পদক্ষেপ নিতে সাহায্য করে। এটি নিম্নলিখিত উপাদানগুলোর উপর নির্ভর করে:
- মডেল: মিথুন।
- ডেটা ও কার্যক্রম: গুগল ওয়ার্কস্পেসের (ক্যালেন্ডার, জিমেইল, ড্রাইভ) জন্য ভার্টেক্স এআই ডেটা স্টোর, গুগল-পরিচালিত ভার্টেক্স এআই সার্চ মডেল কনটেক্সট প্রোটোকল (এমসিপি) সার্ভার, গুগল চ্যাট মেসেজ পাঠানোর জন্য কাস্টম টুল ফাংশন (গুগল চ্যাট এপিআই-এর মাধ্যমে)।
- এজেন্ট তৈরির সরঞ্জাম: এজেন্ট ডেভেলপমেন্ট কিট (ADK)।
- এজেন্ট হোস্ট: ভার্টেক্স এআই এজেন্ট ইঞ্জিন।
- UI: ADK Web.
ধারণা পর্যালোচনা করুন
এজেন্ট ডেভেলপমেন্ট কিট (ADK)
এজেন্ট ডেভেলপমেন্ট কিট (ADK) হলো বিভিন্ন টুল ও ফ্রেমওয়ার্কের একটি বিশেষায়িত সংকলন, যা যুক্তিনির্মাণ, মেমরি ব্যবস্থাপনা এবং টুল ইন্টিগ্রেশনের জন্য পূর্ব-নির্মিত মডিউল সরবরাহ করার মাধ্যমে স্বয়ংক্রিয় এআই এজেন্ট তৈরি প্রক্রিয়াকে সহজ করার জন্য ডিজাইন করা হয়েছে।
মডেল প্রসঙ্গ প্রোটোকল (MCP)
মডেল কনটেক্সট প্রোটোকল (MCP) হলো একটি উন্মুক্ত স্ট্যান্ডার্ড, যা একটি সার্বজনীন, 'প্লাগ-এন্ড-প্লে' ইন্টারফেসের মাধ্যমে এআই অ্যাপ্লিকেশন এবং বিভিন্ন ডেটা উৎস বা টুলের মধ্যে নির্বিঘ্ন ও নিরাপদ সংযোগ স্থাপনের জন্য ডিজাইন করা হয়েছে।
ফাংশন টুল
ফাংশন টুল হলো একটি পূর্বনির্ধারিত নির্বাহযোগ্য রুটিন, যা একটি এআই মডেল নির্দিষ্ট কাজ সম্পাদন করতে বা বাহ্যিক সিস্টেম থেকে রিয়েল-টাইম ডেটা সংগ্রহ করতে চালু করতে পারে, যার ফলে এর সক্ষমতা সাধারণ টেক্সট তৈরির বাইরেও প্রসারিত হয়।
ADK ওয়েব
ADK ওয়েব হলো ADK SDK-এর সাথে আসা একটি বিল্ট-ইন ডেভ UI, যা ডেভেলপমেন্ট এবং ডিবাগিং আরও সহজ করে তোলে।
সমাধান স্থাপত্য পর্যালোচনা করুন

সোর্স কোড পর্যালোচনা করুন
agent.py
নিম্নলিখিত কোডটি ভার্টেক্স এআই-এর সাথে প্রমাণীকরণ করে, ভার্টেক্স এআই সার্চ এমসিপি এবং চ্যাট এপিআই টুলগুলো চালু করে, এবং এজেন্টের আচরণ নির্ধারণ করে।
- প্রমাণীকরণ : এটি MCP এবং API কলগুলোকে প্রমাণীকরণের জন্য এনভায়রনমেন্ট ভেরিয়েবল থেকে
ACCESS_TOKENসংগ্রহ করে। - টুলস সেটআপ : এটি
vertexai_mcp(একটি টুলসেট যা Vertex AI Search Model Context Protocol (MCP) সার্ভারের সাথে সংযোগ স্থাপন করে) এবংsend_direct_messageটুলটিকে ইনিশিয়ালাইজ করে। এর ফলে এজেন্ট আপনার সংযুক্ত ডেটা স্টোরগুলোতে অনুসন্ধান করতে এবং গুগল চ্যাট বার্তা পাঠাতে সক্ষম হয়। - এজেন্ট সংজ্ঞা : এটি
gemini-2.5-flashমডেল ব্যবহার করেroot_agentসংজ্ঞায়িত করে। নির্দেশাবলীতে এজেন্টকে তথ্য পুনরুদ্ধারের জন্য সার্চ টুল এবং বিভিন্ন কাজের জন্যsend_direct_messageটুল ব্যবহারে অগ্রাধিকার দিতে বলা হয়, যা কার্যকরভাবে এজেন্টকে আপনার এন্টারপ্রাইজ ডেটার সাথে সংযুক্ত করে।
...
MODEL = "gemini-2.5-flash"
# Access token for authentication
ACCESS_TOKEN = os.environ.get("ACCESS_TOKEN")
if not ACCESS_TOKEN:
raise ValueError("ACCESS_TOKEN environment variable must be set")
VERTEXAI_SEARCH_TIMEOUT = 15.0
def get_project_id():
"""Fetches the consumer project ID from the environment natively."""
_, project = google.auth.default()
if project:
return project
raise Exception(f"Failed to resolve GCP Project ID from environment.")
def find_serving_config_path():
"""Dynamically finds the default serving config in the engine."""
project_id = get_project_id()
engines = discoveryengine_v1.EngineServiceClient().list_engines(
parent=f"projects/{project_id}/locations/global/collections/default_collection"
)
for engine in engines:
# engine.name natively contains the numeric Project Number
return f"{engine.name}/servingConfigs/default_serving_config"
raise Exception(f"No Discovery Engines found in project {project_id}")
def send_direct_message(email: str, message: str) -> dict:
"""Sends a Google Chat Direct Message (DM) to a specific user by email address."""
chat_client = chat_v1.ChatServiceClient(
credentials=Credentials(token=ACCESS_TOKEN)
)
# 1. Setup the DM space or find existing one
person = chat_v1.User(
name=f"users/{email}",
type_=chat_v1.User.Type.HUMAN
)
membership = chat_v1.Membership(member=person)
space_req = chat_v1.Space(space_type=chat_v1.Space.SpaceType.DIRECT_MESSAGE)
setup_request = chat_v1.SetUpSpaceRequest(
space=space_req,
memberships=[membership]
)
space_response = chat_client.set_up_space(request=setup_request)
space_name = space_response.name
# 2. Send the message
msg = chat_v1.Message(text=message)
message_request = chat_v1.CreateMessageRequest(
parent=space_name,
message=msg
)
message_response = chat_client.create_message(request=message_request)
return {"status": "success", "message_id": message_response.name, "space": space_name}
vertexai_mcp = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://discoveryengine.googleapis.com/mcp",
timeout=VERTEXAI_SEARCH_TIMEOUT,
sse_read_timeout=VERTEXAI_SEARCH_TIMEOUT,
headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
),
tool_filter=['search']
)
# Answer nicely the following user queries:
# - Please find my meetings for today, I need their titles and links
# - What is the latest Drive file I created?
# - What is the latest Gmail message I received?
# - Please send the following message to someone@example.com: Hello, this is a test message.
root_agent = LlmAgent(
model=MODEL,
name='enterprise_ai',
instruction=f"""
You are a helpful assistant that always uses the Vertex AI MCP search tool to answer the user's message, unless the user asks you to send a message to someone.
If the user asks you to send a message to someone, use the send_direct_message tool to send the message.
You MUST unconditionally use the Vertex AI MCP search tool to find answer, even if you believe you already know the answer or believe the Vertex AI MCP search tool does not contain the data.
The Vertex AI MCP search tool accesses the user's data through datastores including Google Drive, Google Calendar, and Gmail.
Only use the Vertex AI MCP search tool with servingConfig and query parameters, do not use any other parameters.
Always use the servingConfig {find_serving_config_path()} while using the Vertex AI MCP search tool.
""",
tools=[vertexai_mcp, FunctionTool(send_direct_message)]
)
সোর্স কোড ডাউনলোড করুন
কাজ শুরু করতে নমুনা কোডটি আপনার স্থানীয় পরিবেশে ডাউনলোড করুন।
- এই গিটহাব রিপোজিটরিটি ডাউনলোড করুন।
- টার্মিনালে
solutions/enterprise-ai-agent-localডিরেক্টরিটি খুলুন।
এপিআই সক্ষম করুন
সমাধানটির জন্য অতিরিক্ত এপিআই সক্রিয় করার প্রয়োজন হবে:
- Google Cloud কনসোলে Vertex AI, Cloud Resource Manager, এবং Google Chat API-গুলো সক্রিয় করুন:

- মেনু ☰ > এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা- তে ক্লিক করুন এবং তারপরে নিশ্চিত করুন যে Vertex AI API , Cloud Resource Manager API , এবং Google Chat API তালিকায় রয়েছে।
OAuth সম্মতি স্ক্রিন কনফিগার করুন
সমাধানটির জন্য একটি সম্মতি স্ক্রিন কনফিগারেশন প্রয়োজন:

