Google Chat, Vertex AI, और Firestore की मदद से प्रोजेक्ट मैनेज करें

इस ट्यूटोरियल में बताया गया है कि Google Chat ऐप्लिकेशन कैसे बनाएं का इस्तेमाल रीयल टाइम में प्रोजेक्ट मैनेज करने के लिए किया जाता है. Chat ऐप्लिकेशन, Vertex AI की मदद से, टीम उपयोगकर्ता की स्टोरी लिख सकती है. इससे टीमें उपयोगकर्ता के हिसाब से सॉफ़्टवेयर सिस्टम को डिज़ाइन करना होगा) और Firestore डेटाबेस में मौजूद खबरें बनी रहती हैं.

  • प्रोजेक्ट मैनेजमेंट ऐप्लिकेशन का नाम बताने से, ऐप्लिकेशन मदद करने का अनुरोध करता है.
    पहली इमेज. चार्ली, चैट स्पेस में अपनी टीम के साथ फ़ीचर डेवलपमेंट के बारे में बात करते हुए नज़र आ रहे हैं. प्रोजेक्ट मैनेजमेंट के बारे में बताने पर, Chat ऐप्लिकेशन आपकी मदद करने के लिए कहता है.
  • स्टोरी बनाने के लिए, /createUserStory स्लैश कमांड का इस्तेमाल करें. अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    दूसरी इमेज. /createUserStory स्लैश कमांड का इस्तेमाल करके, चार्ली एक स्टोरी बनाते हैं.
  • प्रोजेक्ट मैनेजमेंट के हिसाब से Chat ऐप्लिकेशन, कहानी का ब्यौरा लिखने के लिए Vertex AI का इस्तेमाल करता है. अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    तीसरी इमेज. प्रोजेक्ट मैनेजमेंट के हिसाब से बना Chat ऐप्लिकेशन, Vertex AI का इस्तेमाल करके कहानी की जानकारी लिखने और उसे स्पेस में शेयर करने के लिए करता है.
  • विनोद ने कहानी की पूरी जानकारी दे दी. अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    चौथी इमेज. चार्ली कहानी के विवरण को अंतिम रूप देने के लिए बदलाव करें पर क्लिक करता है. एआई की जानकारी बिलकुल सही है, लेकिन चार्ली को ज़्यादा जानकारी चाहिए, इसलिए चार्ली, बड़ा करें पर क्लिक करते हैं, ताकि Vertex AI आपकी स्टोरी के ब्यौरे में ज़रूरी शर्तें जोड़ सके. चार्ली खुद को कहानी असाइन करते हैं, स्टेटस को 'शुरू किया गया' पर सेट करते हैं, प्राथमिकता और साइज़ चुनते हैं, और सेव करें पर क्लिक करते हैं.
  • टीम के सभी उपयोगकर्ताओं की स्टोरी मैनेज करना. अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
    पांचवीं इमेज. चार्ली, /manageUserStories स्लैश कमांड का इस्तेमाल करके, किसी भी समय टीम की सभी उपयोगकर्ता कहानियों को देखा और मैनेज किया जा सकता है.

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

मकसद

  • ऐसा Chat ऐप्लिकेशन बनाएं जो स्मार्ट सॉफ़्टवेयर को मैनेज करता हो प्रोजेक्ट.
  • जनरेटिव एआई की मदद से, लोगों को स्टोरी लिखने में मदद करें कहानी लिखने के लिए एआई की मदद से काम करने वाले टूल, Vertex AI के साथ काम करते हैं:
    • स्टोरी की जानकारी जनरेट करें और उसे फिर से जनरेट करें.
    • ज़रूरी शर्तों को पूरा करने के लिए, नोट से लेकर स्टोरी के ब्यौरे वाले सेक्शन में जाएं.
    • टाइपिंग की गलतियां ठीक करने के लिए, व्याकरण में सुधार करें.
  • Firestore डेटाबेस को लिखकर और उससे पढ़ते हुए, अपने काम को अप-टू-डेट रखें.
  • उपयोगकर्ताओं को अनुमति दें कि वे चैट स्पेस में साथ मिलकर काम कर सकें इन्हें सीधे तौर पर बातचीत से बनाया, बदला, असाइन, और शुरू किया जा सकता है.

इस्तेमाल किए गए प्रॉडक्ट

प्रोजेक्ट मैनेजमेंट ऐप्लिकेशन, इन Google Workspace का इस्तेमाल करता है और Google Cloud के प्रॉडक्ट:

  • Chat API: अनुरोध पाने वाले और जवाब देने वाले Google Chat ऐप्लिकेशन डेवलप करने के लिए एपीआई चैट के इंटरैक्शन वाले इवेंट, जैसे कि मैसेज. प्रोजेक्ट मैनेजमेंट Google Chat ऐप्लिकेशन, मैसेज पाने और उनका जवाब देने के लिए Chat API का इस्तेमाल करता है और उन एट्रिब्यूट को कॉन्फ़िगर करें जिन्हें Chat से भेजे गए इंटरैक्शन इवेंट के तय करें कि Chat में वह कैसी दिखेगी, जैसे कि नाम और अवतार की इमेज.
  • Vertex AI API: यह जनरेटिव एआई प्लैटफ़ॉर्म है. प्रोजेक्ट मैनेजमेंट Google Chat ऐप्लिकेशन, उपयोगकर्ताओं के बारे में स्टोरी लिखने के लिए, Vertex AI API का इस्तेमाल करता है टाइटल और ब्यौरों.
  • फ़ायरस्टोर: बिना सर्वर वाला दस्तावेज़ का डेटाबेस. प्रोजेक्ट मैनेजमेंट Google Chat ऐप्लिकेशन, उपयोगकर्ता की कहानियों का डेटा सेव करने के लिए Firebase का इस्तेमाल करता है.

  • Cloud के फ़ंक्शन: बिना सर्वर वाली लाइटवेट कंप्यूट सेवा, जिसकी मदद से अलग-अलग कामों के लिए इस्तेमाल किया जाने वाला ऐसा फ़ंक्शन जो Chat का जवाब दे सकता है इंटरैक्शन इवेंट जोड़ने के लिए, सर्वर या रनटाइम एनवायरमेंट को मैनेज करने की ज़रूरत नहीं होती. कॉन्टेंट बनाने प्रोजेक्ट मैनेजमेंट के लिए Google Chat ऐप्लिकेशन, Cloud Functions का इस्तेमाल करता है वह एचटीटीपी एंडपॉइंट होस्ट करें जिसे Chat, कंप्यूट प्लैटफ़ॉर्म का इस्तेमाल कर बनाया है.

    Cloud Functions, इन Google Cloud प्रॉडक्ट का इस्तेमाल करके, और होस्ट कंप्यूट रिसॉर्स होस्ट करने के लिए ये काम करती हैं:

    • क्लाउड बिल्ड: यह एक पूरी तरह से मैनेज किया जा रहा लगातार इंटिग्रेशन, डिलीवरी, और डिप्लॉयमेंट प्लैटफ़ॉर्म है जो ऑटोमेटेड बिल्ड चलाता है.
    • Pub/Sub: यह एसिंक्रोनस और स्केलेबल मैसेज सेवा है, जो सेवाओं को अलग-अलग कर देती है जो उन मैसेज को प्रोसेस करने वाली सेवाओं से मैसेज जनरेट करती हैं.
    • Cloud Run एडमिन एपीआई: कंटेनर किए गए ऐप्लिकेशन को चलाने के लिए पूरी तरह से मैनेज किया गया एनवायरमेंट.

आर्किटेक्चर

प्रोजेक्ट मैनेजमेंट, Google Chat ऐप्लिकेशन के आर्किटेक्चर को मिलता है और एचटीटीपी एंडपॉइंट पर Chat के इंटरैक्शन इवेंट प्रोसेस करता है. साथ ही, मदद करने के लिए Vertex AI का इस्तेमाल करता है उपयोगकर्ताओं की कहानियां लिखें और उपयोगकर्ता की खबरों की जानकारी को Firestore डेटाबेस में सेव करता है. कॉन्टेंट बनाने नीचे दिए गए डायग्राम में, Google Workspace और Google Cloud के संसाधनों का इस्तेमाल किया गया.

प्रोजेक्ट मैनेजमेंट वाले Google Chat ऐप्लिकेशन के आर्किटेक्चर का डायग्राम

प्रोजेक्ट मैनेज करने के लिए बना Google Chat ऐप्लिकेशन इस तरह काम करता है:

  1. कोई उपयोगकर्ता Chat में मैसेज भेजता है और प्रोजेक्ट मैनेज करने के लिए, Google Chat ऐप्लिकेशन को मैसेज करें. सीधे स्पेस में टैग करें या स्लैश कमांड डालें.

  2. Chat, Cloud Function के एचटीटीपी एंडपॉइंट.

  3. प्रोजेक्ट मैनेज करने के लिए इस्तेमाल किया जाने वाला Google Chat ऐप्लिकेशन, एचटीटीपी को प्रोसेस करता है अनुरोध:

    1. Vertex AI की मदद से, उपयोगकर्ता की कहानी लिखी या अपडेट की जा सकती है.

    2. Firestore डेटाबेस उपयोगकर्ता की स्टोरी सेव करता है, इकट्ठा करता है, अपडेट करता है या मिटाता है डेटा शामिल है.

  4. Cloud Functions, Chat के लिए एचटीटीपी रिस्पॉन्स दिखाता है जो इसे उपयोगकर्ता को मैसेज या डायलॉग के तौर पर दिखाता है.

वातावरण को तैयार करना

इस सेक्शन में, Google Cloud प्रोजेक्ट को चैट ऐप्लिकेशन.

Google Cloud प्रोजेक्ट बनाना

Google Cloud कंसोल

  1. Google Cloud Console में, मेन्यू पर जाएं > IAM और एडमिन > प्रोजेक्ट बनाएं.

    'प्रोजेक्ट बनाएं' पर जाएं

  2. प्रोजेक्ट का नाम फ़ील्ड में, अपने प्रोजेक्ट की जानकारी देने वाला नाम डालें.

    ज़रूरी नहीं: प्रोजेक्ट आईडी में बदलाव करने के लिए, बदलाव करें पर क्लिक करें. प्रोजेक्ट आईडी बदला नहीं जा सकता तो ऐसा आईडी चुनें जो प्रोजेक्ट के आजीवन प्रोजेक्ट.

  3. स्थान फ़ील्ड में, अपने लिए संभावित स्थान देखने के लिए ब्राउज़ करें पर क्लिक करें प्रोजेक्ट. इसके बाद, चुनें पर क्लिक करें.
  4. बनाएं पर क्लिक करें. Google Cloud Console, डैशबोर्ड पेज पर जाता है और आपका प्रोजेक्ट बन जाता है कुछ ही मिनटों में.

gcloud सीएलआई

यहां दिए गए डेवलपमेंट एनवायरमेंट में से किसी एक में, Google Cloud को ऐक्सेस करें सीएलआई (`gcloud`):

  • Cloud Shell: gcloud सीएलआई के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए पहले से सेट अप है, तो Cloud Shell को चालू करें.
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है Cloud Shell चालू करें
  • लोकल शेल: लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, इंस्टॉल करें और शुरू करें gcloud सीएलआई.
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है Cloud प्रोजेक्ट बनाने के लिए, `gcloud प्रोजेक्ट create`कमांड का इस्तेमाल करें: 
    gcloud projects create PROJECT_ID
    आपको जो प्रोजेक्ट बनाना है उसका आईडी सेट करके, PROJECT_ID को बदलें.

Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करना

Google Cloud कंसोल

  1. Google Cloud Console में, बिलिंग पर जाएं. क्लिक करें मेन्यू > बिलिंग > मेरे प्रोजेक्ट पर क्लिक करें.

    'मेरे प्रोजेक्ट के लिए बिलिंग' पर जाएं

  2. संगठन चुनें में जाकर, उस संगठन को चुनें जिससे जुड़ा है आपका Google Cloud प्रोजेक्ट.
  3. प्रोजेक्ट की लाइन में, कार्रवाइयां मेन्यू खोलें (), बिलिंग बदलें पर क्लिक करें और क्लाउड बिलिंग खाता.
  4. खाता सेट करें पर क्लिक करें.

gcloud सीएलआई

  1. उपलब्ध बिलिंग खातों की सूची बनाने के लिए, यह चलाएं: 
    gcloud billing accounts list
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  2. Google Cloud प्रोजेक्ट के साथ बिलिंग खाते को लिंक करने के लिए: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

    इन्हें बदलें:

    • PROJECT_ID इसका प्रोजेक्ट आईडी है वह Cloud प्रोजेक्ट जिसके लिए आपको बिलिंग की सुविधा चालू करनी है.
    • BILLING_ACCOUNT_ID, लिंक करने के लिए बिलिंग खाता आईडी है Google Cloud प्रोजेक्ट.

एपीआई चालू करें

Google Cloud कंसोल

  1. Google Cloud Console में, Google Chat API, Vertex AI API, Cloud Functions एपीआई, Firestore एपीआई, Cloud Build API, Pub/Sub API और Cloud Run Admin API के साथ मिलकर काम करना होगा.

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

  2. पुष्टि करें कि एपीआई को सही तरीके से चालू किया जा रहा है Cloud प्रोजेक्ट चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

  3. पुष्टि करें कि आपने सही एपीआई चालू किए हैं. इसके बाद, चालू करें पर क्लिक करें.

gcloud सीएलआई

  1. अगर ज़रूरी हो, तो मौजूदा Cloud प्रोजेक्ट को अपने प्रोजेक्ट पर सेट करें gcloud config set project निर्देश का इस्तेमाल करके बनाया गया:

    gcloud config set project PROJECT_ID

    PROJECT_ID को इसके प्रोजेक्ट आईडी से बदलें आपका बनाया हुआ क्लाउड प्रोजेक्ट.

  2. Google Chat API, Vertex AI API, Cloud Functions API को चालू करें, Firestore एपीआई, Cloud Build API, Pub/Sub एपीआई, और Cloud Run Admin API को gcloud services enable निर्देश से इस्तेमाल करना:

    gcloud services enable chat.googleapis.com \
aiplatform.googleapis.com \
cloudfunctions.googleapis.com \
firestore.googleapis.com \
cloudbuild.googleapis.com \
pubsub.googleapis.com \
run.googleapis.com

    Cloud Build, Pub/Sub, और Cloud Run एडमिन एपीआई ज़रूरी शर्तें Cloud Functions.

पुष्टि करना और अनुमति देना

इसे फ़ॉलो करने के लिए पुष्टि करने और अनुमति देने के कॉन्फ़िगरेशन की ज़रूरत नहीं है ट्यूटोरियल.

Firestore और Vertex AI API को कॉल करने के लिए, यह ट्यूटोरियल ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल के साथ डिफ़ॉल्ट सेवा खाते का इस्तेमाल करके, Cloud Function से सेट अप करने की ज़रूरत नहीं है. प्रोडक्शन एनवायरमेंट के हिसाब से, आपको आम तौर पर बनाएं और अटैच करें के बजाय Cloud Function पर सेवा खाते का इस्तेमाल करेगा.

Google Chat ऐप्लिकेशन बनाना और डिप्लॉय करना

अब आपका Google Cloud प्रोजेक्ट बन गया है और उसे कॉन्फ़िगर कर दिया गया है. इसलिए, अब इसका इस्तेमाल किया जा सकता है और Google Chat ऐप्लिकेशन डिप्लॉय कर सकता है. इस सेक्शन में, आपको फ़ॉलो किया जा रहा है:

  1. एक ऐसा Firestore डेटाबेस बनाएं जिसमें उपयोगकर्ताओं की कहानियों को सेव करके रखना और वापस लाना हो.
  2. वैकल्पिक रूप से, सैंपल कोड की समीक्षा करें.
  3. होस्ट करने और चलाने के लिए एक Cloud Function बनाएं इवेंट के जवाब में चैट ऐप्लिकेशन का कोड Chat से एचटीटीपी अनुरोधों के तौर पर मिले.
  4. Google Chat API पर Google Chat ऐप्लिकेशन बनाना और उसे डिप्लॉय करना कॉन्फ़िगरेशन पेज.

Firestore डेटाबेस बनाना

इस सेक्शन में, जारी रखने और वापस पाने के लिए Firestore डेटाबेस बनाया जाता है उपयोगकर्ता अनुभव बनाए रखता है, लेकिन आप डेटा मॉडल को परिभाषित नहीं करते. डेटा मॉडल सेट हो गया है model/user-story.js और model/user.js की मदद से, इसे सैंपल कोड में साफ़ तौर पर शामिल किया गया है फ़ाइलें शामिल हैं.

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

नीचे दिया गया डायग्राम, प्रोजेक्ट मैनेजमेंट की खास जानकारी देता है Google Chat ऐप्लिकेशन का डेटा मॉडल:

Firestore डेटाबेस का डेटा मॉडल.

रूट कलेक्शन spaces है. यहां हर दस्तावेज़ ऐसा स्पेस दिखाता है जो Chat ऐप्लिकेशन ने इसमें स्टोरी बनाई हैं. हर उपयोगकर्ता की स्टोरी जिसे userStories सबकलेक्शन में एक दस्तावेज़ से दिखाया जाता है और हर उपयोगकर्ता जिसे users सबकलेक्शन में मौजूद दस्तावेज़ से दिखाया जाता है.

कलेक्शन, दस्तावेज़, और फ़ील्ड की परिभाषाएं देखना

spaces

वे स्पेस जिनमें Chat ऐप्लिकेशन ने स्टोरी बनाई हैं.

फ़ील्ड
Document IDString
उस स्पेस का यूनीक आईडी जहां स्टोरी बनाई जाती हैं. यह Chat API में स्पेस के संसाधन के नाम से मेल खाता है.
userStoriesSubcollection of Documents (userStories)
स्टोरीज़ जो Chat ऐप्लिकेशन और उसके उपयोगकर्ताओं ने बनाई हैं. Firebase में मौजूद userStories के Document ID से मेल खाता है.
usersSubcollection of Documents (user)
वे उपयोगकर्ता जिन्होंने कहानियां बनाई हैं या जिन्हें कहानियां असाइन की गई हैं.
displayNameString
Chat API में स्पेस का डिसप्ले नेम. उपयोगकर्ताओं को डायरेक्ट मैसेज भेजने के लिए सेट नहीं है.

userStories

Chat ऐप्लिकेशन और उसके उपयोगकर्ताओं की बनाई गई स्टोरी.

फ़ील्ड
Document IDString
किसी उपयोगकर्ता की स्टोरी का यूनीक आईडी, जिसे Chat ऐप्लिकेशन और उसके उपयोगकर्ताओं ने बनाया है.
assigneeDocument (user)
स्टोरी पूरा करने के लिए असाइन किए गए उपयोगकर्ता के संसाधन का नाम. यह users दस्तावेज़ के Document ID और Chat API में उपयोगकर्ता के संसाधन के नाम से मेल खाता है.
descriptionString
उपयोगकर्ता के नज़रिये से सॉफ़्टवेयर की सुविधा के बारे में जानकारी.
priorityEnum
काम को पूरा करने में लगने वाला समय. संभावित वैल्यू Low, Medium या High हैं.
sizeEnum
काम की संख्या. संभावित वैल्यू Small, Medium या Large हैं.
statusEnum
काम करने का समय. संभावित वैल्यू OPEN, STARTED या COMPLETED हैं.
titleString
स्टोरी का टाइटल; खास जानकारी.

users

ऐसे उपयोगकर्ता जिन्होंने कहानियां बनाई हैं या जिन्हें असाइन की गई हैं.

फ़ील्ड
Document IDString
किसी उपयोगकर्ता का यूनीक आईडी. यह Firebase में userStories के assignee और Chat API में उपयोगकर्ता के संसाधन के नाम से मेल खाता है.
avatarUrlString
उपयोगकर्ता के Chat अवतार की इमेज को होस्ट करने वाला यूआरएल.
displayNameString
उपयोगकर्ता का Chat डिसप्ले नेम.

यहां Firestore डेटाबेस बनाने का तरीका बताया गया है:

Google Cloud कंसोल

  1. Google Cloud Console में, Firestore पर जाएं. क्लिक करें मेन्यू > फ़ायरस्टोर पर क्लिक करें.

    Firestore पर जाएं

  2. डेटाबेस बनाएं पर क्लिक करें.

  3. अपना Firestore मोड चुनें से, नेटिव मोड पर क्लिक करें.

  4. जारी रखें पर क्लिक करें.

  5. डेटाबेस को कॉन्फ़िगर करें:

    1. अपने डेटाबेस को नाम दें में, डेटाबेस आईडी को (default) के तौर पर छोड़ें.

    2. जगह के टाइप में, अपने डेटाबेस के लिए एक इलाका तय करें, जैसे us-central1. सबसे अच्छी परफ़ॉर्मेंस के लिए, उसी जगह या आस-पास की जगह चुनें जगह की जानकारी को Chat ऐप्लिकेशन के Cloud फ़ंक्शन के तौर पर सेट कर सकता है.

  6. डेटाबेस बनाएं पर क्लिक करें.

gcloud सीएलआई

सैंपल कोड की समीक्षा करें

विकल्प के तौर पर, Cloud Function बनाने से पहले, समीक्षा कर लें और GitHub पर होस्ट किए गए सैंपल कोड के बारे में जानें.

GitHub पर देखें

यहां हर फ़ाइल की खास जानकारी दी गई है:

env.js
एनवायरमेंट कॉन्फ़िगरेशन वैरिएबल को डिप्लॉय करना है किसी Google Cloud प्रोजेक्ट से लिंक करने के लिए चैट ऐप्लिकेशन और क्षेत्र. आपको इस फ़ाइल में कॉन्फ़िगरेशन वैरिएबल अपडेट करने होंगे.
package.json और package-lock.json
Node.js प्रोजेक्ट की सेटिंग और डिपेंडेंसी.
index.js
Chat ऐप्लिकेशन के Cloud फ़ंक्शन के लिए एंट्री पॉइंट. यह पढ़ता है चैट इवेंट: एचटीटीपी अनुरोध करता है, ऐप्लिकेशन हैंडलर को कॉल करता है, और एचटीटीपी रिस्पॉन्स को JSON ऑब्जेक्ट.
controllers/app.js
ऐप्लिकेशन का मुख्य लॉजिक. यह प्रोसेस इंटरैक्शन इवेंट को Chat ऐप्लिकेशन में नाम टैग करने और स्लैश कमांड इस्तेमाल करने की सुविधा. कार्ड पर हुए क्लिक का जवाब देने के लिए, app-action-handler.js को कॉल किया जाता है.
controllers/app-action-handler.js
कार्ड पर होने वाले क्लिक को मैनेज करने के लिए ऐप्लिकेशन लॉजिक चैट पर हुए इंटरैक्शन के इवेंट.
services/space-service.js, services/user-service.js, और services/user-story-service.js
इन फ़ाइलों में खास तौर पर, चैट स्पेस के साथ काम करने के लिए बनाया गया ऐप्लिकेशन लॉजिक, और उनकी स्टोरी देखें. इन फ़ाइलों में मौजूद फ़ंक्शन को app.js से कॉल किया जाता है या app-action-handler.js. डेटाबेस से जुड़ी कार्रवाइयां करने के लिए, ये फ़ाइलें firestore-service.js में फ़ंक्शन को कॉल करती हैं.
services/firestore-service.js
डेटाबेस से जुड़ी कार्रवाइयां हैंडल करता है. इस फ़ाइल में दिए गए फ़ंक्शन को इसके ज़रिए कॉल किया जाता है services/space-service.js, services/user-service.js, और services/user-story-service.js.
services/aip-service.js
जनरेटिव एआई टेक्स्ट के लिए, Vertex AI API को कॉल करता है सुझाव.
model/*.js
इन फ़ाइलों में उन क्लास और ईनम की परिभाषा होती है जो ऐप्लिकेशन सेवाओं का इस्तेमाल, फ़ंक्शन के बीच डेटा सेव करने और भेजने के लिए किया जाता है. उन्होंने Firestore डेटाबेस के लिए डेटा मॉडल.
views/*.js
इस डायरेक्ट्री की हर फ़ाइल इंस्टैंशिएट होती है एक कार्ड ऑब्जेक्ट जो इसके बाद, Chat ऐप्लिकेशन इस ईमेल पते से Chat को वापस भेजता है कार्ड वाले मैसेज पर भेजा जाएगा या डायलॉग कार्रवाई का जवाब.
views/widgets/*.js
हर फ़ाइल इंस्टैंशिएट होती है एक प्रकार का विजेट वह ऑब्जेक्ट जिसका इस्तेमाल ऐप्लिकेशन, views/ डायरेक्ट्री में कार्ड बनाने के लिए करता है.
test/**/*.test.js
इस डायरेक्ट्री की हर फ़ाइल और उसकी सबडायरेक्ट्री की हर फ़ाइल में यूनिट की जांच की जाती है का इस्तेमाल, संबंधित फ़ंक्शन, कंट्रोलर, सेवा, व्यू या विजेट के लिए किया जा सकता है. npm run test चलाकर सभी यूनिट टेस्ट को एक्ज़ीक्यूट किया जा सकता है प्रोजेक्ट की रूट डायरेक्ट्री.

Cloud फ़ंक्शन बनाना और डिप्लॉय करना

इस सेक्शन में, एक ऐसा Cloud फ़ंक्शन बनाया और डिप्लॉय किया जाता है जिसमें प्रोजेक्ट मैनेज करने के लिए, Chat ऐप्लिकेशन का लॉजिक भी इस्तेमाल किया जा सकता है.

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

क्लाउड फ़ंक्शन बनाने का तरीका यहां देखें:

Google Cloud कंसोल

  1. GitHub से कोड को ZIP फ़ाइल के तौर पर डाउनलोड करें.

    ZIP फ़ाइल डाउनलोड करें

  2. डाउनलोड की गई ZIP फ़ाइल एक्सट्रैक्ट करें.

    एक्सट्रैक्ट किए गए फ़ोल्डर में, Google Workspace के पूरे सैंपल होते हैं डेटा स्टोर करने की जगह.

  3. एक्सट्रैक्ट किए गए फ़ोल्डर में, इस पर जाएं google-chat-samples-main/node/project-management-app/, फिर कंप्रेस करें project-management-app फ़ोल्डर को ZIP फ़ाइल में सेव करें.

    ZIP फ़ाइल की रूट डायरेक्ट्री में ये चीज़ें शामिल होनी चाहिए फ़ाइलें और फ़ोल्डर:

    • env.js
    • README.md
    • gcloudignore.text
    • package-lock.json
    • package.json
    • index.js
    • model/
    • controllers/
    • views/
    • services/

  4. Google Cloud Console में, Cloud Functions पेज पर जाएं:

    Cloud Functions पर जाएं

    पक्का करें कि Chat ऐप्लिकेशन चुना गया.

  5. फ़ंक्शन बनाएं पर क्लिक करें.

  6. फ़ंक्शन बनाएं पेज पर, अपना फ़ंक्शन सेट अप करें:

    1. Environment में, 2nd gen को चुनें.
    2. फ़ंक्शन के नाम में project-management-tutorial डालें.
    3. क्षेत्र में जाकर, कोई देश/इलाका चुनें.
    4. पुष्टि करना में जाकर, उन अनुरोधों की अनुमति दें जिनकी पुष्टि नहीं की गई है.
    5. आगे बढ़ें पर क्लिक करें.

  7. रनटाइम में, Node.js 20 चुनें.

  8. एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और फिर projectManagementChatApp.

  9. सोर्स कोड में, ज़िप अपलोड चुनें.

  10. डेस्टिनेशन बकेट में, बनाएं या कोई बकेट चुनें:

    1. ब्राउज़ करें पर क्लिक करें.
    2. कोई बकेट चुनें.
    3. चुनें पर क्लिक करें.

    Google Cloud, ZIP फ़ाइल को कॉम्पोनेंट फ़ाइलों पर अपलोड करता है और उन्हें एक्सट्रैक्ट करता है इस बकेट में शामिल नहीं हैं. इसके बाद Cloud Functions, कॉम्पोनेंट फ़ाइलों को Cloud फ़ंक्शन का इस्तेमाल करना होगा.

  11. ज़िप फ़ाइल में, GitHub से डाउनलोड की गई ZIP फ़ाइल अपलोड करें. एक्सट्रैक्ट करके फिर से कंप्रेस किया गया:

    1. ब्राउज़ करें पर क्लिक करें.
    2. उस पर जाएं और ZIP फ़ाइल चुनें.
    3. खोलें पर क्लिक करें.

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

    इसके बाद, Cloud Functions की जानकारी वाला पेज खुलेगा और आपका फ़ंक्शन दिखेगा प्रगति के दो इंडिकेटर के साथ: एक बिल्ड के लिए और दूसरा सेवा के लिए. जब प्रोग्रेस दिखाने वाले दोनों इंडिकेटर गायब हो जाते हैं और उनकी जगह चेक का इस्तेमाल हो जाता है मार्क करते हैं, तो आपका फ़ंक्शन डिप्लॉय हो गया है और तैयार है.

  13. कॉन्सटेंट सेट करने के लिए सैंपल कोड में बदलाव करें:

    1. Cloud फ़ंक्शन की जानकारी वाले पेज पर, बदलाव करें पर क्लिक करें.
    2. आगे बढ़ें पर क्लिक करें.
    3. सोर्स कोड में, इनलाइन एडिटर चुनें.
    4. इनलाइन एडिटर में, env.js फ़ाइल खोलें.
    5. project-id की जगह अपना Cloud प्रोजेक्ट आईडी डालें.
    6. ज़रूरी नहीं: us-central1 को यह सुविधा इन देशों में उपलब्ध है Google Tag Manager.

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

  15. जब फ़ंक्शन डिप्लॉय हो जाए, तो ट्रिगर यूआरएल को कॉपी करें:

    1. फ़ंक्शन की जानकारी पेज पर, ट्रिगर पर क्लिक करें.
    2. यूआरएल कॉपी करें. आपको इसे कॉन्फ़िगर करने की ज़रूरत है Chat ऐप्लिकेशन नीचे दिए गए सेक्शन में मिलेगा.

gcloud सीएलआई

  1. GitHub से कोड का क्लोन बनाएं:

    git clone https://github.com/googleworkspace/google-chat-samples.git

  2. उस डायरेक्ट्री पर जाएं जिसमें इस प्रोजेक्ट का कोड है मैनेज करने के लिए इस्तेमाल किया जाने वाला चैट ऐप्लिकेशन:

    cd google-chat-samples/node/project-management-app

  3. एनवायरमेंट वैरिएबल सेट करने के लिए, env.js फ़ाइल में बदलाव करें:

    1. project-id की जगह अपने Google Cloud प्रोजेक्ट आईडी का इस्तेमाल करें.
    2. us-central1 को अपने Google Cloud प्रोजेक्ट की जगह से बदलें.

  4. Google Cloud में Cloud फ़ंक्शन डिप्लॉय करें:

    gcloud functions deploy project-management-tutorial \
--gen2 \
--region=REGION \
--runtime=nodejs20 \
--source=. \
--entry-point=projectManagementChatApp \
--trigger-http \
--allow-unauthenticated

    REGION को इस Cloud फ़ंक्शन की जगह की जानकारी जहां इसका इन्फ़्रास्ट्रक्चर होस्ट किया जाता है, जैसे कि us-central1.

  1. जब फ़ंक्शन डिप्लॉय हो जाए, तो यहां से url प्रॉपर्टी को कॉपी करें: जवाब. इस ट्रिगर यूआरएल का इस्तेमाल, नीचे दिए गए सेक्शन में Google Chat ऐप्लिकेशन को कॉन्फ़िगर करें.

Google Cloud Console में Google Chat ऐप्लिकेशन कॉन्फ़िगर करना

इस सेक्शन में, Chat API को कॉन्फ़िगर करने का तरीका बताया गया है Google Cloud Console पर जाकर, अपने Chat ऐप्लिकेशन की जानकारी इसमें Chat ऐप्लिकेशन का नाम, उसके साथ काम करने वाला स्लैश कमांड और Chat ऐप्लिकेशन के क्लाउड के ट्रिगर यूआरएल वह फ़ंक्शन जिससे यह Chat के इंटरैक्शन वाले इवेंट भेजता है.

  1. Google Cloud Console में, मेन्यू पर क्लिक करें > ज़्यादा प्रॉडक्ट > Google Workspace > प्रॉडक्ट लाइब्रेरी > Google Chat API > मैनेज करें > कॉन्फ़िगरेशन.

    Chat API कॉन्फ़िगरेशन पर जाएं

  2. ऐप्लिकेशन का नाम में, Project Manager टाइप करें.

  3. अवतार यूआरएल में, https://developers.google.com/chat/images/quickstart-app-avatar.png लिखें.

  4. Description में, Manages projects with user stories. टाइप करें

  5. इंटरैक्टिव सुविधाएं चालू करें टॉगल पर क्लिक करके, टॉगल को चालू करें.

  6. फ़ंक्शनलता में जाकर, 1:1 मैसेज पाएं, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.

  7. कनेक्शन सेटिंग में, ऐप्लिकेशन यूआरएल चुनें.

  8. ऐप्लिकेशन यूआरएल में, उस ट्रिगर यूआरएल को चिपकाएं जिसे आपने क्लाउड से कॉपी किया है फ़ंक्शन डिप्लॉयमेंट, इस फ़ॉर्मैट में दिया गया है https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. अगर आपने gcloud सीएलआई के साथ क्लाउड फ़ंक्शन को डिप्लॉय किया है, तो यह url है प्रॉपर्टी.

  9. Chat ऐप्लिकेशन को रजिस्टर करें स्लैश कमांड का इस्तेमाल किया जाता है. स्लैश कमांड को रजिस्टर करने के लिए:

    1. स्लैश कमांड में जाकर, स्लैश कमांड जोड़ें पर क्लिक करें.

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

      नाम कमांड आईडी ब्यौरा इससे एक डायलॉग बॉक्स खुलता है
      /createUserStory 1 बताए गए टाइटल के साथ स्टोरी बनाएं. चुने हुए का निशान हटाया गया
      /myUserStories 2 उपयोगकर्ता को असाइन की गई सभी खबरों की सूची बनाता है. चुने हुए का निशान हटाया गया
      /userStory 3 बताई गई कहानी की मौजूदा स्थिति दिखाता है. चुने हुए का निशान हटाया गया
      /manageUserStories 4 इससे एक डायलॉग बॉक्स खुलता है, जिसमें खबरों में बदलाव किया जा सकता है. चुना गया
      /cleanupUserStories 5 स्पेस से सभी स्टोरी मिटा दी जाती हैं. चुने हुए का निशान हटाया गया

  10. किसको दिखे सेक्शन में जाकर, इस Chat ऐप्लिकेशन को अपने संगठन के चुनिंदा लोगों और ग्रुप के लिए उपलब्ध कराएं Workspace डोमेन पर क्लिक करें और अपना ईमेल पता डालें.

  11. इसके अलावा, लॉग में जाकर, लॉग करने में गड़बड़ियों को लॉग करें चुनें.

  12. सेव करें पर क्लिक करें. सेव किया गया कॉन्फ़िगरेशन का मैसेज दिखेगा, जिसका मतलब है कि Chat ऐप्लिकेशन है टेस्ट के लिए तैयार है.

Chat ऐप्लिकेशन को टेस्ट करें

प्रोजेक्ट मैनेजमेंट के Chat ऐप्लिकेशन को मैसेज करके टेस्ट करें और इसके स्लैश कमांड का इस्तेमाल करके, उपयोगकर्ता की स्टोरी बनाई जा सकती हैं, उनमें बदलाव किया जा सकता है, और उन्हें मिटाया जा सकता है.

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

    Google Chat पर जाएं

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

  4. नतीजों में से Chat ऐप्लिकेशन चुनें. सीधे तौर पर होने वाला मैसेज खुलता है.

  5. ऐप्लिकेशन की मदद से नए डायरेक्ट मैसेज में, Hello टाइप करें और enter दबाएं. प्रोजेक्ट मैनेजमेंट Chat ऐप्लिकेशन, जवाब के तौर पर दिए गए एक सहायता मेन्यू के साथ जवाब देता है. इसमें ऐप्लिकेशन के बारे में जानकारी होती है कर सकते हैं.
  6. कोई कहानी बनाने के लिए, /createUserStory Test story और उसे भेजें. प्रोजेक्ट मैनेजमेंट Chat ऐप्लिकेशन एक कार्ड मैसेज के साथ जवाब देता है. इसमें उपयोगकर्ता की स्टोरी, जिसे Vertex AI के जनरेटिव एआई का इस्तेमाल करके आपके लिए बनाया गया है.

  7. कंसोल में, Firestore डेटाबेस देखें और आपके द्वारा जोड़े गए स्पेस के बारे में बनाए गए रिकॉर्ड चैट ऐप्लिकेशन से, वे उपयोगकर्ता जिन्होंने उससे इंटरैक्ट किया, उपयोगकर्ता की स्टोरी को भी शामिल करें.

    Firestore पर जाएं

  8. Google Chat पर वापस जाएं.

    Google Chat पर जाएं

  9. अगर आपको स्टोरी में बदलाव करना है, तो बदलाव करें पर क्लिक करें. हालांकि, ऐसा करना ज़रूरी नहीं है. जब आप संतुष्ट हो जाएं स्टोरी के लिए, सेव करें पर क्लिक करें.
  10. ऐप्लिकेशन के साथ काम करने वाले हर स्लैश कमांड की जांच करें. उन्हें देखने के लिए, / या Chat ऐप्लिकेशन का नाम टैग करें.
  11. /cleanupUserStories जारी करके, टेस्ट उपयोगकर्ता की स्टोरी मिटाएं स्लैश कमांड इस्तेमाल न करें. इसके अलावा, ऐप्लिकेशन को हटाएं या अनइंस्टॉल करें. हटाए जाने पर, ऐप्लिकेशन उस स्पेस में बनाई गई सभी उपयोगकर्ता कहानियां मिटा देता है.

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

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

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

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

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

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

    रिसोर्स मैनेजर पर जाएं

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