इस पेज पर, Google Workspace के लिए ऐड-ऑन बनाने का तरीका बताया गया है. यह ऐड-ऑन, Google Chat में काम करता है और Gemini Enterprise के एआई एजेंट के साथ इंटरफ़ेस करता है.
एआई एजेंट, अपने एनवायरमेंट को अपने-आप समझते हैं, तर्क देते हैं, और तय किए गए लक्ष्य को हासिल करने के लिए, मुश्किल और कई चरणों वाली कार्रवाइयां करते हैं. इस ट्यूटोरियल में, Google की ओर से डिफ़ॉल्ट रूप से उपलब्ध आइडिया जनरेशन एजेंट का इस्तेमाल किया गया है. यह एजेंट, एंटरप्राइज़ उपयोगकर्ताओं के लिए, इनोवेशन और समस्या हल करने में मदद करता है.
नीचे दिए गए डायग्राम में, आर्किटेक्चर और मैसेजिंग पैटर्न दिखाया गया है:
ऊपर दिए गए डायग्राम में, Gemini Enterprise के एआई एजेंट की मदद से लागू किए गए Chat ऐप्लिकेशन के साथ इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:
- कोई उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या Chat स्पेस में मैसेज भेजता है.
- Apps Script में या एचटीटीपी एंडपॉइंट वाले वेब सर्वर के तौर पर लागू किया गया Chat ऐप्लिकेशन लॉजिक, मैसेज को रिसीव और प्रोसेस करता है.
- Gemini Enterprise का एआई एजेंट, इंटरैक्शन को रिसीव और प्रोसेस करता है.
- Chat ऐप्लिकेशन या एआई एजेंट, Google Workspace की सेवाओं के साथ इंटिग्रेट हो सकता है. जैसे, Calendar या Sheets. इसके अलावा, Google की अन्य सेवाओं के साथ भी इंटिग्रेट हो सकता है. जैसे, Google Maps या YouTube.
- Chat ऐप्लिकेशन, Google Chat API का इस्तेमाल करके, एसिंक्रोनस तरीके से जवाब भेजता है. इससे एआई एजेंट की प्रोग्रेस के बारे में जानकारी मिलती है.
- जवाब, उपयोगकर्ता को डिलीवर किए जाते हैं.
मकसद
- अपना एनवायरमेंट सेट अप करना.
- Chat ऐप्लिकेशन डिप्लॉय करना.
- Chat ऐप्लिकेशन कॉन्फ़िगर करना.
- Chat ऐप्लिकेशन की जांच करना.
ज़रूरी शर्तें
- Business या Enterprise Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.
- बिलिंग की सुविधा वाला Google क्लाउड प्रोजेक्ट. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट में बिलिंग की सुविधा चालू है या नहीं, देखें अपने प्रोजेक्ट की बिलिंग की स्थिति की पुष्टि करना. कोई प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.
- Google Identity को आइडेंटिटी प्रोवाइडर के तौर पर चुनकर सेट अप किया गया Gemini Enterprise ऐप्लिकेशन.
अपना एनवायरमेंट सेट अप करना
Chat API चालू करना
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.Google Cloud Console में, Google Chat API चालू करें.
उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth को सहमति दी जाती है
OAuth 2.0 का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए, सहमति की स्क्रीन का कॉन्फ़िगरेशन ज़रूरी है. अपने ऐप्लिकेशन की OAuth सहमति स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को क्या दिखेगा. साथ ही, इससे आपका ऐप्लिकेशन रजिस्टर हो जाता है, ताकि उसे बाद में पब्लिश किया जा सके.
- Google API Console में, मेन्यू > Google Auth प्लैटफ़ॉर्म > ब्रैंडिंग पर जाएं.
- अगर आपने Google Auth प्लैटफ़ॉर्म को पहले ही कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth प्लैटफ़ॉर्म को अब तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
- ऐप्लिकेशन की जानकारी में, ऐप्लिकेशन का नाम में जाकर, ऐप्लिकेशन के लिए कोई नाम डालें.
- उपयोगकर्ता सहायता ईमेल में जाकर, सहायता के लिए कोई ऐसा ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
- आगे बढ़ें पर क्लिक करें.
- ऑडियंस में जाकर, इंटरनल को चुनें.
- आगे बढ़ें पर क्लिक करें.
- संपर्क जानकारी में जाकर, ईमेल पता डालें. इस पते पर आपको अपने प्रोजेक्ट में होने वाले किसी भी बदलाव के बारे में सूचनाएं मिलेंगी.
- आगे बढ़ें पर क्लिक करें.
- पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
- जारी रखें पर क्लिक करें.
- बनाएं पर क्लिक करें.
- फ़िलहाल, स्कोप जोड़ने की प्रोसेस को छोड़ा जा सकता है. भविष्य में, जब अपने Google Workspace संगठन के बाहर इस्तेमाल के लिए कोई ऐप्लिकेशन बनाया जाता है, तो आपको उपयोगकर्ता का टाइप बदलकर एक्सटर्नल करना होगा. इसके बाद, अनुमति के वे स्कोप जोड़ें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. ज़्यादा जानने के लिए, पूरी OAuth सहमति स्क्रीन को कॉन्फ़िगर करने की गाइड देखें.
Google Cloud Console में सेवा खाता बनाना
Discovery Engine User की भूमिका वाला नया सेवा खाता बनाने के लिए, यह तरीका अपनाएं:
Google Cloud Console
-
Google Cloud Console में, मेन्यू
> IAM और एडमिन
> सेवा खाते पर जाएं.
बाकी चरण, Google Cloud Console में दिखेंगे.
- कोई Google Cloud प्रोजेक्ट चुनें.
- सेवा खाता बनाएं पर क्लिक करें.
- Google Cloud Console में दिखाने के लिए, सेवा खाते का नाम डालें.
- अगर आपको अभी ऐक्सेस कंट्रोल सेट नहीं करना है, तो सेवा खाता बनाने की प्रोसेस पूरी करने के लिए, हो गया पर क्लिक करें. अगर आपको अभी ऐक्सेस कंट्रोल सेट करना है, तो बनाएं और जारी रखें पर क्लिक करें. इसके बाद, अगले चरण पर जाएं.
- ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि Google Workspace के संसाधनों के अलावा, Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस भी दिया जा सके. ज़्यादा जानकारी के लिए, प्रोजेक्ट, फ़ोल्डर, और संगठनों का ऐक्सेस मैनेज करना लेख पढ़ें.
- जारी रखें पर क्लिक करें.
- ज़रूरी नहीं: उन उपयोगकर्ताओं या ग्रुप के नाम डालें जो इस सेवा खाते को मैनेज कर सकते हैं और इसकी मदद से कार्रवाइयां कर सकते हैं. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
- सेवा खाता बनाने की प्रोसेस पूरी करने के लिए, हो गया पर क्लिक करें.
सेवा खाते के ईमेल पते को नोट करें.
gcloud सीएलआई
- सेवा खाता बनाएं:
gcloud iam service-accounts createSERVICE_ACCOUNT_NAME\ --display-name="SERVICE_ACCOUNT_NAME" - ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि Google Workspace के संसाधनों के अलावा, Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस भी दिया जा सके. ज़्यादा जानकारी के लिए, प्रोजेक्ट, फ़ोल्डर, और संगठनों का ऐक्सेस मैनेज करना लेख पढ़ें.
सेवा खाता, सेवा खाते वाले पेज पर दिखता है.
निजी कुंजी बनाना
सेवा खाते के लिए निजी कुंजी बनाने और डाउनलोड करने के लिए, यह तरीका अपनाएं:
-
Google Cloud Console में, मेन्यू
> IAM और एडमिन
> सेवा खाते पर जाएं.
बाकी चरण, Google Cloud Console में दिखेंगे.
- कोई Google Cloud प्रोजेक्ट चुनें.
- उस सेवा खाते के ईमेल पते पर क्लिक करें जिसके लिए आपको कुंजी बनानी है.
- कुंजियां टैब पर क्लिक करें.
- कुंजी जोड़ें ड्रॉप-डाउन मेन्यू पर क्लिक करें. इसके बाद, नई कुंजी बनाएं को चुनें.
- कुंजी का टाइप के तौर पर JSON को चुनें. इसके बाद, बनाएं पर क्लिक करें.
आपकी नई सार्वजनिक/निजी कुंजी की जोड़ी जनरेट करके, आपकी मशीन पर सेवा खाते की कुंजी वाली फ़ाइल के तौर पर डाउनलोड की जाती है. डाउनलोड की गई JSON फ़ाइल को, अपनी वर्किंग डायरेक्ट्री में
credentials.jsonके तौर पर सेव करें. यह फ़ाइल, इस कुंजी की इकलौती कॉपी होती है. कुंजी वाली फ़ाइल डाउनलोड करने के बाद, इसे दोबारा डाउनलोड नहीं किया जा सकता. अपनी कुंजी को सुरक्षित तरीके से सेव करने के तरीके के बारे में जानने के लिए, सेवा खाते की कुंजियों को मैनेज करने के सबसे सही तरीके लेख पढ़ें.
सेवा खातों के बारे में ज़्यादा जानने के लिए, Google Cloud IAM के दस्तावेज़ में सेवा खाते लेख पढ़ें.
Chat ऐप्लिकेशन का प्रोजेक्ट बनाना और कॉन्फ़िगर करना
Google API Console में, मेन्यू > IAM और एडमिन > सेटिंग पर जाएं.
प्रोजेक्ट नंबर और प्रोजेक्ट आईडी फ़ील्ड को नोट करें.
Gemini Enterprise पर जाएं:
ऐप्लिकेशन की जगह और आईडी को नोट करें.
GE AI Agent Quickstart Apps Script प्रोजेक्ट खोलने के लिए, इस बटन पर क्लिक करें.
खास जानकारी >
कॉपी बनाएं पर क्लिक करें.अपने Apps Script प्रोजेक्ट में,
प्रोजेक्ट सेटिंग
> स्क्रिप्ट की प्रॉपर्टी में बदलाव करें > स्क्रिप्ट प्रॉपर्टी जोड़ें
पर क्लिक करें, ताकि स्क्रिप्ट की ये प्रॉपर्टी जोड़ी जा सकें:REASONING_ENGINE_RESOURCE_NAMEमें, Gemini Enterprise ऐप्लिकेशन का संसाधन शामिल करें. इसमें पिछले चरणों में नोट की गई जानकारी शामिल होनी चाहिए.projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_IDSERVICE_ACCOUNT_KEYमें, सेवा खाते की JSON कुंजी शामिल करें. इसे पिछले चरणों में डाउनलोड किया गया था. जैसे,{ ... }.
स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें
अपने Apps Script प्रोजेक्ट में,
प्रोजेक्ट सेटिंग पर क्लिक करें.Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
GCP प्रोजेक्ट नंबर में, पिछले चरणों में नोट किया गया Google Cloud प्रोजेक्ट नंबर चिपकाएं.
प्रोजेक्ट सेट करें पर क्लिक करें. अब Cloud प्रोजेक्ट और Apps Script प्रोजेक्ट कनेक्ट हो गए हैं.
टेस्ट डिप्लॉयमेंट बनाना
इस Apps Script प्रोजेक्ट के लिए, आपको डिप्लॉयमेंट आईडी की ज़रूरत होगी, ताकि अगले चरण में इसका इस्तेमाल किया जा सके.
हेड डिप्लॉयमेंट आईडी पाने के लिए, यह तरीका अपनाएं:
- Chat ऐप्लिकेशन के Apps Script प्रोजेक्ट में, डिप्लॉय करें > टेस्ट डिप्लॉयमेंट पर क्लिक करें.
- हेड डिप्लॉयमेंट आईडी में जाकर,
कॉपी करें पर क्लिक करें.
- हो गया पर क्लिक करें.
Chat ऐप्लिकेशन कॉन्फ़िगर करना
Google Chat ऐप्लिकेशन को टेस्ट करने के लिए, Apps Script के डिप्लॉयमेंट का इस्तेमाल करके, यह तरीका अपनाएं:
- API Console में,
Google Chat APIखोजें. इसके बाद, Google Chat API पर क्लिक करें. - मैनेज करें पर क्लिक करें.
कॉन्फ़िगरेशन पर क्लिक करें और Chat ऐप्लिकेशन सेट अप करें:
- ऐप्लिकेशन का नाम फ़ील्ड में,
GE Quickstartडालें. - अवतार यूआरएल फ़ील्ड में,
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.pngडालें. - ब्यौरा फ़ील्ड में,
GE Quickstartडालें. - सुविधा में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
- कनेक्शन सेटिंग में जाकर, Apps Script प्रोजेक्ट को चुनें.
- डिप्लॉयमेंट आईडी फ़ील्ड में, पहले कॉपी किया गया हेड डिप्लॉयमेंट आईडी चिपकाएं.
- विज़िबिलिटी में जाकर, आपके डोमेन में मौजूद चुनिंदा लोग और ग्रुप को चुनें. इसके बाद, अपना ईमेल पता डालें.
- ऐप्लिकेशन का नाम फ़ील्ड में,
सेव करें पर क्लिक करें.
Chat ऐप्लिकेशन, मैसेज के जवाब देने के लिए तैयार है.
Chat ऐप्लिकेशन की जांच करना
अपने Chat ऐप्लिकेशन की जांच करने के लिए, Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज वाला स्पेस खोलें और कोई मैसेज भेजें:
Google Workspace के उस खाते का इस्तेमाल करके Google Chat खोलें जिसे आपने भरोसेमंद टेस्टर के तौर पर खुद को जोड़ते समय दिया था.
- नई चैट पर क्लिक करें.
- एक या उससे ज़्यादा लोग जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.
नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.
ऐप्लिकेशन के साथ नए डायरेक्ट मैसेज में,
I need to find ideas!टाइप करें औरenterदबाएं.Chat ऐप्लिकेशन, डिफ़ॉल्ट आइडिया जनरेशन एजेंट के जवाब के साथ जवाब देता है.
भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं की जांच करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाएं आज़माना लेख पढ़ें.
समस्या हल करें
जब Google Chat ऐप्लिकेशन या कार्ड में कोई गड़बड़ी होती है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका" मैसेज दिखता है. कभी-कभी Chat यूज़र इंटरफ़ेस (यूआई) पर कोई गड़बड़ी का मैसेज नहीं दिखता, लेकिन Chat ऐप्लिकेशन या कार्ड से कोई ऐसा नतीजा मिलता है जिसकी उम्मीद नहीं थी. उदाहरण के लिए, कार्ड मैसेज नहीं दिख सकता.
भले ही, Chat यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे, लेकिन Chat ऐप्लिकेशन के लिए गड़बड़ी लॉग करने की सुविधा चालू होने पर, गड़बड़ियों को ठीक करने में मदद करने के लिए, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होता है. गड़बड़ियों को देखने, डीबग करने, और ठीक करने में मदद पाने के लिए, Google Chat की गड़बड़ियां ठीक करना लेख पढ़ें.
स्टोरेज में जगह बनाएं
इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते पर शुल्क लगने से बचने के लिए, हमारा सुझाव है कि Cloud प्रोजेक्ट मिटा दें.
- Google API Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट मिटाने के लिए, शट डाउन करें पर क्लिक करें.
मिलते-जुलते विषय
- ऐसे Gemini Enterprise एजेंट बनाना जो Workspace के डेटा स्टोर, एपीआई, और Chat ऐप्लिकेशन के साथ इंटिग्रेट किए गए हों
- ऐसे Vertex AI एजेंट बनाना जो Workspace के डेटा स्टोर, एपीआई, और Chat ऐप्लिकेशन के साथ इंटिग्रेट किए गए हों
- ADK एआई एजेंट की मदद से, Google Chat ऐप्लिकेशन बनाना
- A2A की मदद से, ADK एआई एजेंट वाला Google Chat ऐप्लिकेशन बनाना
- A2UI की मदद से, ADK एआई एजेंट वाला Google Chat ऐप्लिकेशन बनाना
- ADK एआई एजेंट और Gemini मॉडल की मदद से, स्टेटमेंट की फ़ैक्ट-चेकिंग करना
- Google Workspace में उपलब्ध एआई एजेंट की मदद से, यात्रा की योजना बनाना
- Chat ऐप्लिकेशन में एआई के बुनियादी कॉन्सेप्ट इंटिग्रेट करना
- Gemini एआई Chat ऐप्लिकेशन की मदद से, Chat की बातचीत के आधार पर सवालों के जवाब देना
- Google Chat, Vertex AI, Apps Script, और उपयोगकर्ता की पुष्टि की मदद से, गड़बड़ियों के बारे में जानकारी देना
- Google Chat, Vertex AI, और Firestore की मदद से, प्रोजेक्ट मैनेज करना