שיתוף סוכנים ממסוף Google Cloud

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

הערה: כדי לשתף סוכנים שנוצרו על ידי עובדים, צריך ליצור סוכן אחד או יותר באמצעות Workflow Builder באפליקציית האינטרנט של Gemini Enterprise. מידע נוסף על יצירת סוכנים באמצעות Workflow Builder זמין במאמר יצירת סוכן באמצעות Workflow Builder.

לפני שמתחילים

כדי לשתף נציג, אתם צריכים לעמוד בדרישות הבאות:

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

2. כדי לשתף סוכנים בהתאמה אישית, אתם צריכים לרשום או להוסיף אותם ל-Gemini Enterprise באחת מהדרכים הבאות:

   • רישום וניהול של סוכני A2A
   • רישום וניהול של סוכני ADK שמתארחים ב-Agent Runtime ב-Gemini Enterprise Agent Platform
   • הוספה וניהול של סוכני A2A מ-Google Cloud Marketplace
   • רישום וניהול של נציגי Dialogflow

שיתוף סוכן

כדי לשתף נציג:

המסוף

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

אל Gemini Enterprise

1. בוחרים את הפרויקט הרצוי.

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

3. בתפריט הניווט, לוחצים על נציגים.

4. לוחצים על השם המוצג של הנציג שרוצים לשתף.

5. לוחצים על הכרטיסייה הרשאת משתמש כדי לפתוח את הדף Permissioned users.

6. לוחצים על הוספת משתמש. תיבת הדו-שיח Add user permissions roles to agent נפתחת.

7. מגדירים את פרטי ההרשאה:

   1. בקטע Member type, בוחרים אחת מהאפשרויות הבאות:

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

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

      • ‫Principal: זהות אחת במאגר הזהויות של כוח העבודה (principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID).

      • מאגר הזהויות של כוח העבודה: קבוצה של מאגר כוח עבודה, מאפיין מותאם אישית או כל המשתמשים במאגר הזהויות של כוח העבודה (principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/...).

      • כל המשתמשים: כל המשתמשים בארגון.

      סוגי החברים שמוצגים תלויים בספק הזהויות שבו האפליקציה משתמשת. באפליקציות שמשתמשות ב-Google Identity, מוצגים סוגי החברים User ו-Group. באפליקציות שמשתמשות באיחוד שירותי אימות הזהות של כוח העבודה, מוצגים במקום זאת סוגי החברים חשבון משתמש ומאגר זהויות של כוח עבודה.

      טיפ: אם אתם משתמשים באיחוד שירותי אימות הזהות של כוח העבודה עם ספק זהויות של צד שלישי, כמו Microsoft Entra ID או Okta, הגדירו הקצאת הרשאות של System for Cross-domain Identity Management ‏(SCIM) למאגר הזהויות של כוח העבודה. אחרי שמגדירים את SCIM, תיבות הדו-שיח Add user ו-Transfer ownership משלימות באופן אוטומטי את המשתמשים והקבוצות, וממלאות את הערכים המדויקים של SUBJECT_ID ו-GROUP_ID (תלוי אותיות רישיות). כדי להשתמש בהשלמה אוטומטית שמבוססת על SCIM, צריך מאגר ייעודי של זהויות כוח עבודה לכל פרויקט ב- Google Cloud , ומיפוי המאפיינים של SCIM צריך להפיק את אותו נושא כמו המיפוי של google.subject במאגר. משתמשים וקבוצות מופיעים בהשלמה האוטומטית רק אחרי שספק הזהויות הקצה אותם דרך SCIM. מידע נוסף זמין במאמרים הגדרת איחוד שירותי אימות הזהות של כוח עבודה ודוגמאות למיפויים לעקביות בנושא.

   2. מזינים את המזהה הייחודי של החבר ובוחרים תפקיד:

      סוג החברות	תיאור
      משתמש	מזינים כתובות אימייל בשדה חבר. בוחרים תפקיד בשדה הקצאת תפקיד.
      קבוצה	מזינים כתובות אימייל בשדה חבר. בוחרים תפקיד בשדה הקצאת תפקיד.
      חשבון משתמש	בשדה Member, מזינים את המזהה של החשבון הראשי עם הנושא היחיד (//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID או principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID). בוחרים תפקיד בשדה הקצאת תפקיד.
      מאגר הזהויות של כוח העבודה	בשדה Member, מזינים את המזהה של קבוצת החשבונות הראשיים (//iam.googleapis.com/locations/global/workforcePools/POOL_ID/... או principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/...). בוחרים תפקיד בשדה הקצאת תפקיד. דוגמאות לקבוצות של חשבונות משתמשים מופיעות במאמר קבוצות של חשבונות משתמשים.
      כל המשתמשים	בוחרים תפקיד בשדה הקצאת תפקיד.

8. לוחצים על Save.

קבוצות של חשבונות משתמשים

הדוגמאות הבאות הן של מזהי חשבונות ראשיים וקבוצות של חשבונות ראשיים שאפשר לציין כשמשתפים עם משתמשים וקבוצות של איחוד שירותי אימות הזהות של כוח עבודה. אם הקצאת ה-SCIM מוגדרת למאגר הזהויות של כוח העבודה, תיבת הדו-שיח Add user מציעה משתמשים וקבוצות בזמן ההקלדה וממלאת את המזהים האלה בשבילכם. אחרת, צריך להזין אותם בדיוק כמו שהם מוצגים, כולל אותיות רישיות וקטנות של SUBJECT_ID:

חשבון משתמש או קבוצת חשבונות משתמשים	תיאור
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	זהות יחידה במאגר זהויות של כוח עבודה (בוחרים את סוג החבר Principal).
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	כל הזהויות של כוח העבודה בקבוצה (בוחרים את סוג החבר מאגר הזהויות של כוח העבודה).
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	כל הזהויות של כוח העבודה עם ערך מאפיין ספציפי (בוחרים את סוג החבר Workforce Identity Pool).
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	כל הזהויות במאגר זהויות של כוח עבודה (בוחרים את סוג החבר Workforce Identity Pool).

מחליפים את ה-placeholders הבאים בערכים בדוגמת הקוד:

• ‫GROUP_ID: מזהה קבוצה ספציפי מספק זהויות (IdP) חיצוני, שמאפשר לתת גישה לכל חברי הקבוצה.
• ‫POOL_ID: המזהה הייחודי של מאגר הזהויות של כוח העבודה שאתם יוצרים ב- Google Cloud.
• ‫SUBJECT_ID: המזהה הייחודי של הנושא (google.subject) לזהות אחת במאגר הזהויות של כוח העבודה. הערך של SUBJECT_ID תלוי אותיות רישיות (case-sensitive) וחייב להיות זהה לאותיות הרישיות שספק הזהויות שלכם קבע (לדוגמה, בטענת הנכוֹנוּת (assertion) של SAML או באסימון OIDC).
• ‫ATTRIBUTE_NAME: שם בהגדרת המשתמש של מאפיין בהתאמה אישית שמיפיתם מספק זהויות (IdP) חיצוני.
• ‫ATTRIBUTE_VALUE: הערך הספציפי של ATTRIBUTE_NAME שמשמש להגבלת הגישה.

הערה: כדי לתת גישה למשתמש יחיד באיחוד שירותי אימות הזהות של כוח עבודה, במקום לקבוצה או למאגר, בוחרים באפשרות Principal בתור סוג החבר ומשתמשים בפורמט של נושא יחיד principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID (או משמיטים את הקידומת principal: במסוף Google Cloud ). חשוב לוודא שהערך של SUBJECT_ID (google.subject) תואם בדיוק לאותיות הרישיות שספק הזהויות שלכם קבע.

העברת הבעלות על הנציג

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

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

שיקולים ומגבלות

לפני שמעבירים את הבעלות על הנציג, חשוב לשים לב לשיקולים ולמגבלות הבאים:

• הרשאת אדמין: רק אדמינים עם התפקיד אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) או התפקיד אדמין ב-Discovery Engine (roles/discoveryengine.admin) יכולים להעביר בעלות על סוכנים. הבעלים הנוכחי של הנציג לא יכול להעביר את הבעלות, אלא אם הוא גם אדמין.
• נציגים משותפים בלבד: אפשר להעביר בעלות רק על נציגים שכבר משותפים. בעמודה Sharing של הנציג בדף Agents במסוף Google Cloud , צריך להופיע הערך Enabled. אי אפשר להעביר סוכנים פרטיים (שלא משותפים).
• בעלים יחיד: לכל נציג יש בעלים אחד בלבד. אחרי העברת הבעלות, הנמען שנבחר הופך לבעלים היחיד של הנציג.
• גישה של הבעלים הקודמים: כשהבעלות מועברת, הבעלים הקודמים מורדים בדרגה למשתמשים בנציג עם התפקיד agentUser. הם עדיין יכולים לשלוח שאילתות לסוכן ולהפעיל אותו, אבל לא יכולים לערוך את ההגדרות שלו.
• סוגי הסוכנים הנתמכים: אפשר להעביר בעלות על סוכנים שנוצרו על ידי עובדים (סוכנים עם תכנות מינימלי וסוכנים של תהליכי עבודה שנוצרו באפליקציית האינטרנט).
• סוכנים עם לוחות זמנים או טריגרים: אם לסוכן שהועבר יש טריגר של לוח זמנים או טריגר של אירוע, פעולת ההעברה מסמנת אותם כלוחות זמנים או אירועים מושבתים. כדי להשתמש בסוכן, הבעלים החדשים צריכים להפעיל את לוח הזמנים או את הטריגר של האירוע.

העברת בעלות על נציג

כדי להעביר בעלות על נציג, פועלים לפי השלבים הבאים:

המסוף

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   אל Gemini Enterprise

2. בוחרים את הפרויקט הרצוי.

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

4. בתפריט הניווט, לוחצים על נציגים.

5. לוחצים על השם המוצג של הנציג המשותף.

6. לוחצים על הכרטיסייה הרשאות משתמש. הרשימה Permissioned users מוצגת.

7. לחץ על העבר בעלות. תיבת הדו-שיח העברת בעלות נפתחת.

8. בקטע העברת הבעלות אל, בוחרים אחת מהאפשרויות הבאות:

   • Myself: העברת הבעלות על הנציג לחשבון האדמין הנוכחי שלכם. האפשרות הזו מושבתת אם אתם כבר הבעלים של הסוכן.
   • משתמש אחר: העברת הבעלות למשתמש אחר בארגון.

9. אם בחרתם באפשרות משתמש אחר, ציינו את הבעלים החדשים:

   • Google Identity ו-Cloud Identity: מזינים את כתובת האימייל של המשתמש בשדה כתובת האימייל של הבעלים החדש (לדוגמה, [e-mail]).
   • חשבונות של איחוד שירותי אימות הזהות של כוח העבודה (WIF): בשדה New owner principal, מזינים את מזהה החשבון של הבעלים החדש:

   //iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   אפשר גם לכלול את הקידומת principal::

   principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫POOL_ID: המזהה הייחודי של מאגר הזהויות של כוח העבודה.
   • SUBJECT_ID: מזהה הנושא של המשתמש במאגר הזהויות של כוח העבודה.
   הערה: המזהים של חשבונות המשתמשים באיחוד שירותי אימות הזהות של כוח העבודה הם תלויי אותיות רישיות. חשוב לוודא שהמזהה תואם בדיוק לאותיות הרישיות שהוגדרו במיפוי google.subject של ספק הזהויות. אם הקצאת SCIM מוגדרת למאגר הזהויות של כוח העבודה, השדה New owner principal מציע משתמשים בזמן ההקלדה וממלא את המזהה בשבילכם. מידע נוסף זמין במאמר הגדרת איחוד שירותי אימות הזהות של כוח עבודה.

10. לחץ על העבר בעלות.

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

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