במדריך הזה מפורטים כל השלבים להגדרה ולשימוש ב-CX Agent Studio. בנוסף, הוא כולל עצות לגבי שלבי ניקוי אפשריים אחרי שמנסים או בודקים את הנציג.
מידע על מסוף Google Cloud
מסוף Google Cloud (למשאבי העזרה, לפתיחת המסוף) הוא ממשק משתמש באינטרנט שבאמצעותו מקצים, מגדירים, מנהלים ומנטרים מערכות שמשתמשות במוצרי Google Cloud . בעזרת מסוף Google Cloud אפשר להגדיר ולנהל את המשאבים ב-CX Agent Studio.
יצירת פרויקט
כדי להשתמש בשירותי Google Cloud, אתם צריכים ליצור פרויקט. בפרויקט מאורגנים כל המשאבים שלכם ב- Google Cloud . כל פרויקט כולל קבוצה של שותפי עריכה, קבוצה של ממשקי API שמופעלים (וכן משאבים אחרים), כלי מעקב, פרטי חיוב ובקרת גישה לאימות. אתם יכולים ליצור פרויקט אחד או כמה פרויקטים, ולהשתמש בהם כדי לארגן את המשאבים ב- Google Cloud בהיררכיית משאבים. כשיוצרים פרויקט, חשוב לשים לב למזהה הפרויקט. המזהה הזה נדרש כדי לבצע קריאות ל-API. מידע נוסף על פרויקטים זמין במשאבי העזרה של מנהל המשאבים.
בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
התפקידים שנדרשים כדי לבחור או ליצור פרויקט
- בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
-
יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (
roles/resourcemanager.projectCreator), שכולל את ההרשאהresourcemanager.projects.create. איך מקצים תפקידים?
הפעלת החיוב
באמצעות החשבון לחיוב תוכלו לקבוע מי משלם על קבוצה מסוימת של משאבים, וכן לקשר את החשבון לפרויקט אחד או יותר. השימוש בפרויקט מחויב בחשבון שמקושר אליו. ברוב המקרים, מגדירים את החיוב בזמן שיוצרים פרויקט. מידע נוסף נמצא במשאבי העזרה בנושא חיוב.
מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .
הפעלת ה-API
צריך להפעיל בפרויקט את Gemini Enterprise for Customer Experience API. רוצים לדעת איך מפעילים או משביתים שירותים?
מפעילים את Gemini Enterprise for Customer Experience API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
צריך גם להפעיל את ה-API של Customer Experience Insights בפרויקט:
מפעילים את Contact Center AI Insights API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, אתם יכולים לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים
הפעלה של יומני ביקורת
מפעילים בפרויקט יומני ביקורת של גישה לנתונים ב-Gemini Enterprise for Customer Experience API. בנוסף לגרסאות, יומני הביקורת עוזרים לכם לעקוב אחרי שינויים בזמן התכנון באפליקציות של הסוכנים ב-CX Agent Studio שמשויכות לפרויקט.
התקנה והפעלה של Google Cloud CLI
אם אתם מתכוונים להשתמש ב-Gemini Enterprise for Customer Experience API, אתם צריכים להתקין ולהפעיל את Google Cloud CLI. ה-CLI של gcloud הוא קבוצת כלים שבעזרתם אפשר לנהל את המשאבים והאפליקציות שמתארחים ב- Google Cloud.
אתם יכולים להיעזר בהוראות שבקישורים האלה:
התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
gcloud initהגדרת אימות ובקרת גישה
אם אתם מתכוונים להשתמש ב-Gemini Enterprise for Customer Experience API, אתם צריכים להגדיר אימות. כל אפליקציית לקוח שמשתמשת ב-API צריכה לעבור אימות ולקבל גישה למשאבים הנדרשים. בקטע הזה מוסברים מושגים חשובים של אימות, ומפורטים השלבים להגדרת האימות. למידע נוסף, קראו את הסקירה הכללית על אימות ב-Google Cloud .
אימות באמצעות חשבונות משתמשים
חשבונות משתמשים הם אפשרות האימות הכי טובה כשאתם לומדים את Gemini Enterprise for Customer Experience API ולפיתוח מקומי. אתם יכולים להשתמש בחשבון המשתמש שלכם כדי לאמת הפעלות של שורת פקודה ב-REST או קריאות לספריית לקוח.
אימות של חשבון משתמש בשורת הפקודה של REST
כדי לאמת קריאות של שורת פקודה ב-REST, משתמשים ב-CLI של gcloud.
הפקודה gcloud auth login מחברת אתכם ל-gcloud באמצעות חשבון המשתמש שלכם, וצריך להריץ אותה לפני שקוראים ל-API.
הפקודה gcloud auth print-access-token משמשת לאימות קריאות ל-REST בכל הדוגמאות לשורת הפקודה של REST במסמכי התיעוד האלה.
כדי ליצור פרטי כניסה של משתמשים לסביבה המקומית:
gcloud auth login
אימות של חשבון משתמש בספריית לקוח
כדי לבצע אימות לקריאות של ספריית הלקוח, משתמשים ב-CLI של gcloud.
הפקודה gcloud auth application-default login מחברת אתכם ל-gcloud בשביל Application Default Credentials באמצעות חשבון המשתמש שלכם, וצריך להריץ אותה לפני ששולחים קריאה ל-API.
צריך להשתמש בפקודה gcloud auth application-default set-quota-project כדי להגדיר את הפרויקט לחיוב ולמכסות שקשורות לקריאות ל-API.
בדרך כלל, זהו אותו פרויקט שמשמש את הנציג, ואתם מספקים את מזהה הפרויקט שיצרתם בשלבים שלמעלה.
כדי שספריות הלקוח ישתמשו ב-Application Default Credentials, אסור להגדיר את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS.
כדי ליצור Application Default Credentials בסביבה המקומית:
gcloud auth application-default login gcloud auth application-default set-quota-project PROJECT_ID
אימות באמצעות חשבונות שירות
חשבונות שירות מספקים פרטי כניסה לאפליקציות, בניגוד למשתמשי קצה. חשבונות השירות הם בבעלות הפרויקטים, ובכל פרויקט אפשר ליצור הרבה חשבונות שירות. למידע נוסף:
בקרת גישה באמצעות תפקידים
כשחשבון משתמש (חשבון משתמש, חשבון שירות וכו') קורא ל-API, צריך לתת לחשבון המשתמש את ההרשאות המתאימות שנדרשות על ידי Google Cloud . כדי לתת הרשאות, צריך להקצות תפקידים לחשבון משתמש. מידע נוסף זמין בסקירה הכללית של התפקידים.
אם יצרתם את הפרויקט באמצעות חשבון המשתמש שלכם, לחשבון המשתמש יש את התפקיד הבסיסי "בעלים" בפרויקט. התפקיד הזה מאפשר גישה לקריאה לכל API בפרויקט. עם זאת, אם הפרויקט נוצר בחשבון אחר, יכול להיות שתצטרכו להקצות תפקידים לחשבון המשתמש שלכם כדי שתוכלו לשלוח קריאות ל-API.
התקנה של ספריית הלקוח של CX Agent Studio Agents
הוראות להורדה ולהתקנה של הספרייה מופיעות במאמר ספריות לקוח.
הסרת המשאבים
אחרי שמגדירים את CX Agent Studio ומנסים או בודקים אותו, יכול להיות שתרצו למחוק את המשאבים שיצרתם:
- יכול להיות שתרצו להשבית את הפרויקט.
-
אם הפעלתם את
gcloud auth login, פרטי הכניסה האלה מאוחסנים בספריית המשתמש במחשב שלכם. כדי למחוק את פרטי הכניסה האלה, אפשר להפעיל את הפונקציה:gcloud auth revoke
-
אם הפעלתם את
gcloud auth application-default login, פרטי הכניסה האלה מאוחסנים בספריית המשתמש במחשב שלכם. כדי למחוק את פרטי הכניסה האלה, אפשר להפעיל את הפונקציה:gcloud auth application-default revoke