1. מבוא
בשיעור ה-Codelab הזה אפשר למצוא הוראות ליצירת שירות סיכום ב-Slack Workspace, באמצעות שילוב עם Slack Slash Command.
המשתמש מפעיל פקודת לוכסן /summarize ומזין את הטקסט לסיכום. לאחר מכן, אפליקציית Slack מפעילה את הפונקציה של Cloud Functions המשויכת שמקבלת את הטקסט ומפעילה את PaLM API לסיכום. הטקסט המסכם מוחזר לפקודה Slack Slash ומוצג כתשובה באפליקציית Slack.
הקצר הזה. התשובות שלך יעזרו לנו להשתפר. רשימת שירותי Google Cloud שבשימוש היא:
- Cloud Functions
- Vertex AI PaLM API
- Cloud Logging
מה תפַתחו
היצירה שלך
- פונקציה של Cloud Functions שמפעילה את PaLM API לסיכום טקסט בטקסט שמגיע מ-Slack, באמצעות הפקודה slack
- אפליקציית Slack שמפעילה את הפונקציה של Cloud Functions שלמעלה לצורך סיכום.
2. דרישות
3. לפני שמתחילים
- במסוף Google Cloud, בדף בורר הפרויקטים, בוחרים או יוצרים פרויקט ב-Google Cloud.
- צריך לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. איך בודקים אם החיוב מופעל בפרויקט
- ודאו שCloud Functions API ו-Vertex AI APIs מופעלים.
- מפעילים את Cloud Shell ממסוף Google Cloud לפי ההוראות שמפורטות כאן.
- אם הפרויקט לא מוגדר, מגדירים אותו באמצעות הפקודה הבאה:
gcloud config set project <YOUR_PROJECT_ID>
- ב-Cloud Shell, מגדירים את משתני הסביבה הבאים:
export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1
4. פריסת הפונקציה של Cloud Functions
כדי ליצור ולפרוס את Cloud Functions, פועלים לפי השלבים הבאים:
- מריצים את הפקודה הבאה בטרמינל ב-Cloud Shell כדי לשכפל את הקוד מהמאגר https://github.com/rominirani/genai-apptemplates-googlecloud:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
- הפקודה הזו תשכפל את תוכן המאגר לתיקייה genai-templates-googlecloud.
- כדי להגיע לתיקייה של הפרויקט הרצוי, מריצים את הפקודה הבאה מהטרמינל של Cloud Shell:
cd genai-apptemplates-googlecloud/summarization-slack
- אתם אמורים לראות את הקבצים main.py ו-requirements.txt בתיקייה Summarymarization-slack, על ידי הרצת הפקודה dir או על ידי מעבר אל Cloud Shell Editor.
- כדי לפרוס את הפונקציה של Cloud Functions, מריצים את הפקודה gcloud functions deploy:
gcloud functions deploy summarizeText \
--gen2 \
--runtime=python311 \
--source=. \
--region=$GCP_REGION \
--project=$GCP_PROJECT \
--entry-point=summarizeText \
--trigger-http \
--set-env-vars=GCP_PROJECT=$GCP_PROJECT,GCP_REGION=$GCP_REGION \
--max-instances=1
אחרי שפורסים את הפונקציה של Cloud Functions, כתובת ה-URL של הפונקציה של Cloud Functions שנפרסה מוצגת בטרמינל של Cloud Shell. כתובת ה-URL בפורמט הבא:
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
שימו לב לכתובת ה-URL שהוצגה. היא נדרשת ליצירת הפקודה Slack Slash.
5. יצירת הפקודה Slack Lash
בואו ניצור פקודת לוכסן מותאמת אישית ב-Slack. הפקודה המותאמת אישית /summarize מפעילה את הפונקציה של Cloud Functions שפרסנו בקטע הקודם.
כדי ליצור פקודה באמצעות לוכסן, מבצעים את השלבים הבאים:
- נכנסים לכתובת api.slack.com/apps.
- לוחצים על Create New App (יצירת אפליקציה חדשה).
- בחלון יצירת אפליקציה, בוחרים באפשרות מאפס.
- נותנים לאפליקציה שם. לדוגמה,
Summarization Slack Application.בוחרים את סביבת העבודה ב-Slack לצורך פיתוח האפליקציה. - לוחצים על Create App. הדף הגדרות ייפתח.
- בדף Settings (הגדרות), לוחצים על Basic Information > (מידע בסיסי >) פקודות לוכסן. לוחצים על Create New Command.
- בטופס Create New Command, ממלאים את הערכים הבאים:
- Command: פקודה של שורת הפקודות. לדוגמה,
/summarize.. - Request URL: מזינים את כתובת ה-URL המלאה של הפונקציה של Cloud Functions שפרסנו. לדוגמה,
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText. - מזינים תיאור קצר, רמז לשימוש ושומרים.
- חוזרים אל הגדרות > מידע בסיסי. לוחצים על התקנת האפליקציה ואז על התקנה ב-Workspace. האפליקציה מותקנת בסביבת העבודה שלכם.
הושלמה היצירה של אפליקציית Slack בהתאמה אישית, שמותקנת עכשיו בסביבת העבודה ב-Slack עם פקודת Slash בהתאמה אישית (/summarize) שעוזרת למשתמשים לסכם את הטקסט שהוא מסר בהודעה.
6. בדיקת הפקודה לוכסן
- נכנסים לסביבת העבודה של Slack, שבה התקנתם את אפליקציית Summarization Slack:
נכנסים אל https://slack.com/intl/en-in/workspace-signin ומזינים את המילה 'חיפוש סביבות עבודה'. כדי לאתר את השם של סביבת העבודה. בוחרים באפשרות הזו.
- בצ'אט, אפשר להזין את הטקסט שלפניו מופיעה הפקודה "/summarize ". בהמשך מוצגת דוגמה להפעלה:
- לוחצים על הלחצן Send כדי להפעיל את הפונקציה של Cloud Functions ולהציג את תגובת הסיכום באופן הבא:
7. הסרת המשאבים
כדי לא לצבור חיובים לחשבון Google Cloud עבור המשאבים שבהם השתמשתם בפוסט הזה:
- במסוף Google Cloud, נכנסים לדף Manage resources:
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
- כדי לשמור את הפרויקט, מדלגים אל Cloud Functions ומוחקים את הפונקציה של Cloud Functions. ברשימת הפונקציות, מסמנים את הפונקציה שרוצים למחוק ולוחצים על DELETE.
8. מזל טוב
מעולה! יצרתם בהצלחה שירות סיכום טקסט באפליקציית Slack.