Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

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

איור 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 שמגיבה לאירועים.
כדי לעזור למשתמשים להגיב לאירועים, אפשר לבצע את הפעולות הבאות:
- יצירת מרחבים לתגובה לאירועים.
- פרסום הודעות עם סיכום של תקריות ותגובות.
- תמיכה בשיתוף פעולה באמצעות תכונות אינטראקטיביות של אפליקציית Chat.
סיכום שיחות ופתרונות באמצעות Vertex AI.

ארכיטקטורה

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

ארכיטקטורה של אפליקציית Chat לתגובה לתקריות אבטחת מידע

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

משתמש מתחיל אירוע מאתר חיצוני שמארח ב-Apps Script.
האתר שולח בקשת HTTP אסינכרונית לאפליקציית Chat, שגם היא מתארחת ב-Apps Script.
אפליקציית Chat לתגובה לתקריות מעבדת את הבקשה:
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 API Console

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

‫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 במזהה הפרויקט שרוצים ליצור.

הפעלת החיוב בפרויקט ב-Cloud

Google API Console

ב-Google API Console, עוברים אל 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 API Console

ב-Google API Console, מפעילים את 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 API, עוברים אל תפריט > פלטפורמת אימות של Google > מיתוג.

מעבר לדף Branding
אם כבר הגדרתם את פלטפורמת האימות של Google, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-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 Console

במסוף Google Cloud, לוחצים על סמל התפריט > IAM & Admin‏ (IAM ומנהל מערכת) > Service Accounts‏ (חשבונות שירות).
לדף Service accounts

שאר השלבים יופיעו במסוף Google Cloud.
בוחרים פרויקט ב-Google Cloud.
לוחצים על יצירת חשבון שירות.
מזינים שם לחשבון השירות שיופיע במסוף Google Cloud.
הערה: כברירת מחדל, Google יוצרת מזהה ייחודי לחשבון השירות על סמך השם של חשבון השירות. אפשר לשנות את המזהה בשדה 'מזהה חשבון השירות'. אי אפשר יהיה לשנות את המזהה בשלב מאוחר יותר.
אם לא רוצים להגדיר את אמצעי בקרת הגישה עכשיו, לוחצים על Done כדי לסיים את יצירת חשבון השירות. כדי להגדיר אמצעי בקרת גישה עכשיו, לוחצים על Create and continue וממשיכים לשלב הבא.
הערה: מתן בקרת גישה כאן משפיע רק על משאבים ב-Google Cloud. משאבי Google Workspace (כמו Google Sheets ו-Google Drive) משותפים ומוגדרים בנפרד.
אופציונלי: מקצים תפקידים לחשבון השירות כדי לתת גישה למשאבים בפרויקט Google Cloud בנוסף למשאבים ב-Google Workspace. מידע נוסף על ניהול הגישה לפרויקטים, לתיקיות ולארגונים
לוחצים על המשך.
אופציונלי: מזינים משתמשים או קבוצות שיכולים לנהל את חשבון השירות הזה ולבצע בו פעולות. פרטים נוספים מופיעים במאמר התחזות לחשבון שירות.
לוחצים על Done כדי לסיים ליצור את חשבון השירות.
רושמים את כתובת האימייל של חשבון השירות.

‫CLI של gcloud

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

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

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

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

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

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

במסוף Google Cloud, לוחצים על סמל התפריט > IAM & Admin > Service Accounts (חשבונות שירות).
לדף Service accounts

שאר השלבים יופיעו במסוף Google Cloud.
בוחרים פרויקט ב-Google Cloud.
לוחצים על כתובת האימייל של חשבון השירות שעבורו רוצים ליצור מפתח.
לוחצים על הכרטיסייה Keys.
לוחצים על התפריט הנפתח Add key ובוחרים באפשרות Create new key.
בוחרים באפשרות JSON בתור Key type ולוחצים על Create.
זוג המפתחות הציבורי/פרטי החדש נוצר ומורד למחשב שלכם כקובץ מפתח של חשבון שירות. שומרים את קובץ ה-JSON שהורדתם בשם credentials.json בספריית העבודה. הקובץ הזה הוא העותק היחיד של המפתח. אחרי שמורידים את קובץ המפתח, אי אפשר להוריד אותו שוב. מידע על אחסון מאובטח של המפתח זמין במאמר שיטות מומלצות לניהול מפתחות של חשבונות שירות.

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

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

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

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

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

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

יצירה ופריסה של אפליקציה ל-Chat

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

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

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

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

הצגת הקוד ב-GitHub

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

Consts.gs

הקובץ מגדיר קבועים שאליהם מתייחסים קובצי קוד אחרים, כולל מזהה פרויקט Cloud, מזהה מיקום 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 Directory ב-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

מסכם את השיחה במרחב באמצעות 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>

איך מוצאים את מספר הפרויקט ואת מזהה הפרויקט ב-Cloud

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

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

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

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

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

הגדרת פרויקט Cloud לפרויקט Apps Script

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

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

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

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

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

הגדרת אפליקציית Chat ב-Google API Console

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

ב-Google API Console, לוחצים על Menu > APIs & Services > Enabled APIs & Services > 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 ומזינים את כתובת האימייל.
בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.
לוחצים על שמירה. מופיעה הודעה שההגדרה נשמרה, כלומר האפליקציה מוכנה לבדיקה.

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

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

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

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

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

מעבר להגדרת האפליקציה
משלימים את הדף 'הגדרת אפליקציה'. האופן שבו מגדירים את אפליקציית Chat תלוי בקהל היעד ובגורמים אחרים. לקבלת עזרה בהשלמת דף הגדרת האפליקציה, אפשר לעיין במאמר בנושא הגדרת האפליקציה ב-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.
בקטע פרטי האפליקציה, בוחרים באפשרות 'פיתוח אתרים' כקטגוריה.
בקטע נכסים גרפיים, מעלים סמלים של אפליקציות בפורמטים הנדרשים.
בקטע צילומי מסך, מעלים צילום מסך של האפליקציה.
בקטע קישורי תמיכה, ממלאים את כתובת ה-URL של התנאים וההגבלות, כתובת ה-URL של מדיניות הפרטיות וכתובת ה-URL של התמיכה.
בקטע הפצה, בוחרים את האזורים שבהם האפליקציה תהיה זמינה.
לוחצים על פרסום.

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

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

בדיקת אפליקציית Chat

כדי לבדוק את אפליקציית Chat לניהול אירועים, יוזמים אירוע מדף האינטרנט ומוודאים שאפליקציית 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 API, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin > Manage Resources.
כניסה ל-Resource Manager
ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על 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 API Console

‫CLI של gcloud

הפעלת החיוב בפרויקט ב-Cloud

Google API Console

‫CLI של gcloud

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

Google API Console

‫CLI של gcloud

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

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

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

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

Google Cloud Console

‫CLI של gcloud

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

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

יצירה ופריסה של אפליקציה ל-Chat

הצגת קוד Consts.gs

הצגת קוד ChatApp.gs

הצגת קוד ChatSpaceCreator.gs

הצגת קוד DocsApi.gs

הצגת קוד VertexAiApi.gs

הצגת קוד WebController.gs

הצגת קוד Index.html

הצגת קוד JavaScript.html

הצגת קוד Stylesheet.html

איך מוצאים את מספר הפרויקט ואת מזהה הפרויקט ב-Cloud

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

הגדרת פרויקט Cloud לפרויקט Apps Script

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

הגדרת אפליקציית Chat ב-Google API Console

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

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

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

בדיקת אפליקציית Chat

הסרת המשאבים

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

איך מגיבים לתקריות באמצעות 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`