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

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

הערה: בדרך כלל האדמין מבצע את שלבים 1-4.

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 Code Assist

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

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

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

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 למשתמשים ספציפיים במסוף 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. עוברים לדף ניהול 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 היא רשימה של חשבונות משתמשים שמופרדים בפסיקים, שאליהם רוצים להקצות את הרישיון. לדוגמה, "[e-mail]", "[e-mail]".

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

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

הגדרת חומת האש לתעבורת 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 לבוררי פרויקטים. יכול להיות שלא תצטרכו את ה-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, יש כמה אפשרויות:

• אתם יכולים להשתמש ברשימות שפורסמו שלנו או להפעיל סקריפט באופן אוטומטי כדי לקבל טווחי כתובות IP של Google.
• משתמשים ב-private.googleapis.com Virtual IP.
• להשתמש ב-Private Service Connect.

אופציונלי: הגדרת 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. לוחצים על 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:[e-mail].

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

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

• סקירה כללית של תכונות הקוד
• סקירה כללית על תכונות הצ'אט

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

• כתיבה של קוד באמצעות Gemini Code Assist
• איך מתכתבים בצ'אט עם Gemini Code Assist

רשימת הספריות שבהן 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.

   

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

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

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

   

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) שלכם.

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

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

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

• סוגי הכלים שמבוססים על AI גנרטיבי שזמינים ב-Gemini for Google Cloud
• איך Gemini for Google Cloud משתמש בנתונים שלכם
• איך ניגשים לאמצעי הבקרה של Gemini Code Assist Standard ושל אדמינים ארגוניים ומנהלים אותם
• כך מגדירים התאמה אישית של קוד ב-Gemini Code Assist Enterprise.
• הגדרת VPC Service Controls ל-Gemini Code Assist Standard ו-Enterprise