Google Chat, Vertex AI, और Apps Script की मदद से गड़बड़ियों का जवाब दें

इस ट्यूटोरियल में, Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. यह ऐप्लिकेशन, रीयल टाइम में होने वाली घटनाओं पर जवाब देता है. किसी समस्या का जवाब देते समय, ऐप्लिकेशन एक चैट स्पेस बनाता है और उसमें जानकारी भरता है. साथ ही, मैसेज, स्लैश कमांड, और डायलॉग की मदद से समस्या को हल करने में मदद करता है. साथ ही, Google Docs दस्तावेज़ में समस्या के जवाब की खास जानकारी देने के लिए एआई का इस्तेमाल करता है.

इंसिडेंट एक ऐसा इवेंट होता है जिसे ठीक करने के लिए, लोगों की टीम को तुरंत ध्यान देने की ज़रूरत होती है. ऐसी घटनाओं के उदाहरण:

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

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

समस्या मैनेजमेंट चैट ऐप्लिकेशन को काम करते हुए देखें:

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

अगर आपको अपने संगठन के लिए इनमें से कोई ज़रूरी शर्त चालू करनी है, तो अपने Google Workspace एडमिन से कहें कि वह इन्हें चालू करे:

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

मकसद

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

आर्किटेक्चर

नीचे दिए गए डायग्राम में, Google Workspace और Google Cloud के संसाधनों का आर्किटेक्चर दिखाया गया है. इन्हें, समस्या हल करने के लिए Google Chat ऐप्लिकेशन इस्तेमाल करता है.

इस आर्किटेक्चर से पता चलता है कि समस्या के जवाब में, Google Chat ऐप्लिकेशन किसी समस्या और उसके समाधान को कैसे प्रोसेस करता है.

1. कोई उपयोगकर्ता, Apps Script पर होस्ट की गई किसी बाहरी वेबसाइट से कोई समस्या शुरू करता है.

2. वेबसाइट, Google Chat ऐप्लिकेशन पर एक एसिंक्रोनस एचटीटीपी अनुरोध भेजती है. यह ऐप्लिकेशन भी Apps Script पर होस्ट किया जाता है.

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

   1. Apps Script Admin SDK सेवा को टीम के सदस्य की जानकारी मिलती है. जैसे, उपयोगकर्ता आईडी और ईमेल पता.

   2. Apps Script की बेहतर Chat सेवा का इस्तेमाल करके, Chat API को एचटीटीपी अनुरोधों के एक सेट की मदद से, समस्या के जवाब के लिए Google Chat ऐप्लिकेशन, समस्या से जुड़ा Chat स्पेस बनाता है. साथ ही, उसमें टीम के सदस्यों को जोड़ता है और स्पेस में एक मैसेज भेजता है.

4. टीम के सदस्य, Chat स्पेस में इस घटना के बारे में चर्चा कर रहे हैं.

5. समस्या हल होने पर, टीम का कोई सदस्य स्लैश कमांड का इस्तेमाल करके इसकी सूचना देता है.

   1. Apps Script की बेहतर Chat सेवा का इस्तेमाल करके, Chat API को एचटीटीपी कॉल करने पर, Chat स्पेस के सभी मैसेज की सूची दिखती है.

   2. Vertex AI को सूची में शामिल मैसेज मिलते हैं और वह खास जानकारी जनरेट करता है.

   3. Apps Script DocumentApp सेवा, Docs दस्तावेज़ बनाती है और दस्तावेज़ में Vertex AI की खास जानकारी जोड़ती है.

   4. समस्या के जवाब में Google Chat ऐप्लिकेशन, Chat API को कॉल करता है, ताकि वह समरी के Docs दस्तावेज़ का लिंक शेयर करने वाला मैसेज भेज सके.

एनवायरमेंट तैयार करना

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

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

Google Cloud कंसोल

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

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

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

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

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

gcloud सीएलआई

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

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

  gcloud projects create PROJECT_ID

  आपको जिस प्रोजेक्ट को बनाना है उसका आईडी सेट करके, PROJECT_ID की जगह पर उसे डालें.

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

Google Cloud कंसोल

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

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

2. कोई संगठन चुनें में जाकर, अपने Google Cloud प्रोजेक्ट से जुड़ा संगठन चुनें.
3. प्रोजेक्ट की लाइन में, कार्रवाइयां मेन्यू (more_vert) खोलें. इसके बाद, बिलिंग बदलें पर क्लिक करें और Cloud Billing खाता चुनें.
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 प्रोजेक्ट से लिंक करने के लिए बिलिंग खाता आईडी है.

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

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

पुष्टि और अनुमति की मदद से, Chat ऐप्लिकेशन, किसी समस्या के जवाब को प्रोसेस करने के लिए, Google Workspace और Google Cloud के संसाधनों को ऐक्सेस कर सकता है.

इस ट्यूटोरियल में, ऐप्लिकेशन को संगठन के अंदर पब्लिश किया जाता है. इसलिए, प्लेसहोल्डर की जानकारी का इस्तेमाल किया जा सकता है. ऐप्लिकेशन को बाहरी तौर पर पब्लिश करने से पहले, सहमति वाली स्क्रीन के लिए प्लेसहोल्डर की जानकारी को असल जानकारी से बदलें.

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

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

2. अगर आपने पहले से हीको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth की सहमति स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको कोई मैसेज दिखता है, जिसमें लिखा है कि अभी तक कॉन्फ़िगर नहीं किया गया है, तो शुरू करें पर क्लिक करें:

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

3. डेटा ऐक्सेस > दायरा जोड़ें या हटाएं पर क्लिक करें. आपको एक पैनल दिखेगा, जिसमें उन सभी एपीआई के स्कोप की सूची होगी जिन्हें आपने अपने Google Cloud प्रोजेक्ट में चालू किया है.

   1. मैन्युअल तरीके से स्कोप जोड़ें में जाकर, ये स्कोप चिपकाएं:

      • https://www.googleapis.com/auth/chat.spaces.create
      • https://www.googleapis.com/auth/chat.memberships
      • https://www.googleapis.com/auth/chat.memberships.app
      • https://www.googleapis.com/auth/chat.messages
      • https://www.googleapis.com/auth/documents
      • https://www.googleapis.com/auth/admin.directory.user.readonly
      • https://www.googleapis.com/auth/script.external_request
      • https://www.googleapis.com/auth/userinfo.email
      • https://www.googleapis.com/auth/cloud-platform

   2. टेबल में जोड़ें पर क्लिक करें.

   3. अपडेट करें पर क्लिक करें.

   4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर, सेव करें पर क्लिक करें.

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

नीचे दिए गए सेक्शन में, आपको एक पूरा Apps Script प्रोजेक्ट कॉपी करना होगा और उसे अपडेट करना होगा. इस प्रोजेक्ट में, आपके Chat ऐप्लिकेशन के लिए ज़रूरी सभी ऐप्लिकेशन कोड मौजूद होते हैं. इसलिए, हर फ़ाइल को कॉपी करके चिपकाने की ज़रूरत नहीं है.

कुछ फ़ंक्शन के नाम के आखिर में अंडरस्कोर होते हैं, जैसे कि ChatApp.gs से processSlashCommand_(). अंडरस्कोर, ब्राउज़र में खोले जाने पर, समस्या शुरू होने के वेब पेज से फ़ंक्शन को छिपा देता है. ज़्यादा जानकारी के लिए, निजी फ़ंक्शन लेख पढ़ें.

Apps Script में दो तरह की फ़ाइलें काम करती हैं: .gs स्क्रिप्ट और .html फ़ाइलें. इस सहायता का पालन करने के लिए, ऐप्लिकेशन के क्लाइंट-साइड JavaScript को <script /> टैग में शामिल किया जाता है. साथ ही, उसकी सीएसएस को एचटीएमएल फ़ाइल में <style /> टैग में शामिल किया जाता है.

इसके अलावा, GitHub पर पूरा प्रोजेक्ट देखा जा सकता है.

GitHub पर देखना

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

Consts.gs

अन्य कोड फ़ाइलों के रेफ़रंस वाली कॉन्स्टेंट तय करता है. इनमें आपका Cloud प्रोजेक्ट आईडी, Vertex AI लोकेशन आईडी, और किसी समस्या को बंद करने के लिए स्लैश कमांड आईडी शामिल है.

Consts.gs कोड देखना

apps-script/incident-response/Consts.gs

GitHub पर देखना

const PROJECT_ID = 'replace-with-your-project-id';
const VERTEX_AI_LOCATION_ID = 'us-central1';
const CLOSE_INCIDENT_COMMAND_ID = 1;

ChatApp.gs

चैट इंटरैक्शन इवेंट को मैनेज करता है. इनमें मैसेज, कार्ड पर क्लिक, स्लैश निर्देश, और डायलॉग शामिल हैं. /closeIncident स्लैश कमांड का जवाब देता है. इसके लिए, वह समस्या को हल करने के बारे में जानकारी इकट्ठा करने के लिए डायलॉग बॉक्स खोलता है. Chat API में spaces.messages.list तरीके को कॉल करके, स्पेस में मौजूद मैसेज पढ़ता है. Apps Script में, Admin SDK डायरेक्ट्री सेवा का इस्तेमाल करके यूज़र आईडी पाता है.

ChatApp.gs कोड देखना

apps-script/incident-response/ChatApp.gs

GitHub पर देखना

/**
 * Responds to a MESSAGE event in Google Chat.
 *
 * This app only responds to a slash command with the ID 1 ("/closeIncident").
 * It will respond to any other message with a simple "Hello" text message.
 *
 * @param {Object} event the event object from Google Chat
 */
function onMessage(event) {
  if (event.message.slashCommand) {
    return processSlashCommand_(event);
  }
  return { "text": "Hello from Incident Response app!" };
}

/**
 * Responds to a CARD_CLICKED event in Google Chat.
 *
 * This app only responds to one kind of dialog (Close Incident).
 *
 * @param {Object} event the event object from Google Chat
 */
function onCardClick(event) {
  if (event.isDialogEvent) {
    if (event.dialogEventType == 'SUBMIT_DIALOG') {
      return processSubmitDialog_(event);
    }
    return {
      actionResponse: {
        type: "DIALOG",
        dialogAction: {
          actionStatus: "OK"
        }
      }
    };
  }
}

/**
 * Responds to a MESSAGE event with a Slash command in Google Chat.
 *
 * This app only responds to a slash command with the ID 1 ("/closeIncident")
 * by returning a Dialog.
 *
 * @param {Object} event the event object from Google Chat
 */
function processSlashCommand_(event) {
  if (event.message.slashCommand.commandId != CLOSE_INCIDENT_COMMAND_ID) {
    return {
      "text": "Command not recognized. Use the command `/closeIncident` to close the incident managed by this space."
    };
  }
  const sections = [
    {
      header: "Close Incident",
      widgets: [
        {
          textInput: {
            label: "Please describe the incident resolution",
            type: "MULTIPLE_LINE",
            name: "description"
          }
        },
        {
          buttonList: {
            buttons: [
              {
                text: "Close Incident",
                onClick: {
                  action: {
                    function: "closeIncident"
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ];
  return {
    actionResponse: {
      type: "DIALOG",
      dialogAction: {
        dialog: {
          body: {
            sections,
          }
        }
      }
    }
  };
}

/**
 * Responds to a CARD_CLICKED event with a Dialog submission in Google Chat.
 *
 * This app only responds to one kind of dialog (Close Incident).
 * It creates a Doc with a summary of the incident information and posts a message
 * to the space with a link to the Doc.
 *
 * @param {Object} event the event object from Google Chat
 */
function processSubmitDialog_(event) {
  const resolution = event.common.formInputs.description[""].stringInputs.value[0];
  const chatHistory = concatenateAllSpaceMessages_(event.space.name);
  const chatSummary = summarizeChatHistory_(chatHistory);
  const docUrl = createDoc_(event.space.displayName, resolution, chatHistory, chatSummary);
  return {
    actionResponse: {
      type: "NEW_MESSAGE",
    },
    text: `Incident closed with the following resolution: ${resolution}\n\nHere is the automatically generated post-mortem:\n${docUrl}`
  };
}

/**
 * Lists all the messages in the Chat space, then concatenate all of them into
 * a single text containing the full Chat history.
 *
 * For simplicity for this demo, it only fetches the first 100 messages.
 *
 * Messages with slash commands are filtered out, so the returned history will
 * contain only the conversations between users and not app command invocations.
 *
 * @return {string} a text containing all the messages in the space in the format:
 *          Sender's name: Message
 */
function concatenateAllSpaceMessages_(spaceName) {
  // Call Chat API method spaces.messages.list
  const response = Chat.Spaces.Messages.list(spaceName, { 'pageSize': 100 });
  const messages = response.messages;
  // Fetch the display names of the message senders and returns a text
  // concatenating all the messages.
  let userMap = new Map();
  return messages
    .filter(message => message.slashCommand === undefined)
    .map(message => `${getUserDisplayName_(userMap, message.sender.name)}: ${message.text}`)
    .join('\n');
}

/**
 * Obtains the display name of a user by using the Admin Directory API.
 *
 * The fetched display name is cached in the provided map, so we only call the API
 * once per user.
 *
 * If the user does not have a display name, then the full name is used.
 *
 * @param {Map} userMap a map containing the display names previously fetched
 * @param {string} userName the resource name of the user
 * @return {string} the user's display name
 */
function getUserDisplayName_(userMap, userName) {
  if (userMap.has(userName)) {
    return userMap.get(userName);
  }
  let displayName = 'Unknown User';
  try {
    const user = AdminDirectory.Users.get(
      userName.replace("users/", ""),
      { projection: 'BASIC', viewType: 'domain_public' });
    displayName = user.name.displayName ? user.name.displayName : user.name.fullName;
  } catch (e) {
    // Ignore error if the API call fails (for example, because it's an
    // out-of-domain user or Chat app)) and just use 'Unknown User'.
  }
  userMap.set(userName, displayName);
  return displayName;
}

ChatSpaceCreator.gs

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

ChatSpaceCreator.gs कोड देखना

apps-script/incident-response/ChatSpaceCreator.gs

GitHub पर देखना

/**
 * Creates a space in Google Chat with the provided title and members, and posts an
 * initial message to it.
 *
 * @param {Object} formData the data submitted by the user. It should contain the fields
 *                          title, description, and users.
 * @return {string} the resource name of the new space.
 */
function createChatSpace(formData) {
  const users = formData.users.trim().length > 0 ? formData.users.split(',') : [];
  const spaceName = setUpSpace_(formData.title, users);
  addAppToSpace_(spaceName);
  createMessage_(spaceName, formData.description);
  return spaceName;
}

/**
 * Creates a space in Google Chat with the provided display name and members.
 *
 * @return {string} the resource name of the new space.
 */
function setUpSpace_(displayName, users) {
  const memberships = users.map(email => ({
    member: {
      name: `users/${email}`,
      type: "HUMAN"
    }
  }));
  const request = {
    space: {
      displayName: displayName,
      spaceType: "SPACE",
      externalUserAllowed: true
    },
    memberships: memberships
  };
  // Call Chat API method spaces.setup
  const space = Chat.Spaces.setup(request);
  return space.name;
}

/**
 * Adds this Chat app to the space.
 *
 * @return {string} the resource name of the new membership.
 */
function addAppToSpace_(spaceName) {
  const request = {
    member: {
      name: "users/app",
      type: "BOT"
    }
  };
  // Call Chat API method spaces.members.create
  const membership = Chat.Spaces.Members.create(request, spaceName);
  return membership.name;
}

/**
 * Posts a text message to the space on behalf of the user.
 *
 * @return {string} the resource name of the new message.
 */
function createMessage_(spaceName, text) {
  const request = {
    text: text
  };
  // Call Chat API method spaces.messages.create
  const message = Chat.Spaces.Messages.create(request, spaceName);
  return message.name;
}

DocsApi.gs

उपयोगकर्ता के Google Drive में Google Docs दस्तावेज़ बनाने के लिए, Google Docs API को कॉल करता है. साथ ही, VertexAiApi.gs में बनाई गई समस्या की जानकारी की खास जानकारी को दस्तावेज़ में लिखता है.

DocsApi.gs कोड देखना

apps-script/incident-response/DocsApi.gs

GitHub पर देखना

/**
 * Creates a Doc in the user's Google Drive and writes a summary of the incident information to it.
 *
 * @param {string} title The title of the incident
 * @param {string} resolution Incident resolution described by the user
 * @param {string} chatHistory The whole Chat history be included in the document
 * @param {string} chatSummary A summary of the Chat conversation to be included in the document
 * @return {string} the URL of the created Doc
 */
function createDoc_(title, resolution, chatHistory, chatSummary) {
  let doc = DocumentApp.create(title);
  let body = doc.getBody();
  body.appendParagraph(`Post-Mortem: ${title}`).setHeading(DocumentApp.ParagraphHeading.TITLE);
  body.appendParagraph("Resolution").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(resolution);
  body.appendParagraph("Summary of the conversation").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(chatSummary);
  body.appendParagraph("Full Chat history").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(chatHistory);
  return doc.getUrl();
}

VertexAiApi.gs

Vertex AI का इस्तेमाल करके, Chat स्पेस में हुई बातचीत की खास जानकारी देता है. यह खास जानकारी, DocsAPI.gs में खास तौर पर बनाए गए दस्तावेज़ में पोस्ट की जाती है.

VertexAiApi.gs कोड देखना

apps-script/incident-response/VertexAiApi.gs

GitHub पर देखना

/**
 * Summarizes a Chat conversation using the Vertex AI text prediction API.
 *
 * @param {string} chatHistory The Chat history that will be summarized.
 * @return {string} The content from the text prediction response.
 */
function summarizeChatHistory_(chatHistory) {
  const prompt =
    "Summarize the following conversation between Engineers resolving an incident"
      + " in a few sentences. Use only the information from the conversation.\n\n"
      + chatHistory;
  const request = {
    instances: [
      { prompt: prompt }
    ],
    parameters: {
      temperature: 0.2,
      maxOutputTokens: 256,
      topK: 40,
      topP: 0.95
    }
  }
  const fetchOptions = {
    method: 'POST',
    headers: { Authorization: 'Bearer ' + ScriptApp.getOAuthToken() },
    contentType: 'application/json',
    payload: JSON.stringify(request)
  }
  const response = UrlFetchApp.fetch(
    `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1`
      + `/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}`
      + "/publishers/google/models/text-bison:predict",
    fetchOptions);
  const payload = JSON.parse(response.getContentText());
  return payload.predictions[0].content;
}

WebController.gs

यह समस्या शुरू होने की जानकारी देने वाली वेबसाइट दिखाता है.

WebController.gs कोड देखना

apps-script/incident-response/WebController.gs

GitHub पर देखना

/**
 * Serves the web page from Index.html.
 */
function doGet() {
  return HtmlService
    .createTemplateFromFile('Index')
    .evaluate();
}

/**
 * Serves the web content from the specified filename.
 */
function include(filename) {
  return HtmlService
    .createHtmlOutputFromFile(filename)
    .getContent();
}

/**
 * Returns the email address of the user running the script.
 */
function getUserEmail() {
  return Session.getActiveUser().getEmail();
}

Index.html

वह एचटीएमएल जिसमें समस्या शुरू होने की जानकारी देने वाली वेबसाइट शामिल है.

Index.html कोड देखना

apps-script/incident-response/Index.html

GitHub पर देखना

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <link href='https://fonts.googleapis.com/css?family=Roboto' rel='stylesheet'>
    <?!= include('Stylesheet'); ?>
  </head>
  <body>
    <div class="container">
      <div class="content">
        <h1>Incident Manager</h1>
        <form id="incident-form" onsubmit="handleFormSubmit(this)">
          <div id="form">
            <p>
              <label for="title">Incident title</label><br/>
              <input type="text" name="title" id="title" />
            </p>
            <p>
              <label for="users">Incident responders</label><br/>
              <small>
                Please enter a comma-separated list of email addresses of the users
                that should be added to the space.
                Do not include <?= getUserEmail() ?> as it will be added automatically.
              </small><br/>
              <input type="text" name="users" id="users" />
            </p>
            <p>
              <label for="description">Initial message</label></br>
              <small>This message will be posted after the space is created.</small><br/>
              <textarea name="description" id="description"></textarea>
            </p>
            <p class="text-center">
              <input type="submit" value="CREATE CHAT SPACE" />
            </p>
          </div>
          <div id="output" class="hidden"></div>
          <div id="clear" class="hidden">
            <input type="reset" value="CREATE ANOTHER INCIDENT" onclick="onReset()" />
          </div>
        </form>
      </div>
    </div>
    <?!= include('JavaScript'); ?>
  </body>
</html>

JavaScript.html

यह इवेंट शुरू करने वाली वेबसाइट के लिए, फ़ॉर्म के व्यवहार को मैनेज करता है. इसमें, सबमिट करना, गड़बड़ियां, और मिटाना शामिल है. इसे WebController.gs में मौजूद कस्टम include फ़ंक्शन की मदद से, Index.html में शामिल किया गया है.

JavaScript.html कोड देखना

apps-script/incident-response/JavaScript.html

GitHub पर देखना

<script>
  var formDiv = document.getElementById('form');
  var outputDiv = document.getElementById('output');
  var clearDiv = document.getElementById('clear');

  function handleFormSubmit(formObject) {
    event.preventDefault();
    outputDiv.innerHTML = 'Please wait while we create the space...';
    hide(formDiv);
    show(outputDiv);
    google.script.run
      .withSuccessHandler(updateOutput)
      .withFailureHandler(onFailure)
      .createChatSpace(formObject);
  }

  function updateOutput(response) {
    var spaceId = response.replace('spaces/', '');
    outputDiv.innerHTML =
      '<p>Space created!</p><p><a href="https://mail.google.com/chat/#chat/space/'
        + spaceId
        + '" target="_blank">Open space</a></p>';
    show(outputDiv);
    show(clearDiv);
  }

  function onFailure(error) {
    outputDiv.innerHTML = 'ERROR: ' + error.message;
    outputDiv.classList.add('error');
    show(outputDiv);
    show(clearDiv);
  }

  function onReset() {
    outputDiv.innerHTML = '';
    outputDiv.classList.remove('error');
    show(formDiv);
    hide(outputDiv);
    hide(clearDiv);
  }

  function hide(element) {
    element.classList.add('hidden');
  }

  function show(element) {
    element.classList.remove('hidden');
  }
</script>

Stylesheet.html

समस्या शुरू होने की जानकारी देने वाली वेबसाइट के लिए सीएसएस. इसे WebController.gs में मौजूद कस्टम include फ़ंक्शन की मदद से, Index.html में शामिल किया गया है.

Stylesheet.html कोड देखना

apps-script/incident-response/Stylesheet.html

GitHub पर देखना

<style>
  * {
    box-sizing: border-box;
  }
  body {
    font-family: Roboto, Arial, Helvetica, sans-serif;
  }
  div.container {
    display: flex;
    justify-content: center;
    align-items: center;
    position: absolute;
    top: 0; bottom: 0; left: 0; right: 0;
  }
  div.content {
    width: 80%;
    max-width: 1000px;
    padding: 1rem;
    border: 1px solid #999;
    border-radius: 0.25rem;
    box-shadow: 0 2px 2px 0 rgba(66, 66, 66, 0.08), 0 2px 4px 2px rgba(66, 66, 66, 0.16);
  }
  h1 {
    text-align: center;
    padding-bottom: 1rem;
    margin: 0 -1rem 1rem -1rem;
    border-bottom: 1px solid #999;
  }
 #output {
    text-align: center;
    min-height: 250px;
  }
  div#clear {
    text-align: center;
    padding-top: 1rem;
    margin: 1rem -1rem 0 -1rem;
    border-top: 1px solid #999;
  }
  input[type=text], textarea {
    width: 100%;
    padding: 1rem 0.5rem;
    margin: 0.5rem 0;
    border: 0;
    border-bottom: 1px solid #999;
    background-color: #f0f0f0;
  }
  textarea {
    height: 5rem;
  }
  small {
    color: #999;
  }
  input[type=submit], input[type=reset] {
    padding: 1rem;
    border: none;
    background-color: #6200ee;
    color: #fff;
    border-radius: 0.25rem;
    width: 25%;
  }
  .hidden {
    display: none;
  }
  .text-center {
    text-align: center;
  }
  .error {
    color: red;
  }
</style>

अपने Cloud प्रोजेक्ट का नंबर और आईडी ढूंढना

1. Google Cloud Console में, अपने Cloud प्रोजेक्ट पर जाएं.

   Google Cloud Console पर जाएं

2. सेटिंग और सुविधाएं more_vert > प्रोजेक्ट सेटिंग पर क्लिक करें.

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

Apps Script प्रोजेक्ट बनाना

Apps Script प्रोजेक्ट बनाने और उसे अपने Cloud प्रोजेक्ट से कनेक्ट करने के लिए:

1. Google Chat की मदद से समस्याओं का जवाब दें Apps Script प्रोजेक्ट खोलने के लिए, नीचे दिए गए बटन पर क्लिक करें.
   प्रोजेक्ट खोलना
2. info_outline खास जानकारी पर क्लिक करें.
3. खास जानकारी वाले पेज पर, कॉपी बनाएं पर क्लिक करें.

4. Apps Script प्रोजेक्ट की कॉपी का नाम डालें:

   1. Google Chat से समस्याओं का जवाब देने की सुविधा की कॉपी पर क्लिक करें.

   2. प्रोजेक्ट का टाइटल में, Incident Management Chat app टाइप करें.

   3. नाम बदलें पर क्लिक करें.

5. Apps Script प्रोजेक्ट की कॉपी में, Consts.gs फ़ाइल पर जाएं और YOUR_PROJECT_ID की जगह अपने Cloud प्रोजेक्ट का आईडी डालें.

Apps Script प्रोजेक्ट का Cloud प्रोजेक्ट सेट करना

1. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग पर क्लिक करें.
2. Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
3. GCP प्रोजेक्ट नंबर में, अपने Cloud प्रोजेक्ट का प्रोजेक्ट नंबर चिपकाएं.
4. प्रोजेक्ट सेट करें पर क्लिक करें. Cloud प्रोजेक्ट और Apps Script प्रोजेक्ट अब कनेक्ट हो गए हैं.

Apps Script का डिप्लॉयमेंट बनाना

अब जब पूरा कोड मौजूद है, तो Apps Script प्रोजेक्ट को डिप्लॉय करें. Google Cloud में Chat ऐप्लिकेशन को कॉन्फ़िगर करते समय, डिप्लॉयमेंट आईडी का इस्तेमाल किया जाता है.

1. Apps Script में, समस्या हल करने वाले ऐप्लिकेशन का प्रोजेक्ट खोलें.

   Apps Script पर जाएं

2. डिप्लॉय करें > नया डिप्लॉयमेंट पर क्लिक करें.

3. अगर ऐड-ऑन और वेब ऐप्लिकेशन पहले से नहीं चुने गए हैं, तो डिप्लॉयमेंट टाइप के बगल में, टाइप चुनें पर क्लिक करें. इसके बाद, ऐड-ऑन और वेब ऐप्लिकेशन चुनें.

4. जानकारी में, इस वर्शन के बारे में जानकारी डालें, जैसे कि Complete version of incident management app.

5. इस तौर पर चलाएं में जाकर, वेब ऐप्लिकेशन ऐक्सेस करने वाला उपयोगकर्ता चुनें

6. किसके पास ऐक्सेस है में जाकर, आपके Workspace संगठन का कोई भी सदस्य चुनें. यहां "आपके Workspace संगठन" का मतलब आपके Google Workspace संगठन से है.

7. डिप्लॉय करें पर क्लिक करें. Apps Script, डिप्लॉयमेंट के पूरी होने की जानकारी देता है. साथ ही, गड़बड़ी के शुरू होने वाले वेब पेज के लिए डिप्लॉयमेंट आईडी और यूआरएल भी उपलब्ध कराता है.

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

9. हो गया पर क्लिक करें.

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

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

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

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

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

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

4. जानकारी में, Responds to incidents. टाइप करें.

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

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

7. कनेक्शन सेटिंग में जाकर, Apps Script चुनें.

8. डिप्लॉयमेंट आईडी में, वह Apps Script डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पहले Apps Script प्रोजेक्ट के डिप्लॉयमेंट से कॉपी किया था.

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

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

   2. नाम में, /closeIncident टाइप करें.

   3. कमांड आईडी में, 1 टाइप करें.

   4. जानकारी में, लिखें Closes the incident being discussed in the space.

   5. डायलॉग बॉक्स खोलता है को चुनें.

   6. हो गया पर क्लिक करें. स्लैश कमांड रजिस्टर हो जाता है और सूची में शामिल हो जाता है.

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

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

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

Chat ऐप्लिकेशन की जांच करना

समस्या मैनेजमेंट के लिए Chat ऐप्लिकेशन की जांच करने के लिए, वेब पेज से कोई समस्या शुरू करें और पुष्टि करें कि Chat ऐप्लिकेशन ठीक से काम कर रहा है या नहीं:

1. Apps Script के डिप्लॉयमेंट वेब ऐप्लिकेशन के यूआरएल पर जाएं.

2. जब Apps Script आपके डेटा को ऐक्सेस करने की अनुमति मांगे, तो अनुमतियां देखें पर क्लिक करें. इसके बाद, अपने Google Workspace डोमेन में किसी सही Google खाते से साइन इन करें और अनुमति दें पर क्लिक करें.

3. समस्या शुरू होने की जानकारी देने वाला वेब पेज खुलता है. जांच की जानकारी डालें:

   1. इंसिडेंट का टाइटल में, The First Incident टाइप करें.
   2. आपके पास इंसिडेंट रिस्पॉन्स टीम में, अपने साथ काम करने वाले इंसिडेंट रिस्पॉन्स टीम के सदस्यों के ईमेल पते डालने का विकल्प भी है. यह ज़रूरी है कि वे आपके Google Workspace संगठन में Google Chat खाते का इस्तेमाल करने वाले उपयोगकर्ता हों. ऐसा न होने पर, स्पेस बनाने की प्रोसेस पूरी नहीं हो पाएगी. अपना ईमेल पता न डालें, क्योंकि यह अपने-आप शामिल हो जाता है.
   3. शुरुआती मैसेज में, Testing the incident management Chat app. टाइप करें

4. चैट स्पेस बनाएं पर क्लिक करें. आपको creating space मैसेज दिखेगा.

5. स्पेस बनाने के बाद, आपको Space created! मैसेज दिखेगा. स्पेस खोलें पर क्लिक करें. इससे Chat में मौजूद स्पेस, नए टैब में खुल जाएगा.

6. आपके पास और घटना के जवाब देने वाले दूसरे लोगों के पास, स्पेस में मैसेज भेजने का विकल्प भी होता है. ऐप्लिकेशन, Vertex AI का इस्तेमाल करके इन मैसेज की खास जानकारी देता है और एक दस्तावेज़ शेयर करता है.

7. समस्या हल करने की प्रोसेस शुरू करने के लिए, चैट स्पेस में /closeIncident टाइप करें. समस्या मैनेजमेंट वाला डायलॉग बॉक्स खुलेगा.

8. इंसिडेंट बंद करें में, समस्या को ठीक करने के बारे में जानकारी डालें. जैसे, Test complete.

9. इंसिडेंट बंद करें पर क्लिक करें.

इंसिडेंट मैनेजमेंट ऐप्लिकेशन, स्पेस में मौजूद मैसेज की सूची बनाता है. साथ ही, Vertex AI की मदद से उन मैसेज की खास जानकारी देता है. इसके बाद, वह खास जानकारी को Google Docs दस्तावेज़ में चिपकाता है और उस दस्तावेज़ को स्पेस में शेयर करता है.

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

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

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

   संसाधन मैनेजर पर जाएं

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

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

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