איך מגיבים לתקריות באמצעות Google Chat,‏ Vertex AI ו-Google Apps Script

במדריך הזה מוסבר איך ליצור אפליקציה ל-Google Chat שמגיבה לאירועים בזמן אמת. כשמגיבים לאירוע, האפליקציה יוצרת מרחב ב-Chat וממלאת אותו בפרטים, עוזרת לפתור את האירוע באמצעות הודעות, פקודות לוכסן ודיאלוגים, ומשתמשת ב-AI כדי לסכם את התגובה לאירוע במסמך Google Docs.

במדריך הזה נעשה שימוש בהיקפי הרשאות שמתחילים ב-https://www.googleapis.com/auth/chat.app.*. כדי שאפליקציית צ'אט תוכל להשתמש בהיקפי ההרשאות האלה, צריך לקבל אישור אדמין חד-פעמי.

אירוע הוא אירוע שדורש טיפול מיידי של צוות אנשים כדי לפתור אותו. דוגמאות לאירועים:

בקשת תמיכה דחופה נוצרת בפלטפורמה לניהול קשרי לקוחות (CRM), וצוות שירות צריך לשתף פעולה כדי לפתור אותה.
מערכת עוברת למצב אופליין, וקבוצה של מהנדסי Site Reliability (SRE) מקבלת התראה כדי שיוכלו לעבוד יחד ולהחזיר אותה למצב אונליין.
מתרחשת רעידת אדמה בעוצמה גבוהה, ועובדי החירום צריכים לתאם את התגובה שלהם.

לצורך המדריך הזה, ההתראה על האירוע מתחילה כשמישהו מדווח על האירוע בלחיצה על לחצן מדף אינטרנט. דף האינטרנט מדמה אירוע על ידי בקשה מהמשתמשים להזין מידע בסיסי על האירוע: כותרת, תיאור וכתובות אימייל של המשיבים.

כך נראית אפליקציית צ'אט לניהול אירועים בפעולה:

איור 1. האתר שבו אפשר לדווח על תקרית.
איור 2. התראה על יצירת המרחב ב-Chat לדיווח על האירוע.
איור 3. מרחב ב-Chat לתגובה לאירוע.
איור 4. לפתור את האירוע באמצעות פקודה דרך שורת הפקודות.
איור 5. תיבת הדו-שיח של פתרון האירוע.
איור 6. מסמך Google Docs לפתרון אירועים ששותף במרחב.
איור 7. מסמך Google Docs עם סיכום AI של פתרון האירוע.

דרישות מוקדמות

אם אתם צריכים להפעיל בארגון שלכם את אחת מהדרישות המוקדמות האלה, אתם יכולים לבקש מהאדמין ב-Google Workspace להפעיל אותן:

חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.
להפעיל את הארגון שלי (שיתוף אנשי קשר) ב-Google Workspace. אפליקציית האירוע משתמשת בספרייה כדי לחפש את פרטי הקשר של המגיבים לאירוע, כמו שם וכתובת אימייל. מגיבים לאירועים צריכים להיות משתמשים עם חשבון Chat בארגון Google Workspace שלכם.

מטרות

ליצור אפליקציה ל-Chat שמגיבה לאירועים.
כדי לעזור למשתמשים להגיב לאירועים, אפשר לבצע את הפעולות הבאות:
- יצירת מרחבים משותפים לתגובה לאירועים.
- פרסום הודעות עם סיכום של אירועים ותגובות.
- תמיכה בשיתוף פעולה באמצעות תכונות אינטראקטיביות באפליקציית צ'אט.
סיכום שיחות ופתרונות בעזרת Vertex AI.

ארכיטקטורה

בתרשים הבא מוצגת הארכיטקטורה של משאבי Google Workspace ו-Google Cloud שבהם נעשה שימוש באפליקציית Chat לתגובה לאירועים.

ארכיטקטורה של אפליקציית צ'אט לתגובה לאירועים

הארכיטקטורה מראה איך אפליקציית צ'אט לתגובה לאירועים מעבדת אירוע ופתרון.

משתמש מתחיל אירוע מאתר חיצוני שמארח ב-Apps Script.
האתר שולח בקשת HTTP אסינכרונית לאפליקציית צ'אט, שגם היא מתארחת ב-Apps Script.
אפליקציית צ'אט לתגובה לאירועים מעבדת את הבקשה:
1. שירות Apps Script Admin SDK מקבל מידע על חברי הצוות, כמו מזהה משתמש וכתובת אימייל.
2. באמצעות קבוצה של בקשות HTTP ל-Chat API באמצעות שירות Chat מתקדם של Apps Script, אפליקציית Chat לתגובה לאירועים יוצרת מרחב ב-Chat לאירוע, מאכלסת אותו בחברי הצוות ושולחת הודעה למרחב.
חברי הצוות דנים באירוע במרחב ב-Chat.
חבר צוות מפעיל פקודה דרך שורת הפקודות כדי לסמן שהתקרית נפתרה.
1. קריאת HTTP ל-Chat API באמצעות שירות Chat המתקדם של Apps Script מציגה את כל ההודעות במרחב ב-Chat.
2. ‫Vertex AI מקבל את ההודעות שצוינו ויוצר סיכום.
3. שירות DocumentApp של Apps Script יוצר מסמך Docs ומוסיף למסמך את הסיכום של Vertex AI.
4. אפליקציית הצ'אט של התגובה לאירוע קוראת ל-Chat API כדי לשלוח הודעה עם קישור למסמך הסיכום ב-Docs.

הכנת הסביבה

בקטע הזה מוסבר איך ליצור ולהגדיר פרויקט ב-Google Cloud לאפליקציית Chat.

יצירת פרויקט של Google Cloud

מסוף Google Cloud

במסוף Google Cloud, עוברים אל תפריט > IAM & Admin > Create a Project (יצירת פרויקט).
כניסה לדף Create a Project
בשדה Project Name (שם הפרויקט), מזינים שם תיאורי לפרויקט.
אופציונלי: כדי לערוך את מזהה הפרויקט, לוחצים על עריכה. אי אפשר לשנות את מזהה הפרויקט אחרי שהוא נוצר, לכן חשוב לבחור מזהה שיענה על הצרכים שלכם למשך חיי הפרויקט.
בשדה Location, לוחצים על Browse כדי להציג מיקומים אפשריים לפרויקט. אחר כך לוחצים על בחירה.
שימו לב: לא מוצאים את הארגון שלכם ב-Google Workspace?
המשמעות היא שלא נכנסתם לחשבון Google Workspace. חלק מהתכונות שמתוארות במסמכי התיעוד למפתחים של Google Workspace זמינות רק לפרויקטים שמשויכים לארגון.
לוחצים על יצירה. מערכת Google Cloud תעביר אתכם לדף Dashboard, והפרויקט ייצור תוך כמה דקות.

‫CLI של gcloud

באחת מסביבות הפיתוח הבאות, ניגשים אל Google Cloud CLI‏ (gcloud):

Cloud Shell: כדי להשתמש בטרמינל אונליין שבו כבר מוגדר ה-CLI של gcloud, צריך להפעיל את Cloud Shell.
הפעלת Cloud Shell
מעטפת מקומית: כדי להשתמש בסביבת פיתוח מקומית, צריך להתקין ולהפעיל את ה-CLI של gcloud.
כדי ליצור פרויקט בענן, משתמשים בפקודה gcloud projects create:
‫
```
gcloud projects create PROJECT_ID
```
מחליפים את PROJECT_ID במזהה של הפרויקט שרוצים ליצור.

הפעלת החיוב בפרויקט בענן

מסוף Google Cloud

במסוף Google Cloud, נכנסים אל Billing. לוחצים על תפריט > חיוב > הפרויקטים שלי.
מעבר לדף Billing for My Projects
בקטע Select an organization (בחירת ארגון), בוחרים את הארגון שמשויך לפרויקט שלכם ב-Google Cloud.
בשורת הפרויקט, פותחים את התפריט Actions (), לוחצים על Change billing ובוחרים את החשבון לחיוב ב-Cloud.
לוחצים על Set account.

‫CLI של gcloud

כדי להציג רשימה של החשבונות לחיוב שזמינים לכם, מריצים את הפקודה:
```
gcloud billing accounts list
```
קישור חשבון לחיוב לפרויקט ב-Google Cloud:
```
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID הוא מזהה הפרויקט של פרויקט בענן שרוצים להפעיל בו חיוב.
- ‫BILLING_ACCOUNT_ID הוא המזהה של החשבון לחיוב שאליו רוצים לקשר את הפרויקט בענן ב-Google Cloud.

הפעלת ממשקי ה-API

מסוף Google Cloud

במסוף Google Cloud, מפעילים את Google Chat API,‏ Google Docs API,‏ Admin SDK API,‏ Google Workspace Marketplace SDK ו-Vertex AI API.

הפעלת ממשקי ה-API
מוודאים שמפעילים את ממשקי ה-API בפרויקט הנכון ב-Cloud ולוחצים על הבא.
מוודאים שמפעילים את ממשקי ה-API הנכונים ולוחצים על הפעלה.

‫CLI של gcloud

אם צריך, מגדירים את פרויקט בענן הנוכחי לפרויקט שיצרתם באמצעות הפקודה gcloud config set project:
```
gcloud config set project PROJECT_ID
```
מחליפים את PROJECT_ID במזהה הפרויקט של פרויקט בענן שיצרתם.
מפעילים את Google Chat API,‏ Google Docs API,‏ Admin SDK API,‏ Google Workspace Marketplace SDK ו-Vertex AI API באמצעות הפקודה gcloud services enable:
```
gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com appsmarket-component.googleapis.com
```

הגדרת אימות והרשאה

אפליקציית Chat ניגשת אל Chat API באמצעות פרטי הכניסה של אפליקציית Chat. האפליקציה ניגשת אל Admin SDK API ו-Google Docs API באמצעות פרטי הכניסה של המשתמש.

הגדרת אימות והרשאה של משתמשים

אימות והרשאה מאפשרים לאפליקציית Chat לגשת למשאבים ב-Google Workspace וב-Google Cloud כדי לטפל בתגובה לאירוע. בפרט, אימות משתמשים משמש לשליחת קריאות ל-Docs API ול-Admin SDK API.

במדריך הזה, אתם מפרסמים את האפליקציה באופן פנימי בדומיין שלכם ב-Workspace, ולכן אפשר להשתמש במידע של placeholder. לפני שמפרסמים את האפליקציה באופן חיצוני, צריך להחליף את המידע של placeholder במידע אמיתי במסך ההסכמה.

במסוף Google Cloud, לוחצים על סמל התפריט > Google Auth platform > Branding.

מעבר לדף Branding
אם כבר הגדרתם אתGoogle Auth platform, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים Branding,‏ Audience וData Access. אם מופיעה ההודעה Google Auth platform not configured yet, לוחצים על Get Started:
1. בקטע App Information בשדה App name, מקלידים Incident Management.
2. בקטע User support email, בוחרים את כתובת האימייל או קבוצת Google המתאימה.
3. לוחצים על הבא.
4. בקטע Audience, לוחצים על Internal. אם אי אפשר לבחור באפשרות פנימי, בוחרים באפשרות חיצוני.
5. לוחצים על הבא.
6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
7. לוחצים על הבא.
8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, מסמנים את התיבה I agree to the Google API Services: User Data Policy.
9. לוחצים על המשך.
10. לוחצים על יצירה.
11. אם בחרתם באפשרות חיצוני לסוג המשתמש, מוסיפים משתמשי בדיקה:
  1. לוחצים על קהל.
  2. בקטע משתמשי בדיקה, לוחצים על הוספת משתמשים.
  3. מזינים את כתובת האימייל שלכם ושל משתמשי בדיקה מורשים אחרים, ואז לוחצים על שמירה.
לוחצים על גישה לנתונים > הוספה או הסרה של היקפי גישה. מופיעה חלונית עם רשימה של היקפי הרשאות לכל API שהפעלתם בפרויקט שלכם ב-Google Cloud.
1. בקטע Manually add scopes (הוספת היקפי הרשאה באופן ידני), מדביקים את היקפי ההרשאה הבאים:
  - 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 API.

איך יוצרים חשבון שירות במסוף Google Cloud

כדי ליצור חשבון שירות:

מסוף Google Cloud

במסוף Google Cloud, לוחצים על סמל התפריט > IAM & Admin > Service Accounts (חשבונות שירות).
לדף Service accounts
לוחצים על יצירת חשבון שירות.
ממלאים את פרטי חשבון השירות ולוחצים על יצירה והמשך.
הערה: כברירת מחדל, Google יוצרת מזהה ייחודי לחשבון שירות. אם רוצים לשנות את המזהה, משנים אותו בשדה 'מזהה חשבון השירות'.
אופציונלי: מקצים תפקידים לחשבון השירות כדי לתת גישה למשאבים בפרויקט Google Cloud. פרטים נוספים זמינים במאמר הענקה, שינוי וביטול גישה למשאבים.
לוחצים על המשך.
אופציונלי: מזינים משתמשים או קבוצות שיכולים לנהל את חשבון השירות הזה ולבצע בו פעולות. פרטים נוספים מופיעים במאמר ניהול התחזות לחשבון שירות.
לוחצים על סיום. רושמים את כתובת האימייל של חשבון השירות.

‫CLI של gcloud

יוצרים את חשבון השירות:

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

אופציונלי: מקצים תפקידים לחשבון השירות כדי לתת גישה למשאבים בפרויקט Google Cloud. פרטים נוספים זמינים במאמר הענקה, שינוי וביטול גישה למשאבים.

חשבון השירות מופיע בדף של חשבונות השירות. בשלב הבא, יוצרים מפתח פרטי לחשבון השירות.

יצירת מפתח פרטי

כדי ליצור ולהוריד מפתח פרטי לחשבון השירות, פועלים לפי השלבים הבאים:

במסוף Google Cloud, לוחצים על סמל התפריט > IAM & Admin > Service Accounts (חשבונות שירות).
לדף Service accounts
בוחרים את חשבון השירות.
לוחצים על מפתחות > הוספת מפתח > יצירת מפתח חדש.
בוחרים באפשרות JSON ולוחצים על יצירה.
זוג המפתחות הציבורי/הפרטי החדש נוצר ומורד למחשב שלכם כקובץ חדש. שומרים את קובץ ה-JSON שהורדתם בשם credentials.json בספריית העבודה. הקובץ הזה הוא העותק היחיד של המפתח. מידע על אחסון מאובטח של המפתח זמין במאמר ניהול מפתחות לחשבונות שירות.
לוחצים על סגירה.

מידע נוסף על חשבונות שירות זמין במאמר חשבונות שירות במאמרי העזרה של Google Cloud IAM.

יצירת לקוח OAuth שתואם ל-Google Workspace Marketplace

כדי ליצור לקוח OAuth שתואם ל-Google Workspace Marketplace, מבצעים את השלבים הבאים:

במסוף Google Cloud, לוחצים על סמל התפריט > IAM & Admin ‏> Service Accounts.

לדף Service accounts
לוחצים על חשבון השירות שיצרתם לאפליקציית Chat.
לוחצים על הגדרות מתקדמות.
לוחצים על Create Google Workspace Marketplace-compatible OAuth client (יצירת לקוח OAuth שתואם ל-Google Workspace Marketplace).
לוחצים על המשך.

תוצג הודעת אישור שנוצר לקוח OAuth שתואם ל-Google Workspace Marketplace.

יצירה ופריסה של אפליקציית צ'אט

בקטע הבא, מעתיקים ומעדכנים פרויקט שלם בסקריפט של Google Apps שמכיל את כל קוד האפליקציה הנדרש לאפליקציית Chat, כך שאין צורך להעתיק ולהדביק כל קובץ בנפרד.

חלק מהפונקציות כוללות קו תחתון בסוף השם שלהן, כמו processSlashCommand_() מתוך ChatApp.gs. הקו התחתון מסתיר את הפונקציה מדף האינטרנט של אתחול האירוע כשהוא פתוח בדפדפן. מידע נוסף זמין במאמר בנושא פונקציות פרטיות.

‫Apps Script תומך בשני סוגי קבצים: סקריפטים .gs וקבצים .html. כדי לעמוד בדרישות התמיכה האלה, קוד ה-JavaScript בצד הלקוח של האפליקציה נכלל בתגי <script /> וקוד ה-CSS נכלל בתגי <style /> בתוך קובץ HTML.

אם רוצים, אפשר לראות את כל הפרויקט ב-GitHub.

הצגת הקוד ב-GitHub

סקירה כללית של כל קובץ:

Consts.gs

הקובץ מגדיר קבועים שמופנים אליהם בקובצי קוד אחרים, כולל מזהה פרויקט בענן, מזהה מיקום Vertex AI, פרטי כניסה לאפליקציה של חשבון השירות ומזהה פקודה דרך שורת הפקודות לסגירת אירוע.

הצגת הקוד `Consts.gs`

apps-script/incident-response-app-auth/Consts.gs

הצגת הקוד ב-GitHub

const PROJECT_ID = 'replace-with-your-project-id';
const CLOSE_INCIDENT_COMMAND_ID = 1;
const APP_CREDENTIALS = 'replace-with-your-app-credentials';
const APP_CREDENTIALS_SCOPES = 'https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.app.spaces.create';
const VERTEX_AI_LOCATION_ID = 'us-central1';
const MODEL_ID = 'gemini-1.5-flash-002';

ChatApp.gs

טיפול באירועי אינטראקציה ב-Chat, כולל הודעות, קליקים על כרטיסים, פקודות עם לוכסנים ודיאלוגים. מגיב לפקודת הלוכס /closeIncident על ידי פתיחת תיבת דו-שיח לאיסוף פרטים על פתרון האירוע. קורא את ההודעות במרחב על ידי קריאה לשיטה spaces.messages.list ב-Chat API. קבלת מזהי משתמשים באמצעות שירות הספרייה של Admin SDK ב-Apps Script.

הצגת הקוד `ChatApp.gs`

apps-script/incident-response-app-auth/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-app-auth/ChatSpaceCreator.gs

הצגת הקוד ב-GitHub

/**
 * Handles an incident by creating a chat space, adding members, and posting a message.
 * All the actions are done using application credentials.
 *
 * @param {Object} formData - The data submitted by the user. It should contain the fields:
 *                           - title: The display name of the chat space.
 *                           - description: The description of the incident.
 *                           - users: A comma-separated string of user emails to be added to the space.
 * @return {string} The resource name of the new space.
 */
function handleIncident(formData) {
  const users = formData.users.trim().length > 0 ? formData.users.split(',') : [];
  const service = getService_();
  if (!service.hasAccess()) {
    console.error(service.getLastError());
    return;
   }
  const spaceName = createChatSpace_(formData.title, service);
  createHumanMembership_(spaceName, getUserEmail(), service);
  for (const user of users ){
    createHumanMembership_(spaceName, user, service);
  }
  createMessage_(spaceName, formData.description, service);
  return spaceName;
}
/**
 * Creates a chat space with application credentials.
 *
 * @param {string} displayName - The name of the chat space.
 * @param {object} service - The credentials of the service account.
 * @returns {string} The resource name of the new space.
*/
function createChatSpace_(displayName, service) {
  try {
    // For private apps, the alias can be used
    const my_customer_alias = "customers/my_customer";
    // Specify the space to create.
    const space = {
        displayName: displayName,
        spaceType: 'SPACE',                
        customer: my_customer_alias
    };
    // Call Chat API with a service account to create a message.
    const createdSpace = Chat.Spaces.create(
        space,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + service.getAccessToken()});
    return createdSpace.name;
  } catch (err) {
    // TODO (developer) - Handle exception.
    console.log('Failed to create space with error %s', err.message);
  }
}
/*
 * Creates a chat message with application credentials.
 *
 * @param {string} spaceName - The resource name of the space.
 * @param {string} message - The text to be posted.
 * @param {object} service - The credentials of the service account.
 * @return {string} the resource name of the new space.
 */
function createMessage_(spaceName, message, service) {
  try {
    // Call Chat API with a service account to create a message.
    const result = Chat.Spaces.Messages.create(
        {'text': message},
        spaceName,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + service.getAccessToken()});

  } catch (err) {
    // TODO (developer) - Handle exception.
    console.log('Failed to create message with error %s', err.message);
  }
}
/**
 * Creates a human membership in a chat space with application credentials.
 *
 * @param {string} spaceName - The resource name of the space.
 * @param {string} email - The email of the user to be added.
 * @param {object} service - The credentials of the service account.
 */
function createHumanMembership_(spaceName, email, service){
  try{
    const membership = {
      member: {
        name: 'users/'+email,
        // User type for the membership
        type: 'HUMAN'
      }
    };
    const result = Chat.Spaces.Members.create(
      membership,
      spaceName,
      {},
      {'Authorization': 'Bearer ' + service.getAccessToken()}
    );
  } catch (err){
    console.log('Failed to create membership with error %s', err.message)
  }

}

 /*
 * Creates a service for the service account.
 * @return {object}  - The credentials of the service account.
 */
function getService_() {
  return OAuth2.createService(APP_CREDENTIALS.client_email)
      .setTokenUrl('https://oauth2.googleapis.com/token')
      .setPrivateKey(APP_CREDENTIALS.private_key)
      .setIssuer(APP_CREDENTIALS.client_email)
      .setSubject(APP_CREDENTIALS.client_email)
      .setScope(APP_CREDENTIALS_SCOPES)
      .setPropertyStore(PropertiesService.getScriptProperties());
}

DocsApi.gs

קורא ל-Docs API כדי ליצור מסמך ב-Docs ב-Google Drive של המשתמש, וכותב במסמך סיכום של פרטי האירוע שנוצר ב-VertexAiApi.gs.

הצגת הקוד `DocsApi.gs`

apps-script/incident-response-app-auth/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

מסכם את השיחה במרחב ב-Chat באמצעות Vertex AI API. הסיכום הזה מתפרסם במסמך שנוצר במיוחד ב-DocsAPI.gs.

הצגת הקוד `VertexAiApi.gs`

apps-script/incident-response-app-auth/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 API_ENDPOINT = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}/publishers/google/models/${MODEL_ID}:generateContent`;
  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;
  // Get the access token.
  const accessToken = ScriptApp.getOAuthToken();

  const headers = {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  };
  const payload = {
    'contents': {
      'role': 'user',
      'parts' : [
        {
          'text': prompt
        }
      ]
    }
  }
  const options = {
    'method': 'post',
    'headers': headers,
    'payload': JSON.stringify(payload),
    'muteHttpExceptions': true,
  };
  try {
    const response = UrlFetchApp.fetch(API_ENDPOINT, options);
    const responseCode = response.getResponseCode();
    const responseText = response.getContentText();

    if (responseCode === 200) {
      const jsonResponse = JSON.parse(responseText);
      console.log(jsonResponse)
      if (jsonResponse.candidates && jsonResponse.candidates.length > 0) {
        return jsonResponse.candidates[0].content.parts[0].text; // Access the summarized text
      } else {
        return "No summary found in response.";
      }

    } else {
      console.error("Vertex AI API Error:", responseCode, responseText);
      return `Error: ${responseCode} - ${responseText}`;
    }
  } catch (e) {
    console.error("UrlFetchApp Error:", e);
    return "Error: " + e.toString();
  }
}

WebController.gs

האתר שבו מתבצע אתחול האירוע.

הצגת הקוד `WebController.gs`

apps-script/incident-response-app-auth/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

קוד ה-HTML שמרכיב את אתר האינטרנט של הפעלת האירוע.

הצגת הקוד `Index.html`

apps-script/incident-response-app-auth/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

מטפל בהתנהגות של טפסים, כולל שליחות, שגיאות וניקויים, באתר לאתחול האירוע. היא נכללת ב-Index.html על ידי הפונקציה המותאמת אישית include ב-WebController.gs.

הצגת הקוד `JavaScript.html`

apps-script/incident-response-app-auth/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)
      .handleIncident(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

ה-CSS של אתר ההפעלה של האירוע. הוא נכלל ב-Index.html על ידי הפונקציה המותאמת אישית include ב-WebController.gs.

הצגת הקוד `Stylesheet.html`

apps-script/incident-response-app-auth/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>

איך מוצאים את מספר הפרויקט ואת מזהה הפרויקט בענן

במסוף Google Cloud, נכנסים לפרויקט בענן.

כניסה למסוף Google Cloud
לוחצים על סמל ההגדרות והכלים > הגדרות הפרויקט.
רושמים את הערכים בשדות מספר הפרויקט ומזהה הפרויקט. משתמשים בהם בקטעים הבאים.

יצירת פרויקט Apps Script

כדי ליצור פרויקט Apps Script ולקשר אותו לפרויקט Cloud:

לוחצים על הלחצן הבא כדי לפתוח את פרויקט Apps Script של תגובה לאירועים באמצעות Google Chat.
פתיחת הפרויקט
לוחצים על סקירה כללית.
בדף הסקירה הכללית, לוחצים על יצירת עותק.
נותנים שם לעותק של פרויקט Apps Script:
1. לוחצים על העתקה של Respond to incidents with Google Chat (תגובה לאירועים באמצעות Google Chat).
2. בשדה Project title, כותבים Incident Management Chat app.
3. לוחצים על Rename.
בעותק של פרויקט Apps Script, עוברים לקובץ Consts.gs ומחליפים את YOUR_PROJECT_ID במזהה של פרויקט בענן.

הגדרת פרויקט בענן לפרויקט Apps Script

בפרויקט Apps Script, לוחצים על הגדרות הפרויקט.
בקטע פרויקט Google Cloud Platform (GCP)‎, לוחצים על שינוי הפרויקט.
בקטע מספר הפרויקט ב-GCP, מדביקים את מספר הפרויקט בענן.
לוחצים על הגדרת פרויקט. הפרויקט בענן והפרויקט ב-Apps Script מקושרים עכשיו.

יצירת פריסה של Apps Script

אחרי שכל הקוד במקום, פורסים את פרויקט Apps Script. משתמשים במזהה הפריסה כשמגדירים את אפליקציית Chat ב-Google Cloud.

ב-Apps Script, פותחים את הפרויקט של אפליקציית התגובה לאירועים.

מעבר אל Apps Script
לוחצים על פריסה > פריסה חדשה.
אם האפשרויות תוסף ואפליקציית אינטרנט לא מסומנות, לוחצים על סוגי הפריסה לצד בחירת סוג ובוחרים באפשרויות תוסף ואפליקציית אינטרנט.
בשדה תיאור, מזינים תיאור לגרסה הזו, כמו Complete version of incident management app.
בקטע Execute as (הרצה בתור), בוחרים באפשרות User accessing the web app (משתמש שנכנס לאפליקציית האינטרנט).
בקטע למי יש גישה, בוחרים באפשרות כל מי ששייך לארגון שלכם ב-Workspace, כאשר 'הארגון שלכם ב-Workspace' הוא השם של הארגון שלכם ב-Google Workspace.
לוחצים על פריסה. ‫Apps Script מדווח על פריסה מוצלחת ומספק מזהה פריסה וכתובת URL לדף האינטרנט של אתחול האירוע.
רושמים את כתובת ה-URL של אפליקציית האינטרנט כדי להיכנס אליה בהמשך כשמתחילים אירוע. מעתיקים את מזהה הפריסה. משתמשים במזהה הזה כשמגדירים את אפליקציית Chat במסוף Google Cloud.
לוחצים על סיום.

הגדרת אפליקציית Chat במסוף Google Cloud

בקטע הזה נסביר איך להגדיר את Google Chat API במסוף Google Cloud עם מידע על אפליקציית Chat, כולל מזהה הפריסה שיצרתם זה עתה מפרויקט Apps Script.

ב-מסוף Google Cloud, לוחצים על תפריט > APIs & Services (ממשקי API ושירותים) > Enabled APIs & Services (ממשקי API ושירותים מופעלים) > Google Chat API (Google Chat API) > Configuration (הגדרה).

כניסה להגדרות של Chat API
מבטלים את הסימון של Build this Chat app as a Google Workspace add-on (פיתוח אפליקציית Chat כתוסף ל-Google Workspace). תיפתח תיבת דו-שיח שבה תתבקשו לאשר את הפעולה. בתיבת הדו-שיח, לוחצים על השבתה.
בשדה App name, כותבים Incident Management.
בקטע כתובת ה-URL של הדמות, מקלידים https://developers.google.com/chat/images/quickstart-app-avatar.png.
בשדה תיאור, מקלידים Responds to incidents..
לוחצים על המתג הפעלת תכונות אינטראקטיביות כדי להפעיל אותו.
בקטע פונקציונליות, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
בקטע הגדרות חיבור, בוחרים באפשרות Apps Script.
בקטע Deployment ID (מזהה פריסה), מדביקים את מזהה הפריסה של Apps Script שהעתקתם קודם מהפריסה של פרויקט Apps Script.
רושמים פקודת סלאש שבה משתמשת אפליקציית Chat שהוטמעה באופן מלא:
1. בקטע Commands, לוחצים על Add a command.
2. בשדה Command ID (מזהה הפקודה), מקלידים 1.
3. בשדה תיאור, מקלידים Closes the incident being discussed in the space.
4. בקטע סוג הפקודה, בוחרים באפשרות פקודה דרך שורת הפקודות.
5. בשדה Slash command name, כותבים /closeIncident.
6. בוחרים באפשרות הקישור פותח תיבת דו-שיח.
7. לוחצים על סיום. פקודת הסלאש רשומה ומופיעה ברשימה.
בקטע Visibility (חשיפה), בוחרים באפשרות Make this Chat app available to specific people and groups in Your Workspace Domain (הפיכת אפליקציית הצ'אט הזו לזמינה לאנשים ולקבוצות ספציפיים בדומיין שלכם ב-Workspace) ומזינים את כתובת האימייל.
בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.
לוחצים על שמירה. מופיעה הודעה שההגדרה נשמרה, כלומר האפליקציה מוכנה לבדיקה.

קבלת אישור אדמין

כדי לקבל אישור מהאדמין, צריך להגדיר את אפליקציית Chat ב-SDK של Google Workspace Marketplace.

הגדרת אפליקציית צ'אט ב-Google Workspace Marketplace SDK

כדי להגדיר את אפליקציית Chat ב-SDK של Google Workspace Marketplace, פועלים לפי השלבים הבאים:

במסוף Google Cloud, נכנסים אל תפריט > APIs & Services (ממשקי API ושירותים) > Enabled APIs & services (ממשקי API ושירותים מופעלים) > Google Workspace Marketplace SDK (ערכת פיתוח ל-Google Workspace Marketplace) > App Configuration (הגדרת האפליקציה).

מעבר להגדרת האפליקציה
משלימים את הדף 'הגדרת אפליקציה'. האופן שבו מגדירים את אפליקציית צ'אט תלוי בקהל היעד ובגורמים אחרים. לקבלת עזרה בהשלמת דף הגדרת האפליקציה, אפשר לעיין במאמר בנושא הגדרת האפליקציה ב-SDK. לצורך המדריך הזה, מזינים את הפרטים הבאים:
1. בקטע הרשאות גישה לאפליקציה, בוחרים באפשרות פרטי.
2. בקטע הגדרות התקנה, בוחרים באפשרות התקנה לאדמין.
3. בקטע שילובים של אפליקציות, בוחרים באפשרות אפליקציה ל-Chat.
4. בקטע OAuth scopes (היקפי הרשאות OAuth), מזינים את היקפי ההרשאות הבאים:
  - https://www.googleapis.com/auth/chat.app.spaces
  - https://www.googleapis.com/auth/chat.app.memberships
5. בקטע פרטים למפתחים, מזינים את שם המפתח, כתובת ה-URL של אתר המפתחים וכתובת האימייל של המפתח.
6. לוחצים על שמירת הטיוטה.

אחרי שמגדירים את האפליקציה, מעדכנים את דף האפליקציה בחנות:

במסוף Google Cloud, נכנסים אל תפריט > APIs & Services > Enabled APIs & services > Google Workspace Marketplace SDK > Store Listing.
בקטע פרטי האפליקציה, בוחרים באפשרות 'פיתוח אתרים' כקטגוריה.
בקטע Graphic Assets (נכסים גרפיים), מעלים סמלים של אפליקציות בפורמטים הנדרשים.
בקטע צילומי מסך, מעלים צילום מסך של האפליקציה.
בקטע קישורי תמיכה, ממלאים את כתובת ה-URL של התנאים וההגבלות, כתובת ה-URL של מדיניות הפרטיות וכתובת ה-URL של התמיכה.
בקטע הפצה, בוחרים את האזורים שבהם האפליקציה תהיה זמינה.
לוחצים על פרסום.

קבלת אישור אדמין

אחרי שמגדירים את חשבון השירות לקבלת אישור מהאדמין, צריך לקבל אישור מאדמין ב-Google Workspace. כדי לעשות זאת, האדמין צריך לפעול לפי השלבים שמפורטים במאמר הגדרת הרשאה לאפליקציות ל-Chat.

בדיקת אפליקציית צ'אט

כדי לבדוק את אפליקציית צ'אט לניהול אירועי אבטחה, יוזמים אירוע מדף האינטרנט ומוודאים שאפליקציית צ'אט פועלת כמצופה:

עוברים אל כתובת ה-URL של אפליקציית האינטרנט של פריסת Apps Script.
כש-Apps Script מבקש הרשאה לגשת לנתונים שלכם, לוחצים על בדיקת ההרשאות, נכנסים לחשבון Google מתאים בדומיין Google Workspace שלכם ולוחצים על אישור.
ייפתח דף האינטרנט של אתחול האירוע. מזינים את פרטי הבדיקה:
1. בשדה Incident title, כותבים The First Incident.
2. אופציונלי: בשדה Incident responders (מגיבים לאירועים), מזינים את כתובות האימייל של חברי הצוות שמגיבים לאירועים. הם צריכים להיות משתמשים עם חשבון Google Chat בארגון Google Workspace שלכם, אחרת לא תוכלו ליצור את המרחב. אל תזינו את כתובת האימייל שלכם, כי היא נכללת באופן אוטומטי.
3. בהודעה ראשונית, מקלידים Testing the incident management Chat app.
לוחצים על יצירת מרחב לצ'אט. תופיע ההודעה creating space.
אחרי שיוצרים את המרחב, מופיעה הודעה Space created!. לוחצים על פתיחת המרחב כדי לפתוח את המרחב ב-Chat בכרטיסייה חדשה.
אם רוצים, אתם וצוות התגובה לאירוע יכולים לשלוח הודעות במרחב. האפליקציה מסכמת את ההודעות האלה באמצעות Vertex AI ומשתפת מסמך רטרוספקטיבי.
כדי לסיים את תגובת האירוע ולהתחיל בתהליך הפתרון, מקלידים /closeIncident בחדר הצ'אט. תיפתח תיבת דו-שיח של ניהול אירועי אבטחה.
בקטע סגירת אירוע, מזינים תיאור של פתרון האירוע, כמו Test complete.
לוחצים על סגירת האירוע.

אפליקציית ניהול האירועים מציגה את ההודעות במרחב, מסכמת אותן באמצעות Vertex AI, מדביקה את הסיכום במסמך Google Docs ומשתפת את המסמך במרחב.

הסרת המשאבים

כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את פרויקט Cloud.

זהירות: כשמוחקים פרויקט:

התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו כתובת URL ב-appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.

אם אתם מתכננים להיעזר במספר מדריכי לימוד או מדריכים למתחילים, מומלץ להשתמש שוב באותו פרויקט כדי לא לחרוג ממכסות הפרויקטים.

במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin > Manage Resources.
כניסה למנהל המשאבים
ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete .
כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

אפליקציית התגובה לאירועים מאמתת את עצמה באמצעות פרטי כניסה של משתמש כדי לקרוא לממשקי API ולהפעיל שירותי Google Cloud, כמו Chat API ו-Vertex AI API. המשמעות היא שלמשתמש שמפעיל אירוע צריכה להיות גישה לשירותים האלה. כדי להפוך את האפליקציה לחזקה יותר, כדאי לשקול לבצע קריאה ל-Vertex AI API באמצעות חשבון שירות במקום באמצעות פרטי הכניסה של המשתמש שמפעיל את /closeIncident פקודת הלוכסן. למידע נוסף על הגדרת חשבון שירות ל-Vertex AI API, אפשר לעיין במאמר בנושא שימוש בחשבון שירות בהתאמה אישית.

איך מגיבים לתקריות באמצעות Google Chat,‏ Vertex AI ו-Google Apps Script קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

דרישות מוקדמות

מטרות

ארכיטקטורה

הכנת הסביבה

יצירת פרויקט של Google Cloud

מסוף Google Cloud

‫CLI של gcloud

הפעלת החיוב בפרויקט בענן

מסוף Google Cloud

‫CLI של gcloud

הפעלת ממשקי ה-API

מסוף Google Cloud

‫CLI של gcloud

הגדרת אימות והרשאה

הגדרת אימות והרשאה של משתמשים

הגדרת אימות והרשאה של אפליקציות

איך יוצרים חשבון שירות במסוף Google Cloud

מסוף Google Cloud

‫CLI של gcloud

יצירת מפתח פרטי

יצירת לקוח OAuth שתואם ל-Google Workspace Marketplace

יצירה ופריסה של אפליקציית צ'אט

הצגת הקוד Consts.gs

הצגת הקוד ChatApp.gs

הצגת הקוד ChatSpaceCreator.gs

הצגת הקוד DocsApi.gs

הצגת הקוד VertexAiApi.gs

הצגת הקוד WebController.gs

הצגת הקוד Index.html

הצגת הקוד JavaScript.html

הצגת הקוד Stylesheet.html

איך מוצאים את מספר הפרויקט ואת מזהה הפרויקט בענן

יצירת פרויקט Apps Script

הגדרת פרויקט בענן לפרויקט Apps Script

יצירת פריסה של Apps Script

הגדרת אפליקציית Chat במסוף Google Cloud

קבלת אישור אדמין

הגדרת אפליקציית צ'אט ב-Google Workspace Marketplace SDK

קבלת אישור אדמין

בדיקת אפליקציית צ'אט

הסרת המשאבים

נושאים קשורים

איך מגיבים לתקריות באמצעות Google Chat,‏ Vertex AI ו-Google Apps Script

הצגת הקוד `Consts.gs`

הצגת הקוד `ChatApp.gs`

הצגת הקוד `ChatSpaceCreator.gs`

הצגת הקוד `DocsApi.gs`

הצגת הקוד `VertexAiApi.gs`

הצגת הקוד `WebController.gs`

הצגת הקוד `Index.html`

הצגת הקוד `JavaScript.html`

הצגת הקוד `Stylesheet.html`