קניית מינויים והקצאת רישיונות ל-Gemini Enterprise

בדף הזה מוסבר איך להירשם ל-Gemini Enterprise ואיך לנהל את רישיונות המשתמשים.

הגדרת הגישה כוללת בדרך כלל את השלבים הבאים:

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

מידע על רישיונות

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

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

• רישיונות שמוקצים באופן אוטומטי: אתם יכולים להגדיר שרישיונות שכלולים במינוי יוקצו באופן אוטומטי למשתמש בפעם הראשונה שהוא ניגש ל-Gemini Enterprise או לממשק של Gemini Notebook Enterprise.

הערה: הרישיונות ספציפיים לפרויקט ולמיקום. Google Cloud לדוגמה, אם משתמשים צריכים גישה לאפליקציית Gemini Enterprise שנמצאת בפרויקט Google Cloud שנמצא גם בארה"ב וגם באזורים גלובליים מרובים, צריך שני רישיונות נפרדים לשני המיקומים הנפרדים האלה באותו פרויקט Google Cloud .

מידע על מינויים

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

ב-Gemini Enterprise, אפשר לקנות מינוי חודשי או מינוי לשנה. אפשר להגדיר את המינויים האלה לחידוש אוטומטי.

מידע על מצבי מינוי

מינוי יכול להיות באחד מהסטטוסים הבאים:

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

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

לפני שמתחילים בתהליכים שמתוארים בדף הזה, צריך לוודא שמתקיימים התנאים המוקדמים הבאים:

• צריך להשלים את כל המשימות שמפורטות במאמר בנושא הגדרת Gemini Enterprise. למשל:

  • הגדרת חשבון לחיוב עבור הפרויקט.
  • הקצאת לפחות את התפקיד Gemini Enterprise User לכל המשתמשים שרוצים לתת להם רישיון לשימוש ב-Gemini Enterprise.

• מוודאים שיש לכם את התפקידים וההרשאות הנדרשים ב-IAM:

  • תפקיד אדמין של Gemini Enterprise.

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

    • Billing Account Administrator (roles/billing.admin)
    • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

    לחלופין, כדי לקבל שליטה מפורטת ב-IAM, אפשר להשתמש בתפקיד בהתאמה אישית עם ההרשאות הבאות במקום בתפקיד Billing Account Administrator:

    שירות	הרשאות
    Discovery Engine	discoveryengine.billingAccountLicenseConfigs.distribute discoveryengine.billingAccountLicenseConfigs.get discoveryengine.billingAccountLicenseConfigs.list discoveryengine.billingAccountLicenseConfigs.retract discoveryengine.licenseConfigs.create discoveryengine.licenseConfigs.get discoveryengine.licenseConfigs.list discoveryengine.licenseConfigs.update discoveryengine.projects.get discoveryengine.projects.provision discoveryengine.projects.reportConsentChange discoveryengine.userStores.batchUpdateUserLicenses discoveryengine.userStores.listUserLicenses
    רכש צרכני	consumerprocurement.orders.get consumerprocurement.licensePools.assign consumerprocurement.licensePools.unassign consumerprocurement.licensePools.enumerateLicensedUsers
    מנהל המשאבים	resourcemanager.projects.get resourcemanager.projects.list
    Service Usage	serviceusage.services.get serviceusage.services.list

הרשמה למינוי

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

כדי לרכוש מינוי ל-Gemini Enterprise:

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

   ‫Gemini Enterprise

2. לוחצים על ניהול מינויים > יצירת מינוי.

3. במהדורה שרוצים להירשם אליה, לוחצים על הרשמה.

4. מגדירים את פרטי החיוב:

   1. בוחרים את החשבון לחיוב מהתפריט הנפתח.

   2. מזינים שם מינוי.

   3. מזינים את מספר הרישיונות שדרושים למהדורה.

5. בוחרים את תקופת המינוי.

6. אם רוצים שהמינוי יתחדש אוטומטית, בוחרים באפשרות חידוש אוטומטי של המינוי.

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

   1. בתפריט הנפתח Select a project, בוחרים את הפרויקט.

   2. בוחרים Location type למינוי. אם אין צורך לשמור את הנתונים בארצות הברית או באחת ממדינות האיחוד האירופי כדי לעמוד בדרישות של הוראות דין או חוקים, Google ממליצה לבחור במרחב הגלובלי הרב-אזורי כדי להשיג זמינות מקסימלית וזמן אחזור נמוך.

8. לוחצים על יצירה > אישור.

ניהול מינויים

בקטע הזה מוסבר איך לצפות במינויים ל-Gemini Enterprise, לעדכן אותם, להפיץ אותם ולבטל אותם.

צפייה בפרטי המינויים

כדי לראות את פרטי המינויים שלכם ל-Gemini Enterprise:

המסוף

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

   ‫Gemini Enterprise

2. לוחצים על ניהול המינויים.

3. בוחרים את החשבון לחיוב מהתפריט הנפתח.

4. בטבלה Gemini Subscriptions (מינויים ל-Gemini), לוחצים על שם המינוי.

REST

כדי לקבל את פרטי המינוי, מריצים את הפקודה הבאה:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

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

• ‫PROJECT_NUMBER: מספר הפרויקט שבו יש לכם את התפקיד Service Usage Consumer
• ‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.

פלט לדוגמה

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

עדכון הגדרות המינוי

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

הדרך להוסיף עוד רישיונות משתנה בהתאם לדרך שבה רכשתם את המינוי:

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

אם רכשתם רישיון דרך מסוףGoogle Cloud , כך מעדכנים אותו:

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

   ‫Gemini Enterprise

2. לוחצים על ניהול המינויים.

3. לוחצים על המינוי שרוצים לעדכן בטבלה Gemini Subscriptions (מינויי Gemini).

4. לוחצים על עריכה לצד פרטי המינוי.

5. מעדכנים את מספר הרישיונות או מפעילים או משביתים את החידוש האוטומטי.

6. לוחצים על שליחה.

הפצת רישיונות

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

הערה: מינוי ל-Gemini Enterprise Standard או ל-Plus מעניק גם גישה לתכונות של Gemini Code Assist Standard בסביבות פיתוח משולבות (IDE) נתמכות. צריך להקצות את הרישיונות האלה בנפרד בדפי האדמין של Gemini Code Assist. צריך לפעול לפי ההוראות במאמר הגדרת Gemini Code Assist.

היכולת הזו לא נכללת ברמות Business או Frontline. מידע נוסף על התכונות שנכללות בכל רמה זמין במאמר השוואה בין מהדורות Gemini Enterprise.

המסוף

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

   ‫Gemini Enterprise

2. לוחצים על ניהול המינויים.

3. בוחרים את החשבון לחיוב מהתפריט הנפתח.

4. בטבלה Gemini Subscriptions (מינויים ל-Gemini), לוחצים על שם המינוי.

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

6. כדי להפיץ רישיונות לפרויקט:

   1. לוחצים על רשימת הפרויקטים ובוחרים פרויקט. הבורר תומך בהשלמה אוטומטית.
   2. הערה: אם Discovery Engine API מושבת בפרויקט שנבחר, תופיע תיבת דו-שיח עם בקשה להפעיל אותו.
   3. בוחרים מיקום.
   4. מזינים את מספר הרישיונות להקצאה.
   5. אם רוצים להקצות רישיונות לכמה פרויקטים או מיקומים, חוזרים על השלבים האלה.

7. לוחצים על שליחה.

8. בתיבת הדו-שיח לאישור, בודקים את סיכום השינויים ולוחצים כדי לאשר.

REST

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

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

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

• ‫PROJECT_NUMBER: מספר הפרויקט שבו יש לכם את התפקיד Service Usage Consumer
• ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור מרובה בארה"ב
  • ‫eu לאזור עם מספר אזורים באיחוד האירופי
  • global למיקום הגלובלי
  מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
• ‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu
• ‫TARGET_PROJECT_NUMBER: מספר הפרויקט שאליו רוצים להקצות רישיונות
• ‫LICENSE_COUNT: מספר הרישיונות להפצה.
• ‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.
• ‫BILLING_ACCOUNT_LICENSE_CONFIG_ID: מאתרים את מזהה תצורת הרישיון של החשבון לחיוב בפרטי המינוי

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

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

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

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

המסוף

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

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

   ‫Gemini Enterprise

2. לוחצים על ניהול המינויים.

3. בוחרים את החשבון לחיוב מהתפריט הנפתח.

4. בטבלה Gemini Subscriptions (מינויים ל-Gemini), לוחצים על שם המינוי.

5. לוחצים על הפצת רישיון בחלק העליון של הדף (הלחצן הזה פותח את טופס הניהול של כל ההקצאות).

6. ברשימת ההקצאות, מאתרים את השורה של הפרויקט והמיקום שרוצים לבטל את ההקצאה של הרישיונות שלהם.

7. בוחרים אחת מהפעולות הבאות:

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

8. לוחצים על שליחה.

9. בתיבת הדו-שיח לאישור, בודקים את סיכום השינויים (שבו יפורטו כל הרישיונות שבוטלו) ולוחצים כדי לאשר.

REST

הערה: אפשר לבצע את הפעולה הזו רק פעם ביום.

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

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

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

• ‫PROJECT_NUMBER: מספר הפרויקט שבו יש לכם את התפקיד Service Usage Consumer
• ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור מרובה בארה"ב
  • ‫eu לאזור עם מספר אזורים באיחוד האירופי
  • global למיקום הגלובלי
  מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
• ‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu
• ‫TARGET_PROJECT_NUMBER: מספר הפרויקט שממנו רוצים לבטל את ההקצאה של הרישיונות
• ‫LICENSE_COUNT: מספר הרישיונות שרוצים לבטל.
• ‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.
• ‫BILLING_ACCOUNT_LICENSE_CONFIG_ID: מאתרים את מזהה תצורת הרישיון של החשבון לחיוב בפרטי המינוי
• ‫LICENSE_CONFIG_ID: מזהה הגדרת הרישיון של הגדרת רישיון קיימת ברמת הפרויקט

טיפול בסיום מוקדם

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

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

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

בתמונה הבאה מוצגת דוגמה להשבתת רישיון בGoogle Cloud מסוף:

באפשרותך לנהל את רישיונות המשתמשים

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

הצגת רישיונות

כדי לראות את הרישיונות ואת המשתמשים שהוקצו להם:

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

   ‫Gemini Enterprise

2. לוחצים על ניהול משתמשים.

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

הקצה רישיונות למשתמשים

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

הוספת משתמשים והקצאת רישיונות באופן אוטומטי

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

הערה: חשוב לוודא שיש במינוי מספיק רישיונות למספר המקסימלי של משתמשים שצפויים להשתמש ב-Gemini Enterprise.

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

   ‫Gemini Enterprise

2. לוחצים על ניהול משתמשים.

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

4. בוחרים באפשרות הקצאת רישיונות באופן אוטומטי ואז בוחרים את המינוי.

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

   מידע נוסף על מינויים זמין בקטע מידע על מינויים.

הוספת משתמשים והקצאת רישיונות באופן ידני

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

המסוף

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

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

   ‫Gemini Enterprise

2. לוחצים על ניהול משתמשים.

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

4. לוחצים על הוספת משתמשים.

5. בדף הוספת משתמשים:

   1. מזינים את כתובות האימייל של המשתמשים. חשוב להשתמש באותה כתובת אימייל שבה הם ישתמשו כדי להיכנס לאפליקציית Gemini Enterprise.

   2. בוחרים את המינוי שרוצים להקצות למשתמשים.

   3. לוחצים על שליחה.

REST

כדי להקצות רישיונות למשתמשים באופן ידני, מריצים את הפקודה הבאה:

מונח חשוב: ב-Gemini Enterprise, אפשר להשתמש במונח אפליקציה לסירוגין עם המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask":{
         "paths":[
            "userPrincipal",
            "licenseConfig"
         ]
      }
   },
   "deleteUnassignedUserLicenses":false
  }'

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור מרובה בארה"ב
  • ‫eu לאזור עם מספר אזורים באיחוד האירופי
  • global למיקום הגלובלי
  מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
• ‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu
• ‫USER_EMAIL: כתובת האימייל של המשתמש שרוצים להוסיף לרישיון.
• ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
• ‫SUBSCRIPTION_ID: המזהה של המינוי ל-Gemini Enterprise.

העברת רישיונות ממינויים שתוקפם פג

המשתמשים לא יכולים להיכנס ל-Gemini Enterprise אם המינוי פג. יש כמה דרכים להחזיר להם את הגישה לחשבון:

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

• העברה ידנית של משתמשים קיימים למינוי חדש.

הערה: אם בעבר נחסמה הגישה של משתמש לרישיון, הגישה ל-Gemini Enterprise תינתן תוך 30 דקות אחרי הקצאת הרישיון החדש.

העברה אוטומטית של משתמשים למינוי פעיל

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

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

   רישיון ל-Gemini Enterprise

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

3. מוודאים שיש לכם מינוי פעיל. אם אין לכם מינוי, אפשר לרכוש מינוי.

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

5. בוחרים באפשרות עדכון אוטומטי של רישיון שתוקפו פג.

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

העברה ידנית של משתמשים למינוי פעיל

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

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

   רישיון ל-Gemini Enterprise

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

3. מוודאים שיש לכם מינוי פעיל. אם אין לכם מינוי, אפשר לרכוש מינוי.

4. בוחרים את המשתמשים ולוחצים על הקצאת רישיון אחר.

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

רשימת הרישיונות

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

מונח חשוב: ב-Gemini Enterprise, אפשר להשתמש במונח אפליקציה לסירוגין עם המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור מרובה בארה"ב
  • ‫eu לאזור עם מספר אזורים באיחוד האירופי
  • global למיקום הגלובלי
  מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
• ‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu

הסרת משתמשים מרישיון

אפשר להסיר רישיון ממשתמש בכל שלב. כשמסירים רישיון, המשתמש מאבד מיד את הגישה ל-Gemini Enterprise. כדי להסיר משתמשים מרישיון:

המסוף

כדי להסיר משתמשים מרישיון באמצעות מסוף Google Cloud :

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

   רישיון ל-Gemini Enterprise

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

3. בטבלת המשתמשים, בוחרים את המשתמשים.

4. כדי להסיר משתמשים מרישיון, בוחרים באחת מהאפשרויות הבאות:

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

5. לוחצים על אישור.

REST

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

מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש לסירוגין עם המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask":{
         "paths":[
            "userPrincipal",
            "licenseConfig"
         ]
      }
   },
   "deleteUnassignedUserLicenses":true
  }'

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
  • ‫us לאזור מרובה בארה"ב
  • ‫eu לאזור עם מספר אזורים באיחוד האירופי
  • global למיקום הגלובלי
  מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
• ‫LOCATION: האזור הגיאוגרפי המורכב של מאגר הנתונים: global, ‏ us או eu
• USER_EMAIL: כתובת האימייל של המשתמש שרוצים להסיר מהרישיון.

צפייה בשימוש במכסה המשותפת (גרסת טרום-השקה ציבורית)

תצוגה מקדימה

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

סקירה כללית של מכסות משותפות ב-Gemini Enterprise

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

לדוגמה, בטבלה הבאה אפשר לראות איך מכסת יצירת התמונות משותפת במהדורת Gemini Enterprise Plus:

סוג המכסה	מכסה לכל רישיון	דוגמה לסך הכול (ל-100 רישיונות)
יצירת תמונות	‫10 תמונות ביום	‫1,000 תמונות ביום

כל משתמש בפרויקט יכול להשתמש במכסה המשותפת הזו.

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

אפשר לראות את מרכז הבקרה לשימוש במכסה רק אם מתקיימים התנאים הבאים:

• אתם אדמינים של Gemini Enterprise.
• יש לכם לפחות מינוי פעיל אחד ל-Gemini Enterprise, מתוך Gemini Enterprise Standard, ‏ Gemini Enterprise Plus או Gemini Enterprise Frontline.

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

• המיכסות של Gemini Enterprise Plus כוללות את המיכסות של Agentspace Enterprise Plus
• המיכסות של Gemini Enterprise Standard כוללות את המיכסות של Agentspace Enterprise
• המכסות של Gemini Enterprise Frontline כוללות את המכסות של Agentspace Frontline Worker

אם יש לכם רק מינוי ל-AgentSpace ואין לכם מינוי פעיל ל-Gemini Enterprise, לא תוכלו לראות את לוח הבקרה של השימוש במכסה.

הצגת לוח הבקרה של השימוש במכסה

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

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

   רישיון ל-Gemini Enterprise

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

3. לוחצים על הצגת נפח האחסון שנוצל מתוך המכסה.

4. בחלונית Gemini Enterprise Quota Usage שנפתחת, בוחרים את מהדורת המוצר מהרשימה Subscription tier.

   לוח הבקרה מאכלס את המכסות ומציג את השימוש המוחלט ואת השימוש באחוזים בכל מכסה.

המאמרים הבאים

• שאלות נפוצות על רישיונות ל-Gemini Enterprise
• מידע על תפקידים והרשאות ב-IAM