שיתוף סוכנים ממסוף 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. לוחצים על הכרטיסייה הרשאות משתמש, ומוצג הדף משתמשים עם הרשאות.

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

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

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

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

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

      • חשבון משתמש: זהות יחידה בקבוצה של מאגר זהויות של כוח עבודה, שכוללת קבוצות חיצוניות שלא מנוהלות על ידי Google.

      • מאגר זהויות של כוח עבודה: כל הזהויות במאגר זהויות של כוח עבודה.

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

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

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

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

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

הדוגמאות הבאות מציגות קבוצות של ישויות שאפשר לציין עבור סוג החברים Workforce identity pool:

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

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

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

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

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

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

הערות ומגבלות

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

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

העברת בעלות על סוכן

כדי להעביר בעלות על סוכן, פועלים לפי השלבים הבאים:

המסוף

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

   עוברים אל Gemini Enterprise

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

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

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

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

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

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

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

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

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 של ספק הזהויות.

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

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

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