1. शुरू करने से पहले
Gemini Enterprise क्या है?
Gemini Enterprise, एआई की मदद से काम करने वाला एक ऐडवांस एजेंटिक प्लैटफ़ॉर्म है. यह हर कर्मचारी और हर वर्कफ़्लो के लिए, Google के सबसे बेहतरीन एआई की सुविधाएं उपलब्ध कराता है. इसकी मदद से, टीम के सदस्य एक ही सुरक्षित प्लैटफ़ॉर्म पर एआई एजेंट ढूंढ सकते हैं, बना सकते हैं, शेयर कर सकते हैं, और उन्हें रन कर सकते हैं.
- ऐडवांस मॉडल का ऐक्सेस: उपयोगकर्ताओं को Google के सबसे बेहतरीन मल्टीमॉडल एआई का तुरंत ऐक्सेस मिलता है. इसमें Gemini भी शामिल है. इससे वे कारोबार से जुड़ी मुश्किल चुनौतियों का सामना कर पाते हैं.
- खास एजेंट का इस्तेमाल करें: इस सुइट में, रिसर्च, कोडिंग, और नोट लेने के लिए, इस्तेमाल के लिए तैयार Google एजेंट शामिल हैं. इनसे तुरंत फ़ायदा मिलता है.
- हर कर्मचारी को सशक्त बनाएं: नो-कोड और प्रो-कोड के विकल्पों की मदद से, सभी विभागों के कर्मचारी वर्कफ़्लो को ऑटोमेट करने के लिए, अपने कस्टम एजेंट बना सकते हैं और उन्हें मैनेज कर सकते हैं.
- डेटा में ग्राउंड एजेंट: एजेंट को कंपनी के इंटरनल डेटा और तीसरे पक्ष के ऐप्लिकेशन से सुरक्षित तरीके से कनेक्ट किया जा सकता है. इससे यह पक्का किया जा सकता है कि उनके जवाब, कॉन्टेक्स्ट के हिसाब से सटीक हों.
- सेंट्रलाइज़्ड गवर्नेंस: एडमिन, एजेंट की सभी गतिविधियों को देख सकते हैं और उनकी ऑडिट कर सकते हैं. इससे यह पक्का किया जा सकता है कि संगठन, सुरक्षा और अनुपालन के कड़े मानकों को पूरा करता है.
- इकोसिस्टम के साथ काम करने की सुविधा: यह प्लैटफ़ॉर्म, पार्टनर ऐप्लिकेशन और सेवा देने वाली कंपनियों के बड़े नेटवर्क के साथ इंटिग्रेट होता है. इससे अलग-अलग सिस्टम में ऑटोमेशन की सुविधा मिलती है.
Google Workspace क्या है?
Google Workspace, क्लाउड-आधारित प्रॉडक्टिविटी और साथ मिलकर काम करने के टूल का एक कलेक्शन है. इसे लोगों, स्कूलों, और कारोबारों के लिए डिज़ाइन किया गया है:
- कम्यूनिकेशन: इसमें प्रोफ़ेशनल ईमेल सेवाएं (Gmail), वीडियो कॉन्फ़्रेंसिंग (Meet), और टीम मैसेजिंग (Chat) शामिल हैं.
- कॉन्टेंट बनाना: दस्तावेज़ लिखने (Docs), स्प्रेडशीट बनाने (Sheets), और प्रज़ेंटेशन डिज़ाइन करने (Slides) के लिए टूल.
- संगठन: शेयर किए गए कैलेंडर (Calendar) और डिजिटल नोट लेने की सुविधा (Keep).
- स्टोरेज: फ़ाइलों को सुरक्षित तरीके से सेव और शेयर करने के लिए, क्लाउड स्टोरेज की सुविधा (Drive).
- मैनेजमेंट: उपयोगकर्ताओं और सुरक्षा सेटिंग को मैनेज करने के लिए एडमिन कंट्रोल (Workspace Admin Console).
किस तरह के कस्टम इंटिग्रेशन?
Google Workspace और Gemini Enterprise, एक बेहतरीन फ़ीडबैक लूप बनाते हैं. इसमें Workspace, रीयल-टाइम डेटा और साथ मिलकर काम करने से जुड़ा कॉन्टेक्स्ट उपलब्ध कराता है. वहीं, Gemini Enterprise, स्मार्ट वर्कफ़्लो को ऑटोमेट करने के लिए ज़रूरी मॉडल, एजेंटिक रीज़निंग, और ऑर्केस्ट्रेशन उपलब्ध कराता है.
- स्मार्ट कनेक्टिविटी: Google के मैनेज किए गए डेटा स्टोर, एपीआई, और एमसीपी सर्वर (Google के मैनेज किए गए और कस्टम) की मदद से, एजेंट Workspace डेटा को सुरक्षित और आसानी से ऐक्सेस कर सकते हैं. साथ ही, उपयोगकर्ताओं की ओर से कार्रवाइयां कर सकते हैं.
- कस्टम एजेंट: नो-कोड डिज़ाइनर या प्रो-कोड फ़्रेमवर्क का इस्तेमाल करके, टीमें ऐसे खास एजेंट बना सकती हैं जो एडमिन के कंट्रोल वाले Workspace डेटा और कार्रवाइयों पर आधारित हों.
- नेटिव इंटिग्रेशन: Workspace ऐड-ऑन, एआई सिस्टम और Chat और Gmail जैसे ऐप्लिकेशन के बीच के अंतर को कम करते हैं. ऐसा, यूज़र इंटरफ़ेस (यूआई) के कॉम्पोनेंट या बैकग्राउंड प्रोसेस के ज़रिए किया जाता है. इससे एजेंट, उपयोगकर्ताओं को उसी जगह पर मदद कर पाते हैं जहां वे मौजूद हैं. इससे उन्हें तुरंत और संदर्भ के हिसाब से मदद मिलती है.
Google Workspace के प्रॉडक्टिविटी बढ़ाने वाले दमदार ईकोसिस्टम को Gemini Enterprise की ऐडवांस एजेंटिक सुविधाओं के साथ मिलाकर, संगठन अपने कामकाज को बेहतर बना सकते हैं. इसके लिए, वे डेटा पर आधारित एआई एजेंट को अपनी ज़रूरत के हिसाब से तैयार कर सकते हैं. ये एजेंट, मुश्किल वर्कफ़्लो को ऑटोमेट करते हैं. ये वर्कफ़्लो, उन टूल में ऑटोमेट होते हैं जिन्हें टीमें रोज़ाना इस्तेमाल करती हैं.
ज़रूरी शर्तें
अगर आपको अपने एनवायरमेंट में सभी चरणों को फ़ॉलो करना है, तो आपको इनकी ज़रूरत होगी:
- Google Cloud और Python की बुनियादी जानकारी.
- आपके पास बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट होना चाहिए. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है या नहीं, अपने प्रोजेक्ट के बिलिंग स्टेटस की पुष्टि करना लेख पढ़ें. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें. प्रोजेक्ट का मालिकाना हक बदलने के लिए, प्रोजेक्ट के सदस्यों को मैनेज करना या प्रोजेक्ट का मालिकाना हक बदलना लेख पढ़ें.
- Gemini Enterprise Standard / Plus वर्शन चालू हों. Gemini Enterprise के वर्शन की तुलना करने के लिए, Gemini Enterprise के वर्शन की तुलना करना लेख पढ़ें. अगर आपके पास Gemini Enterprise का लाइसेंस नहीं है, तो अगले चरण में आपके पास ट्रायल लाइसेंस बनाने का विकल्प होगा.
- Business या Enterprise वर्शन वाला Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो और स्मार्ट सुविधाएं चालू हों.
- Google Cloud प्रोजेक्ट के लिए, Google Cloud CLI इंस्टॉल और शुरू किया गया हो.
- Python 3.11+ इंस्टॉल किया गया हो. इसके लिए, Python की आधिकारिक वेबसाइट पर दिए गए निर्देश देखें.
आपको क्या बनाना है
इस कोडलैब में, हम Google Workspace के साथ इंटिग्रेट किए गए Gemini Enterprise के एआई एजेंट की मदद से तीन समाधान तैयार करेंगे. ये आर्किटेक्चरल पैटर्न दिखाएंगे, जिनका इस्तेमाल डेटा, कार्रवाइयों, और यूज़र इंटरफ़ेस (यूआई) के साथ इंटरैक्ट करने के लिए किया जा सकता है.
नो-कोड कस्टम एजेंट
यह एजेंट उपयोगकर्ताओं को Workspace में डेटा खोजने और अपनी नैचुरल लैंग्वेज में कार्रवाइयां करने की अनुमति देता है. यह इन एलिमेंट पर निर्भर करता है:
- मॉडल: Gemini.
- डेटा और कार्रवाइयाँ: Google Workspace (Calendar, Gmail, Drive, NotebookLM) के लिए Gemini Enterprise के डेटा स्टोर, Google Search.
- एजेंट बनाने के टूल: Gemini Enterprise Agent Designer.
- एजेंट होस्ट: Gemini Enterprise.
- यूज़र इंटरफ़ेस (यूआई): Gemini Enterprise का वेब ऐप्लिकेशन.


प्रो-कोड कस्टम एजेंट
यह एजेंट उपयोगकर्ताओं को कस्टम टूल और नियमों का इस्तेमाल करके, नैचुरल लैंग्वेज में Workspace के डेटा को खोजने और कार्रवाइयां करने की सुविधा देता है. यह इन एलिमेंट पर निर्भर करता है:
- मॉडल: Gemini.
- डेटा और कार्रवाइयां: Google Workspace (Calendar, Gmail, Drive, NotebookLM) के लिए Gemini Enterprise के डेटा स्टोर, Google Search, Google के मैनेज किए गए Agent Search का मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, Google Chat के मैसेज भेजने के लिए कस्टम टूल फ़ंक्शन (Google Chat API के ज़रिए).
- एजेंट बनाने के टूल: Agent Development Kit (ADK).
- एजेंट होस्ट: एजेंट रनटाइम.
- यूज़र इंटरफ़ेस (यूआई): Gemini Enterprise का वेब ऐप्लिकेशन.


Google Workspace ऐड-ऑन के तौर पर डिफ़ॉल्ट एजेंट
यह एजेंट, Workspace ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में उपयोगकर्ताओं को उनकी नैचुरल लैंग्वेज में Workspace का डेटा खोजने की सुविधा देता है. यह इन एलिमेंट पर निर्भर करता है:
- मॉडल: Gemini.
- डेटा: Google Workspace (Calendar, Gmail, Drive, NotebookLM) के लिए Gemini Enterprise के डेटा स्टोर, Google Search.
- एजेंट होस्ट: Gemini Enterprise.
- यूज़र इंटरफ़ेस (यूआई): Chat और Gmail के लिए Google Workspace ऐड-ऑन. इसे Calendar, Drive, Docs, Sheets, और Slides के लिए आसानी से बढ़ाया जा सकता है.
- Google Workspace ऐड-ऑन: Apps Script, Gemini Enterprise API, कॉन्टेक्स्ट के हिसाब से (उपयोगकर्ता का मेटाडेटा, चुना गया Gmail मैसेज).


आपको क्या-क्या सीखने को मिलेगा
- Gemini Enterprise और Google Workspace के बीच इंटिग्रेशन पॉइंट, जो डेटा और कार्रवाइयों को चालू करते हैं.
- Gemini Enterprise में होस्ट किए गए कस्टम एजेंट बनाने के लिए, नो-कोड और प्रो-कोड के विकल्प.
- उपयोगकर्ता, Gemini Enterprise के वेब ऐप्लिकेशन और Google Workspace के ऐप्लिकेशन से एजेंट को कैसे ऐक्सेस कर सकते हैं.
इस कोडलैब को आसानी से ऐक्सेस किया जा सकता है

2. सेट अप करें
कॉन्सेप्ट की समीक्षा करें
Gemini Enterprise ऐप्लिकेशन
Gemini Enterprise ऐप्लिकेशन, आपके असली उपयोगकर्ताओं को खोज के नतीजे, कार्रवाइयां, और एजेंट उपलब्ध कराता है. एपीआई के संदर्भ में, ऐप्लिकेशन शब्द का इस्तेमाल इंजन शब्द के साथ किया जा सकता है. किसी ऐप्लिकेशन को डेटा स्टोर से कनेक्ट करना ज़रूरी है, ताकि वह डेटा का इस्तेमाल करके खोज के नतीजे, जवाब या कार्रवाइयां दिखा सके.
Gemini Enterprise का वेब ऐप्लिकेशन
Gemini Enterprise का वेब ऐप्लिकेशन, Gemini Enterprise ऐप्लिकेशन से जुड़ा होता है. यह एक सेंट्रल एआई होम बेस के तौर पर काम करता है. यहाँ कर्मचारी, एक ही चैट इंटरफ़ेस का इस्तेमाल करके, कंपनी के अलग-अलग डेटा को खोज सकते हैं. साथ ही, मुश्किल वर्कफ़्लो के लिए खास एआई एजेंट चला सकते हैं. इसके अलावा, एंटरप्राइज़-लेवल की निजता के साथ, प्रोफ़ेशनल-ग्रेड का कॉन्टेंट जनरेट कर सकते हैं.
संसाधन शुरू करना और उन्हें ऐक्सेस करना
इस सेक्शन में, अपने पसंदीदा वेब ब्राउज़र से इन संसाधनों को ऐक्सेस और कॉन्फ़िगर किया जा सकता है.
Gemini Enterprise ऐप्लिकेशन
Google Cloud Console को नए टैब में खोलें. इसके बाद, यह तरीका अपनाएं:
- अपना प्रोजेक्ट चुनें.
- Google Cloud के खोज फ़ील्ड में, Gemini Enterprise खोजें और उसे चुनें. इसके बाद, + ऐप्लिकेशन बनाएं पर क्लिक करें. अगर आपके पास Gemini Enterprise का लाइसेंस नहीं है, तो आपको 30 दिनों के लिए बिना किसी शुल्क के आज़माने वाला लाइसेंस चालू करने के लिए कहा जाएगा.
- ऐप्लिकेशन का नाम को
codelabपर सेट करें. - नाम के आधार पर एक आईडी जनरेट होता है और उसे फ़ील्ड में दिखाया जाता है. इसे कॉपी करें.
- एक से ज़्यादा क्षेत्र को
global (Global)पर सेट करें. - बनाएं पर क्लिक करें.

- ऐप्लिकेशन बन जाता है और आपको अपने-आप Gemini Enterprise > खास जानकारी पर रीडायरेक्ट कर दिया जाता है.
- पूरा ऐक्सेस पाएं में जाकर, पहचान सेट अप करें पर क्लिक करें.
- नई स्क्रीन पर, Google Identity का इस्तेमाल करें को चुनें. इसके बाद, Workforce Identity की पुष्टि करें पर क्लिक करें.

- कॉन्फ़िगरेशन सेव हो जाता है और आपको Gemini Enterprise > खास जानकारी पर अपने-आप रीडायरेक्ट कर दिया जाता है.
- कॉन्फ़िगरेशन पर जाएं.
- सुविधा मैनेजमेंट टैब में, एजेंट डिज़ाइनर चालू करें को चालू करें. इसके बाद, सेव करें पर क्लिक करें.

Gemini Enterprise का वेब ऐप्लिकेशन
Cloud Console में जाकर, नए टैब में Gemini Enterprise खोलें. इसके बाद, यह तरीका अपनाएं:
codelabनाम वाले ऐप्लिकेशन पर क्लिक करें.- दिखने वाले यूआरएल को कॉपी करें. हम इसका इस्तेमाल अगले चरणों में, Gemini Enterprise के वेब ऐप्लिकेशन पर जाने के लिए करेंगे.

3. नो-कोड कस्टम एजेंट
यह एजेंट उपयोगकर्ताओं को Workspace में डेटा खोजने और अपनी नैचुरल लैंग्वेज में कार्रवाइयां करने की अनुमति देता है. यह इन एलिमेंट पर निर्भर करता है:
- मॉडल: Gemini.
- डेटा और कार्रवाइयाँ: Google Workspace (Calendar, Gmail, Drive, NotebookLM) के लिए Gemini Enterprise के डेटा स्टोर, Google Search.
- एजेंट बनाने के टूल: Gemini Enterprise Agent Designer.
- एजेंट होस्ट: Gemini Enterprise.
- यूज़र इंटरफ़ेस (यूआई): Gemini Enterprise का वेब ऐप्लिकेशन.
कॉन्सेप्ट की समीक्षा करें
Gemini
Gemini, Google का एक मल्टीमॉडल एलएलएम है. इससे लोगों को अपनी पूरी क्षमता का इस्तेमाल करने में मदद मिलती है. इससे वे अपनी कल्पना को और बेहतर बना पाते हैं, नई चीज़ें जानने की इच्छा को बढ़ा पाते हैं, और अपनी प्रॉडक्टिविटी को बेहतर बना पाते हैं.
Gemini Enterprise का डेटा स्टोर
Gemini Enterprise का डेटा स्टोर एक ऐसी इकाई होती है जिसमें पहले पक्ष (ग्राहक) के डेटा सोर्स से लिया गया डेटा शामिल होता है. जैसे, Google Workspace या तीसरे पक्ष के ऐप्लिकेशन, जैसे कि Jira या Salesforce. डेटा कनेक्टर, ऐसे डेटा स्टोर होते हैं जिनमें तीसरे पक्ष के ऐप्लिकेशन का डेटा होता है.
Gemini Enterprise का एजेंट डिज़ाइनर
Gemini Enterprise Agent Designer, एक इंटरैक्टिव नो-कोड और लो-कोड प्लैटफ़ॉर्म है. इसकी मदद से, Gemini Enterprise में एक या कई चरणों वाले एजेंट बनाए, मैनेज किए, और लॉन्च किए जा सकते हैं.
समाधान के आर्किटेक्चर की समीक्षा करना

एपीआई चालू करना
Gemini Enterprise के Workspace डेटा स्टोर के लिए, इन एपीआई को चालू करना ज़रूरी है:
- Google Cloud console में जाकर, Calendar, Gmail, और People API चालू करें:

- मेन्यू ☰ > एपीआई और सेवाएं > चालू किए गए एपीआई और सेवाएं पर क्लिक करें. इसके बाद, पुष्टि करें कि सूची में Google Calendar API, Gmail API, और People API मौजूद हैं.
उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth को सहमति दी जाती है
Gemini Enterprise के Workspace Calendar और Gmail में कार्रवाइयां करने के लिए, सहमति वाली स्क्रीन को कॉन्फ़िगर करना ज़रूरी है:
- Google Cloud console में, मेन्यू ☰ > Google Auth platform > ब्रैंडिंग पर क्लिक करें.
- शुरू करें पर क्लिक करें.
- ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम
Codelabपर सेट करें . - उपयोगकर्ता सहायता के लिए ईमेल पता में, सहायता के लिए वह ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
- आगे बढ़ें पर क्लिक करें.
- दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें.
- आगे बढ़ें पर क्लिक करें.
- संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव की सूचना मिल सके.
- आगे बढ़ें पर क्लिक करें.
- पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
- इसके बाद, जारी रखें और फिर बनाएं पर क्लिक करें.

- कॉन्फ़िगरेशन सेव हो जाता है और आपको Google Auth Platform > खास जानकारी पर अपने-आप रीडायरेक्ट कर दिया जाता है.
- डेटा ऐक्सेस पर जाएं.
- स्कोप जोड़ें या हटाएं पर क्लिक करें.
- यहां दिए गए स्कोप कॉपी करें और उन्हें मैन्युअल तरीके से स्कोप जोड़ें फ़ील्ड में चिपकाएं.
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.calendars
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.readonly
- टेबल में जोड़ें पर क्लिक करें. इसके बाद, अपडेट करें और फिर सेव करें पर क्लिक करें.

ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करना गाइड पढ़ें.
OAuth क्लाइंट के क्रेडेंशियल बनाना
उपयोगकर्ताओं की पुष्टि करने के लिए, Gemini Enterprise का नया OAuth क्लाइंट बनाएं:
- Google Cloud console में, मेन्यू ☰ > Google Auth platform > क्लाइंट पर क्लिक करें.
- + क्लाइंट बनाएं पर क्लिक करें.
- ऐप्लिकेशन टाइप के लिए, वेब ऐप्लिकेशन चुनें.
- नाम को
codelabपर सेट करें. - अनुमति वाले JavaScript ऑरिजिन को छोड़ें.
- रीडायरेक्ट यूआरआई की अनुमति दी गई है सेक्शन में, यूआरआई जोड़ें पर क्लिक करें और
https://vertexaisearch.cloud.google.com/oauth-redirectडालें. - बनाएं पर क्लिक करें.
- आपको एक डायलॉग बॉक्स दिखेगा. इसमें आपका नया OAuth क्लाइंट आईडी और सीक्रेट होगा. इस जानकारी को सुरक्षित जगह पर सेव करें.

डेटा स्टोर बनाना
Gemini Enterprise को अपने Workspace डेटा से कनेक्ट करने के लिए, आपको डेटा स्टोर बनाने होंगे.
Cloud Console में जाकर, Gemini Enterprise को नए टैब में खोलें. इसके बाद, यह तरीका अपनाएं:
codelabनाम वाले ऐप्लिकेशन पर क्लिक करें.- नेविगेशन मेन्यू में, कनेक्ट किए गए डेटा स्टोर पर क्लिक करें.
- + नया डेटा स्टोर पर क्लिक करें.
- सोर्स में, Google Calendar खोजें और चुनें पर क्लिक करें.
- कार्रवाइयां सेक्शन में, पिछले चरणों में सेव किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट डालें. इसके बाद, पुष्टि करें पर क्लिक करें. साथ ही, OAuth क्लाइंट की पुष्टि करने और उसे अनुमति देने के लिए दिया गया तरीका अपनाएं.
- कैलेंडर इवेंट बनाएं और कैलेंडर इवेंट अपडेट करें कार्रवाइयां चालू करें.
- जारी रखें पर क्लिक करें.

- कॉन्फ़िगरेशन सेक्शन में, डेटा कनेक्टर का नाम
calendarपर सेट करें. - बनाएं पर क्लिक करें.
- आपको कनेक्ट किए गए डेटा स्टोर पर अपने-आप रीडायरेक्ट कर दिया जाएगा. यहां आपको नया डेटा स्टोर दिखेगा.
Google Gmail डेटा स्टोर बनाएं:
- + नया डेटा स्टोर पर क्लिक करें.
- सोर्स में, Google Gmail खोजें. इसके बाद, चुनें पर क्लिक करें.
- कार्रवाइयां सेक्शन में, पिछले चरणों में सेव किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट डालें. इसके बाद, पुष्टि करें पर क्लिक करें.
- ईमेल भेजें कार्रवाई चालू करें.
- जारी रखें पर क्लिक करें.
- कॉन्फ़िगरेशन सेक्शन में, डेटा कनेक्टर का नाम
gmailपर सेट करें. - बनाएं पर क्लिक करें.
- आपको कनेक्ट किए गए डेटा स्टोर पर अपने-आप रीडायरेक्ट कर दिया जाएगा. यहां आपको नया डेटा स्टोर दिखेगा.
Google Drive डेटा स्टोर बनाएं:
- + नया डेटा स्टोर पर क्लिक करें.
- सोर्स में, Google Drive खोजें और चुनें पर क्लिक करें.
- डेटा सेक्शन में जाकर, सभी को चुनें. इसके बाद, जारी रखें पर क्लिक करें.
- कॉन्फ़िगरेशन सेक्शन में, डेटा कनेक्टर का नाम
driveपर सेट करें. - बनाएं पर क्लिक करें.
- आपको कनेक्ट किए गए डेटा स्टोर पर अपने-आप रीडायरेक्ट कर दिया जाएगा. यहां आपको नया डेटा स्टोर दिखेगा.
NotebookLM डेटा स्टोर बनाएं:
- + नया डेटा स्टोर पर क्लिक करें.
- सोर्स में जाकर, NotebookLM खोजें. इसके बाद, चुनें पर क्लिक करें.
- कॉन्फ़िगरेशन सेक्शन में, डेटा कनेक्टर का नाम
notebooklmपर सेट करें. - बनाएं पर क्लिक करें.
- आपको कनेक्ट किए गए डेटा स्टोर पर अपने-आप रीडायरेक्ट कर दिया जाएगा. यहां आपको नया डेटा स्टोर दिखेगा.
कुछ मिनट बाद, कनेक्ट किए गए सभी डेटा स्टोर की स्थिति (NotebookLM को छोड़कर) चालू है के तौर पर दिखेगी. अगर आपको कोई गड़बड़ी दिखती है, तो गड़बड़ी की जानकारी देखने के लिए, डेटा सोर्स पर क्लिक करें.

टेस्ट डेटा स्टोर
कुछ टेस्ट क्वेरी चलाकर पुष्टि करें कि आपके डेटा स्टोर, डेटा को सही तरीके से शामिल कर रहे हैं.
Gemini Enterprise के वेब ऐप्लिकेशन का वह यूआरएल खोलें जिसे हमने पहले कॉपी किया था:
- मेन्यू ☰ > नई चैट पर क्लिक करें.
- चैट मैसेज फ़ील्ड के फ़ुटर में, कनेक्टर आइकॉन पर क्लिक करें और सभी कनेक्टर चालू करें.
- अब कनेक्टर से जुड़े प्रॉम्प्ट के साथ एक्सपेरिमेंट किया जा सकता है. उदाहरण के लिए, चैट में
Do I have any meetings today?टाइप करें औरenterदबाएं. - इसके बाद,
How many emails did I receive today?टाइप करें औरenterदबाएं. - आखिर में,
Give me the title of the last Drive file I createdटाइप करें औरenterदबाएं.

कस्टम एजेंट बनाना
Gemini Enterprise के वेब ऐप्लिकेशन में, एजेंट डिज़ाइनर का इस्तेमाल करके एक नया एजेंट बनाएँ:
- मेन्यू ☰ > + नया एजेंट पर क्लिक करें.
- चैट में,
An agent that always sends pirate-themed emails but use normal English otherwiseटाइप करें औरenterदबाएं.

- Agent Designer, प्रॉम्प्ट के आधार पर एजेंट को ड्राफ़्ट करता है और उसे एडिटर में खोलता है.
- बनाएं पर क्लिक करें
कस्टम एजेंट आज़माएँ
अपने नए एजेंट को टेस्ट करें. इससे आपको पता चलेगा कि वह सवालों के जवाब कैसे देता है और कार्रवाइयां कैसे करता है.
- Gemini Enterprise के वेब ऐप्लिकेशन में, नए एजेंट के साथ चैट करें:
- मेन्यू ☰ > एजेंट पर क्लिक करें.
- आपके एजेंट में जाकर, एजेंट चुनें.
- नए चैट मैसेज फ़ील्ड के फ़ुटर में, कनेक्टर आइकॉन पर क्लिक करें. इसके बाद, Mail के लिए कार्रवाइयां चालू करें पर क्लिक करें और एजेंट को अनुमति देने के लिए निर्देशों का पालन करें
- चैट में,
Send an email to someone@example.com saying I'll see them at Cloud Next, generate some subject and body yourselfटाइप करें औरenterदबाएं. संपल ईमेल पते की जगह अपना ईमेल पता डाला जा सकता है. - ईमेल भेजने के लिए, ✔️ पर क्लिक करें.


4. प्रो-कोड कस्टम एजेंट
यह एजेंट उपयोगकर्ताओं को कस्टम टूल और नियमों का इस्तेमाल करके, नैचुरल लैंग्वेज में Workspace के डेटा को खोजने और कार्रवाइयां करने की सुविधा देता है. यह इन एलिमेंट पर निर्भर करता है:
- मॉडल: Gemini.
- डेटा और कार्रवाइयां: Google Workspace (Calendar, Gmail, Drive, NotebookLM) के लिए Gemini Enterprise के डेटा स्टोर, Google Search, Google के मैनेज किए गए Agent Search का मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, Google Chat के मैसेज भेजने के लिए कस्टम टूल फ़ंक्शन (Google Chat API के ज़रिए).
- एजेंट बनाने के टूल: Agent Development Kit (ADK).
- एजेंट होस्ट: एजेंट रनटाइम.
- यूज़र इंटरफ़ेस (यूआई): Gemini Enterprise का वेब ऐप्लिकेशन.
इसे bring-your-own सुविधा का इस्तेमाल करके Gemini Enterprise में इंटिग्रेट किया जाएगा. इसलिए, हमें डिप्लॉयमेंट, रजिस्ट्रेशन, और कॉन्फ़िगरेशन के चरणों को पूरा करना होगा.
कॉन्सेप्ट की समीक्षा करें
Gemini Enterprise एजेंट प्लैटफ़ॉर्म
Gemini Enterprise Agent Platform (पहले इसे Vertex AI कहा जाता था) एक ओपन और कॉम्प्रिहेंसिव प्लैटफ़ॉर्म है. यह कारोबारों को एंटरप्राइज़-ग्रेड एजेंट बनाने, उन्हें स्केल करने, उन्हें मैनेज करने, और उन्हें ऑप्टिमाइज़ करने की सुविधा देता है. ये एजेंट, एंटरप्राइज़ डेटा पर आधारित होते हैं.

Agent Development Kit (ADK)
एजेंट डेवलपमेंट किट (एडीके), टूल और फ़्रेमवर्क का एक खास सुइट है. इसे अपने-आप काम करने वाले एआई एजेंट बनाने की प्रोसेस को आसान बनाने के लिए डिज़ाइन किया गया है. इसमें तर्क, मेमोरी मैनेजमेंट, और टूल इंटिग्रेशन के लिए पहले से बने मॉड्यूल उपलब्ध कराए जाते हैं.
मॉडल कॉन्टेक्स्ट पी्रोटोकॉल (एमसीपी)
मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) एक ओपन स्टैंडर्ड है. इसे एआई ऐप्लिकेशन और अलग-अलग डेटा सोर्स या टूल के बीच, आसानी से और सुरक्षित तरीके से इंटिग्रेट करने के लिए डिज़ाइन किया गया है. इसके लिए, एक यूनिवर्सल "प्लग-एंड-प्ले" इंटरफ़ेस का इस्तेमाल किया जाता है.
फ़ंक्शन टूल
फ़ंक्शन टूल, पहले से तय की गई एक ऐसी रूटीन होती है जिसे एआई मॉडल ट्रिगर कर सकता है. इससे वह कुछ खास कार्रवाइयां कर सकता है या बाहरी सिस्टम से रीयल-टाइम डेटा पा सकता है. इससे, एआई मॉडल की क्षमताएं सिर्फ़ टेक्स्ट जनरेट करने से आगे बढ़ जाती हैं.
समाधान के आर्किटेक्चर की समीक्षा करना

सोर्स कोड की समीक्षा करना
agent.py
यहां दिया गया कोड, Gemini Enterprise से पुष्टि करता है. साथ ही, Agent Search MCP और Chat API टूल को शुरू करता है. इसके अलावा, यह एजेंट के व्यवहार को तय करता है.
- पुष्टि करना: यह पुष्टि करने के लिए, हेल्पर फ़ंक्शन
_get_access_token_from_contextका इस्तेमाल करता है. इससे पुष्टि करने वाले टोकन (CLIENT_AUTH_NAME) को वापस पाने में मदद मिलती है. यह टोकन, Gemini Enterprise इंजेक्ट करता है. यह टोकन, Agent Search MCP और Google Chat टूल जैसी डाउनस्ट्रीम सेवाओं को सुरक्षित तरीके से कॉल करने के लिए ज़रूरी है. - टूल सेटअप: यह
vertexai_mcpको शुरू करता है. यह एक टूलसेट है, जो एजेंट सर्च मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर औरsend_direct_messageटूल से कनेक्ट होता है. इससे एजेंट को, कनेक्ट किए गए डेटा स्टोर में खोजने और Google Chat पर मैसेज भेजने की सुविधा मिलती है. - एजेंट की परिभाषा: इसमें
gemini-2.5-flashमॉडल का इस्तेमाल करके,root_agentको परिभाषित किया गया है. इन निर्देशों में एजेंट को बताया जाता है कि जानकारी पाने के लिए, खोज टूल का इस्तेमाल सबसे पहले किया जाए. साथ ही, कार्रवाइयां करने के लिएsend_direct_messageटूल का इस्तेमाल किया जाए. इससे एजेंट को आपके एंटरप्राइज़ डेटा के बारे में सटीक जानकारी मिलती है.
...
MODEL = "gemini-2.5-flash"
# Gemini Enterprise authentication injects a bearer token into the ToolContext state.
# The key pattern is "CLIENT_AUTH_NAME_<random_digits>".
# We dynamically parse this token to authenticate our MCP and API calls.
CLIENT_AUTH_NAME = "enterprise-ai"
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 _get_access_token_from_context(tool_context: ToolContext) -> str:
"""Helper method to dynamically parse the intercepted bearer token from the context state."""
escaped_name = re.escape(CLIENT_AUTH_NAME)
pattern = re.compile(fr"^{escaped_name}_\d+$")
# Handle ADK varying state object types (Raw Dict vs ADK State)
state_dict = tool_context.state.to_dict() if hasattr(tool_context.state, 'to_dict') else tool_context.state
matching_keys = [k for k in state_dict.keys() if pattern.match(k)]
if matching_keys:
return state_dict.get(matching_keys[0])
raise Exception(f"No bearer token found in ToolContext state matching pattern {pattern.pattern}")
def auth_header_provider(tool_context: ToolContext) -> dict[str, str]:
token = _get_access_token_from_context(
