‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול פרויקטים באמצעות Google Chat, Vertex AI ו-Firestore

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

איור 1. צ'ארלי דנה עם הצוות שלה בפיתוח תכונות במרחב ב-Chat. אם מתייגים את אפליקציית Chat לניהול פרויקטים, אפליקציית Chat מציעה עזרה.
איור 2. /createUserStoryצ'רלי משתמש בפקודה דרך שורת הפקודות כדי ליצור סטורי.
איור 3. אפליקציית הצ'אט לניהול פרויקטים משתמשת ב-Vertex AI כדי לכתוב את תיאור הסיפור, ואז משתפת את הסיפור במרחב.
איור 4. צ'ארלי לוחץ על עריכה כדי לסיים את פרטי הסיפור. התיאור שנוצר על ידי ה-AI מדויק, אבל צ'ארלי רוצה פרטים נוספים, אז הוא לוחץ על הרחבה כדי ש-Vertex AI יוסיף דרישות לתיאור הסיפור. צ'ארלי מקצה את הסיפור לעצמו, מגדיר את הסטטוס ל'התחיל', בוחר עדיפות וגודל מתאימים ולוחץ על שמירה.
איור 5. בכל שלב, צ'ארלי יכול לראות ולנהל את כל סיפורי המשתמשים של הצוות באמצעות /manageUserStoriesפקודה דרך שורת הפקודות
.

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

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

מטרות

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

המוצרים שהשתמשו בהם

אפליקציית ניהול הפרויקטים משתמשת במוצרים הבאים של Google Workspace ו-Google Cloud:

‫Chat API: ‫API לפיתוח אפליקציות ל-Google Chat שמקבלות אירועי אינטראקציה ב-Chat ומגיבות להם, כמו הודעות. אפליקציית ניהול הפרויקטים ל-Google Chat משתמשת ב-Chat API כדי לקבל אירועי אינטראקציה שנשלחים מ-Chat ולהגיב להם, וכדי להגדיר מאפיינים שקובעים איך היא תופיע ב-Chat, כמו שם ותמונת אווטאר.
‫Vertex AI API: פלטפורמת AI גנרטיבי. אפליקציית Google Chat לניהול פרויקטים משתמשת ב-Vertex AI API כדי לכתוב כותרות ותיאורים של סיפורי משתמשים.
‫Firestore: מסד נתונים של מסמכים ללא שרת. אפליקציית Google Chat לניהול פרויקטים משתמשת ב-Firebase כדי לאחסן נתונים על סיפורי משתמשים.
‫Cloud Functions: שירות מחשוב קל משקל ללא שרת (serverless) שמאפשר ליצור פונקציות עצמאיות למטרה יחידה שיכולות להגיב לאירועי אינטראקציה ב-Chat, בלי צורך לנהל שרת או סביבת זמן ריצה. אפליקציית Google Chat לניהול פרויקטים משתמשת ב-Cloud Functions כדי לארח את נקודת הקצה של HTTP שאליה Chat שולח אירועי אינטראקציה, וכפלטפורמת מחשוב להפעלת לוגיקה שמבצעת עיבוד של האירועים האלה ומגיבה להם.

‫Cloud Functions משתמש במוצרי Google Cloud הבאים כדי לבנות, לעבד אירועי אינטראקציה ולארח משאבי מחשוב:
- ‫Cloud Build: פלטפורמה מנוהלת לחלוטין לאינטגרציה רציפה, לפיתוח רציף ולפריסה רציפה, שמריצה גרסאות build אוטומטיות.
- ‫Pub/Sub: שירות העברת הודעות אסינכרוני וניתן להרחבה שמפריד בין שירותים שמפיקים הודעות לבין שירותים שמעבדים את ההודעות האלה.
- ‫Cloud Run Admin API: סביבה מנוהלת להרצת אפליקציות בקונטיינרים.

ארכיטקטורה

ארכיטקטורת אפליקציית ניהול הפרויקטים של Google Chat מקבלת ומעבדת אירועי אינטראקציה ב-Chat בנקודת קצה של HTTP, משתמשת ב-Vertex AI כדי לכתוב סיפורי משתמשים, ומאחסנת את פרטי סיפורי המשתמשים במסד נתונים של Firestore. בתרשים הבא מוצגת הארכיטקטורה של משאבי Google Workspace ו-Google Cloud שנעשה בהם שימוש.

דיאגרמת ארכיטקטורה של אפליקציית ניהול הפרויקטים ל-Google Chat

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

משתמש שולח הודעה ב-Chat ומפעיל את אפליקציית ניהול הפרויקטים של Google Chat. הוא יכול לשלוח לה הודעה ישירה, לתייג אותה במרחב או להזין פקודה דרך שורת הפקודות.
‫Chat שולח בקשת HTTP סינכרונית לנקודת הקצה של ה-HTTP של Cloud Function.
אפליקציית Google Chat לניהול פרויקטים מעבדת את בקשת ה-HTTP:
1. ‫Vertex AI עוזר לכתוב או לעדכן סיפור משתמש.
2. מסד נתונים ב-Firestore מאחסן, מאחזר, מעדכן או מוחק נתונים של סיפורי משתמשים.
‫Cloud Functions מחזירה תגובת HTTP ל-Chat, שמוצגת למשתמש כהודעה או כתיבת דו-שיח.

הכנת הסביבה

בסעיף הזה מוסבר איך ליצור ולהגדיר פרויקט ב-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 במזהה הפרויקט שרוצים ליצור.

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

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,‏ Vertex AI API,‏ Cloud Functions API,‏ Firestore API,‏ Cloud Build API,‏ Pub/Sub API ו-Cloud Run Admin API.

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

‫CLI של gcloud

אם צריך, מגדירים את פרויקט בענן הנוכחי לפרויקט שיצרתם באמצעות הפקודה gcloud config set project:
```
gcloud config set project PROJECT_ID
```
מחליפים את PROJECT_ID במזהה הפרויקט של פרויקט בענן שיצרתם.
מפעילים את Google Chat API, את Vertex AI API, את Cloud Functions API, את Firestore API, את Cloud Build API, את Pub/Sub API ואת Cloud Run Admin API באמצעות הפקודה gcloud services enable:
```
gcloud services enable chat.googleapis.com \
aiplatform.googleapis.com \
cloudfunctions.googleapis.com \
firestore.googleapis.com \
cloudbuild.googleapis.com \
pubsub.googleapis.com \
run.googleapis.com
```
‫Cloud Build,‏ Pub/Sub ו-Cloud Run Admin APIs הם דרישות מוקדמות ל-Cloud Functions.

אימות והרשאה

לא צריך להגדיר אימות והרשאה כדי לבצע את ההוראות במדריך הזה.

כדי להפעיל את ממשקי ה-API של Firestore ו-Vertex AI, במדריך הזה נעשה שימוש בApplication Default Credentials עם חשבון השירות שמוגדר כברירת מחדל ומצורף ל-Cloud Function. לא צריך להגדיר אותו. בסביבת ייצור, בדרך כלל יוצרים ומצרפים חשבון שירות לפונקציה ב-Cloud Functions.

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

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

יוצרים מסד נתונים של Firestore שבו יאוחסנו סיפורי המשתמשים ויוכלו לאחזר אותם.
אופציונלי: בודקים את הקוד לדוגמה.
יוצרים פונקציית Cloud כדי לארח ולהריץ את הקוד של אפליקציית הצ'אט בתגובה לאירועים שמתקבלים מ-Chat כבקשות HTTP.
יוצרים ופורסים אפליקציית Google Chat בדף ההגדרות של Google Chat API.

יצירת מסד הנתונים ב-Firestore

בקטע הזה יוצרים מסד נתונים של Firestore כדי לשמור ולאחזר סיפורי משתמשים, אבל לא מגדירים את מודל הנתונים. מודל הנתונים מוגדר באופן מרומז בקוד לדוגמה על ידי הקבצים model/user-story.js ו-model/user.js.

מסד הנתונים של אפליקציית הצ'אט לניהול פרויקטים משתמש במודל נתונים של NoSQL שמבוסס על מסמכים שמסודרים ב אוספים. מידע נוסף על מודל הנתונים של Firestore

בתרשים הבא מוצג סקירה כללית של מודל הנתונים של אפליקציית ניהול הפרויקטים ב-Google Chat:

מודל הנתונים של מסד הנתונים ב-Firestore.

אוסף הבסיס הוא spaces, שבו כל מסמך מייצג מרחב שבו אפליקציית Chat יצרה סיפורים. כל סיפור משתמש מיוצג על ידי מסמך באוסף המשנה userStories, וכל משתמש מיוצג על ידי מסמך באוסף המשנה users.

הצגת הגדרות של אוסף, מסמך ושדה

`spaces`

מרחבים שבהם אפליקציית Chat יצרה סיפורים.

שדות
`Document ID`	`String` מזהה ייחודי של מרחב ספציפי שבו נוצרים סטוריז. השם הזה תואם לשם המשאב של המרחב ב-Chat API.
`userStories`	`Subcollection of Documents (userStories)` סטוריז שנוצרו על ידי אפליקציית Chat והמשתמשים שלה. תואם ל-`Document ID` של `userStories` ב-Firebase.
`users`	`Subcollection of Documents (user)` משתמשים שיצרו סיפורים או שהוקצו להם סיפורים.
`displayName`	`String` השם המוצג של המרחב ב-Chat API. לא מוגדר לצ'אטים ישירים עם משתמשים.

`userStories`

סטוריז שנוצרו על ידי אפליקציית Chat והמשתמשים שלה.

שדות
`Document ID`	`String` מזהה ייחודי של סיפור משתמש ספציפי שנוצר על ידי אפליקציית ה-Chat והמשתמשים שלה.
`assignee`	`Document (user)` שם המשאב של המשתמש שהוקצה להשלמת הסיפור. תואם ל-`Document ID` של מסמך `users` ולשם המשאב של המשתמש ב-Chat API.
`description`	`String` תיאור של תכונת התוכנה מנקודת המבט של המשתמש.
`priority`	`Enum` דחיפות העבודה. הערכים האפשריים הם `Low`,‏ `Medium` או `High`.
`size`	`Enum` כמות העבודה. הערכים האפשריים הם `Small`,‏ `Medium` או `Large`.
`status`	`Enum` שלב העבודה. הערכים האפשריים הם `OPEN`,‏ `STARTED` או `COMPLETED`.
`title`	`String` הכותרת של הסיפור; סיכום קצר.

`users`

משתמשים שיצרו סיפורים או שהוקצו להם סיפורים.

שדות
`Document ID`	`String` מזהה ייחודי של משתמש ספציפי. הערך הזה תואם ל`assignee` של `userStories` ב-Firebase ולשם המשאב של המשתמש ב-Chat API.
`avatarUrl`	‫`String` כתובת URL שבה מתארחת תמונת האווטאר של המשתמש ב-Chat.
`displayName`	`String` השם המוצג של המשתמש ב-Chat.

כך יוצרים את מסד הנתונים ב-Firestore:

Google API Console

ב-Google API Console, עוברים אל Firestore. לוחצים על תפריט > Firestore.

כניסה אל Firestore
לוחצים על יצירת מסד נתונים.
בקטע בחירת מצב Firestore, לוחצים על מצב Native.
לוחצים על המשך.
מגדירים את מסד הנתונים:
1. בקטע Name your database (מתן שם למסד הנתונים), משאירים את Database ID (מזהה מסד הנתונים) כ-(default).
2. בשדה Location type, מציינים אזור למסד הנתונים, למשל us-central1. כדי לקבל את הביצועים הטובים ביותר, כדאי לבחור את אותו מיקום או מיקום סמוך למיקום של פונקציית הענן של אפליקציית Chat.
לוחצים על יצירת מסד נתונים.

‫CLI של gcloud

יוצרים מסד נתונים של Firestore במצב Native באמצעות הפקודה gcloud firestore databases create:
```
gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native
```
מחליפים את LOCATION בשם של אזור ב-Firestore, כמו us-central1.

בדיקת קוד לדוגמה

אופציונלי: לפני שיוצרים את Cloud Function, כדאי לעיין בקוד לדוגמה שמתארח ב-GitHub ולהכיר אותו.

הצגת הקוד ב-GitHub

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

env.js: משתני תצורה של הסביבה לפריסת אפליקציית Chat לפרויקט בענן ולאזור ספציפיים ב-Google Cloud. צריך לעדכן את משתני התצורה בקובץ הזה.
package.json וגם package-lock.json: הגדרות הפרויקט ויחסי התלות ב-Node.js.
index.js: נקודת הכניסה לפונקציה של Cloud Functions של אפליקציית Chat. הוא קורא את אירוע הצ'אט מבקשת ה-HTTP, מפעיל את handler האפליקציה ומפרסם את תגובת ה-HTTP כאובייקט JSON.
controllers/app.js: הלוגיקה הראשית של האפליקציה. מעבד את אירועי האינטראקציה על ידי טיפול בתיוגים של אפליקציית Chat ובפקודות. כדי להגיב לקליקים על כרטיסים, הפונקציה app-action-handler.js מופעלת.
controllers/app-action-handler.js: לוגיקת אפליקציה לטיפול בקליק על כרטיס אירועי אינטראקציה ב-Chat.
‫services/space-service.js,‏ services/user-service.js וגם services/user-story-service.js: הקבצים האלה מכילים את החלקים של לוגיקת האפליקציה שספציפיים לעבודה עם מרחבים ב-Chat, משתמשים וסיפורי משתמשים. הפונקציות בקבצים האלה נקראות על ידי app.js או app-action-handler.js. כדי לבצע פעולות במסד הנתונים, הפונקציות בקבצים האלה קוראות לפונקציות ב-firestore-service.js.
services/firestore-service.js: Handles database operations. הפונקציות בקובץ הזה נקראות על ידי services/space-service.js,‏ services/user-service.js ו-services/user-story-service.js.
services/aip-service.js: קורא ל-Vertex AI API כדי לקבל תחזית של טקסט מ-AI גנרטיבי.
model/*.js: הקבצים האלה מכילים את ההגדרה של מחלקות וספירות שהשירותים של האפליקציה משתמשים בהן כדי לאחסן נתונים ולהעביר אותם בין פונקציות. הם מגדירים את מודל הנתונים של מסד הנתונים ב-Firestore.
views/*.js: כל קובץ בספרייה הזו יוצר אובייקט כרטיס שאפליקציית Chat שולחת בחזרה ל-Chat בתור הודעת כרטיס או תגובה לפעולת דיאלוג.
views/widgets/*.js: כל קובץ יוצר מופע של אובייקט מסוג ווידג'ט שהאפליקציה משתמשת בו כדי ליצור את הכרטיסים בספרייה views/.
test/**/*.test.js: כל קובץ בספרייה הזו ובספריות המשנה שלה מכיל את בדיקות היחידות (unit testing) של הפונקציה, בקר, שירות, תצוגה או ווידג'ט התואמים. כדי להריץ את כל בדיקות היחידות, מריצים את הפקודה npm run test כשנמצאים בספריית הבסיס של הפרויקט.

יצירה ופריסה של הפונקציה של Cloud Functions

בקטע הזה יוצרים ופורסים Cloud Function שכולל את הלוגיקה של האפליקציה לניהול פרויקטים ב-Chat.

פונקציית Cloud Functions פועלת בתגובה לבקשת HTTP מ-Chat שמכילה אירוע אינטראקציה ב-Chat. כשמריצים את הקוד של Cloud Function, הוא מעבד את האירוע ומחזיר תגובה ל-Chat. התגובה מוצגת ב-Chat כהודעה, תיבת דו-שיח או סוג אחר של אינטראקציה עם המשתמש. במקרה הרלוונטי, Cloud Function קורא גם ממסד הנתונים של Firestore או כותב בו.

כך יוצרים את הפונקציה ב-Cloud Functions:

Google API Console

מורידים את הקוד מ-GitHub כקובץ ZIP.

הורדת קובץ ה-ZIP
מחלצים את קובץ ה-ZIP שהורד.

התיקייה שחולצה מכילה את כל מאגר הדוגמאות של Google Workspace.
בתיקייה שחולצה, עוברים אל add-ons-samples-main/node/chat/project-management-app/ ודוחסים את התיקייה project-management-app לקובץ ZIP.

ספריית הבסיס של קובץ ה-ZIP חייבת להכיל את הקבצים והתיקיות הבאים:
- env.js
- README.md
- gcloudignore.text
- package-lock.json
- package.json
- index.js
- model/
- controllers/
- views/
- services/
במסוף Google API, עוברים לדף Cloud Functions:

כניסה לדף Cloud Functions

מוודאים שהפרויקט ב-Google Cloud של אפליקציית Chat נבחר.
לוחצים על Create Function (יצירת פונקציה).
בדף Create function (יצירת פונקציה), מגדירים את הפונקציה:
1. בקטע Environment (סביבה), בוחרים באפשרות Cloud Run Function (פונקציית Cloud Run).
2. בשדה Function name, מזינים project-management-tutorial.
3. בקטע אזור, בוחרים אזור.
4. בקטע אימות, בוחרים באפשרות התרת הפעלות לא מאומתות.
5. לוחצים על הבא.
בקטע Runtime (סביבת זמן ריצה), בוחרים באפשרות Node.js 20.
בקטע נקודת כניסה, מוחקים את טקסט ברירת המחדל ומזינים projectManagementChatApp.
בקטע קוד מקור, בוחרים באפשרות העלאת קובץ ZIP.
בקטע קטגוריית יעד, יוצרים או בוחרים קטגוריה:
1. לוחצים על מה מעניין אותך היום?
2. בוחרים קטגוריה.
3. לוחצים על בחירה.
מערכת Google Cloud מעלה את קובץ ה-ZIP ומחלצת את קובצי הרכיבים בקטגוריה הזו. לאחר מכן, Cloud Functions מעתיק את קובצי הרכיבים אל Cloud Functions.
בקטע Zip file (קובץ ZIP), מעלים את קובץ ה-ZIP שהורדתם מ-GitHub, חילצתם ודחסתם מחדש:
1. לוחצים על מה מעניין אותך היום?
2. מנווטים אל קובץ ה-ZIP ובוחרים בו.
3. לוחצים על פתיחה.
לוחצים על פריסה.

ייפתח הדף Cloud Functions detail, והפונקציה שלכם תופיע עם שני אינדיקטורים להתקדמות: אחד לבנייה ואחד לשירות. כשהאינדיקטורים להתקדמות נעלמים ומוחלפים בסימן וי, הפונקציה מוכנה לפריסה.
עורכים את הקוד לדוגמה כדי להגדיר קבועים:
1. בדף Cloud Function detail (פרטי Cloud Function), לוחצים על Edit (עריכה).
2. לוחצים על הבא.
3. בקטע קוד מקור, בוחרים באפשרות עורך בתוך השורה.
4. בעורך המוטבע, פותחים את הקובץ env.js.
5. מחליפים את project-id במזהה הפרויקט בענן.
6. אופציונלי: מעדכנים את us-central1 עם מיקום נתמך עבור Cloud Function.
לוחצים על פריסה.
כשהפריסה של הפונקציה מסתיימת, מעתיקים את כתובת ה-URL של הטריגר:
1. בדף פרטי הפונקציה, לוחצים על הפעלה.
2. מעתיקים את כתובת ה-URL. תצטרכו אותו כדי להגדיר את אפליקציית Chat בקטע הבא.

‫CLI של gcloud

משכפלים את הקוד מ-GitHub:

git clone https://github.com/googleworkspace/add-ons-samples.git

עוברים לספרייה שמכילה את הקוד של אפליקציית Chat לניהול הפרויקט הזה:
```
cd add-ons-samples/node/chat/project-management-app
```
עורכים את הקובץ env.js כדי להגדיר משתני סביבה:
1. מחליפים את project-id במזהה הפרויקט ב-Google Cloud.
2. מחליפים את us-central1 במיקום של הפרויקט ב-Google Cloud.

פורסים את הפונקציה של Cloud Functions ב-Google Cloud:

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

מחליפים את REGION במיקום של Cloud Functions שבו התשתית מתארחת, כמו us-central1.

כשהפונקציה מסיימת את הפריסה, מעתיקים את המאפיין url מהתגובה. זו כתובת ה-URL של הטריגר שבה תשתמשו בקטע הבא כדי להגדיר את האפליקציה של Google Chat.

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

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

ב-Google API Console, לוחצים על Menu > APIs & Services > Enabled APIs & Services > Google Chat API > Configuration.

כניסה להגדרות של Chat API
בשדה App name, כותבים Project Manager.
בקטע כתובת ה-URL של הדמות, מקלידים https://developers.google.com/add-ons/samples/images/quickstart-app-avatar.png.
בקטע תיאור, מקלידים Manages projects with user stories.
לוחצים על המתג הפעלת תכונות אינטראקטיביות כדי להפעיל אותו.
בקטע פונקציונליות, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
בקטע Connection settings (הגדרות חיבור), בוחרים באפשרות HTTP endpoint URL (כתובת URL של נקודת קצה בפרוטוקול HTTP).
מעתיקים את כתובת האימייל בחשבון השירות. תצטרכו את כתובת האימייל הזו כשתאשרו לתוסף להפעיל את הפונקציה.
בקטע טריגרים, בוחרים באפשרות שימוש בכתובת URL משותפת של נקודת קצה (endpoint) בפרוטוקול HTTP לכל הטריגרים.
בקטע HTTP endpoint URL (כתובת URL של נקודת קצה HTTP), מדביקים את כתובת ה-URL של הטריגר של Cloud Function בפורמט https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. אם פרסתם את הפונקציה של Cloud Functions באמצעות ה-CLI של gcloud, זהו המאפיין url.

רושמים את הפקודות דרך שורת הפקודות של אפליקציית Chat. כדי לרשום פקודה דרך שורת הפקודות:

בקטע Commands, לוחצים על Add a command.

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

מזהה הפקודה	תיאור	שם הפקודה דרך שורת הפקודות	Dialog
1	יוצרים סיפור עם הכותרת שצוינה.	`/createUserStory`	לא נבחר
2	רשימה של כל הסיפורים שהוקצו למשתמש.	`/myUserStories`	לא נבחר
3	בעמודה הזו מוצג הסטטוס הנוכחי של הכתבה שצוינה.	`/userStory`	לא נבחר
4	תיבת דו-שיח נפתחת, שבה אפשר לערוך את הסיפורים.	`/manageUserStories`	נבחר
5	מחיקה של כל הסטוריז במרחב.	`/cleanupUserStories`	לא נבחר

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

אפליקציית Chat מוכנה לקבל הודעות ב-Chat ולענות להן.

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

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

פותחים את Google Chat באמצעות חשבון Google Workspace שציינתם כשנוספתם כבודקים מהימנים.

מעבר אל Google Chat
לוחצים על שיחה חדשה.
בשדה הוספת אדם אחד או יותר, מקלידים את השם של אפליקציית Chat.
בוחרים את אפליקציית Chat מתוך התוצאות. ייפתח צ'אט ישיר.

הערה: אם אתם לא רואים את אפליקציית Chat ברשימת התוצאות, ודאו שכללתם את חשבון Google Workspace בהגדרות החשיפה של הדף Chat API Configuration ב-Google API Console.
בצ'אט אישי החדש עם האפליקציה, כותבים Hello ולוחצים על enter. אפליקציית הצ'אט לניהול פרויקטים מגיבה עם תפריט עזרה שמפרט את הפעולות שהיא יכולה לבצע.
כדי ליצור סיפור, מקלידים /createUserStory Test story בסרגל ההודעות ושולחים אותו. אפליקציית הצ'אט לניהול פרויקטים מגיבה בהודעה עם כרטיס שמפרט את סיפור המשתמש שהיא יוצרת בשבילכם באמצעות AI גנרטיבי מ-Vertex AI.
במסוף ה-API, בודקים את מסד הנתונים של Firestore כדי לראות את הרשומות שנוצרו לגבי המרחב שהוספתם אליו את אפליקציית הצ'אט, המשתמשים שהיו איתה באינטראקציה ואת סיפור המשתמש שיצרתם.

כניסה אל Firestore
חוזרים ל-Google Chat.

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

פתרון בעיות

כשמוחזרת שגיאה מאפליקציית Google Chat או מכרטיס, מוצגת בממשק של Chat ההודעה "משהו השתבש". או 'לא הצלחנו לעבד את הבקשה שלך'. לפעמים בממשק המשתמש של Chat לא מוצגת הודעת שגיאה, אבל אפליקציית Chat או הכרטיס יוצרים תוצאה לא צפויה. לדוגמה, יכול להיות שהודעה בכרטיס לא תופיע.

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

הסרת המשאבים

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

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

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

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

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

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

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

מטרות

המוצרים שהשתמשו בהם

ארכיטקטורה

הכנת הסביבה

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

Google API Console

‫CLI של gcloud

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

Google API Console

‫CLI של gcloud

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

Google API Console

‫CLI של gcloud

אימות והרשאה

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

יצירת מסד הנתונים ב-Firestore

הצגת הגדרות של אוסף, מסמך ושדה

spaces

userStories

users

Google API Console

‫CLI של gcloud

בדיקת קוד לדוגמה

יצירה ופריסה של הפונקציה של Cloud Functions

Google API Console

‫CLI של gcloud

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

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

פתרון בעיות

הסרת המשאבים

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

ניהול פרויקטים באמצעות Google Chat, Vertex AI ו-Firestore

`spaces`

`userStories`

`users`