הגדרת Gemini Code Assist (Standard ו-Enterprise)

כדי שתוכלו להשתמש ב-Gemini Code Assist, הצוות שלכם צריך לבצע את שלבי ההגדרה שמפורטים במסמך הזה:

  1. רוכשים מינוי ל-Gemini Code Assist.

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

  3. מפעילים את Gemini for Google Cloud API בפרויקטים ב-Google Cloud.

  4. הקצאת תפקידים של ניהול זהויות והרשאות גישה בפרויקט ב-Google Cloud

  5. המשתמשים בארגון מתקינים את הפלאגין של Gemini Code Assist כדי להשתמש ב-Gemini Code Assist בסביבת פיתוח משולבת (IDE).

רכישת מינוי ל-Gemini Code Assist

רשימה של התכונות הזמינות בכל מהדורה מופיעה בקטע תכונות נתמכות.

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

המינוי ל-Gemini Code Assist Enterprise זמין במחיר של 19 $לחודש לכל משתמש, עם התחייבות ל-12 חודשים עד 31 במרץ 2025. פנו לצוות המכירות שלנו כדי ליהנות מהמבצע הזה.

אם יש לכם חוזים קיימים עם Google Cloud, פנו לצוות המכירות שלנו לפני רכישת המינוי.

  1. נכנסים לדף Gemini for Google Cloud.

    כניסה לדף Gemini for Google Cloud

    הדף Gemini for Google Cloud ייפתח.

  2. בוחרים באפשרות קבלת Gemini Code Assist. חשוב לזכור שאם לא רכשתם מינוי ל-Gemini Code Assist בחשבון לחיוב, תוצג ההודעה Eligible for 30 day trial for up to 50 licenses at no cost. אם כבר הוספתם את Gemini Code Assist לפרויקט, הטקסט הזה יוחלף באפשרות Manage Gemini Code Assist.

    הדף רכישת מינוי ל-Gemini Code Assist ייפתח.

  3. בקטע Select Gemini Code Assist subscription Edition בוחרים מהדורה של Gemini Code Assist. בוחרים באפשרות Compare Gemini Code Assist Editions כדי לראות רשימה מפורטת של התכונות הזמינות בכל מהדורה.

    לאחר מכן בוחרים באפשרות Continue (המשך).

  4. בקטע Configure subscription (הגדרת המינוי), ממלאים את השדות כדי להגדיר את המינוי, כולל את הפרטים הבאים:

    • שם המינוי.
    • מספר הרישיונות במינוי. שימו לב: אם אתם רוכשים את המהדורה Enterprise, עליכם לרכוש לפחות 10 רישיונות.
    • תקופת המינוי (חודשית או שנתית). במינוי שנתי, אתם מקבלים הנחה ותשלום חודשי במקום תשלום חד-פעמי.
    • חידוש אוטומטי של המינוי בסיום תקופת ההתחייבות (חודשית או שנתית). החידוש האוטומטי מבטיח שהמינוי והרישיונות יישארו פעילים. אם המינוי לא יתחדש באופן אוטומטי, הוא יסתיים בסיום התקופה הנוכחית, ותצטרכו לעבור שוב את תהליך הרכישה ולהקצות מחדש את הרישיונות.

  5. כדי לאשר את המינוי, בוחרים באפשרות המשך.

  6. אם אתם מסכימים לתנאים, בוחרים באפשרות I agree to the terms of this purchase ואז באפשרות Confirm subscription.

  7. בוחרים באפשרות השלב הבא: ניהול הקצאות רישיונות של Gemini.

המינוי נרכש עכשיו ל-Gemini Code Assist. עכשיו תצטרכו לנהל את הקצאות הרישיונות של Gemini בארגון.

הקצאת רישיונות

כדי להשתמש ב-Gemini Code Assist, כל משתמש בארגון צריך רישיון.

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

המסוף API

כדי להקצות רישיונות Gemini למשתמשים ספציפיים במסוף Google Cloud, צריך את ההרשאות הבאות:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. עוברים לדף ניהול ב-Gemini.

    כניסה לדף Gemini for Google Cloud

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

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

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

  5. בוחרים את שירותי Gemini שרוצים להקצות להם רישיונות.

  6. לוחצים על הקצאת רישיונות.

כדי להקצות רישיונות Gemini באמצעות ה-API, צריכה להיות לכם ההרשאה consumerprocurement.licensePools.assign.

שיטת HTTP: ‏ POST

כתובת אתר: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

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

  • BILLING_ACCOUNT_ID: מספר החשבון לחיוב
  • ORDER_ID: מדיניות IAM

גוף הבקשה:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

הפלט אמור להיראות כך:

{}

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

עכשיו צריך להפעיל את Gemini for Google Cloud API בפרויקט אחד או יותר שמשויך לחשבון לחיוב הזה. המשתמשים לא יראו את Gemini Code Assist עד שתפעילו אותו בפרויקט אחד לפחות.

הפעלת Gemini for Google Cloud API בפרויקט ב-Cloud

בקטע הזה מוסבר איך מפעילים את Gemini for Google Cloud API בפרויקט ב-Cloud.

המסוף gcloud

  1. כדי להפעיל את Gemini for Google Cloud API, נכנסים לדף Gemini for Google Cloud.

    כניסה לדף Gemini for Google Cloud

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

  3. לוחצים על Enable.

    הדף יתעדכן ויופיע הסטטוס Enabled. עכשיו Gemini זמין בפרויקט Cloud שנבחר לכל המשתמשים שיש להם את תפקידי ה-IAM הנדרשים.

כדי להשתמש בסביבת פיתוח מקומית, צריך להתקין ולהפעיל את ה-CLI של gcloud.

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

  2. מפעילים את Gemini for Google Cloud API באמצעות הפקודה הבאה של gcloud services enable: 

    gcloud services enable cloudaicompanion.googleapis.com

    אם רוצים להפעיל את Gemini for Google Cloud API בפרויקט אחר ב-Cloud, מוסיפים את הפרמטר --project:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט ב-Cloud.

    הפלט אמור להיראות כך:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Gemini for Google Cloud זמין עכשיו בפרויקט Cloud שצוין לכל המשתמשים שיש להם את תפקידי ה-IAM הנדרשים.

ממשקי API נדרשים למשתמשים מאחורי חומות אש

בנוסף להפעלת Gemini for Google Cloud, יכול להיות שמשתמשים מאחורי חומות אש יצטרכו להפעיל גם את ממשקי ה-API הבאים:

  • oauth2.googleapis.com: משמש לכניסה ל-Google Cloud.
  • serviceusage.googleapis.com: משמש לבדיקה שהפרויקט של המשתמש ב-Gemini Code Assist מוגדר בצורה נכונה.
  • cloudaicompanion.googleapis.com: נקודת הקצה הראשית של Gemini for Google Cloud API.
  • cloudcode-pa.googleapis.com: ממשק API פנימי שמספק תכונות שקשורות לסביבת הפיתוח המשולבת (IDE).
  • cloudresourcemanager.googleapis.com: משמש ב-IDE לבוררי פרויקטים. יכול להיות שלא תצטרכו את ה-API של מנהל המשאבים אם הפרויקטים מוגדרים במפורש בקובץ settings.json.
  • people.googleapis.com: גישה למידע על פרופילים ואנשי קשר.
  • firebaselogging-pa.googleapis.com: ממשק API פנימי המשמש לשליחת טלמטריה של מוצרים, כולל אירועים לגבי קבלת ההצעות.
  • feedback-pa.googleapis.com: ממשק API פנימי שמשמש לשליחת משוב בתוך סביבת הפיתוח המשולבת (IDE).
  • apihub.googleapis.com: הפונקציה משמשת את התכונה Cloud Code API Browser.

אופציונלי: הגדרת VPC Service Controls

אם לארגון שלכם יש תחום שירות, עליכם להוסיף את המשאבים הבאים לתחום:

  • Gemini for Google Cloud API
  • Gemini Code Assist API

אם אתם משתמשים ב-Gemini Code Assist מחוץ למתחם השירות שלכם, תצטרכו גם לשנות את מדיניות תעבורת הנתונים הנכנסת כדי לאפשר גישה לשירותים האלה.

למידע נוסף, קראו את המאמר הגדרת VPC Service Controls ל-Gemini.

איך מקצים תפקידי IAM בפרויקט ב-Google Cloud

בקטע הזה מוסבר איך מעניקים למשתמשים את תפקידי ה-IAM 'משתמש' ו'צרכן של נתוני שימוש בשירות' ב-Gemini for Google Cloud.

המסוף gcloud

  1. נכנסים לדף IAM & Admin כדי לתת את תפקידי IAM שנדרשים בשביל Gemini.

    כניסה לדף IAM & Admin

  2. בעמודה Principal, מחפשים את החשבון הראשי שרוצים לתת לו גישה ל-Gemini, ולוחצים על Edit principal בשורה הזו.

  3. בחלונית Edit access לוחצים על Add another role.

  4. ברשימת התפקידים Select a role בוחרים את Gemini for Google Cloud User.

  5. לוחצים על Add another role ובוחרים את התפקיד Service Usage Consumer.

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

כדי להשתמש בסביבת פיתוח מקומית, צריך להתקין ולהפעיל את ה-CLI של gcloud.

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

  2. מקצים את התפקיד Gemini for Google Cloud User:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user

    מחליפים את PRINCIPAL במזהה של החשבון הראשי. המזהה יכול להיות user|group|serviceAccount:email או domain:domain, לדוגמה: user:cloudysanfrancisco@gmail.com,‏ group:admins@example.com,‏ serviceAccount:test123@example.domain.com או domain:example.domain.com.

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

    - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

  3. מקצים את התפקיד 'צרכן השימוש בשירות':

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

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

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

למידע נוסף, ראו הקצאת תפקיד יחיד וגם gcloud projects add-iam-policy-binding.

לכל המשתמשים שקיבלו את התפקידים האלה תהיה גישה לתכונות של Gemini for Google Cloud במסוף Google Cloud בפרויקט שנבחר. למידע נוסף, תוכלו לקרוא את הסקירה הכללית על Gemini for Google Cloud.

התקנת הפלאגין של Gemini Code Assist בסביבת פיתוח משולבת (IDE)

המשתמשים בארגון מתקינים את Gemini Code Assist בסביבת הפיתוח המשולבת (IDE) המועדפת עליהם. למידע נוסף, קראו את המאמרים הבאים:

כברירת מחדל, Gemini Code Assist כלול בסביבות הפיתוח המשולבות הבאות:

משימות מתקדמות להגדרה

במקום להשתמש במסוף Google Cloud או ב-gcloud כדי לתת תפקידי IAM מוגדרים מראש, תוכלו לבצע את הפעולות הבאות:

  • לתת תפקידים באמצעות API בארכיטקטורת REST של IAM או ספריות לקוח של IAM.

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

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

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

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

    כדי שלתפקידים בהתאמה אישית שתיצרו תהיה גישה ל-Gemini Code Assist, צריך לתת להם את ההרשאות הבאות:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • הקצאה וניהול של רישיונות.

    כדי שלתפקידים בהתאמה אישית שתיצרו תהיה גישה ל-Gemini Code Assist, צריך לתת להם את ההרשאות הבאות:

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

חשוב לזכור שכל אחת מההרשאות הקודמות תהיה תקפה רק אם Gemini for Google Cloud API מופעל באותו פרויקט ב-Google Cloud שבו הקצית את כל ההרשאות.

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