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

इस डायग्राम में आर्किटेक्चर और मैसेजिंग पैटर्न दिखाया गया है:
इस डायग्राम में, A2A एजेंट के साथ लागू किए गए चैट ऐप्लिकेशन से इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:
- कोई उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या Chat स्पेस में मैसेज भेजता है.
- Chat ऐप्लिकेशन का लॉजिक, Apps Script में लागू किया जाता है. इसके अलावा, इसे एचटीटीपी एंडपॉइंट वाले वेब सर्वर के तौर पर भी लागू किया जाता है. यह मैसेज को पाता है और उसे प्रोसेस करता है.
- Vertex AI Agent Engine के साथ होस्ट किया गया A2A एजेंट, इंटरैक्शन को स्वीकार करता है और उसे प्रोसेस करता है.
- Chat ऐप्लिकेशन या एआई एजेंट को Google Workspace की सेवाओं के साथ इंटिग्रेट किया जा सकता है. जैसे, Calendar या Sheets. इसके अलावा, इसे Google की अन्य सेवाओं के साथ भी इंटिग्रेट किया जा सकता है. जैसे, Google Maps या YouTube. हालांकि, ऐसा करना ज़रूरी नहीं है.
- Chat ऐप्लिकेशन, Google Chat API का इस्तेमाल करके एसिंक्रोनस तरीके से जवाब भेजता है. इससे एआई एजेंट की प्रोग्रेस के बारे में जानकारी मिलती है.
- जवाब, उपयोगकर्ता को भेजे जाते हैं.
मकसद
- अपना एनवायरमेंट सेट अप करें.
- A2A एजेंट को डिप्लॉय करें.
- Chat ऐप्लिकेशन डिप्लॉय करें.
- Chat ऐप्लिकेशन को कॉन्फ़िगर करें.
- Chat ऐप्लिकेशन को टेस्ट करें.
ज़रूरी शर्तें
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है या नहीं, अपने प्रोजेक्ट के बिलिंग स्टेटस की पुष्टि करें लेख पढ़ें. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.
- LLM Auditor ADK एजेंट के लिए ज़रूरी शर्तें
- Python 3.11+: इसे इंस्टॉल करने के लिए, Python की आधिकारिक वेबसाइट पर दिए गए निर्देशों का पालन करें.
- Python Poetry: इसे इंस्टॉल करने के लिए, Poetry की आधिकारिक वेबसाइट पर दिए गए निर्देशों का पालन करें.
- Google Cloud CLI: इसे इंस्टॉल करने के लिए, Google Cloud की आधिकारिक वेबसाइट पर दिए गए निर्देशों का पालन करें.
अपना एनवायरमेंट सेट अप करने का तरीका
Google Cloud API चालू करना
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. एक ही Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.Google Cloud console में, Google Chat, Vertex AI, और Cloud Resource Manager API चालू करें.
उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है
OAuth 2.0 का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए, सहमति स्क्रीन को कॉन्फ़िगर करना ज़रूरी है. अपने ऐप्लिकेशन की OAuth सहमति स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को क्या दिखेगा. साथ ही, इससे आपका ऐप्लिकेशन रजिस्टर हो जाता है, ताकि बाद में इसे पब्लिश किया जा सके.
- Google Cloud console में, मेन्यू > Google Auth platform > ब्रैंडिंग पर जाएं.
- अगर आपने पहले ही Google Auth platformको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth platform अभी तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
- ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
- उपयोगकर्ता सहायता के लिए ईमेल पता में, सहायता के लिए वह ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
- आगे बढ़ें पर क्लिक करें.
- दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें.
- आगे बढ़ें पर क्लिक करें.
- संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना मिल सके.
- आगे बढ़ें पर क्लिक करें.
- पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
- जारी रखें पर क्लिक करें.
- बनाएं पर क्लिक करें.
- फ़िलहाल, स्कोप जोड़ने की प्रोसेस को स्किप किया जा सकता है. अगर आपको आने वाले समय में, अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाना है, तो आपको उपयोगकर्ता का टाइप बदलकर बाहरी करना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए ज़रूरी अनुमति के स्कोप जोड़ें. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करना गाइड पढ़ें.
Google Cloud Console में सेवा खाता बनाना
Vertex AI User की भूमिका वाला नया सेवा खाता बनाने के लिए, यह तरीका अपनाएं:
Google Cloud कंसोल
- Google Cloud Console में, मेन्यू > आईएएम और एडमिन > सेवा खाते पर जाएं.
- सेवा खाता बनाएं पर क्लिक करें.
- सेवा खाते की जानकारी भरें. इसके बाद, बनाएं और जारी रखें पर क्लिक करें.
- ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि उसे आपके Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस मिल सके. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, उसमें बदलाव करना, और उसे रद्द करना लेख पढ़ें.
- जारी रखें पर क्लिक करें.
- उन उपयोगकर्ताओं या ग्रुप के नाम डालें जिनके पास इस सेवा खाते को मैनेज करने और इससे जुड़ी कार्रवाइयां करने का ऐक्सेस है. हालांकि, यह ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
- हो गया पर क्लिक करें. सेवा खाते का ईमेल पता नोट कर लें.
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 के दस्तावेज़ में सेवा खाते लेख पढ़ें.
A2A एजेंट को डिप्लॉय करना
अगर आपने ऐसा नहीं किया है, तो अपने 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 प्रोजेक्ट का आईडी डालें.
इस बटन का इस्तेमाल करके, ADK के सैंपल वाली GitHub रिपॉज़िटरी डाउनलोड करें:
अपने पसंदीदा लोकल डेवलपमेंट एनवायरमेंट में, डाउनलोड की गई संग्रह फ़ाइल को निकालें और
adk-samples/python/agents/llm-auditorडायरेक्ट्री खोलें.unzip adk-samples-main.zipcd adk-samples-main/python/agents/llm-auditorADK एजेंट को A2A रिमोट एजेंट के तौर पर डिप्लॉय करने के लिए, लागू करने की प्रोसेस को अपडेट करें:
pyproject.toml: डिप्लॉयमेंट ग्रुप में ADK और A2A SDK की डिपेंडेंसी जोड़ें.
deployment/deploy.py: ADK ऐप्लिकेशन को डिप्लॉय करने के बजाय, A2A एजेंट और कार्ड को डिप्लॉय करें.
ADK एजेंट के लिए, नया 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 ऐप्लिकेशन प्रोजेक्ट बनाना और उसे कॉन्फ़िगर करना
A2A एआई एजेंट क्विकस्टार्ट 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 ऐप्लिकेशन सेट अप करें:
- ऐप्लिकेशन का नाम फ़ील्ड में,
A2A Quickstartडालें. - अवतार का यूआरएल फ़ील्ड में,
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.pngडालें. - ब्यौरा फ़ील्ड में,
A2A Quickstartडालें. - सुविधाएं में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
- कनेक्शन सेटिंग में जाकर, Apps Script प्रोजेक्ट को चुनें.
- डिप्लॉयमेंट आईडी फ़ील्ड में, हेड डिप्लॉयमेंट आईडी चिपकाएं. यह वही आईडी होना चाहिए जिसे आपने पहले कॉपी किया था.
- 'दिखने की सेटिंग' में जाकर, आपके डोमेन में मौजूद चुनिंदा लोग और ग्रुप को चुनें. इसके बाद, अपना ईमेल पता डालें.
- ऐप्लिकेशन का नाम फ़ील्ड में,
सेव करें पर क्लिक करें.
Chat ऐप्लिकेशन, मैसेज का जवाब देने के लिए तैयार है.
Chat ऐप्लिकेशन की टेस्टिंग करना
Chat ऐप्लिकेशन को आज़माने के लिए, Chat ऐप्लिकेशन की मदद से कोई डायरेक्ट मैसेज स्पेस खोलें और मैसेज भेजें:
Google Workspace खाते का इस्तेमाल करके Google Chat खोलें. आपने इसी खाते का इस्तेमाल करके, भरोसेमंद टेस्टर के तौर पर खुद को जोड़ा था.
- नई चैट पर क्लिक करें.
- एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.
नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.
ऐप्लिकेशन को भेजे गए नए डायरेक्ट मैसेज में,
The Eiffel Tower was completed in 1900टाइप करें औरenterदबाएं.Chat ऐप्लिकेशन, समीक्षक और बदलाव करने वाला सब-एजेंट के जवाब देता है.
भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं की टेस्टिंग के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं की टेस्टिंग करना लेख पढ़ें.
समस्या हल करें
जब कोई Google Chat ऐप्लिकेशन या कार्ड कोई गड़बड़ी दिखाता है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat के यूज़र इंटरफ़ेस (यूआई) में कोई गड़बड़ी का मैसेज नहीं दिखता है, लेकिन Chat ऐप्लिकेशन या कार्ड से कोई अनचाहा नतीजा मिलता है. उदाहरण के लिए, ऐसा हो सकता है कि कार्ड मैसेज न दिखे.
ऐसा हो सकता है कि Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे. हालांकि, Chat ऐप्लिकेशन के लिए गड़बड़ी के लॉगिंग की सुविधा चालू होने पर, गड़बड़ियों को ठीक करने में आपकी मदद करने के लिए, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होता है. गड़बड़ियों को देखने, डीबग करने, और ठीक करने के बारे में मदद पाने के लिए, Google Chat से जुड़ी गड़बड़ियों को ठीक करना लेख पढ़ें.
व्यवस्थित करें
इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते से शुल्क न लिए जाने से बचने के लिए, हमारा सुझाव है कि आप Cloud प्रोजेक्ट मिटा दें.
- Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग बॉक्स में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट मिटाने के लिए बंद करें पर क्लिक करें.
मिलते-जुलते विषय
- ADK एआई एजेंट की मदद से Google Chat ऐप्लिकेशन बनाना
- ADK के एआई एजेंट और Gemini मॉडल की मदद से, तथ्यों की जांच करना
- Google Workspace के सभी ऐप्लिकेशन में उपलब्ध एआई एजेंट की मदद से यात्राओं की योजना बनाना
- Chat ऐप्लिकेशन में एआई से जुड़े बुनियादी कॉन्सेप्ट इंटिग्रेट करना
- Gemini के एआई चैट ऐप्लिकेशन के साथ हुई बातचीत के आधार पर सवालों के जवाब देना
- Google Chat, Vertex AI, Apps Script, और उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करके, सुरक्षा से जुड़ी घटनाओं का जवाब देना
- Google Chat, Vertex AI, और Firestore की मदद से प्रोजेक्ट मैनेज करना