בקרת גישה

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

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

יש מצבים שבהם צריך להשתמש במסוף Google Cloud :

  • התפקיד Project Owner ב-IAM מוקצה כברירת מחדל למשתמש שיצר את הפרויקט שבבעלותו הסוכן. לבעלים הזה יש גישה מלאה לכל הנציגים בפרויקט. כדי לשנות את ה-Project Owner של הפרויקט, צריך להשתמש במסוף Google Cloud .
  • אפשר להגדיר רק גישה ברמת הנציג דרך מסוף Dialogflow CX. כדי להגדיר גישה ברמת הפרויקט, צריך להשתמש במסוף Google Cloud .
  • לחלק מהתפקידים ב-IAM יש תפקידים תואמים של סוכני Dialogflow CX. אם אתם רוצים להקצות תפקיד ברמת הפרויקט או ברמת הנציג שלא קיים במסוף Dialogflow CX, אתם צריכים להשתמש במסוף Google Cloud .
  • אם אתם יוצרים סוכן של מאגר נתונים באמצעות ממשק המשתמש של Vertex AI Agents, אתם צריכים להשתמש במסוף Google Cloud .

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

שליטה בגישה באמצעות מסוף כלי ליצירת סוכנים בממשק שיחה

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

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

תפקיד סוכן ה-CX ב-Dialogflow CX סיכום תפקיד ב-IAM
קורא שיחות נותן גישת קריאה כדי לשלוח שאילתות לסוכן (לא לזהות כוונה) מהמסוף או מה-API. ‫Dialogflow‏ > Dialogflow API Reader
אדמין בממשק שיחה גישה מלאה ליצירה, עדכון, שליחת שאילתות, זיהוי כוונה ומחיקה של הנציג מהמסוף או מה-API. ‫Dialogflow > Dialogflow API Admin
לקוח בממשק שיחה מאפשרת גישה לזיהוי כוונה מהמסוף או מה-API. ‫Dialogflow > לקוח Dialogflow API
סוכן שירות סוכני שירות סוכני שירות
עורך Flow מאפשרת גישה לעדכון, לשליחת שאילתות לגבי תהליך ספציפי וליצירה, לעדכון, למחיקה או לשליחת שאילתות לגבי משאבי התהליך (דפים, קבוצות של מסלולים וגרסאות) מהמסוף או מה-API. ‫Dialogflow > עורך התהליכים ב-Dialogflow
עורך הסביבה מאפשרת לעדכן סביבה ספציפית ולשלוח אליה שאילתות, וגם ליצור, לעדכן, למחוק או לשלוח שאילתות לגבי משאבי הסביבה (ניסויים) מהמסוף או מה-API. ‫Dialogflow > עריכת סביבות ב-Dialogflow
אדמין של סוג הישות מאפשרת ליצור, לעדכן, למחוק או לשלוח שאילתות לגבי סוגי הישויות של נציג מהמסוף או מה-API. ‫Dialogflow‏ > אדמין של סוגי ישויות ב-Dialogflow
אדמין של Intent מאפשרת ליצור, לעדכן, למחוק או לשלוח שאילתות לגבי כוונות המשתמש של נציג מהמסוף או מה-API. ‫Dialogflow > מנהל כוונות ב-Dialogflow
אדמין של מקרי בדיקה מאפשרת ליצור, לעדכן, למחוק או לשלוח שאילתות לגבי מקרי הבדיקה של נציג מהמסוף או מה-API. ‫Dialogflow > אדמין של מקרי בדיקה ב-Dialogflow
אדמין של תגובה לפעולה מאתר אחר (webhook) מאפשרת ליצור, לעדכן, למחוק או לשלוח שאילתות ל-webhooks של נציג מהמסוף או מה-API. ‫Dialogflow > אדמין של Dialogflow Webhook

אפשרויות השיתוף נמצאות בהגדרות של הנציג. כדי לפתוח את הגדרות השיתוף של הסוכן:

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על Agent Settings.
  5. לוחצים על הכרטיסייה שיתוף.

הוספת חשבון משתמש

  1. לוחצים על הוספה.
  2. מזינים את כתובת האימייל של המשתמש, הקבוצה או חשבון השירות.
  3. בוחרים את סוג האימייל: משתמש, קבוצה או חשבון שירות.
  4. התפקיד קורא ב-Dialogflow נוסף כברירת מחדל, והוא נדרש כדי שהמשתמשים יוכלו לגשת למסוף של "סוכנים בממשק שיחה".
  5. בקטע הקצאת תפקידים, לוחצים על הוספת תפקיד.
  6. בקטע סוג, בוחרים סוג תפקיד.
  7. בתפקידים עריכת תהליכים ועריכת סביבות, בוחרים תהליכים או סביבות ספציפיים או משאירים את אפשרות ברירת המחדל הכול.
  8. אם רוצים, מגדירים את תאריך התפוגה של התפקיד.
  9. לוחצים על Save.

שינוי התפקידים של חשבונות משתמשים

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

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

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

שליטה בגישה באמצעות מסוף Google Cloud

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

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

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

כדי להוסיף חשבון משתמש:

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

שינוי הרשאות

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

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

  1. לוחצים על כפתור המחיקה של חשבון המשתמש.

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

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

לדוגמה:

{
    "expression": "resource.name.startsWith(\"projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID\")",
    "title": "For Dialogflow CX Agent AGENT_ID"
}

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

כדי להוסיף את התנאי הזה לתפקיד שניתן לחשבון ראשי:

  1. בוחרים חשבון ראשי.
  2. לוחצים על לחצן העריכה של חשבון המשתמש.
  3. לוחצים על הוספת תנאי.
  4. בשדה Title, מזינים את הערך For Dialogflow CX Agent AGENT_ID ומחליפים את AGENT_ID במזהה הנציג.
  5. אפשר להוסיף כל תיאור שרוצים.
  6. בוחרים באפשרות עורך התנאים כדי ליצור את התנאי.
  7. מוסיפים את הביטוי resource.name.startsWith("projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID"), ומחליפים את AGENT_ID במזהה הנציג ואת PROJECT_ID במזהה הפרויקט.
  8. לוחצים על Save.

תפקידי IAM

בטבלה הבאה מפורטים תפקידי IAM נפוצים שרלוונטיים ל-Dialogflow CX. בסיכומי ההרשאות בטבלה נעשה שימוש במונחים הבאים:

  • גישה מלאה: הרשאה לשנות את הגישה, ליצור, למחוק, לערוך ולקרוא כל משאב.
  • גישת עריכה: הרשאה ליצור, למחוק, לערוך ולקרוא כל משאב.
  • גישה לסשן: הרשאה להפעיל שיטות למשאבים בזמן ריצה בלבד במהלך שיחה, כמו זיהוי כוונה, עדכון הקשר, עדכון ישויות של סשן או אינטראקציות בשיחה של Agent Assist.
  • גישת קריאה: הרשאה לקרוא כל משאב.
תפקיד IAM סיכום ההרשאות פרטי ההרשאות
פרויקט >
בעלים		 מקצים לבעלי פרויקטים שצריכים גישה מלאה לכל המשאבים של Google Cloud ו-Dialogflow CX:
  • גישה מלאה לכל Google Cloud משאבי הפרויקט באמצעות Google Cloud המסוף או ממשקי ה-API.
  • גישה מלאה לסוכנים באמצעות מסוף "סוכנים בממשק שיחה".
  • יכול לזהות כוונה באמצעות API.
 הגדרות של תפקידים בסיסיים ב-IAM
פרויקט >
עריכה		 מקצים לעורכי פרויקטים שצריכים גישת עריכה לכל המשאבים של Google Cloud ו-Dialogflow CX:
  • עריכת הגישה לכל המשאבים של הפרויקט Google Cloud באמצעות מסוף Google Cloud או ממשקי API.
  • עורכים את גישת העריכה לסוכנים באמצעות מסוף כלי ליצירת סוכנים בממשק שיחה.
  • יכול לזהות כוונה באמצעות API.
 הגדרות של תפקידים בסיסיים ב-IAM
Project >
Viewer		 מקצים לצופים בפרויקט שצריכים גישת קריאה לכל המשאבים של Google Cloud ו-Dialogflow CX:
  • גישת קריאה לכל Google Cloud משאבי הפרויקט של באמצעות Google Cloud מסוף או ממשקי API.
  • גישת קריאה לסוכנים בממשק שיחה באמצעות מסוף כלי ליצירת סוכנים בממשק שיחה או ה-API, לא יכולים להשתמש בסימולטור.
  • לא ניתן לזהות את הכוונה באמצעות ה-API.
 הגדרות של תפקידים בסיסיים ב-IAM
פרויקט >
אדמין IAM		 צריך להקצות את התפקיד לאדמינים של IAM בפרויקט שצריכים גישת עריכה להגדרת התפקידים של סוכני Dialogflow CX. הגדרות התפקידים של מנהל המשאבים ב-IAM
פרויקט >
דפדפן		 כדי לתת למשתמשים גישה לקריאה בלבד, כדי שהם יוכלו לעיין בהיררכיה של הפרויקט, כולל התיקייה, הארגון ומדיניות ה-IAM:
  • גישת קריאה להיררכיית הפרויקטים של Google Cloud .
  • אין גישה לסוכנים באמצעות מסוף כלי ליצירת סוכנים בממשק שיחה.
  • לא ניתן לזהות את הכוונה באמצעות ה-API.
 הגדרות של תפקידים בפרויקט ב-IAM
‫Dialogflow >
Dialogflow API Admin		 צריך להקצות לאדמינים של Dialogflow CX API שזקוקים לגישה מלאה למשאבים ספציפיים של Dialogflow CX:
  • גישה מלאה לכל המשאבים של Dialogflow CX באמצעות מסוף Google Cloud או ממשקי API.
  • גישה מלאה לסוכנים באמצעות מסוף "סוכנים בממשק שיחה".
  • יכול לזהות כוונה באמצעות API.
 הגדרות של תפקידי IAM ב-Dialogflow
‫Dialogflow >
לקוח Dialogflow API		 יש להעניק ללקוחות API של Dialogflow CX שמבצעים קריאות לזיהוי כוונה באמצעות ה-API:
  • גישה לסשן של משאבי Dialogflow CX בזמן ריצה באמצעות סימולטור או API של Dialogflow CX.
  • גישה מוגבלת לסוכנים באמצעות מסוף כלי ליצירת סוכנים בממשק שיחה.
  • יכול לזהות כוונה באמצעות API.
 הגדרות של תפקידי IAM ב-Dialogflow
‫Dialogflow >
עורך הסוכנים במסוף כלי ליצירת סוכנים בממשק שיחה		 הקצאה לעורכים במסוף של "סוכנים בממשק שיחה" שעורכים סוכנים קיימים:
  • גישה מלאה לכל המשאבים של Dialogflow CX באמצעות מסוף Google Cloud .
  • לערוך את הגישה לרוב נתוני הסוכן באמצעות מסוף Conversational Agents.
  • יכול לזהות כוונה באמצעות API.
 הגדרות של תפקידי IAM ב-Dialogflow
‫Dialogflow >
Dialogflow API Reader		 צריך להקצות ללקוחות Dialogflow API שמבצעים קריאות לקריאה בלבד שספציפיות ל-Dialogflow CX באמצעות ה-API:
  • גישת קריאה לכל המשאבים של Dialogflow CX באמצעות מסוף Google Cloud או ממשקי API.
  • גישת קריאה לסוכנים בממשק שיחה באמצעות מסוף כלי ליצירת סוכנים בממשק שיחה, לא ניתן להשתמש בסימולטור.
  • לא ניתן לזהות את הכוונה באמצעות ה-API.
 הגדרות של תפקידי IAM ב-Dialogflow
אדמין ב-Discovery Engine יש להקצות למשתמשים שיוצרים סוכני AI של מאגרי נתונים באמצעות ממשק המשתמש של Vertex AI Agents. למידע נוסף, קראו את ההגדרות של תפקידי IAM ב-Discovery Engine.

OAuth

אם אתם משתמשים בספריות הלקוח של Google כדי לגשת ל-Dialogflow CX, אתם לא צריכים להשתמש ב-OAuth באופן ישיר, כי הספריות האלה מטפלות בהטמעה בשבילכם. עם זאת, אם אתם מטמיעים לקוח משלכם, יכול להיות שתצטרכו להטמיע תהליך OAuth משלכם. כדי לגשת ל-Dialogflow CX API, צריך אחד מהיקפי ההרשאות הבאים של OAuth:

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

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

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

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

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

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

תפקידים בהתאמה אישית לגישה לכלי הפלייבוק

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

כדי לראות את רשימת ההרשאות הזמינות, אפשר להשתמש בכלי לחיפוש הרשאות ולחפש את dialogflow.tools.

באמצעות ההרשאות האלה, אתם יכולים ליצור תפקידים בהתאמה אישית.

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