בדף הזה מוסבר איך מגדירים את Gemini Code Assist Standard ו-Gemini Code Assist Enterprise.
כדי להשתמש בשירותים שזמינים למשתמשים עם רישיונות ל-Gemini Code Assist Standard או Enterprise, הצוות שלכם צריך לבצע את שלבי ההגדרה שמתוארים במסמך הזה:
קניית מינוי ל-Gemini Code Assist Standard או ל-Gemini Code Assist Enterprise
מפעילים את Gemini for Google Cloud API בפרויקט ב- Google Cloud .
המשתמשים בארגון מגדירים את השירותים שבהם הם רוצים להשתמש.
כדי להשתמש ב-Gemini Code Assist Standard או Enterprise בסביבת פיתוח משולבת (IDE), המשתמשים צריכים להתקין את הפלאגין Gemini Code Assist, כמו שמתואר בדף הזה.
כדי להשתמש בעיגון בקוד של הארגון ב-Gemini Code Assist, המשתמשים צריכים לעיין במאמר הגדרת עיגון בקוד של הארגון ב-Gemini Code Assist.
כדי להשתמש ב-Gemini CLI, המשתמשים צריכים לפעול לפי הוראות ההתקנה של Gemini CLI, ואז לבצע אימות על ידי הגדרת Google Cloud פרויקט.
כדי להשתמש ב-Gemini ב-Android Studio, המשתמשים צריכים לעיין במאמר תחילת השימוש ב-Gemini ב-Android Studio לעסקים.
רכישת מינוי ל-Gemini Code Assist
כדי לרכוש מינוי חדש ל-Gemini Code Assist, צריך לפנות Google Cloud למחלקת המכירות. רשימה של התכונות שזמינות בכל מהדורה של Gemini Code Assist מופיעה במאמר תכונות נתמכות.
אם יש לכם מינוי קיים ל-Gemini Code Assist, אתם יכולים לנהל ולחדש אותו דרך מסוף Google Cloud .
הקצה רישיונות
אחרי שקונים מינוי ל-Gemini Code Assist Standard או Enterprise, אפשר לנהל את הקצאות הרישיונות ל-Gemini Code Assist בארגון באמצעות מסוף Google Cloud .
לפני שמשתמשים ברישיון ל-Gemini Code Assist, למשתמשים צריך להיות התפקיד Gemini ל-Google Cloud User או הרשאות דומות בפרויקט שבו ה-API כבר מופעל.
כברירת מחדל, מינויים חדשים מוגדרים להקצאת רישיונות אוטומטית. למשתמש בארגון מוקצה רישיון באופן אוטומטי כשהוא משתמש ב-Gemini Code Assist בסביבת פיתוח משולבת (IDE) נתמכת, בתנאי שמתקיימים כל התנאים הבאים:
- המשתמש בחר פרויקט שמשויך לחשבון לחיוב של המינוי.
- למשתמש יש הרשאת
cloudaicompanion.licenses.selfAssignIAM בפרויקט שנבחר.
אם רישיון לא פעיל במשך 30 יום, הוא יוקצה אוטומטית למשתמש אחר בארגון שעומד בתנאים שצוינו למעלה.
כשכל הרישיונות שזמינים במינוי מוקצים, משתמשים שמנסים לגשת ל-Gemini Code Assist בלי רישיון יקבלו הודעת שגיאה שמציינת שנדרש רישיון.
אחרי שמגדירים את Gemini Code Assist, אפשר לראות את הקצאות הרישיונות. לשם כך, עוברים לדף אדמין ל-Gemini, בוחרים את חשבון החיוב, לוחצים על ניהול המינוי ל-Gemini Code Assist ואז בוחרים בכרטיסייה ניהול רישיונות. אם אתם צריכים שליטה מדויקת יותר בהקצאת הרישיונות, אתם יכולים להשתמש בכרטיסייה הזו גם כדי לעבור מניהול רישיונות אוטומטי לניהול רישיונות ידני.
צריך להפעיל את Gemini for Google Cloud API בפרויקט אחד או יותר שמקושרים לחשבון החיוב הזה. המשתמשים לא יוכלו לראות את Gemini Code Assist עד שתפעילו אותו בפרויקט אחד לפחות.
הפעלת Gemini for Google Cloud API בפרויקט ב- Google Cloud
בקטע הזה מוסבר איך מפעילים את Gemini for Google Cloud API בפרויקט ב- Google Cloud . כדי לנהל את הגישה ל-API, את המכסה ואת החיוב ב-Gemini Code Assist, צריך Google Cloud פרויקט. לכן, כדי שהמשתמשים יוכלו לגשת ל-Gemini Code Assist, צריך להפעיל את Gemini for Google Cloud API בפרויקט ב- Google Cloud .
המסוף
כדי להפעיל את Gemini for Google Cloud API, נכנסים לדף Gemini for Google Cloud.
בוחרים את הפרויקט מרשימת הפרויקטים.
לוחצים על Enable.
הדף יתעדכן ויופיע הסטטוס Enabled. Gemini זמין עכשיו בפרויקטGoogle Cloud שנבחר לכל המשתמשים עם התפקידים הנדרשים של IAM.
CLI של gcloud
-
במסוף Google Cloud , מפעילים את Cloud Shell.
בתפריט לבחירת פרויקטים, בוחרים את הפרויקט.
מפעילים את 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 זמינות עכשיו בפרויקט שבחרתם ב-Google Cloud לכל המשתמשים עם התפקידים הנדרשים של IAM.
הגדרת חומת האש לתעבורת API בין ה-IDE לבין Google
בנוסף להפעלת Gemini for Google Cloud API, משתמשים מאחורי חומות אש צריכים גם לאפשר תנועה דרך ממשקי ה-API הבאים:
oauth2.googleapis.com: משמש לכניסה ל- Google Cloud.-
serviceusage.googleapis.com: משמש לבדיקה שהפרויקט של המשתמש ב-Gemini Code Assist מוגדר בצורה תקינה. -
cloudaicompanion.googleapis.com: נקודת קצה ל-API הראשית של Gemini Code Assist. -
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 ל-API Google Cloud , חומת האש צריכה לאפשר תעבורת 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 מחוץ לגבולות גזרה לשירות, אתם צריכים גם לשנות את מדיניות הכניסה כדי לאפשר גישה לשירותים האלה.
מידע נוסף זמין במאמר הגדרת VPC Service Controls ל-Gemini.
הקצאת תפקידי IAM בפרויקט ב- Google Cloud
בקטע הזה מוסבר איך מקצים למשתמשים את תפקידי ה-IAM 'משתמש Gemini ל-Google Cloud' ו-'Service Usage Consumer'.
המסוף
נכנסים לדף IAM & Admin כדי להקצות את התפקידים ב-IAM שנדרשים בשביל Gemini.
לוחצים על Grant access ומזינים את שם החשבון הראשי שרוצים לתת לו גישה ל-Gemini.
בחלונית Grant access לוחצים על Add another role.
בקטע Assign roles (הקצאת תפקידים), בוחרים באפשרות Gemini for Google Cloud User (משתמש ב-Gemini ל-Google Cloud).
לוחצים על Add roles ובוחרים באפשרות Service Usage Consumer.
לוחצים על Save.
CLI של gcloud
-
במסוף Google Cloud , מפעילים את Cloud Shell.
בתפריט לבחירת פרויקטים, בוחרים את הפרויקט.
מקצים את התפקיד Gemini ל-Google Cloud User:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/cloudaicompanion.user
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב-Google Cloud . לדוגמה:my-project-id. -
PRINCIPAL: המזהה של החשבון הראשי. בחשבונות משתמשים, המזהה הזה הוא בפורמטuser:EMAIL_ADDRESS. לדוגמה,user:cloudysanfrancisco@gmail.com.
תיווצר רשימה של קישורי מדיניות עם הפרטים הבאים:
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user-
חוזרים על השלב הקודם לתפקיד
roles/serviceusage.serviceUsageConsumer.
מידע נוסף זמין במאמרים הקצאת תפקיד יחיד וgcloud projects add-iam-policy-binding.
לכל המשתמשים שקיבלו את התפקידים האלה תהיה גישה לתכונות של Gemini במסוף Google Cloud בפרויקט שנבחר. מידע נוסף מופיע במאמר סקירה כללית עלGoogle Cloud עם Gemini.
התקנת הפלאגין Gemini Code Assist
המשתמשים בארגון מתקינים את הפלאגין של Gemini Code Assist בסביבת פיתוח משולבת (IDE) נתמכת לפי בחירתם. משתמשים בסביבות פיתוח משולבות (IDE) נתמכות של JetBrains צריכים לפעול לפי ההוראות ל-IntelliJ.
VS Code
כדי לפתוח את התצוגה Extensions ב-VS Code, לוחצים על
Extensions או מקישים על Ctrl/Cmd+Shift+X.חיפוש של
Gemini Code Assist.לוחצים על התקנה.
אם מוצגת בקשה, מפעילים מחדש את VS Code.
אחרי שהתוסף מותקן בהצלחה, Gemini Code Assist מופיע בסרגל הפעילות ומוכן לשימוש. אפשר להגדיר עוד את ההתקנה של Gemini Code Assist על ידי ציון ההעדפות באמצעות סרגל המשימות של האפליקציה ברמה העליונה: עוברים אל קוד > הגדרות > הגדרות > תוספים ומחפשים את
Gemini Code Assist.
IntelliJ
- לוחצים על settings IDE and Project Settings > Plugins.
- בכרטיסייה Marketplace, מחפשים את
Gemini Code Assist. - לוחצים על Install (התקנה) כדי להתקין את הפלאגין.
- בסיום ההתקנה, לוחצים על Restart IDE (הפעלה מחדש של IDE).
כשמפעילים מחדש את סביבת הפיתוח המשולבת, 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 פרויקט. זהו אותו פרויקט שמשמש להגדרת Gemini Code Assist, ומשמש לניהול גישה ל-API, מכסה וחיוב.
VS Code
אם בוחרים פרויקט ב- Google Cloud שבו Gemini for Google Cloud API לא מופעל, מוצגת הודעה עם אפשרות להפעיל את ה-API מ-IDE. בוחרים באפשרות Enable the API (הפעלת ה-API) בחלון ההתראה כדי להפעיל את ה-API בפרויקט.
אם אתם מעדיפים לעבור על ההסבר המפורט תכנות באמצעות Gemini Code Assist ישירות בסביבת הפיתוח המשולבת (IDE), אתם יכולים ללחוץ על הפעלת VS Code ולבצע את השלבים שמופיעים בהסבר כדי להתחבר Google Cloud ל-Gemini Code Assist Standard או ל-Gemini Code Assist Enterprise ולהפעיל אותם.
אם לא, פועלים לפי השלבים הבאים:
מפעילים את סביבת הפיתוח המשולבת (IDE).
בסרגל הפעילות, לוחצים על Gemini Code Assist.
בחלונית הצ'אט של Gemini Code Assist, לוחצים על Login to Google Cloud (כניסה ל-Google Cloud).
כשמופיעה בקשה לאשר ל-Gemini Code Assist לפתוח את האתר החיצוני, לוחצים על פתיחה.
פועלים לפי ההנחיות כדי להיכנס לחשבון Google.
כשמוצגת השאלה אם הורדתם את Gemini Code Assist מ-Google, לוחצים על כניסה.
התחברת עכשיו אל Google Cloud.
כדי לבחור פרויקט ב- Google Cloud שבו פועל Gemini for Google Cloud API, פועלים לפי השלבים הבאים:
בסרגל הסטטוס של Gemini Code Assist, לוחצים על Gemini Code Assist.
בתפריט Gemini Code Assist בוחרים באפשרות Select Gemini Code project.
בוחרים פרויקט ב- Google Cloud שבו פועל Gemini for Google Cloud API.
Gemini Code Assist Standard או Enterprise מוכן לשימוש.
IntelliJ
כדי להיכנס לחשבון Google, פועלים לפי השלבים הבאים:
בסרגל הפעילות, לוחצים על spark Gemini Code Assist.
לוחצים על התחברות אל Google. אפשר גם ללחוץ על העתקת הקישור ולהדביק את כתובת ה-URL בדפדפן.
בדף שנפתח בדפדפן האינטרנט, בוחרים את חשבון Google.
במסך שבו מוצגת הבקשה לוודא שהורדתם את האפליקציה הזו מ-Google, לוחצים על כניסה.
עכשיו יש ל-Gemini Code Assist הרשאה לגשת לחשבון שלכם.
אם זו הפעם הראשונה שאתם משתמשים ב-Gemini Code Assist Standard או ב-Gemini Code Assist Enterprise בסביבת הפיתוח המשולבת (IDE), אתם צריכים לבחור Google Cloud פרויקט לפי השלבים הבאים:
חוזרים לסביבת הפיתוח המשולבת (IDE). בחלון של הכלי Gemini Code Assist, אם אתם מסכימים לאפשר ל-Google להפעיל בשמכם את ממשקי ה-API שנדרשים לשימוש ב-Gemini Code Assist בפרויקט שבחרתם, לוחצים על Select a GCP project (בחירת פרויקט ב-GCP) כדי להמשיך.
בתיבת הדו-שיח Select Google Cloud Project, מחפשים את הפרויקט Google Cloud שלכם, בוחרים אותו ולוחצים על OK.
לוחצים על סיום.
הפרויקט ב- Google Cloud נבחר עם Gemini Code Assist API מופעל. אתם מוכנים להשתמש ב-Gemini Code Assist Standard או ב-Gemini Code Assist Enterprise בסביבת הפיתוח המשולבת (IDE)!
משימות מתקדמות להגדרה
בקטעים הבאים מתוארות משימות הגדרה מתקדמות שאפשר לבצע כדי להתאים אישית את Gemini Code Assist.
שיקולים מתקדמים בנושא IAM
במקום להשתמש במסוף Google Cloud או ב-CLI של gcloud כדי להקצות תפקידי IAM מוגדרים מראש, אתם יכולים לבצע את הפעולות הבאות:
להקצות תפקידים באמצעות API בארכיטקטורת REST של IAM או ספריות לקוח של IAM.
אם משתמשים בממשקים האלה, צריך לציין את השמות המלאים של התפקידים:
roles/cloudaicompanion.userroles/serviceusage.serviceUsageConsumer
כדי לקרוא הסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
ליצור ולהקצות תפקידים בהתאמה אישית.
כדי שלתפקידים בהתאמה אישית שתיצרו תהיה גישה ל-Gemini Code Assist Standard ול-Gemini Code Assist Enterprise, צריך לתת להם את ההרשאות הבאות:
cloudaicompanion.instances.completeCodecloudaicompanion.instances.completeTaskcloudaicompanion.instances.generateCodecloudaicompanion.instances.generateTextcloudaicompanion.instances.exportMetricscloudaicompanion.instances.queryEffectiveSettingcloudaicompanion.instances.queryEffectiveSettingBindingsserviceusage.services.enable
הקצאה וניהול של רישיונות.
כדי שתוכלו להקצות ולנהל רישיונות ל-Gemini Code Assist, צריך לתת לתפקידים בהתאמה אישית שתיצרו את ההרשאות הבאות:
consumerprocurement.orders.getconsumerprocurement.orders.licensePools.*consumerprocurement.orders.licensePools.updateconsumerprocurement.orders.licensePools.getconsumerprocurement.orders.licensePools.assignconsumerprocurement.orders.licensePools.unassignconsumerprocurement.orders.licensePools.enumerateLicensedUsers
חשוב גם לזכור שכדי שההרשאות שצוינו למעלה יפעלו, צריך להפעיל את Gemini for Google Cloud API באותו פרויקט ב- Google Cloud שבו הקציתם כל הרשאה.
שינוי ערוץ ההפצה של Google Cloud הפרויקט
אנחנו משיקים את התכונות של Gemini Code Assist בערוצי הפצה שונים, או בגרסה זמינה לכולם או בגרסת טרום-השקה. כשמגדירים את Gemini Code Assist, הפרויקט מוגדר אוטומטית לערוץ ההפצה 'זמינות כללית'.
תמיד אפשר לשנות את ערוץ ההפצה של Gemini Code Assist לערוץ Preview או חזרה לערוץ Generally Available.