इस पेज पर, Google Workspace ऐड-ऑन बनाने का तरीका बताया गया है. यह ऐड-ऑन, Google Chat में काम करता है और Agent2UI (A2UI) प्रोटोकॉल का इस्तेमाल करने वाले एआई एजेंट के साथ इंटरैक्ट करता है. Agent Development Kit (ADK) का इस्तेमाल करके एजेंट डेवलप किया जाता है. साथ ही, इसे Vertex AI Agent Engine में होस्ट किया जाता है.
एआई एजेंट, अपने-आप अपने आस-पास के माहौल को समझते हैं, तर्क देते हैं, और तय किए गए लक्ष्य को हासिल करने के लिए, कई चरणों वाली मुश्किल कार्रवाइयां करते हैं. इस ट्यूटोरियल में, आपको एक बुनियादी एआई एजेंट को डिप्लॉय करने का तरीका बताया गया है. यह एजेंट, टूल से मिली स्टैटिक प्रोफ़ाइल की जानकारी दिखाता है.
A2UI, एआई एजेंट को अडैप्टिव, रिच, और इंटरैक्टिव यूज़र इंटरफ़ेस (यूआई) जनरेट करने की सुविधा देता है. ये यूआई, नेटिव तौर पर रेंडर होते हैं. इसके बाद, यूज़र इंटरफ़ेस (यूआई) के बजाय, एआई एजेंट के लॉजिक पर ध्यान दिया जा सकता है.
-
पहली इमेज. A2UI एजेंट, उपयोगकर्ता को टेक्स्ट और एक कार्ड के साथ जवाब देता है. इस कार्ड में नाम, इमेज, और LinkedIn बटन होता है. -
दूसरी इमेज. A2UI एजेंट को अपडेट किया गया है, ताकि वह प्रोफ़ाइल का टाइटल भी दिखा सके. -
तीसरी इमेज. A2UI एजेंट, उपयोगकर्ता को एक मैसेज भेजता है. इसमें कार्ड में मौजूद प्रोफ़ाइल का नाम दिखता है.
इस डायग्राम में आर्किटेक्चर और मैसेजिंग पैटर्न दिखाया गया है:

डायग्राम में, A2UI एजेंट के साथ लागू किए गए चैट ऐप्लिकेशन से इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:
- कोई उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या किसी Chat स्पेस में मैसेज भेजता है.
- Chat ऐप्लिकेशन का लॉजिक, Apps Script में लागू किया जाता है. इसके अलावा, इसे एचटीटीपी एंडपॉइंट वाले वेब सर्वर के तौर पर भी लागू किया जाता है. यह लॉजिक, मैसेज को पाने और उसे प्रोसेस करने का काम करता है.
- Vertex AI Agent Engine के साथ होस्ट किया गया A2UI एजेंट, इंटरैक्शन को स्वीकार करता है और उसे प्रोसेस करता है.
- Chat ऐप्लिकेशन या एआई एजेंट को Google Workspace की सेवाओं के साथ इंटिग्रेट किया जा सकता है. जैसे, Calendar या Sheets. इसके अलावा, इसे Google की अन्य सेवाओं के साथ भी इंटिग्रेट किया जा सकता है. जैसे, Google Maps या YouTube.
- Chat ऐप्लिकेशन, Google Chat API का इस्तेमाल करके, एआई एजेंट की प्रोग्रेस के बारे में जानकारी देता है. साथ ही, एसिंक्रोनस तरीके से अडैप्टिव जवाब जनरेट करके भेजता है.
- जवाब, उपयोगकर्ता को भेजे जाते हैं.
मकसद
- अपना एनवायरमेंट सेट अप करें.
- A2UI एजेंट को डिप्लॉय करें.
- Chat ऐप्लिकेशन डिप्लॉय करें.
- Chat ऐप्लिकेशन को कॉन्फ़िगर करें.
- Chat ऐप्लिकेशन को टेस्ट करें.
ज़रूरी शर्तें
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है या नहीं, अपने प्रोजेक्ट के बिलिंग स्टेटस की पुष्टि करें लेख पढ़ें. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.
- Python 3.11+: इसे इंस्टॉल करने के लिए, Python की आधिकारिक वेबसाइट पर दिए गए निर्देशों का पालन करें.
- Python Poetry: इसे इंस्टॉल करने के लिए, Poetry की आधिकारिक वेबसाइट पर दिए गए निर्देशों का पालन करें.
- Google Cloud CLI: इसे इंस्टॉल करने के लिए, Google Cloud की आधिकारिक वेबसाइट पर दिए गए निर्देशों का पालन करें.
अपना एनवायरमेंट सेट अप करने का तरीका
Google Cloud API चालू करना
Google API का उपयोग करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में सक्रिय करना होगा. आप एक ही Google क्लाउड प्रोजेक्ट में एक या अधिक API चालू कर सकते हैं.Google क्लाउड कंसोल में, Google चैट, वर्टेक्स एआई और क्लाउड रिसोर्स मैनेजर एपीआई को सक्षम करें.
उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है
OAuth 2.0 का उपयोग करने वाले सभी ऐप्स के लिए सहमति स्क्रीन कॉन्फ़िगरेशन की आवश्यकता होती है. अपने ऐप की OAuth सहमति स्क्रीन को कॉन्फ़िगर करने से यह परिभाषित होता है कि उपयोगकर्ताओं और ऐप समीक्षकों को क्या प्रदर्शित किया जाएगा, और आपके ऐप को पंजीकृत करता है ताकि आप इसे बाद में प्रकाशित कर सकें.
- गूगल क्लाउड कंसोल में, मेनू > Google Auth platform > ब्रांडिंग पर जाएं.
- यदि आपने पहले ही Google Auth platformको कॉन्फ़िगर कर लिया है, तो आप ब्रांडिंग, दर्शक और डेटा एक्सेस में निम्नलिखित OAuth सहमति स्क्रीन सेटिंग्स को कॉन्फ़िगर कर सकते हैं. यदि आपको Google Auth platform अभी तक कॉन्फ़िगर नहीं किया गया है संदेश दिखाई देता है, तो आरंभ करें पर क्लिक करें:
- ऐप जानकारी के अंतर्गत, ऐप नाम में, ऐप के लिए एक नाम दर्ज करें.
- उपयोगकर्ता सहायता के लिए ईमेल पता में, सहायता के लिए वह ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
- आगे बढ़ें पर क्लिक करें.
- दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें.
- आगे बढ़ें पर क्लिक करें.
- संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना मिल सके.
- आगे बढ़ें पर क्लिक करें.
- पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
- जारी रखें पर क्लिक करें.
- बनाएं पर क्लिक करें.
- फिलहाल, आप स्कोप जोड़ने की प्रक्रिया को छोड़ सकते हैं. भविष्य में, जब आप अपने Google वर्कस्पेस संगठन के बाहर उपयोग के लिए कोई ऐप बनाते हैं, तो आपको उपयोगकर्ता प्रकार को बाहरी में बदलना होगा. फिर अपनी ऐप के लिए आवश्यक प्राधिकरण स्कोप जोड़ें. अधिक जानने के लिए, पूर्ण OAuth सहमति कॉन्फ़िगर करें गाइड देखें.
Google क्लाउड कंसोल में एक सेवा खाता बनाएँ
इन चरणों का पालन करके Vertex AI User भूमिका वाला एक नया सेवा खाता बनाएँ:
Google Cloud कंसोल
- गूगल क्लाउड कंसोल में, मेनू > आईएएम और एडमिन > सर्विस अकाउंट्स पर जाएं.
- सेवा खाता बनाएं पर क्लिक करें.
- सेवा खाता विवरण भरें, फिर बनाएँ और जारी रखें पर क्लिक करें.
- वैकल्पिक: अपने Google क्लाउड प्रोजेक्ट के संसाधनों तक पहुंच प्रदान करने के लिए अपने सेवा खाते को भूमिकाएँ असाइन करें. अधिक जानकारी के लिए, संसाधनों तक पहुंच प्रदान करना, बदलना और निरस्त करना देखें.
- जारी रखें पर क्लिक करें.
- उन उपयोगकर्ताओं या ग्रुप के नाम डालें जिनके पास इस सेवा खाते को मैनेज करने और इससे जुड़ी कार्रवाइयां करने का ऐक्सेस है. हालांकि, यह ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
- हो गया पर क्लिक करें. सेवा खाते का ईमेल पता नोट करें.
gcloud सीएलआई
- सेवा खाता बनाएं:
gcloud iam service-accounts createSERVICE_ACCOUNT_NAME\ --display-name="SERVICE_ACCOUNT_NAME" - ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि उसे आपके Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस मिल सके. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, उसमें बदलाव करना, और उसे रद्द करना लेख पढ़ें.
सेवा खाता, सेवा खाते वाले पेज पर दिखता है.
निजी कुंजी बनाना
सेवा खाते के लिए निजी पासकोड बनाने और उसे डाउनलोड करने के लिए, यह तरीका अपनाएं:
- Google Cloud console में, मेन्यू > आईएएम और एडमिन > सेवा खाते पर जाएं.
- अपना सेवा खाता चुनें.
- कुंजियां > कुंजी जोड़ें > नई कुंजी बनाएं पर क्लिक करें.
- JSON को चुनें. इसके बाद, बनाएं पर क्लिक करें.
आपकी नई सार्वजनिक/निजी कुंजी की जोड़ी जनरेट करके आपकी मशीन पर एक नई फ़ाइल के तौर पर डाउनलोड की जाती है. डाउनलोड की गई JSON फ़ाइल को अपनी वर्किंग डायरेक्ट्री में
credentials.jsonके तौर पर सेव करें. यह फ़ाइल, इस कुंजी की एकमात्र कॉपी है. अपनी कुंजी को सुरक्षित तरीके से सेव करने के बारे में जानकारी के लिए, सेवा खाते की कुंजियां मैनेज करना लेख पढ़ें. - बंद करें पर क्लिक करें.
सेवा खातों के बारे में ज़्यादा जानने के लिए, Google Cloud IAM के दस्तावेज़ में सेवा खाते लेख पढ़ें.
A2UI एजेंट को डिप्लॉय करना
अगर आपने ऐसा नहीं किया है, तो अपने Google Cloud खाते से पुष्टि करें. साथ ही, Google Cloud प्रोजेक्ट का इस्तेमाल करने के लिए, Google Cloud CLI को कॉन्फ़िगर करें.
gcloud auth application-default logingcloud config set project PROJECT_IDgcloud auth application-default set-quota-project PROJECT_IDPROJECT_ID की जगह, अपने Cloud प्रोजेक्ट का आईडी डालें.
इस बटन का इस्तेमाल करके,
googleworkspace/add-ons-samplesGitHub रिपॉज़िटरी डाउनलोड करें:अपने पसंदीदा लोकल डेवलपमेंट एनवायरमेंट में, डाउनलोड की गई संग्रह फ़ाइल को एक्सट्रैक्ट करें और
add-ons-samples/apps-script/chat/a2ui-ai-agent/a2uiडायरेक्ट्री खोलें.unzip add-ons-samples-main.zipcd add-ons-samples/apps-script/chat/a2ui-ai-agent/a2uiADK एजेंट के लिए, एक नया Cloud Storage बकेट बनाएं.
gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATIONइनकी जगह ये डालें:
- CLOUD_STORAGE_BUCKET_NAME को अपनी पसंद के किसी यूनीक बकेट नाम से बदलें.
- PROJECT_ID की जगह अपने Cloud प्रोजेक्ट का आईडी डालें.
- PROJECT_LOCATION को आपके Cloud प्रोजेक्ट की जगह की जानकारी का ऐक्सेस चाहिए.
इन एनवायरमेंट वैरिएबल को सेट करें:
export GOOGLE_GENAI_USE_VERTEXAI=trueexport GOOGLE_CLOUD_PROJECT=PROJECT_IDexport GOOGLE_CLOUD_LOCATION=PROJECT_LOCATIONexport GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAMEइनकी जगह ये डालें:
- CLOUD_STORAGE_BUCKET_NAME में, बनाए गए बकेट का नाम डालें.
- PROJECT_ID की जगह अपने Cloud प्रोजेक्ट का आईडी डालें.
- PROJECT_LOCATION को अपने Cloud प्रोजेक्ट की जगह की जानकारी का ऐक्सेस दें.
वर्चुअल एनवायरमेंट से ADK एजेंट को इंस्टॉल और डिप्लॉय करें.
python3 -m venv myenvsource myenv/bin/activatepoetry install --with deploymentpython3 deployment/deploy.py --createएजेंट आईडी वापस पाएं. इसकी ज़रूरत आपको बाद में Chat ऐप्लिकेशन को कॉन्फ़िगर करते समय पड़ेगी.
python3 deployment/deploy.py --list
Chat ऐप्लिकेशन प्रोजेक्ट बनाना और उसे कॉन्फ़िगर करना
A2UI AI एजेंट क्विकस्टार्ट Apps Script प्रोजेक्ट खोलने के लिए, यहां दिए गए बटन पर क्लिक करें.
खास जानकारी >
कॉपी बनाएं पर क्लिक करें.
अपने Apps Script प्रोजेक्ट में,
प्रोजेक्ट सेटिंग पर क्लिक करें > स्क्रिप्ट की प्रॉपर्टी में बदलाव करें > स्क्रिप्ट की प्रॉपर्टी जोड़ें पर क्लिक करें. इसके बाद, स्क्रिप्ट की ये प्रॉपर्टी जोड़ें:
REASONING_ENGINE_RESOURCE_NAMEमें, Vertex AI एजेंट के संसाधन का नाम डालें. यह नाम पिछले चरणों में कॉपी किया गया था.SERVICE_ACCOUNT_KEYमें, सेवा खाते से मिली JSON कुंजी का इस्तेमाल करें. यह कुंजी, पिछले चरणों में डाउनलोड की गई थी. जैसे,{ ... }.
स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें.
Google Cloud console में, मेन्यू > IAM और एडमिन > सेटिंग पर जाएं.
प्रोजेक्ट नंबर फ़ील्ड में, वैल्यू कॉपी करें.
अपने Apps Script प्रोजेक्ट में,
प्रोजेक्ट की सेटिंग पर क्लिक करें.
Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
GCP प्रोजेक्ट नंबर में, पिछले चरणों में कॉपी किया गया Google Cloud प्रोजेक्ट नंबर चिपकाएं.
प्रोजेक्ट सेट करें पर क्लिक करें. अब Cloud प्रोजेक्ट और Apps Script प्रोजेक्ट कनेक्ट हो गए हैं.
टेस्ट डिप्लॉयमेंट बनाना
आपको इस Apps Script प्रोजेक्ट के लिए डिप्लॉयमेंट आईडी की ज़रूरत होगी, ताकि आप इसका इस्तेमाल अगले चरण में कर सकें.
हेड डिप्लॉयमेंट आईडी पाने के लिए, यह तरीका अपनाएं:
- Chat ऐप्लिकेशन के Apps Script प्रोजेक्ट में, परिनियोजित करें > परिनियोजन की जांच करें पर क्लिक करें.
- हेड डिप्लॉयमेंट आईडी में जाकर,
कॉपी करें पर क्लिक करें.
- हो गया पर क्लिक करें.
Chat ऐप्लिकेशन को कॉन्फ़िगर करना
Apps Script डिप्लॉयमेंट का इस्तेमाल करके, Google Chat ऐप्लिकेशन को टेस्ट करने के लिए डिप्लॉय करने के लिए, यह तरीका अपनाएं:
- कंसोल में,
Google Chat APIखोजें और Google Chat API पर क्लिक करें. - मैनेज करें पर क्लिक करें.
कॉन्फ़िगरेशन पर क्लिक करें और Chat ऐप्लिकेशन सेट अप करें:
- ऐप्लिकेशन का नाम फ़ील्ड में,
A2UI Quickstartडालें. - अवतार का यूआरएल फ़ील्ड में,
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.pngडालें. - ब्यौरा फ़ील्ड में,
A2UI Quickstartडालें. - सुविधाएं में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
- कनेक्शन सेटिंग में जाकर, Apps Script प्रोजेक्ट को चुनें.
- डिप्लॉयमेंट आईडी फ़ील्ड में, हेड डिप्लॉयमेंट आईडी चिपकाएं. यह वही आईडी होना चाहिए जिसे आपने पहले कॉपी किया था.
- 'दिखने की सेटिंग' में जाकर, आपके डोमेन में मौजूद कुछ खास लोग और ग्रुप को चुनें. इसके बाद, अपना ईमेल पता डालें.
- ऐप्लिकेशन का नाम फ़ील्ड में,
सेव करें पर क्लिक करें.
Chat ऐप्लिकेशन, मैसेज का जवाब देने के लिए तैयार है.
Chat ऐप्लिकेशन की टेस्टिंग करना
Chat ऐप्लिकेशन को आज़माने के लिए, Chat ऐप्लिकेशन की मदद से कोई डायरेक्ट मैसेज स्पेस खोलें और मैसेज भेजें:
उस Google Workspace खाते से Google Chat खोलें जिसका इस्तेमाल आपने भरोसेमंद टेस्टर के तौर पर खुद को शामिल करते समय किया था.
- नई चैट पर क्लिक करें.
- एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.
नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.
ऐप्लिकेशन को भेजे गए नए डायरेक्ट मैसेज में,
Hello!टाइप करें औरenterदबाएं.Chat ऐप्लिकेशन, अभिवादन वाले टेक्स्ट और एक कार्ड के साथ जवाब देता है. इस कार्ड में प्रोफ़ाइल का नाम, इमेज, और LinkedIn बटन होता है.
प्रोफ़ाइल का टाइटल भी दिखाने के लिए, A2UI एजेंट को लागू करने का तरीका अपडेट करें.
अपने लोकल डेवलपमेंट एनवायरमेंट में,
a2ui/agent.pyफ़ाइल खोलें. इसके बाद, टूल में उस लाइन से टिप्पणी हटाएं जो दिखाए गए डेटा में टाइटल जोड़ती है.लागू करने के नए वर्शन के साथ पहले से डिप्लॉय किए गए एडीके को अपडेट करें.
python3 deployment/deploy.py --update --resource_id=RESOURCE_IDRESOURCE_ID को Vertex AI एजेंट के संसाधन के नाम से बदलें. यह नाम, पिछले चरणों में कॉपी किया गया था.
ऐप्लिकेशन को भेजे गए डायरेक्ट मैसेज में,
Hello again!टाइप करें औरenterदबाएं.Chat ऐप्लिकेशन, कुछ टेक्स्ट और प्रोफ़ाइल का टाइटल दिखाने वाले कार्ड के साथ मैसेज का जवाब देता है.
भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं को टेस्ट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाएं टेस्ट करना लेख पढ़ें.
समस्या हल करें
जब कोई Google Chat ऐप्लिकेशन या कार्ड कोई गड़बड़ी दिखाता है, तो Chat इंटरफ़ेस पर एक मैसेज दिखता है. इसमें लिखा होता है कि "कोई गड़बड़ी हुई." या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat के यूज़र इंटरफ़ेस (यूआई) में कोई गड़बड़ी का मैसेज नहीं दिखता है, लेकिन Chat ऐप्लिकेशन या कार्ड से कोई अनचाहा नतीजा मिलता है. उदाहरण के लिए, ऐसा हो सकता है कि कार्ड मैसेज न दिखे.
ऐसा हो सकता है कि Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे. हालांकि, Chat ऐप्लिकेशन के लिए गड़बड़ी के लॉगिंग की सुविधा चालू होने पर, गड़बड़ियों को ठीक करने में आपकी मदद करने के लिए, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होता है. गड़बड़ियों को देखने, डीबग करने, और ठीक करने के बारे में मदद पाने के लिए, Google Chat से जुड़ी गड़बड़ियों को ठीक करना लेख पढ़ें.
व्यवस्थित करें
इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते से शुल्क लिए जाने से बचने के लिए, हमारा सुझाव है कि आप Cloud प्रोजेक्ट मिटा दें.
- Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग बॉक्स में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट मिटाने के लिए बंद करें पर क्लिक करें.
मिलते-जुलते विषय
- ADK एआई एजेंट की मदद से Google Chat ऐप्लिकेशन बनाना
- A2A एजेंट की मदद से Google Chat ऐप्लिकेशन बनाना
- ADK के एआई एजेंट और Gemini मॉडल की मदद से, तथ्यों की जांच करना
- Google Workspace के सभी ऐप्लिकेशन में उपलब्ध एआई एजेंट की मदद से यात्राओं की योजना बनाना
- Chat ऐप्लिकेशन में एआई से जुड़े बुनियादी कॉन्सेप्ट इंटिग्रेट करना
- Gemini के एआई चैट ऐप्लिकेशन के साथ हुई बातचीत के आधार पर सवालों के जवाब देना
- Google Chat, Vertex AI, Apps Script, और उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करके, सुरक्षा से जुड़ी घटनाओं का जवाब देना
- Google Chat, Vertex AI, और Firestore की मदद से प्रोजेक्ट मैनेज करना