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

इस पेज पर, Google Workspace ऐड-ऑन बनाने का तरीका बताया गया है. यह ऐड-ऑन, Google Chat में काम करता है और Gemini Enterprise के एआई एजेंट के साथ इंटरफ़ेस करता है.

एआई एजेंट, अपने-आप अपने आस-पास के माहौल को समझते हैं, तर्क देते हैं, और तय किए गए लक्ष्य को हासिल करने के लिए, कई चरणों वाली मुश्किल कार्रवाइयां करते हैं. इस ट्यूटोरियल में, Google की ओर से डिफ़ॉल्ट रूप से उपलब्ध कराए गए आइडिया जनरेशन एजेंट का इस्तेमाल किया जाता है. यह एजेंट, एंटरप्राइज़ उपयोगकर्ताओं को इनोवेशन और समस्या हल करने में मदद करता है.

आइडिया जनरेट करने वाले एजेंट को चैट ऐप्लिकेशन के तौर पर इस्तेमाल करना.

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

Gemini Enterprise के एआई एजेंट की मदद से लागू किए गए चैट ऐप्लिकेशन का आर्किटेक्चर.

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

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

मकसद

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

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

अपना एनवायरमेंट सेट अप करने का तरीका

Chat API चालू करना

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. एक ही Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

Google Cloud Console में, Google Chat API चालू करें.

एपीआई चालू करना

उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है

OAuth 2.0 का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए, सहमति स्क्रीन को कॉन्फ़िगर करना ज़रूरी है. अपने ऐप्लिकेशन के लिए, OAuth की सहमति स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को क्या दिखेगा. साथ ही, इससे आपका ऐप्लिकेशन रजिस्टर हो जाता है, ताकि बाद में उसे पब्लिश किया जा सके.

  1. Google API Console में, मेन्यू &gt Google Auth प्लैटफ़ॉर्म &gt ब्रैंडिंग पर जाएं.

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

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

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

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

Google Cloud Console

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

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

    बाकी के चरण, Google Cloud Console में दिखते हैं.

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

    सेवा खाते का ईमेल पता नोट करें.

gcloud सीएलआई

  1. सेवा खाता बनाएं: 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. ज़रूरी नहीं: Google Workspace के संसाधनों के साथ-साथ, Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस देने के लिए, अपने सेवा खाते को भूमिकाएं असाइन करें. ज़्यादा जानकारी के लिए, प्रोजेक्ट, फ़ोल्डर, और संगठनों का ऐक्सेस मैनेज करना लेख पढ़ें.

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

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

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

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

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

    बाकी के चरण, Google Cloud Console में दिखते हैं.

  2. कोई Google Cloud प्रोजेक्ट चुनें.
  3. उस सेवा खाते के ईमेल पते पर क्लिक करें जिसके लिए आपको कुंजी बनानी है.
  4. कुंजियां टैब पर क्लिक करें.
  5. कुंजी जोड़ें ड्रॉप-डाउन मेन्यू पर क्लिक करें. इसके बाद, नई कुंजी बनाएं चुनें.
  6. कुंजी का टाइप के तौर पर JSON चुनें. इसके बाद, बनाएं पर क्लिक करें.

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

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

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

  1. Google API Console में, मेन्यू > IAM और एडमिन > सेटिंग पर जाएं.

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

  2. प्रोजेक्ट नंबर और प्रोजेक्ट आईडी फ़ील्ड को नोट करें.

  3. Gemini Enterprise पर जाएं:

    Gemini Enterprise खोलें

  4. ऐप्लिकेशन की जगह की जानकारी और आईडी को नोट करें.

  5. GE AI Agent Quickstart Apps Script प्रोजेक्ट खोलने के लिए, यहां दिए गए बटन पर क्लिक करें.

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

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

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

    1. REASONING_ENGINE_RESOURCE_NAME में, Gemini Enterprise ऐप्लिकेशन के संसाधन के साथ-साथ पिछले चरणों में दी गई जानकारी भी शामिल है.

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID

    2. SERVICE_ACCOUNT_KEY में, सेवा खाते से मिली JSON कुंजी का इस्तेमाल करें. यह कुंजी, पिछले चरणों में डाउनलोड की गई थी. जैसे, { ... }.

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

  9. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग का आइकॉन प्रोजेक्ट की सेटिंग पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Chat ऐप्लिकेशन को आज़माना

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

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

    Google Chat पर जाएं

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

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

  5. ऐप्लिकेशन को भेजे गए नए डायरेक्ट मैसेज में, I need to find ideas! टाइप करें और enter दबाएं.

    Chat ऐप्लिकेशन, डिफ़ॉल्ट आइडिया जनरेशन एजेंट के जवाब के साथ जवाब देता है.

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

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

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

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

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

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

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

    Resource Manager पर जाएं

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