הגדרת 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. הקצאת תפקידים של ניהול זהויות והרשאות גישה (IAM) ב Google Cloud פרויקט.

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

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

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

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

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

הערה: כדי לרכוש מינוי ל-Gemini, צריכה להיות לכם הרשאת ניהול זהויות והרשאות גישה (IAM) מסוג consumerprocurement.orders.place בחשבון לחיוב. ההרשאה consumerprocurement.orders.place כלולה בתפקיד IAM roles/billing.admin או בתפקיד roles/consumerprocurement.orderAdmin. לחלופין, אפשר להוסיף את ההרשאה לתפקיד מותאם אישית.

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

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

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

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

    הערה: אם אין לכם את ההרשאה consumerprocurement.orders.place, הלחצן הזה יהיה מושבת. אם כבר יש מינוי ל-Gemini Code Assist בחשבון לחיוב שמשויך לפרויקט, הלחצן הזה יופיע בתור Manage Gemini Code Assist (ניהול 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 Standard או ל-Enterprise. עכשיו צריך לנהל את הקצאות הרישיונות של Gemini בארגון.

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

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

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

המסוף

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

  • 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. עוברים לדף ניהול Gemini.

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

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

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

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

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

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

API

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

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

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

    {
  "usernames": [
    USER_EMAILS
  ]
}

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

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

    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 ב Google Cloud פרויקט

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

המסוף

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

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

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

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

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

CLI של gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

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

    gcloud services enable cloudaicompanion.googleapis.com

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

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

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

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

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

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

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

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

  • oauth2.googleapis.com: משמש לכניסה ל- Google Cloud.
  • serviceusage.googleapis.com: משמש לבדיקה שהפרויקט של המשתמש ב-Gemini Code Assist מוגדר בצורה נכונה.
  • cloudaicompanion.googleapis.com: נקודת הקצה הראשית ל-API של Gemini for Google Cloud .
  • 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.
  • 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 מחוץ למתחם השירות, תצטרכו גם לשנות את מדיניות ה-ingress כדי לאפשר גישה לשירותים האלה.

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

הענקת תפקידי IAM ב Google Cloud פרויקט

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

המסוף

  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. לוחצים על שמירה.

CLI של gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

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

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

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

    • PROJECT_ID: מזהה הפרויקט ב-Google 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 ‎ במסוףGoogle Cloud בפרויקט שנבחר. למידע נוסף, קראו את המאמר סקירה כללית על 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 ומוכן לשימוש. אפשר להגדיר את Gemini Code Assist באופן נוסף על ידי ציון ההעדפות שלכם באמצעות סרגל האפליקציות ברמה העליונה: עוברים אל Code > Settings > Settings > Extensions ומחפשים את Gemini Code Assist.

IntelliJ

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

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

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

עכשיו המשתמשים מוכנים להשתמש ב-Gemini Code Assist Standard או ב-Gemini Code Assist 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 מתוך סביבת הפיתוח המשולבת. בוחרים באפשרות Enable the API (הפעלת ה-API) בחלון ההתראה כדי להפעיל את ה-API בפרויקט. מידע נוסף זמין במאמר הגדרת Gemini Code Assist Standard ו-Enterprise לפרויקט.

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

הפעלת VS Code

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

  1. פותחים את סביבת הפיתוח המשולבת.

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

  3. בחלונית הצ'אט של Gemini Code Assist, לוחצים על Login to 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 או ב-Enterprise בסביבת הפיתוח המשולבת (IDE), עליכם לבחור פרויקט Google Cloudלפי השלבים הבאים:

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

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

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

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

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

במקום להשתמש במסוף Google Cloud או ב-CLI של 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 פרויקט שבו הקצית את כל ההרשאות.

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