דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

מטרות

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

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

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

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

כדי ליצור, לעבד ולארח אירועי אינטראקציה, Cloud Functions משתמש במוצרים הבאים של Google Cloud:
- Cloud Build: פלטפורמה מנוהלת לניהול רציף (continuous delivery), להעברה ולפריסה, שמריצה גרסאות 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 סינכרונית לנקודת הקצה (endpoint) של HTTP של הפונקציה של Cloud Functions.
אפליקציית Google Chat לניהול הפרויקט מעבדת את בקשת ה-HTTP:
1. Vertex AI עוזר לכתוב או לעדכן סיפור משתמש.
2. מסד נתונים ב-Firestore מאחסן, מאחזר, מעדכן או מוחק נתונים של סיפורי משתמשים.
Cloud Functions מחזיר תגובה מסוג HTTP ל-Chat, שמציג אותה למשתמש כהודעה או כתיבת תיגר.

מכינים את הסביבה

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

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

מסוף Google Cloud

במסוף Google Cloud, עוברים לתפריט > IAM & Admin > Create a Project.
כניסה לדף Create a Project
בשדה Project Name (שם הפרויקט), מזינים שם תיאורי לפרויקט.
אופציונלי: כדי לערוך את מזהה הפרויקט, לוחצים על Edit. אי אפשר לשנות את מזהה הפרויקט אחרי היצירה שלו, לכן חשוב לבחור מזהה שיעמוד בצרכים שלכם לכל משך חיי הפרויקט.
בשדה 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
Local Shell: כדי להשתמש בסביבת פיתוח מקומית, מתקינים ומאתחלים את ה-CLI של gcloud.
כדי ליצור פרויקט ב-Cloud, משתמשים בפקודה gcloud projects create:
```
gcloud projects create PROJECT_ID
```
מחליפים את PROJECT_ID על ידי הגדרת המזהה של הפרויקט שרוצים ליצור.

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

מסוף Google Cloud

נכנסים לדף Billing במסוף Google Cloud. לוחצים על תפריט > חיוב > My Projects.
לדף 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 הוא מזהה הפרויקט של הפרויקט ב-Cloud שרוצים להפעיל בו חיוב.
- BILLING_ACCOUNT_ID הוא מזהה החשבון לחיוב שרוצים לקשר לפרויקט ב-Google Cloud.

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

מסוף Google Cloud

במסוף Google Cloud, מפעילים את Google Chat API, את Vertex AI API, את Cloud Functions API, את Firestore API, את Cloud Build API, את Pub/Sub API ואת Cloud Run Admin API.

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

CLI של gcloud

אם צריך, מגדירים את הפרויקט הנוכחי ב-Cloud כפרויקט שיצרתם באמצעות הפקודה gcloud config set project:
```
gcloud config set project PROJECT_ID
```
מחליפים את PROJECT_ID ב-Project ID של הפרויקט ב-Cloud שיצרתם.
מפעילים את 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 API הם דרישות מוקדמות ל-Cloud Functions.

אימות והרשאה

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

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

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

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

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

יצירת מסד הנתונים של Firestore

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

במסד הנתונים של אפליקציית Chat לניהול פרויקטים נעשה שימוש במודל נתונים של 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 Cloud

נכנסים לדף Firestore במסוף Google Cloud. לוחצים על תפריט > Firestore.

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

CLI של gcloud

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

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

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

הצגת הקוד ב-GitHub

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

env.js: משתני תצורת סביבה לפריסה של אפליקציית Chat בפרויקט ובאזור מסוימים ב-Google Cloud. צריך לעדכן את משתני התצורה בקובץ הזה.
package.json וגם package-lock.json: הגדרות ויחסי תלות של פרויקט ב-Node.js.
index.js: נקודת הכניסה של Cloud Function של אפליקציית Chat. היא קוראת את האירוע ב-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: טיפול בפעולות במסד הנתונים. הפונקציות בקובץ הזה נקראות על ידי services/space-service.js,‏ services/user-service.js ו-services/user-story-service.js.
services/aip-service.js: קורא ל-Vertex AI API לחיזוי טקסט של בינה מלאכותית גנרטיבית.
model/*.js: הקבצים האלו מכילים את ההגדרה של מחלקות וטיפוסים שבהם משתמשים שירותי האפליקציות כדי לאחסן ולהעביר נתונים בין פונקציות. הם מגדירים את מודל הנתונים למסד הנתונים של Firestore.
views/*.js: כל קובץ בספרייה הזו יוצר אובייקט כרטיס שאפליקציית Chat שולחת חזרה ל-Chat בתור הודעת כרטיס או תגובה לפעולה דיאלוגית.
views/widgets/*.js: כל קובץ יוצר מופע של סוג של אובייקט ווידג'ט, שבו האפליקציה משתמשת כדי ליצור את הכרטיסים בספרייה views/.
test/**/*.test.js: כל קובץ בספרייה הזו ובספריות המשנה שלה מכיל את בדיקות היחידות של הפונקציה, הבקר, השירות, התצוגה או הווידג'ט התואמים. כדי להריץ את כל בדיקות היחידה, מריצים את npm run test בספריית הבסיס של הפרויקט.

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

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

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

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

מסוף Google Cloud

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

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

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

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

כניסה אל Cloud Functions

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

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

CLI של gcloud

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

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

עוברים לספרייה שמכילה את הקוד של אפליקציית Chat לניהול פרויקטים:
```
cd google-chat-samples/node/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 Cloud

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

במסוף Google Cloud, לוחצים על תפריט > מוצרים נוספים > Google Workspace > ספריית מוצרים > Google Chat API > ניהול > הגדרות אישיות.

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

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

בקטע SlashCommand, לוחצים על Add a לוכסן הפקודה.

בכל פקודה של הלוכסן שמפורט בטבלה הבאה, מזינים את השדות Name, Command ID ו-Description, ובוחרים אם הפקודה Opens a invoice ולוחצים על Done:

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

בקטע Visibility (חשיפה), בוחרים באפשרות Make this Chat app available to specific people and groups in your Workspace domain (האפליקציה תהיה זמינה לאנשים ולקבוצות ספציפיים בדומיין של Workspace) ומזינים את כתובת האימייל.
לחלופין, בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.
לוחצים על שמירה. תוצג הודעה על שמירת ההגדרות, והמשמעות היא שאפליקציית Chat מוכנה לבדיקה.

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

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

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

כניסה ל-Google Chat
לוחצים על צ'אט חדש.
בשדה Add 1 or more people, מקלידים את שם אפליקציית Chat.
בוחרים את אפליקציית Chat בתוצאות. תיפתח צ'אט אישי.

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

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

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

פתרון בעיות

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

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

הסרת המשאבים

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

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

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

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

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

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

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

מטרות

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

ארכיטקטורה

מכינים את הסביבה

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

מסוף Google Cloud

CLI של gcloud

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

מסוף Google Cloud

CLI של gcloud

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

מסוף Google Cloud

CLI של gcloud

אימות והרשאה

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

יצירת מסד הנתונים של Firestore

הצגת הגדרות של אוספים, מסמכים ושדות

spaces

userStories

users

מסוף Google Cloud

CLI של gcloud

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

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

מסוף Google Cloud

CLI של gcloud

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

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

פתרון בעיות

הסרת המשאבים

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

`spaces`

`userStories`

`users`