בקרת גישה באמצעות IAM

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

אפשר להגדיר גישה באמצעות מסוףGoogle Cloud עם ניהול זהויות והרשאות גישה (IAM). משתמשים במסוף Google Cloud כדי להעניק תפקידי IAM לחשבונות משתמשים. במדריך לתחילת העבודה עם IAM מוסבר איך מוסיפים, עורכים ומסירים הרשאות.

כדי לגשת להגדרות, פותחים את הדף IAM במסוף Google Cloud .

הוספת משתמש או חשבון שירות לפרויקט

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

הוספת גורם מרכזי

כדי להוסיף חשבון ראשי:

1. לוחצים על בראש הדף.
2. מזינים את כתובת האימייל של החשבון הראשי.
3. בוחרים תפקיד.
4. לוחצים על Save.

שינוי הרשאות

כדי לשנות את ההרשאות:

1. לוחצים על ליד שם הגורם המורשה.
2. בוחרים תפקיד אחר.
3. לוחצים על Save.

הסרת חשבון ראשי

כדי להסיר חשבון ראשי, לוחצים על ליד החשבון הראשי.

תפקידי IAM

התפקידים הבאים זמינים לגישה ל-CX Agent Studio.

אדמין של Gemini Enterprise for Customer Experience‏ (ces.googleapis.com/admin)

ההרשאה הזו מספקת גישה מלאה למשאבים.

תפקידים בסיסיים:

• ces.googleapis.com/viewer
• ces.googleapis.com/client
• contactcenterinsights.googleapis.com/admin

הרשאות נוספות:

• ces.googleapis.com/operations.delete
• ces.googleapis.com/operations.cancel
• ces.googleapis.com/apps.create
• ces.googleapis.com/apps.update
• ces.googleapis.com/apps.delete
• ces.googleapis.com/apps.import
• ces.googleapis.com/apps.export
• ces.googleapis.com/apps.runEvaluation
• ces.googleapis.com/agents.create
• ces.googleapis.com/agents.update
• ces.googleapis.com/agents.updateCallbacks
• ces.googleapis.com/agents.updateInstructions
• ces.googleapis.com/agents.updateTools
• ces.googleapis.com/agents.updateGeneral
• ces.googleapis.com/agents.delete
• ces.googleapis.com/examples.create
• ces.googleapis.com/examples.update
• ces.googleapis.com/examples.delete
• ces.googleapis.com/tools.create
• ces.googleapis.com/tools.update
• ces.googleapis.com/tools.delete
• ces.googleapis.com/guardrails.create
• ces.googleapis.com/guardrails.update
• ces.googleapis.com/guardrails.delete
• ces.googleapis.com/toolsets.create
• ces.googleapis.com/toolsets.update
• ces.googleapis.com/toolsets.delete
• ces.googleapis.com/deployments.create
• ces.googleapis.com/deployments.update
• ces.googleapis.com/deployments.delete
• ces.googleapis.com/conversations.delete
• ces.googleapis.com/evaluations.create
• ces.googleapis.com/evaluations.update
• ces.googleapis.com/evaluations.delete
• ces.googleapis.com/evaluationResults.delete
• ces.googleapis.com/evaluationDatasets.create
• ces.googleapis.com/evaluationDatasets.update
• ces.googleapis.com/evaluationDatasets.delete
• ces.googleapis.com/evaluationRuns.delete
• ces.googleapis.com/scheduledEvaluationRuns.create
• ces.googleapis.com/scheduledEvaluationRuns.update
• ces.googleapis.com/scheduledEvaluationRuns.delete
• ces.googleapis.com/appVersions.create
• ces.googleapis.com/appVersions.delete
• ces.googleapis.com/appVersions.restore
• ces.googleapis.com/omnichannels.create
• ces.googleapis.com/omnichannels.update
• ces.googleapis.com/omnichannels.delete
• ces.googleapis.com/apps.createTagBinding
• ces.googleapis.com/apps.deleteTagBinding
• ces.googleapis.com/apps.listTagBindings
• ces.googleapis.com/apps.listEffectiveTags
• ces.googleapis.com/assistantSessions.create
• ces.googleapis.com/routes.create
• ces.googleapis.com/routes.update
• ces.googleapis.com/routes.delete
• ces.googleapis.com/endpointConfigs.create
• ces.googleapis.com/endpointConfigs.update
• ces.googleapis.com/endpointConfigs.delete
• ces.googleapis.com/sipDomains.create
• ces.googleapis.com/sipDomains.update
• ces.googleapis.com/sipDomains.delete
• ces.googleapis.com/securitySettings.update

‫Gemini Enterprise for Customer Experience Viewer ‏ (ces.googleapis.com/viewer)

ההרשאה הזו מאפשרת גישה לקריאה בלבד למשאבים.

תפקידים בסיסיים:

• contactcenterinsights.googleapis.com/viewer

הרשאות נוספות:

• cloudresourcemanager.googleapis.com/projects.get
• cloudresourcemanager.googleapis.com/projects.list
• ces.googleapis.com/operations.list
• ces.googleapis.com/operations.get
• ces.googleapis.com/locations.list
• ces.googleapis.com/locations.get
• ces.googleapis.com/apps.list
• ces.googleapis.com/apps.get
• ces.googleapis.com/agents.list
• ces.googleapis.com/agents.get
• ces.googleapis.com/examples.list
• ces.googleapis.com/examples.get
• ces.googleapis.com/tools.list
• ces.googleapis.com/tools.get
• ces.googleapis.com/guardrails.list
• ces.googleapis.com/guardrails.get
• ces.googleapis.com/toolsets.list
• ces.googleapis.com/toolsets.get
• ces.googleapis.com/deployments.list
• ces.googleapis.com/deployments.get
• ces.googleapis.com/conversations.list
• ces.googleapis.com/conversations.get
• ces.googleapis.com/appVersions.list
• ces.googleapis.com/appVersions.get
• ces.googleapis.com/evaluations.list
• ces.googleapis.com/evaluations.get
• ces.googleapis.com/evaluationResults.list
• ces.googleapis.com/evaluationResults.get
• ces.googleapis.com/evaluationDatasets.list
• ces.googleapis.com/evaluationDatasets.get
• ces.googleapis.com/evaluationRuns.list
• ces.googleapis.com/evaluationRuns.get
• ces.googleapis.com/scheduledEvaluationRuns.list
• ces.googleapis.com/scheduledEvaluationRuns.get
• ces.googleapis.com/changelogs.list
• ces.googleapis.com/changelogs.get
• ces.googleapis.com/omnichannels.get
• ces.googleapis.com/omnichannels.list
• ces.googleapis.com/apps.listTagBindings
• ces.googleapis.com/apps.listEffectiveTags
• ces.googleapis.com/assistantSessions.list
• ces.googleapis.com/assistantSessions.get
• ces.googleapis.com/routes.list
• ces.googleapis.com/routes.get
• ces.googleapis.com/endpointConfigs.list
• ces.googleapis.com/endpointConfigs.get
• ces.googleapis.com/sipDomains.list
• ces.googleapis.com/sipDomains.get
• ces.googleapis.com/securitySettings.get

‫Gemini Enterprise for Customer Experience Client ‏ (ces.googleapis.com/client)

כך הסוכנים יכולים לגשת לשאילתות.

הרשאות:

• ces.googleapis.com/sessions.runSession
• ces.googleapis.com/sessions.bidiRunSession
• ces.googleapis.com/tools.execute

עורך האפליקציות של Gemini Enterprise for Customer Experience‏ (ces.googleapis.com/appEditor)

שליטה מלאה בהגדרות ברמת האפליקציה. ניהול של רישום גלובלי ביומן, הגדרות של אודיו/קול, מאגרי אחסון וגרסאות של אפליקציות.

תפקידים בסיסיים:

• ces.googleapis.com/viewer

הרשאות נוספות:

• ces.googleapis.com/apps.create
• ces.googleapis.com/apps.update
• ces.googleapis.com/apps.delete
• ces.googleapis.com/apps.import
• ces.googleapis.com/apps.export
• ces.googleapis.com/apps.runEvaluation
• ces.googleapis.com/apps.createTagBinding
• ces.googleapis.com/apps.deleteTagBinding
• ces.googleapis.com/appVersions.create
• ces.googleapis.com/appVersions.delete
• ces.googleapis.com/appVersions.restore

עריכה ב-Gemini Enterprise for Customer Experience Agent Editor‏ (ces.googleapis.com/agentEditor)

שליטה מלאה במבנים, בתהליכים, בהוראות ובשיחות החוזרות של צומתי ה-Agent. יכולים להוסיף כלים לסוכנים או להסיר אותם (אבל לא ליצור כלים חדשים).

תפקידים בסיסיים:

• ces.googleapis.com/viewer
• ces.googleapis.com/client

הרשאות נוספות:

• ces.googleapis.com/agents.create
• ces.googleapis.com/agents.update
• ces.googleapis.com/agents.updateCallbacks
• ces.googleapis.com/agents.updateInstructions
• ces.googleapis.com/agents.updateTools
• ces.googleapis.com/agents.updateGeneral
• ces.googleapis.com/agents.delete
• ces.googleapis.com/examples.create
• ces.googleapis.com/examples.update
• ces.googleapis.com/examples.delete

עריכה ב-Gemini Enterprise for Customer Experience Tools (ces.googleapis.com/toolsEditor)

שליטה מלאה בכלים, בערכות הכלים ובשילובים.

תפקידים בסיסיים:

• ces.googleapis.com/viewer
• ces.googleapis.com/client

הרשאות נוספות:

• ces.googleapis.com/tools.create
• ces.googleapis.com/tools.update
• ces.googleapis.com/tools.delete
• ces.googleapis.com/toolsets.create
• ces.googleapis.com/toolsets.update
• ces.googleapis.com/toolsets.delete

כלי העריכה של אמצעי הבקרה של Gemini Enterprise for Customer Experience‏ (ces.googleapis.com/guardrailsEditor)

שליטה מלאה בהגדרות הבטיחות ובאמצעי ההגנה.

תפקידים בסיסיים:

- ces.googleapis.com/viewer
- ces.googleapis.com/client

הרשאות נוספות:

- ces.googleapis.com/guardrails.create
- ces.googleapis.com/guardrails.update
- ces.googleapis.com/guardrails.delete

עורך ההערכות של Gemini Enterprise for Customer Experience‏ (ces.googleapis.com/evalsEditor)

שליטה מלאה במערכי נתונים, בהרצות ובתוצאות של הערכות.

תפקידים בסיסיים:

• ces.googleapis.com/viewer
• ces.googleapis.com/client

הרשאות נוספות:

• ces.googleapis.com/evaluations.create
• ces.googleapis.com/evaluations.update
• ces.googleapis.com/evaluations.delete
• ces.googleapis.com/evaluationResults.delete
• ces.googleapis.com/evaluationDatasets.create
• ces.googleapis.com/evaluationDatasets.update
• ces.googleapis.com/evaluationDatasets.delete
• ces.googleapis.com/evaluationRuns.delete
• ces.googleapis.com/scheduledEvaluationRuns.create
• ces.googleapis.com/scheduledEvaluationRuns.update
• ces.googleapis.com/scheduledEvaluationRuns.delete

עורך הגדרות האבטחה של Gemini Enterprise for Customer Experience‏ (ces.googleapis.com/securitySettingsEditor)

שליטה מלאה בהגדרות האבטחה ברמת הפרויקט.

תפקידים בסיסיים:

• ces.googleapis.com/viewer

הרשאות נוספות:

• ces.googleapis.com/securitySettings.update

עריכה ב-Gemini Enterprise for Customer Experience Deployment Editor (ces.googleapis.com/deploymentEditor)

אפשרות לנהל סביבות ולפרוס בהן גרסאות ספציפיות של אפליקציות.

תפקידים בסיסיים:

• ces.googleapis.com/viewer

הרשאות נוספות:

• ces.googleapis.com/deployments.create
• ces.googleapis.com/deployments.update
• ces.googleapis.com/deployments.delete

תובנות לגבי חוויית הלקוח

‫CX Agent Studio משולב עם CX Insights, ולכן צריך להעניק את ההרשאות הבאות ב-CX Insights לגורמים שמקבלים גישה ל-CX Agent Studio:

• contactcenterinsights.googleapis.com/conversations.get
• contactcenterinsights.googleapis.com/conversations.list

ההרשאות האלה נכללות באופן אוטומטי בתפקידי הצאצא של ces.googleapis.com/admin ו-ces.googleapis.com/viewer. עם זאת, אם אתם מגדירים תפקידים בהתאמה אישית, הקפידו לכלול את ההרשאות האלה בהגדרות של התפקידים בהתאמה אישית.

לחלופין, אתם יכולים להעניק לאנשים הרלוונטיים אחד מהתפקידים הבאים ב-CX Insights:

• ‫contactcenterinsights.googleapis.com/viewer: גישת קריאה בלבד לשיחות
• contactcenterinsights.googleapis.com/admin: נותן גישה מלאה לשיחות

בנוסף לתפקידים, יכול להיות שתצטרכו לבצע את השלבים של הגדרת מנוע Discovery.

בקשות שכוללות גישה ל-Cloud Storage

חלק מהבקשות של CX Agent Studio הן בקשות גישה לאובייקטים ב-Cloud Storage לצורך קריאה או כתיבה של נתונים. כשמתקשרים לאחת מהבקשות האלה, CX Agent Studio ניגש לנתוני Cloud Storage בשם המתקשר. כלומר, לאימות הבקשה שלכם צריכות להיות הרשאות גישה ל-CX Agent Studio ולאובייקטים ב-Cloud Storage.

אם אתם משתמשים בספריית לקוחות של Google ובתפקידי IAM, תוכלו לקרוא מידע על תפקידים ב-Cloud Storage במדריך לבקרת גישה ב-Cloud Storage.

כשמטמיעים לקוח משלכם ומשתמשים ב-OAuth, צריך להשתמש בהיקף ההרשאות הבא של OAuth:

• https://www.googleapis.com/auth/cloud-platform (גישה לכל משאבי הפרויקט)

הוספת תנאי להגבלת הגישה לאפליקציית סוכן אחת

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

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

resource.name == "projects/PROJECT_ID" ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/apps/APP_ID") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/operations") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/sipDomains") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/omnichannels") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/dataStores") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/routes") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/endpointConfigs")

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