במאמר הזה נסביר איך משתמשים ב-Gemini Code Assist Standard ו-Enterprise, שותף מבוסס-AI בסביבת הפיתוח המשולבת (IDE), כדי לבצע את הפעולות הבאות ב-VS Code או ב-IntelliJ ובסביבות פיתוח משולבות אחרות של JetBrains:
- לקבל הדרכה שתעזור לכם לפתור בעיות בקוד.
- יוצרים קוד לפרויקט.
- ניהול ההקשר של הפרויקט על ידי ציון קבצים ותיקיות.
- ליצור פקודות וכללים בהתאמה אישית.
התאמה אישית של קוד מאפשרת לקבל הצעות לקוד על סמך קוד המקור הפרטי של הארגון ישירות מ-Gemini Code Assist Enterprise. כך מגדירים התאמה אישית של קוד
המסמך הזה מיועד למפתחים בכל רמות המיומנות. ההנחה היא שיש לכם ידע מעשי ב-VS Code או ב-IntelliJ ובסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains, ושאתם מכירים את Google Cloud. אם אתם מעדיפים, תוכלו גם לנסות את Gemini Code Assist ב-Cloud Shell Editor, ב-Cloud Workstations וב-Android Studio.
לפני שמתחילים
VS Code
מגדירים את Gemini Code Assist Standard או Enterprise, אם עדיין לא עשיתם זאת.
לפני שבודקים את היכולות של Gemini Code Assist בקובץ הקוד, צריך לוודא ששפת התכנות של הקובץ נתמכת. למידע נוסף על שפות התכנות הנתמכות, ראו שפות התכנות הנתמכות.
אם אתם מעדיפים להשתמש בסביבת הפיתוח המשולבת מאחורי שרת proxy, תוכלו לעיין במאמר חיבורי רשת ב-Visual Studio Code.
IntelliJ
מגדירים את Gemini Code Assist Standard או Enterprise, אם עדיין לא עשיתם זאת.
לפני שבודקים את היכולות של Gemini Code Assist בקובץ הקוד, צריך לוודא ששפת התכנות של הקובץ נתמכת. למידע נוסף על שפות התכנות הנתמכות, ראו שפות התכנות הנתמכות.
אם אתם מעדיפים להשתמש בסביבת הפיתוח המשולבת מאחורי שרת proxy, תוכלו לעיין במאמר שרת proxy מסוג HTTP.
איך להסביר את הקוד בצ'אט של Gemini Code Assist
בקטע הזה מבקשים מ-Gemini Code Assist לספק הסבר על הקוד הקיים.
VS Code
כדי לקבל הסבר על הקוד, פועלים לפי השלבים הבאים:
פותחים את קובץ הקוד.
בסרגל הפעילות של סביבת הפיתוח המשולבת, לוחצים על spark Gemini Code Assist.
בחלונית Gemini Code Assist, מזינים את ההנחיה
Explain this code to me
ולוחצים על send Send.התכונה Gemini Code Assist משתמשת בקוד בקובץ הקוד שלכם כמקור להנחיה, ומשיבים לה עם הסבר על הקוד.
כדי להפנות לקטע קוד ספציפי במקום לכל הקוד בקובץ, אפשר לבחור את הקטע בקובץ הקוד ואז להפעיל את Gemini Code Assist.
IntelliJ
כדי לקבל הסבר על הקוד, פועלים לפי השלבים הבאים:
פותחים את קובץ הקוד בסביבת הפיתוח המשולבת.
בחלון הכלי של Gemini Code Assist, מזינים את ההנחיה
Explain this code to me
ולוחצים על Submit.
התכונה Gemini Code Assist משתמשת בקוד בקובץ הקוד שלכם כמקור להנחיה, ומשיבים לה עם הסבר על הקוד.
אם אתם רוצים לקבל הסבר רק על חלק מסוים בקוד, תוכלו לבחור קטע מסוים בקוד ואז להפעיל שוב את Gemini Code Assist. התכונה Gemini Code Assist תשתמש בקוד שנבחר רק כמקור מידע לתשובה שנוצרה.
כש-Gemini Code Assist מספק לכם קוד בתגובה, תוכלו לבחור באחת מהאפשרויות הבאות שמפורטות בסוף התגובה:
הוספה במיקום של הסמן: הוספת הקוד שנוצר לקובץ הנוכחי במיקום הנוכחי של הסמן.
הוספה לקובץ חדש: פתיחת קובץ חדש והוספת הקוד שנוצר לקובץ החדש.
האפשרויות האלה זמינות כש-Gemini Code Assist מזהה את השפה שבה נעשה שימוש בבלוק הקוד, ורק אם השפה הזו נתמכת בסביבת הפיתוח המשולבת הנוכחית.
הצגת היסטוריית השאילתות
אם רוצים להשתמש שוב בהנחיות הקודמות, אפשר למצוא אותן בהיסטוריית השאילתות בחלון הכלי Gemini Code Assist. לשם כך, לוחצים על schedule Show Query History.
יצירת מספר שיחות
אתם יכולים ליצור כמה שיחות עם Gemini Code Assist, לכל אחת מהן הקשר משלה, נפרד משאר השיחות. בהיסטוריית הצ'אט מוצגים הצ'אט הראשון וחותמת הזמן של העדכון האחרון. יש מגבלה של 20 צ'אטים. כשמגיעים למגבלה הזו, השיחה הישנה ביותר נמחקת באופן אוטומטי כשמוסיפים שיחה חדשה.
VS Code
- כדי להוסיף שיחה חדשה, לוחצים על הוספה שיחה חדשה ומזינים את ההנחיה בשדה הטקסט. אחרי שמזינים את ההנחיה, Gemini Code Assist יוצר את הצ'אט החדש.
- כדי לגשת לצ'אט הקודם, לוחצים על היסטוריה המשך צ'אט קודם. תופיע רשימה של השיחות שלכם. בוחרים את השיחה שרוצים להציג.
- כדי למחוק שיחה, לוחצים על המשך השיחה הקודמת ואז על מחיקה מחיקה לצד השיחה שרוצים למחוק.
IntelliJ
בשלב הזה, התכונה הזו לא נתמכת ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.
איפוס היסטוריית הצ'אט
כדי לענות להנחיות שלכם, התכונה Gemini Code Assist משתמשת בהיסטוריית הצ'אט כרקע נוסף. אם היסטוריית הצ'אט כבר לא רלוונטית למטרה שלכם, תוכלו לאפס את היסטוריית הצ'אט.
ניהול הצ'אט
אתם יכולים לנהל את הגדרות הצ'אט של Gemini Code Assist באופן הבא:
הגדרת גלילה אוטומטית
VS Code
כברירת מחדל, התכונה Gemini Code Assist גוללת אוטומטית את השיחה. כדי להשבית את ההתנהגות הזו, מבצעים את המשימות הבאות:
עוברים אל הגדרות > תוספים > Gemini Code Assist.
מחפשים את ההגדרה גלילה אוטומטית ומבטלים את הסימון של התיבה.
IntelliJ
התכונה הזו לא נתמכת ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) אחרות של JetBrains.
איך מפסיקים שיחת צ'אט פעילה
VS Code
כדי להפסיק תשובה ב-Chat שנמצאת בתהליך כתיבת, לוחצים על עצירה עצירה:
IntelliJ
התכונה הזו לא נתמכת ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) אחרות של JetBrains.
איך מפעילים את Gemini Code Assist באמצעות צ'אט עם הקוד שנבחר
Gemini Code Assist יכול לבצע משימות או לענות על השאלות שלכם על סמך הקוד שבחרתם. כדי ליצור קוד שמבוסס על הנחיה עם קוד שנבחר, פועלים לפי השלבים הבאים:
VS Code
בסרגל הפעילות, לוחצים על spark Gemini Code Assist כדי לפתוח את החלונית Gemini Code Assist.
בקובץ הקוד, בוחרים בלוק קוד.
בשדה הטקסט בחלונית Gemini Code Assist, מזינים הנחיה לקוד שנבחר.
לדוגמה, בוחרים פונקציה בקוד ומזינים את ההנחיה
Write a unit test for this function
.Gemini משתמש בקוד שבחרתם כמקור מידע ומגיב להנחיה שלכם.
IntelliJ
בסרגל הפעילות, לוחצים על התגובה Gemini Code Assist כדי לפתוח את חלון הכלי Gemini Code Assist.
בקובץ הקוד, בוחרים בלוק קוד.
בשדה הטקסט של חלון הכלי Gemini Code Assist, מזינים הנחיה לקוד שנבחר.
לדוגמה, בוחרים פונקציה בקוד ומזינים את ההנחיה
Write a unit test for this function.
Gemini Code Assist משתמש בקוד שבחרתם כמקור מידע ומגיב להנחיה שלכם.
הצגת הנחיות לגבי קבצים ותיקיות ספציפיים בסביבת העבודה, עם התחשבות בקוד המקומי
כשמציינים קבצים או תיקיות ל-Gemini Code Assist לשימוש כהקשר, המערכת יכולה להשתמש במודל ה-codebase המקומי כדי לספק הצעות קוד באיכות גבוהה, שתקינות מבחינה תחבירית ומשמעותיות מבחינה סמנטית בהקשר הרחב יותר של ה-codebase.
כשמציינים תיקייה, התכונה Gemini Code Assist משתמשת בקבצים בתיקייה ובקבצים בתיקיות המשנה בתור הקשר.
VS Code
כדי לציין קבצים או תיקיות בהנחיה בצ'אט, מקלידים @ ובוחרים את הקובץ או התיקייה שרוצים לציין.
כדי לקבל הסבר על ההבדלים בין שני קבצים בקוד, פועלים לפי השלבים הבאים:
בסרגל הפעילות, לוחצים על spark Gemini Code Assist.
בחלונית Gemini Code Assist, מזינים את ההנחיה
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
ומקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS) או על Tab. אפשר גם ללחוץ על שם הקובץ ברשימה כדי לבחור אותו. לחיצה על שם הקובץ מוסיפה את הקובץ להקשר של ההנחיה ופותחת אותו בסביבת הפיתוח המשולבת.
התכונה Gemini Code Assist תגיב להנחיה שלכם תוך שימוש בשני הקבצים שציינתם כרקע. התכונה Gemini Code Assist כוללת גם את הקבצים שציינתם בקטע מקורות הקשר.
אחרי שתציינו את הקבצים האלה, תוכלו להמשיך לשאול שאלות או להציג הנחיות נוספות באותה היסטוריית צ'אט, בלי שתצטרכו לציין את הקבצים שוב.
לדוגמה: בחלונית Gemini Code Assist, מזינים את ההנחיה How can I
improve YOUR_FILE_NAME_1?
(ללא הסמל @) ולוחצים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).
התכונה Gemini Code Assist תגיב לשאילתה שלכם לגבי הקובץ שציינתם בהנחיה.
IntelliJ
כדי לציין קבצים או תיקיות בהנחיה בצ'אט, מקלידים @ ובוחרים את הקבצים או התיקיות שרוצים לציין.
כדי לקבל הסבר על ההבדלים בין שני קבצים בקוד, פועלים לפי השלבים הבאים:
בסרגל הפעילות, לוחצים על spark Gemini Code Assist.
בחלונית Gemini Code Assist, מזינים את ההנחיה
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
ומקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS) או על Tab. אפשר גם ללחוץ על שם הקובץ ברשימה כדי לבחור אותו. לחיצה על שם הקובץ מוסיפה את הקובץ להקשר של ההנחיה ופותחת אותו בסביבת הפיתוח המשולבת.
התכונה Gemini Code Assist תגיב להנחיה שלכם תוך שימוש בשני הקבצים שציינתם כרקע. התכונה Gemini Code Assist כוללת גם את הקבצים שציינתם בקטע מקורות הקשר.
אחרי שתציינו את הקבצים האלה, תוכלו להמשיך לשאול שאלות או להציג הנחיות נוספות באותה היסטוריית צ'אט, בלי שתצטרכו לציין אותם שוב.
לדוגמה: בחלונית Gemini Code Assist, מזינים את ההנחיה How can I
improve YOUR_FILE_NAME_1?
(ללא הסמל @) ולוחצים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).
התכונה Gemini Code Assist תגיב לשאילתה שלכם לגבי הקובץ שציינתם בהנחיה.
ניהול קבצים ותיקיות בחלונית ההקשר
אחרי שמציינים קובץ או תיקייה שישמשו כהקשר להנחיות של Gemini Code Assist, הקבצים והתיקיות האלה מועברים לתפריט ההקשר, שבו אפשר לראות אותם ולהסיר אותם מההקשר של ההנחיה.
כדי לנהל את הקבצים והתיקיות בחלונית ההקשר, מבצעים את הפעולות הבאות:
VS Code
בסרגל הפעילות של סביבת הפיתוח המשולבת, לוחצים על spark Gemini Code Assist.
כדי להציג את הקבצים והתיקיות בחלונית ההקשר, לוחצים על פריטי הקשר.
כדי להסיר פריטים מחלונית ההקשר, לוחצים על close הסרה.
IntelliJ
בסרגל הפעילות, לוחצים על spark Gemini Code Assist.
כדי להציג את הקבצים והתיקיות בחלונית ההקשר, לוחצים על הקשר.
כדי להסיר קבצים ותיקיות מהמגירה של ההקשר, לוחצים על close הסרה.
החרגת קבצים מההקשר המקומי
כברירת מחדל, התכונה Gemini Code Assist מחריגה קבצים מהשימוש המקומי בהקשר של השלמת קוד, יצירת קוד, טרנספורמציה של קוד וצ'אט, אם הקבצים צוינו בקובץ .aiexclude
או .gitignore
.
במאמר החרגת קבצים מהשימוש ב-Gemini Code Assist מוסבר איך להחריג קבצים מהשימוש המקומי.
יצירת פקודות בהתאמה אישית
כברירת מחדל, Gemini Code Assist מספק פקודות כמו /generate
ל-VS Code ו-Generate Code ל-IntelliJ ולסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.
אתם יכולים גם ליצור פקודות בהתאמה אישית כדי לבצע משימות חוזרות מהר יותר בסביבת הפיתוח המשולבת.
בקטע הזה יוצרים פקודה בהתאמה אישית בשם add-comments
שמוסיפה הערות לקוד בקובץ הקוד. ב-IntelliJ ובסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains, יוצרים, שומרים ומפעילים את הפקודה בהתאמה אישית מ-Prompt Library ומהיומנים שבתוך העריכה.
VS Code
בקובץ הקוד, מקישים על Control+I (ב-Windows וב-Linux) או על Command+I (ב-macOS) כדי לפתוח את התפריט Gemini Code Assist Quick Pick.
בתפריט, מחפשים את האפשרות העדפות: פתיחת ההגדרות (ממשק משתמש) ובוחרים בה.
בשדה הגדרות חיפוש, מזינים
Geminicodeassist: Custom Commands
.בתיבה Custom Commands (פקודות בהתאמה אישית), בוחרים באפשרות Add Item (הוספת פריט).
בשדה Item, מזינים
add-comments
בתור שם הפקודה.בשדה ערך, מזינים
add comments to all functions without comments in my code
כהודעת הנחיה.לוחצים על OK.
עכשיו אפשר להשתמש בפקודה בהתאמה אישית add-comments
בסביבת הפיתוח המשולבת. הפקודה תופיע ברשימת הפקודות בתפריט Quick Pick של Gemini Code Assist (Control+I (ב-Windows וב-Linux) או Command+I (ב-macOS)).
IntelliJ
בסביבת הפיתוח המשולבת, עוברים אל Settings (הגדרות) > Tools (כלים) > Gemini (ג'מיני) > Prompt Library (ספריית הנחיות).
בחלון Prompt Library, לוחצים על add Add.
נותנים שם לפקודה בהתאמה אישית
add-comments
.בתיבת הטקסט של ספריית ההנחיות, מזינים את ההנחיה:
Add comments to all functions without comments in this code
.מסמנים את התיבה הצגה בהנחיה בתוך העורך אם היא לא מסומנת.
לוחצים על אישור כדי לשמור את הפקודה בהתאמה אישית בספריית ההנחיות.
בקובץ הקוד, מדגישים את הקוד שרוצים לשנות.
לוחצים לחיצה ימנית על הקוד המודגש ועוברים אל Gemini > Prompt Library ובוחרים בפקודה בהתאמה אישית
add-comments
.Gemini Code Assist מריץ את הפקודה
add-comments
ומוסיף הערות לקוד המודגש.
אפשר גם להפעיל את הפקודה בהתאמה אישית באמצעות ההנחיה בתוך העורך:
בקובץ הקוד, מדגישים את הקוד שרוצים לשנות ומקישים על Alt+\ (ב-Windows וב-Linux) או על Cmd+\ (ב-macOS) כדי לפתוח את התפריט Gemini Code Assist Quick Pick.
בתפריט, בוחרים את הפקודה בהתאמה אישית
add-comments
.Gemini Code Assist מריץ את הפקודה
add-comments
ומוסיף הערות לקוד המודגש.
יצירת כללים
אתם יכולים ליצור כללים ל-Gemini Code Assist, והכללים האלה כלולים בכל הנחיה להזנת הודעה בצ'אט.
VS Code
בקובץ הקוד, מקישים על Control+I (ב-Windows וב-Linux) או על Command+I (ב-macOS) כדי לפתוח את התפריט Gemini Code Assist Quick Pick.
בתפריט, מחפשים את האפשרות העדפות: פתיחת ההגדרות (ממשק משתמש) ובוחרים בה.
בשדה הגדרות חיפוש, מזינים
Geminicodeassist: Rules
.בשדה הטקסט, מזינים כלל כמו:
Always generate unit tests when creating a new function
. אפשר גם להוסיף כלל אחד או יותר עם כמה שורות בשדה הטקסט.אחרי שמוסיפים כללים בהגדרות של הכללים, Gemini Code Assist מתייחס לכלל בכל הנחיה או בקשה שתשלחו.
כדי להסיר את הכלל, מוחקים את התוכן משדה הטקסט 'כללים'.
IntelliJ
בשלב הזה, התכונה הזו לא נתמכת ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.
בעיות מוכרות
בקטע הזה מפורטות הבעיות הידועות ב-Gemini Code Assist:
VS Code
תשובות בצ'אט עשויות להיות קטועות אם הן כוללות גרסה מעודכנת של קובץ פתוח גדול
כדי לעקוף את הבעיה, בוחרים קטע קוד קטן יותר ומוסיפים הוראה נוספת להנחיה בצ'אט, למשל
only output the selected code.
Vim: אי אפשר לקבל או לדחות הצעות ליצירת קוד אלא אם נמצאים במצב הוספה
כשמשתמשים בפלאגין Vim במצב רגיל, אי אפשר לאשר או לדחות הצעות לקוד.
כדי לעקוף את הבעיה, מקישים על i כדי לעבור למצב הוספה, ואז מקישים על Tab כדי לאשר את ההצעה.
Vim: התנהגות לא עקבית כשמקישים על Esc כדי לסגור הצעות
כשמקישים על Esc, ההצעות של IDE ושל Gemini Code Assist נסגרות. ההתנהגות הזו שונה מההתנהגות ב-Vim, שבה לחיצה על Esc מפעילה מחדש את Gemini Code Assist.
ניסיונות כניסה נתקלים בזמן קצוב
אם ניסיון הכניסה פג תוקף, אפשר לנסות להוסיף את ההגדרה
cloudcode.beta.forceOobLogin
לקובץsettings.json
:"cloudcode.beta.forceOobLogin": true
אזהרות על קריאת הרישיון לא נשארות בין סשנים
אם האזהרות על קריאת הרישיון לא מופיעות בכל הסשנים, כדאי לעיין ביומני הקבע:
לוחצים על View (תצוגה) > Output (פלט).
בוחרים באפשרות Gemini Code Assist – Citations.
בעיות קישוריות בחלון הפלט של Gemini Code Assist
אם מופיעה שגיאת חיבור או בעיות קישוריות אחרות בחלון הפלט של Gemini Code Assist, נסו את הפעולות הבאות:
מגדירים את חומת האש כך שתאפשר גישה אל
oauth2.googleapis.com
ו-cloudaicompanion.googleapis.com
.מגדירים את חומת האש כך שתאפשר תקשורת באמצעות HTTP/2, שבו משתמש gRPC.
אפשר להשתמש בכלי
grpc-health-probe
כדי לבדוק את הקישוריות. אם הבדיקה תצליח, הפלט יהיה:$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved
אם הבדיקה נכשלת, הפלט הוא:
timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s
כדי לקבל פרטים נוספים, מריצים את הפקודה הבאה לפני
grpc-health-probe
:export GRPC_GO_LOG_SEVERITY_LEVEL=info
האפשרות'הפעלת Gemini Code Assist' עדיין מופיעה אחרי שבוחרים פרויקט ב-Gemini Code Assist
אם בחרתם את הפרויקט לפי ההוראות במדריך הזה, כולל הפעלת Gemini for Google Cloud API, יכול להיות שיש בעיה בשרת LS.
כדי לקבל פרטים נוספים על הבעיה, יש לבצע את הפעולות הבאות:
בסרגל הסטטוס, לוחצים על spark Gemini Code Assist ובוחרים באפשרות שליחת משוב.
לוחצים על Show (הצגה) בכל אחד מקובצי היומן כדי לראות פרטים נוספים ולעזור בפתרון הבעיה.
IntelliJ
אין בעיות ידועות ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.
שליחת משוב
כדי לשלוח משוב על החוויה שלכם, פועלים לפי השלבים הבאים:
VS Code
בסרגל הסטטוס, לוחצים על spark Gemini Code Assist ובתפריט Quick Pick בוחרים באפשרות Send feedback.
בטופס, ממלאים את השדות כותרת ותגובות.
אם רוצים לשתף את היומנים של Skaffold או של AI Companion, צריך לבחור באפשרות Send Skaffold logs או Send AI Companion logs.
לוחצים על שליחת משוב.
IntelliJ
בסרגל הסטטוס, לוחצים על spark Gemini Code Assist ובתפריט בוחרים באפשרות שליחת משוב.
מזינים את המשוב בשדה הטקסט שבחלק העליון של הטופס.
אם רוצים לשתף את היומנים של Gemini Code Assist, צריך לוודא שבוחרים את קובצי היומן.
לוחצים על שליחת משוב.
המאמרים הבאים
- איך כותבים הנחיות טובות יותר
- איך Gemini for Google Cloud משתמש בנתונים שלכם
- מידע על התמחור של Gemini Code Assist
- מידע נוסף על תאימות ב-Google Cloud