ADK एआई एजेंट की मदद से Google Chat ऐप्लिकेशन बनाना

इस पेज पर, Google Workspace ऐड-ऑन बनाने का तरीका बताया गया है. यह ऐड-ऑन, Google Chat में काम करता है और Vertex AI Agent Engine में होस्ट किए गए Agent Development Kit (ADK) एआई एजेंट के साथ इंटरैक्ट करता है.

ध्यान दें: Google Chat में, ऐड-ऑन उपयोगकर्ताओं को Google Chat ऐप्लिकेशन के तौर पर दिखते हैं. Google Chat API इंटरैक्शन इवेंट का इस्तेमाल करके भी Chat ऐप्लिकेशन बनाया जा सकता है. ज़्यादा जानने के लिए, Google Chat को एक्सटेंड करने के बारे में खास जानकारी देखें.

एआई एजेंट, अपने आस-पास के माहौल को अपने-आप समझते हैं, उसके बारे में सोचते हैं, और तय किए गए लक्ष्य को हासिल करने के लिए, कई चरणों वाली जटिल कार्रवाइयां करते हैं. इस ट्यूटोरियल में, ADK LLM Auditor multi-agent sample को डिप्लॉय किया जाता है. यह Gemini और Google Search grounding का इस्तेमाल करके, तथ्यों की समीक्षा करता है और उन्हें ठीक करता है.

इस डायग्राम में आर्किटेक्चर और मैसेजिंग पैटर्न दिखाया गया है:

ऊपर दिए गए डायग्राम में, ADK के एआई एजेंट के साथ लागू किए गए चैट ऐप्लिकेशन से इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:

1. कोई उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या Chat स्पेस में मैसेज भेजता है.
2. Chat ऐप्लिकेशन का लॉजिक, Apps Script में लागू किया जाता है. इसके अलावा, इसे एचटीटीपी एंडपॉइंट वाले वेब सर्वर के तौर पर भी लागू किया जाता है. यह मैसेज को पाता है और उसे प्रोसेस करता है.
3. ADK की मदद से लागू किया गया और Vertex AI Agent Engine पर होस्ट किया गया एआई एजेंट, इंटरैक्शन को स्वीकार करता है और उसे प्रोसेस करता है.
4. Chat ऐप्लिकेशन या एआई एजेंट को Google Workspace की सेवाओं के साथ इंटिग्रेट किया जा सकता है. जैसे, Calendar या Sheets. इसके अलावा, इसे Google की अन्य सेवाओं के साथ भी इंटिग्रेट किया जा सकता है. जैसे, Google Maps या YouTube. हालांकि, ऐसा करना ज़रूरी नहीं है.
5. Chat ऐप्लिकेशन, Google Chat API का इस्तेमाल करके एसिंक्रोनस तरीके से जवाब भेजता है. इससे एआई एजेंट की प्रोग्रेस के बारे में जानकारी मिलती है.
6. जवाब, उपयोगकर्ता को भेजे जाते हैं.

मकसद

• अपना एनवायरमेंट सेट अप करें.
• ADK एआई एजेंट को डिप्लॉय करें.
• Chat ऐप्लिकेशन डिप्लॉय करें.
• Chat ऐप्लिकेशन को कॉन्फ़िगर करें.
• Chat ऐप्लिकेशन को टेस्ट करें.

ज़रूरी शर्तें

• आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
• बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है या नहीं, अपने प्रोजेक्ट के बिलिंग स्टेटस की पुष्टि करें लेख पढ़ें. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, 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 की सहमति स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को क्या दिखेगा. साथ ही, इससे आपका ऐप्लिकेशन रजिस्टर हो जाता है, ताकि बाद में उसे पब्लिश किया जा सके.

1. Google Cloud console में, मेन्यू > Google Auth platform > ब्रैंडिंग पर जाएं.

   ब्रैंडिंग पर जाएं

2. अगर आपने पहले ही Google Auth platformको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth platform अभी तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
2. उपयोगकर्ता सहायता के लिए ईमेल पता में, सहायता के लिए वह ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
3. आगे बढ़ें पर क्लिक करें.
4. दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना मिल सके.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
3. फ़िलहाल, स्कोप जोड़ने की प्रोसेस को स्किप किया जा सकता है. अगर आपको आने वाले समय में, अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाना है, तो आपको उपयोगकर्ता का टाइप बदलकर बाहरी करना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए ज़रूरी अनुमति के स्कोप जोड़ें. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करना गाइड पढ़ें.

Google Cloud Console में सेवा खाता बनाना

Vertex AI User की भूमिका वाला नया सेवा खाता बनाने के लिए, यह तरीका अपनाएं:

Google Cloud कंसोल

1. Google Cloud Console में, मेन्यू &gt आईएएम और एडमिन &gt सेवा खाते पर जाएं.

   सेवा खातों पर जाएं

2. सेवा खाता बनाएं पर क्लिक करें.
3. सेवा खाते की जानकारी भरें. इसके बाद, बनाएं और जारी रखें पर क्लिक करें.
   ध्यान दें: Google डिफ़ॉल्ट रूप से, एक यूनीक सेवा खाता आईडी बनाता है. अगर आपको आईडी बदलना है, तो सेवा खाते के आईडी वाले फ़ील्ड में जाकर आईडी में बदलाव करें.
4. ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि उसे आपके Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस मिल सके. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, उसमें बदलाव करना, और उसे रद्द करना लेख पढ़ें.
5. जारी रखें पर क्लिक करें.
6. उन उपयोगकर्ताओं या ग्रुप के नाम डालें जिनके पास इस सेवा खाते को मैनेज करने और इससे जुड़ी कार्रवाइयां करने का ऐक्सेस है. हालांकि, यह ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
7. हो गया पर क्लिक करें. सेवा खाते का ईमेल पता नोट कर लें.

gcloud सीएलआई

1. सेवा खाता बनाएं:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि उसे आपके Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस मिल सके. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, उसमें बदलाव करना, और उसे रद्द करना लेख पढ़ें.

सेवा खाता, सेवा खाते वाले पेज पर दिखता है.

निजी कुंजी बनाना

चेतावनी: इस उदाहरण में, एक्सपोर्ट की गई सेवा खाते की कुंजी का इस्तेमाल किया गया है, ताकि इसे आसानी से समझा जा सके. प्रोडक्शन में निजी कुंजी एक्सपोर्ट करने का सुझाव नहीं दिया जाता, क्योंकि इसे सोर्स कंट्रोल जैसी असुरक्षित जगह पर सेव नहीं किया जाना चाहिए.

सुरक्षित सेवा खाते को लागू करने और सबसे सही तरीकों के बारे में ज़्यादा जानने के लिए, सेवा खातों का इस्तेमाल कब करना है, यह तय करना लेख पढ़ें.

सेवा खाते के लिए निजी पासकोड बनाने और उसे डाउनलोड करने के लिए, यह तरीका अपनाएं:

1. Google Cloud Console में, मेन्यू &gt आईएएम और एडमिन &gt सेवा खाते पर जाएं.

   सेवा खातों पर जाएं

2. अपना सेवा खाता चुनें.
3. कुंजियां > कुंजी जोड़ें > नई कुंजी बनाएं पर क्लिक करें.
4. JSON को चुनें. इसके बाद, बनाएं पर क्लिक करें.

   आपकी नई सार्वजनिक/निजी कुंजी की जोड़ी जनरेट करके आपकी मशीन पर एक नई फ़ाइल के तौर पर डाउनलोड की जाती है. डाउनलोड की गई JSON फ़ाइल को अपनी वर्किंग डायरेक्ट्री में credentials.json के तौर पर सेव करें. यह फ़ाइल, इस कुंजी की सिर्फ़ एक कॉपी है. अपनी कुंजी को सुरक्षित तरीके से सेव करने के बारे में जानकारी के लिए, सेवा खाते की कुंजियों को मैनेज करना लेख पढ़ें.

5. बंद करें पर क्लिक करें.

सेवा खातों के बारे में ज़्यादा जानने के लिए, Google Cloud IAM के दस्तावेज़ में सेवा खाते लेख पढ़ें.

ADK एआई एजेंट को डिप्लॉय करना

1. Vertex AI Agent Garden में एलएलएम ऑडिटर का सैंपल खोलें:

   सैंपल खोलें

2. डिप्लॉय करें पर क्लिक करें.

3. अगर पूछा जाए, तो अपना Google Cloud प्रोजेक्ट चुनें.

4. Cloud Shell में डिप्लॉय करें पर क्लिक करें.

5. अगर पूछा जाए, तो अनुमति दें पर क्लिक करें. इसके बाद, Cloud Shell के लिए OAuth फ़्लो पूरा करें.

6. Cloud Shell पूरी तरह से लोड होने के बाद, पहले से लोड की गई कमांड लाइन चलाने के लिए Enter दबाएं और डिप्लॉय करना शुरू करें.

7. अगर आपसे क्षेत्र की जानकारी डालने के लिए कहा जाए, तो डिफ़ॉल्ट क्षेत्र का इस्तेमाल करने के लिए Enter दबाएं.

8. प्रोसेस पूरी होने के बाद, Vertex AI Agent Engine पर जाएं:

   Vertex AI Agent Engine खोलें

9. टेबल से, नए एजेंट के डिप्लॉय किए गए संसाधन का नाम कॉपी करने के लिए, पर क्लिक करें.

Chat ऐप्लिकेशन प्रोजेक्ट बनाना और उसे कॉन्फ़िगर करना

1. ADK AI एजेंट क्विकस्टार्ट Apps Script प्रोजेक्ट खोलने के लिए, यहां दिए गए बटन पर क्लिक करें.

   प्रोजेक्ट खोलें

2. खास जानकारी > कॉपी बनाएं पर क्लिक करें.

3. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग पर क्लिक करें > स्क्रिप्ट की प्रॉपर्टी में बदलाव करें > स्क्रिप्ट की प्रॉपर्टी जोड़ें पर क्लिक करें. इसके बाद, स्क्रिप्ट की ये प्रॉपर्टी जोड़ें:

   1. REASONING_ENGINE_RESOURCE_NAME में, Vertex AI एजेंट के संसाधन का नाम डालें. यह नाम पिछले चरणों में कॉपी किया गया था.
   2. SERVICE_ACCOUNT_KEY में, सेवा खाते से डाउनलोड की गई JSON कुंजी डालें. जैसे, { ... }.

4. स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें

5. Google Cloud console में, मेन्यू > IAM और एडमिन > सेटिंग पर जाएं.

   आईएएम और एडमिन सेटिंग पर जाएं

6. प्रोजेक्ट नंबर फ़ील्ड में, वैल्यू कॉपी करें.

7. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट की सेटिंग पर क्लिक करें.

8. Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.

9. GCP प्रोजेक्ट नंबर में, पिछले चरणों में कॉपी किया गया Google Cloud प्रोजेक्ट नंबर चिपकाएं.

10. प्रोजेक्ट सेट करें पर क्लिक करें. अब Cloud प्रोजेक्ट और Apps Script प्रोजेक्ट कनेक्ट हो गए हैं.

टेस्ट डिप्लॉयमेंट बनाना

आपको इस Apps Script प्रोजेक्ट के लिए डिप्लॉयमेंट आईडी की ज़रूरत होगी, ताकि आप इसका इस्तेमाल अगले चरण में कर सकें.

हेड डिप्लॉयमेंट आईडी पाने के लिए, यह तरीका अपनाएं:

1. Chat ऐप्लिकेशन के Apps Script प्रोजेक्ट में, परिनियोजित करें > परिनियोजन की जांच करें पर क्लिक करें.
2. हेड डिप्लॉयमेंट आईडी में जाकर, कॉपी करें पर क्लिक करें.
3. हो गया पर क्लिक करें.

Chat ऐप्लिकेशन को कॉन्फ़िगर करना

Apps Script डिप्लॉयमेंट का इस्तेमाल करके, Google Chat ऐप्लिकेशन को टेस्टिंग के लिए डिप्लॉय करने के लिए, यह तरीका अपनाएं:

1. कंसोल में, Google Chat API खोजें और Google Chat API पर क्लिक करें.
2. मैनेज करें पर क्लिक करें.

3. कॉन्फ़िगरेशन पर क्लिक करें और Chat ऐप्लिकेशन सेट अप करें:

   1. ऐप्लिकेशन का नाम फ़ील्ड में, ADK Quickstart डालें.
   2. अवतार का यूआरएल फ़ील्ड में, https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png डालें.
   3. ब्यौरा फ़ील्ड में, ADK Quickstart डालें.
   4. सुविधाएं में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
   5. कनेक्शन सेटिंग में जाकर, Apps Script प्रोजेक्ट को चुनें.
   6. डिप्लॉयमेंट आईडी फ़ील्ड में, हेड डिप्लॉयमेंट आईडी चिपकाएं. यह वही आईडी होना चाहिए जिसे आपने पहले कॉपी किया था.
   7. 'दिखने की सेटिंग' में जाकर, आपके डोमेन में मौजूद चुनिंदा लोग और ग्रुप को चुनें. इसके बाद, अपना ईमेल पता डालें.

4. सेव करें पर क्लिक करें.

Chat ऐप्लिकेशन, मैसेज का जवाब देने के लिए तैयार है.

Chat ऐप्लिकेशन की टेस्टिंग करना

Chat ऐप्लिकेशन को आज़माने के लिए, Chat ऐप्लिकेशन की मदद से कोई डायरेक्ट मैसेज स्पेस खोलें और मैसेज भेजें:

1. Google Workspace खाते का इस्तेमाल करके Google Chat खोलें. आपने इसी खाते का इस्तेमाल करके, भरोसेमंद टेस्टर के तौर पर खुद को जोड़ा था.

   Google Chat पर जाएं

2. नई चैट पर क्लिक करें.
3. एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.

4. नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.

   ध्यान दें: अगर आपको नतीजों की सूची में Chat ऐप्लिकेशन नहीं दिख रहा है, तो पक्का करें कि आपने Google Cloud Console में Chat API कॉन्फ़िगरेशन पेज की Visibility सेटिंग में अपना Google Workspace खाता शामिल किया हो.

5. ऐप्लिकेशन को भेजे गए नए डायरेक्ट मैसेज में, The Eiffel Tower was completed in 1900 टाइप करें और enter दबाएं.

   Chat ऐप्लिकेशन, समीक्षक और बदलाव करने वाला सब-एजेंट के जवाब देता है.

भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं को टेस्ट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं को टेस्ट करना लेख पढ़ें.

समस्या हल करें

जब कोई Google Chat ऐप्लिकेशन या कार्ड कोई गड़बड़ी दिखाता है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat के यूज़र इंटरफ़ेस (यूआई) में कोई गड़बड़ी का मैसेज नहीं दिखता है, लेकिन Chat ऐप्लिकेशन या कार्ड से कोई अनचाहा नतीजा मिलता है. उदाहरण के लिए, ऐसा हो सकता है कि कार्ड मैसेज न दिखे.

ऐसा हो सकता है कि Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे. हालांकि, Chat ऐप्लिकेशन के लिए गड़बड़ी के लॉगिंग की सुविधा चालू होने पर, गड़बड़ियों को ठीक करने में आपकी मदद करने के लिए, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होता है. गड़बड़ियों को देखने, डीबग करने, और ठीक करने के बारे में मदद पाने के लिए, Google Chat से जुड़ी गड़बड़ियों को ठीक करना लेख पढ़ें.

व्यवस्थित करें

इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते से शुल्क न लिए जाने से बचने के लिए, हमारा सुझाव है कि आप Cloud प्रोजेक्ट मिटा दें.

चेतावनी: किसी प्रोजेक्ट को मिटाने पर ये असर होते हैं:

• प्रोजेक्ट में मौजूद सभी आइटम मिट जाते हैं. अगर आपने इस ट्यूटोरियल के लिए किसी मौजूदा प्रोजेक्ट का इस्तेमाल किया है, तो उसे मिटाने पर, प्रोजेक्ट में किया गया आपका अन्य काम भी मिट जाएगा.
• कस्टम प्रोजेक्ट आईडी मिट जाते हैं. ऐसा हो सकता है कि आपने यह प्रोजेक्ट बनाते समय, कोई कस्टम प्रोजेक्ट आईडी बनाया हो और आपको उसे आने वाले समय में इस्तेमाल करना हो. प्रोजेक्ट आईडी का इस्तेमाल करने वाले यूआरएल को बनाए रखने के लिए, जैसे कि appspot.com पर मौजूद कोई यूआरएल, पूरे प्रोजेक्ट को मिटाने के बजाय प्रोजेक्ट में मौजूद चुने गए संसाधनों को मिटाएं.

अगर आपको कई ट्यूटोरियल और क्विकस्टार्ट आज़माने हैं, तो प्रोजेक्ट का दोबारा इस्तेमाल करने से, प्रोजेक्ट के कोटे की सीमाएं पार करने से बचा जा सकता है.

1. Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.

   Resource Manager पर जाएं

2. प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
3. डायलॉग बॉक्स में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट मिटाने के लिए बंद करें पर क्लिक करें.

मिलते-जुलते विषय

• ADK के एआई एजेंट और Gemini मॉडल की मदद से, तथ्यों की जांच करना
• Google Workspace के सभी ऐप्लिकेशन में उपलब्ध एआई एजेंट की मदद से यात्राओं की योजना बनाना
• Chat ऐप्लिकेशन में एआई से जुड़े बुनियादी कॉन्सेप्ट इंटिग्रेट करना
• Gemini के एआई चैट ऐप्लिकेशन के साथ हुई बातचीत के आधार पर सवालों के जवाब देना
• Google Chat, Vertex AI, Apps Script, और उपयोगकर्ता की पुष्टि करने की सुविधा से जुड़ी समस्याओं को हल करना
• Google Chat, Vertex AI, और Firestore की मदद से प्रोजेक्ट मैनेज करना