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

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

  1. קונים מינוי ל-Gemini Code Assist Standard או Enterprise.

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

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

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

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

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

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

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

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

  1. עוברים לדף Admin for Gemini.

    כניסה לדף 'ניהול Gemini'

    ייפתח הדף אדמין ל-Gemini.

  2. בוחרים באפשרות קבלת Gemini Code Assist.

    הערה: אם אין לכם את ההרשאה הנדרשת consumerprocurement.orders.place, הלחצן הזה מושבת. אם כבר קיים מינוי ל-Gemini Code Assist בחשבון לחיוב שמשויך לפרויקט, הלחצן הזה מוצג כManage Gemini Code Assist (ניהול Gemini Code Assist) ומאפשר לכם לערוך את המינוי.

    ייפתח הדף Get Gemini Code Assist subscription (קבלת מינוי ל-Gemini Code Assist).

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

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

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

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

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

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

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

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

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

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

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

המסוף

כדי להקצות רישיונות ל-Gemini למשתמשים פרטיים במסוף לממשקי API, אתם צריכים את ההרשאות הבאות בחשבון לחיוב:

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

  1. עוברים לדף Admin for Gemini.

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

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

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

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

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

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

API

כדי להקצות רישיונות ל-Gemini באמצעות ה-API, משתמשים ב-method‏ billingAccounts.orders.licensePool.assign.

  1. חשוב לוודא שיש לכם הרשאה לניהול זהויות והרשאות גישה (IAM) consumerprocurement.licensePools.assign בחשבון לחיוב שמכיל את מאגר הרישיונות שאתם רוצים להקצות.

  2. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    כאשר USER_EMAILS היא רשימה של חשבונות משתמשים המופרדים בפסיקים, שמוקצה להם הרישיון. לדוגמה, "dana@example.com", "lee@example.com".

  3. משתמשים ב-cURL כדי להפעיל את ה-method:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

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

    • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב 2.
    • ‫PROJECT_ID: המזהה של הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API חלים על הפרויקט הזה.
    • ‫BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ‫ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים את מזהה ההזמנה, אתם יכולים לראות את רשימת ההזמנות שמשויכות לחשבון לחיוב.

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

  {}

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

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

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

המסוף

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

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

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

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

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

gcloud

כדי להשתמש בסביבת פיתוח מקומית, צריך להתקין ולהפעיל את ה-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.

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

הגדרת חומת האש לתעבורת API בין סביבת הפיתוח המשולבת לבין Google

בנוסף להפעלת 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 לבחירת פרויקטים. יכול להיות שלא תצטרכו להשתמש ב-Resource Manager API אם הפרויקטים מוגדרים במפורש בקובץ settings.json.
  • ‫people.googleapis.com: מאפשר גישה למידע על פרופילים ואנשי קשר.
  • ‫firebaselogging-pa.googleapis.com: API פנימי שמשמש לשליחת טלמטריה של מוצרים, כולל אירועים שקשורים לשאלה אם הצעות התקבלו.
  • ‫feedback-pa.googleapis.com: API פנימי שמשמש לשליחת משוב ב-IDE.
  • ‫apihub.googleapis.com: משמש את התכונה 'דפדפן API' ב-Cloud Code.
  • ‫lh3.googleusercontent.com וlh5.googleusercontent.com: משמשים לקבלת תמונות של משתמשים.

איך קובעים כתובות IP לדומיינים שמוגדרים כברירת מחדל ב-Google Cloud

כדי לאפשר קישוריות מ-IDE ל-Google Cloud APIs, חומת האש צריכה לאפשר תעבורת TCP יוצאת לטווחים של כתובות IP שמתועדים באופן ציבורי ב-Google. הטווחים האלה מנוהלים באופן דינמי על ידי Google.

כדי לשמור על רשימה של טווחי כתובות IP לגישה לדומיינים של Google Cloud, יש כמה אפשרויות:

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

אם בארגון שלכם יש היקף שירות, צריך להוסיף להיקף את המשאבים הבאים:

  • Gemini for Google Cloud API
  • Gemini Code Assist API

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

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

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

בקטע הזה מוסבר איך מקצים למשתמשים את תפקידי ה-IAM של Gemini for Google Cloud User ו-Service Usage Consumer.

המסוף

  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.

gcloud

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

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

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

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

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

    • ‫PROJECT_ID: מזהה הפרויקט ב-Cloud. לדוגמה: 1234567890.
    • ‫PRINCIPAL: המזהה של החשבון הראשי. לדוגמה: user:cloudysanfrancisco@gmail.com.

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

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

  3. חוזרים על השלב הקודם לתפקיד roles/serviceusage.serviceUsageConsumer.

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

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

התקנת הפלאגין Gemini Code Assist

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

VS Code

  1. כדי לפתוח את התצוגה Extensions ב-VS Code, לוחצים על סמל התוסף Extensions או מקישים על Ctrl/Cmd+Shift+X.

  2. חיפוש של Gemini Code Assist.

  3. לוחצים על התקנה.

  4. אם מוצגת בקשה, מפעילים מחדש את VS Code.

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

IntelliJ

  1. לוחצים על settings IDE and Project Settings > Plugins (סביבת פיתוח משולבת והגדרות פרויקט > תוספים).
  2. בכרטיסייה Marketplace, מחפשים את Gemini Code Assist.
  3. לוחצים על Install (התקנה) כדי להתקין את הפלאגין.
  4. בסיום ההתקנה, לוחצים על Restart IDE (הפעלה מחדש של סביבת הפיתוח המשולבת).

  5. כשמפעילים מחדש את סביבת הפיתוח המשולבת, Gemini Code Assist מופיע בסרגל הפעילות.

    הסמל של Gemini Code Assist מופיע בסרגל הפעילות.

עכשיו המשתמשים יכולים להשתמש ב-Gemini Code Assist Standard או ב-Enterprise בסביבת הפיתוח המשולבת שלהם. מידע נוסף על התכונות הנתמכות:

כדאי להיעזר במדריכים הבאים:

רשימת ספריות שבהן Gemini Code Assist שומר מידע במטמון

בטבלה הבאה מפורטים מדריכים שבהם Gemini Code Assist מאחסן מידע על תוספים, כמו טוקנים לאימות:

Windows

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

Linux

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

נכנסים לחשבון Google ובוחרים פרויקט ב-Google Cloud.

אחרי שהמשתמשים מתקינים את Gemini Code Assist בסביבות הפיתוח המשולבות שלהם, הם צריכים להיכנס לחשבונות Google שלהם. אם זו הפעם הראשונה שהם משתמשים ב-Gemini Code Assist Standard או Enterprise בסביבת הפיתוח המשולבת שלהם, הם צריכים לבחור פרויקט ב-Google Cloud.

VS Code

אם בוחרים פרויקט ב-Google Cloud ש-Gemini for Google Cloud API לא הופעל בו, תוצג הודעה עם אפשרות להפעיל את ה-API מ-IDE. בוחרים באפשרות Enable the API (הפעלת ה-API) בחלון ההתראה כדי להפעיל את ה-API בפרויקט. מידע נוסף זמין במאמר הגדרת Gemini Code Assist Standard ו-Enterprise לפרויקט.

אם אתם מעדיפים לעקוב אחרי ההסבר המפורט בנושא כתיבת קוד באמצעות Gemini Code Assist ישירות בסביבת הפיתוח המשולבת, אתם יכולים ללחוץ על הפעלת VS Code ולבצע את השלבים שמופיעים בהסבר המפורט כדי להתחבר ל-Google Cloud ולהפעיל את Gemini Code Assist Standard או Enterprise.

הפעלת VS Code

אם לא, פועלים לפי השלבים הבאים:

  1. מפעילים את סביבת הפיתוח המשולבת (IDE).

  2. בסרגל הפעילות, לוחצים על Gemini Code Assist.

  3. בחלונית הצ'אט של Gemini Code Assist, לוחצים על התחברות ל-Google Cloud.

  4. כשמופיעה בקשה לאשר ל-Gemini Code Assist לפתוח את האתר החיצוני, לוחצים על פתיחה.

  5. פועלים לפי ההנחיות כדי להיכנס לחשבון Google.

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

    התחברתם עכשיו ל-Google Cloud.

    כדי לבחור פרויקט ב-Google Cloud שבו מופעל Gemini for Google Cloud API, פועלים לפי השלבים הבאים:

  7. בסרגל הסטטוס של Gemini Code Assist, לוחצים על Gemini Code Assist.

    סרגל הסטטוס של Gemini זמין.

  8. בתפריט Gemini Code Assist, בוחרים באפשרות Select Gemini Code project.

  9. בוחרים פרויקט ב-Google Cloud שפועל בו Gemini for Google Cloud API.

    ‫Gemini Code Assist Standard או Enterprise מוכן לשימוש.

    הסמל של Gemini בשורת הסטטוס מוגדר כרגיל.

IntelliJ

כדי להיכנס לחשבון Google, פועלים לפי השלבים הבאים:

  1. בסרגל הפעילות, לוחצים על spark Gemini Code Assist.

  2. לוחצים על התחברות אל Google.

  3. בדף שנפתח בדפדפן האינטרנט, בוחרים את חשבון Google.

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

    עכשיו יש ל-Gemini Code Assist הרשאה לגשת לחשבון שלכם.

    אם זו הפעם הראשונה שאתם משתמשים ב-Gemini Code Assist Standard או ב-Gemini Code Assist Enterprise בסביבת הפיתוח המשולבת (IDE), אתם צריכים לבחור פרויקט ב-Google Cloud. כך עושים זאת:

  5. חוזרים אל סביבת הפיתוח המשולבת. בחלון של הכלי Gemini Code Assist, אם אתם מסכימים לאפשר ל-Google להפעיל בשמכם את ממשקי ה-API שנדרשים לשימוש ב-Gemini Code Assist בפרויקט שבחרתם, לוחצים על Select a GCP project כדי להמשיך.

  6. בתיבת הדו-שיח Select Google Cloud Project, מחפשים את הפרויקט ב-Google Cloud ובוחרים אותו, ואז לוחצים על OK.

  7. לוחצים על סיום.

הפרויקט שלכם ב-Google Cloud נבחר עם Gemini Code Assist API מופעל. עכשיו אפשר להשתמש ב-Gemini Code Assist Standard או Enterprise בסביבת הפיתוח המשולבת (IDE).

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

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

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

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

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

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

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

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

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • cloudaicompanion.instances.exportMetrics
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • 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 שבו הקציתם כל הרשאה.

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