במאמר הזה מוסבר איך להשתמש ב-Gemini Code Assist, כלי מבוסס-AI לשיתוף פעולה בסביבת הפיתוח המשולבת (IDE), כדי לבצע את הפעולות הבאות ב-VS Code או ב-IntelliJ ובסביבות פיתוח משולבות אחרות של JetBrains שנתמכות:
- יצירת קוד לפרויקט באמצעות שינוי קוד.
- קבלת השלמות קוד בזמן כתיבת הקוד.
- שימוש בפעולות חכמות.
אם אתם משתמשים ב-Gemini Code Assist Enterprise, אתם יכולים להשתמש בהתאמה אישית של קוד כדי לקבל הצעות לקוד על סמך בסיס הקוד הפרטי של הארגון שלכם ישירות מ-Gemini Code Assist Enterprise. איך מגדירים התאמה אישית של קוד
המסמך הזה מיועד למפתחים בכל רמות המיומנות. ההנחה היא שיש לכם ידע בעבודה עם VS Code או IntelliJ ועם סביבות פיתוח משולבות (IDE) אחרות של JetBrains שנתמכות. אפשר גם להשתמש ב-Gemini ב-Android Studio.
לפני שמתחילים
VS Code
אם עדיין לא עשיתם את זה, אתם יכולים להגדיר את Gemini Code Assist ללקוחות פרטיים, Gemini Code Assist Standard או Gemini Code Assist Enterprise.
לפני שבודקים את היכולות של Gemini Code Assist בקובץ הקוד, צריך לוודא ששפת התכנות של הקובץ נתמכת. מידע נוסף על שפות התכנות הנתמכות זמין במאמר שפות התכנות הנתמכות.
אם אתם מעדיפים להשתמש ב-IDE מאחורי proxy, תוכלו לעיין במאמר בנושא חיבורי רשת ב-Visual Studio Code.
IntelliJ
אם עדיין לא עשיתם את זה, אתם יכולים להגדיר את Gemini Code Assist ללקוחות פרטיים, Gemini Code Assist Standard או Gemini Code Assist Enterprise.
לפני שבודקים את היכולות של Gemini Code Assist בקובץ הקוד, צריך לוודא ששפת התכנות של הקובץ נתמכת. מידע נוסף על שפות התכנות הנתמכות זמין במאמר שפות התכנות הנתמכות.
אם אתם מעדיפים להשתמש ב-IDE מאחורי שרת proxy, תוכלו לקרוא את המאמר בנושא HTTP Proxy.
יצירת קוד באמצעות הנחיות
בסעיפים הבאים נסביר איך להשתמש ב-Gemini Code Assist כדי ליצור קוד באמצעות ההנחיה לדוגמה Function to create a Cloud Storage
bucket
בקובץ הקוד. אתם יכולים גם לבחור חלק מהקוד ואז לבקש עזרה מ-Gemini Code Assist באמצעות תכונת הצ'אט, ולקבל הצעות לקוד ולאשר או לדחות אותן בזמן שאתם כותבים קוד.
הנחיית Gemini Code Assist לבצע טרנספורמציה של קוד
התכונה 'שינוי קוד' מאפשרת להשתמש בפקודות או בהנחיות בשפה טבעית בתפריט 'בחירה מהירה' כדי לבקש שינויים בקוד, ומספקת תצוגת השוואה כדי להציג שינויים בהמתנה בקוד. כדי להנחות את Gemini Code Assist לבצע טרנספורמציה של קוד, פועלים לפי השלבים הבאים:
VS Code
בקובץ הקוד, בשורה חדשה, מקישים על Control+I (ב-Windows וב-Linux) או על Command+I (ב-macOS) כדי לפתוח את התפריט בחירה מהירה של Gemini Code Assist.
בתפריט, באמצעות הפקודה
/generate
, מזינים/generate function to create a Cloud Storage bucket
ואז מקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).Gemini Code Assist יוצר את הקוד על סמך ההנחיה שלכם בתצוגת השוואה.
אופציונלי: כדי לאשר את השינויים, לוחצים על אישור.
IntelliJ
בקובץ הקוד, בשורה חדשה, מקישים על Alt+\ (ב-Windows וב-Linux) או על Cmd+\ (ב-macOS) כדי לפתוח את התפריט בחירה מהירה של Gemini Code Assist.
בתפריט, באמצעות הפקודה
/generate
, מזינים/generate function to create a Cloud Storage bucket
ואז מקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).Gemini Code Assist יוצר את הקוד על סמך ההנחיה שלכם בתצוגת השוואה.
אופציונלי: כדי לאשר את השינויים, לוחצים על אישור השינויים.
אפשר להשתמש בפקודות הבאות לשינוי קוד בסביבת הפיתוח המשולבת:
-
/fix
: פתרון בעיות או שגיאות בקוד. דוגמה:/fix potential NullPointerExceptions in my code
-
/generate
: יצירת קוד. דוגמה:/generate a function to get the current time
-
/doc
: מוסיפים תיעוד לקוד. דוגמה:/doc this function
-
/simplify
: פשטו את הקוד. דוגמה:/simplify if statement in this code
-
הנחיית Gemini Code Assist בקובץ קוד באמצעות הערה
אם אתם מעדיפים, אתם יכולים גם להזין הנחיה ל-Gemini Code Assist בקובץ הקוד באמצעות הערה. כך עושים את זה:
VS Code
בשורה חדשה, מזינים את התגובה
Function to create a Cloud Storage bucket
ואז מקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).כדי ליצור קוד, מקישים על Control+Enter (ב-Windows וב-Linux) או על Control+Return (ב-macOS).
לצד הטקסט של ההנחיה בקובץ הקוד, Gemini Code Assist יוצר את הקוד בצורה של טקסט רפאים.
אופציונלי: כדי לאשר את הקוד שנוצר, מקישים על Tab.
IntelliJ
בקובץ הקוד, בשורה חדשה, מזינים את התגובה
Function to create a Cloud Storage bucket
.כדי ליצור קוד, מקישים על Alt+G (ב-Windows וב-Linux) או על Option+G (ב-macOS). אפשרות נוספת היא ללחוץ לחיצה ימנית ליד התגובה ולבחור באפשרות יצירת קוד.
Gemini Code Assist יוצר את הקוד מתחת לתגובה שלכם בצורה של טקסט רפאים.
אופציונלי: כדי לאשר את הקוד שנוצר, מקישים על Tab.
אופציונלי: שינוי מקש הקיצור ליצירת קוד
אם מקש הקיצור שמוגדר כברירת מחדל ליצירת קוד לא פועל כמו שמתואר בקטע הקודם, אפשר לשנות את מקש הקיצור.
השלמת קוד
בזמן שאתם כותבים קוד, Gemini Code Assist מציע הצעות לקוד בתוך השורה, שנקראות גם השלמות קוד. אתם יכולים לאשר את ההצעות או להתעלם מהן. כדי לקבל השלמות קוד, פועלים לפי השלבים הבאים:
VS Code
בקובץ הקוד, בשורה חדשה, מתחילים לכתוב פונקציה. לדוגמה, אם אתם בקובץ Python, כותבים
def
.Gemini Code Assist מציע קוד בצורה של טקסט רפאים.
כדי לאשר את הצעת הקוד מ-Gemini Code Assist, מקישים על Tab. אחרת, כדי להתעלם מההצעה, מקישים על Esc או ממשיכים לכתוב את הקוד.
IntelliJ
בקובץ הקוד, בשורה חדשה, מתחילים לכתוב פונקציה. לדוגמה, אם אתם בקובץ Python, כותבים
def
.Gemini Code Assist מציע קוד בצורה של הצעה מוטמעת.
כדי לאשר את הצעת הקוד מ-Gemini Code Assist, מקישים על Tab. אחרת, כדי להתעלם מההצעה, מקישים על Esc או ממשיכים לכתוב את הקוד.
אופציונלי: אם אתם מעדיפים להשתמש במקש קיצור אחר כדי לאשר את ההצעה בתוך השורה, מעבירים את מצביע העכבר מעל ההצעה בתוך השורה ולוחצים על התפריט הנפתח Tab שמופיע. לאחר מכן, בוחרים את מקש הקיצור המועדף או לוחצים על התאמה אישית כדי להזין מקש קיצור משלכם.
אופציונלי: השבתה של השלמת קוד
השלמת קוד מופעלת כברירת מחדל. כדי להשבית את השלמת הקוד, פועלים לפי השלבים הבאים:
VS Code
ב-IDE, לוחצים על Code (ב-macOS) או על File (ב-Windows וב-Linux), ואז עוברים אל Settings > Settings.
בכרטיסייה משתמש בתיבת הדו-שיח הגדרות, עוברים אל תוספים > Gemini Code Assist.
גוללים עד שמוצאים את הרשימה Duet AI: Inline Suggestions: Enable Auto (Duet AI: הצעות בכתיבה: הפעלה אוטומטית), ואז בוחרים באפשרות מושבת.
הפעולה הזו תשבית את ההצעות המובנות. עדיין אפשר להקיש על Control+Enter (ב-Windows וב-Linux) או על Control+Return (ב-macOS) כדי להפעיל ידנית הצעות מוטבעות.
IntelliJ
בסרגל הסטטוס של סביבת הפיתוח המשולבת (IDE), לוחצים על spark Gemini Code Assist: Active ובוחרים באפשרות Enable AI Code Completion.
הפעולה הזו משביתה את ההגדרה של השלמת קוד, ו-Gemini Code Assist לא יציג יותר הצעות מוטבעות עד שתפעילו שוב את ההגדרה.
שימוש בפעולות חכמות
כדי לעזור לכם להיות פרודוקטיביים יותר ולצמצם את הצורך במעבר בין הקשרים, Gemini Code Assist מספק פעולות חכמות מבוססות-AI ישירות בעורך הקוד. כשבוחרים את הקוד בכלי לעריכת קוד, אפשר לראות רשימה של פעולות שרלוונטיות להקשר ולבחור מתוכה.
כדי להשתמש בפעולות חכמות בקוד, פועלים לפי השלבים הבאים:
VS Code
בקובץ הקוד, בוחרים בלוק קוד.
לצד בלוק הקוד שנבחר, לוחצים על lightbulb הצגת פעולות קוד.
בוחרים פעולה, למשל יצירת בדיקות יחידה.
Gemini Code Assist יוצר תשובה שמבוססת על הפעולה שבחרתם.
IntelliJ
בקובץ הקוד, בוחרים שורה או בלוק קוד.
לוחצים לחיצה ימנית על הקוד שנבחר ובוחרים פעולה חכמה, כמו יצירת בדיקות יחידה.
בחירה בפעולה החכמה תגרום אוטומטית ל-Gemini Code Assist ליצור תשובה להנחיה בחלון הכלים Gemini Code Assist.
שימוש בתיקון מהיר של שינוי קוד
אם יש שגיאה בקוד, Gemini Code Assist מציע תיקון מהיר של השגיאה באמצעות שינוי הקוד.
כדי להחיל תיקון מהיר בקובץ הקוד, פועלים לפי השלבים הבאים:
VS Code
בקובץ הקוד, מעבירים את מצביע העכבר מעל קו השגיאה הגלי ובוחרים באפשרות Quick Fix (תיקון מהיר) ואז באפשרות /fix (תיקון).
כשמחילים את התיקון המהיר, מוצגת תצוגת השוואה. כדי לאשר את השינויים, לוחצים על אישור.
IntelliJ
בקובץ הקוד, לוחצים על סמל הנורה האדום של השגיאה, שמציין שיש שגיאה בקוד, ובוחרים באפשרות תיקון באמצעות Gemini.
אחרי שהתיקון יוחל, תופיע תצוגת השוואה. כדי לאשר את השינויים האלה, לוחצים על אישור.
החרגת קבצים מההקשר המקומי
כברירת מחדל, Gemini Code Assist לא כולל קבצים בשימוש מקומי בהקשר של השלמת קוד, יצירת קוד, שינוי קוד וצ'אט אם הקבצים מצוינים בקובץ .aiexclude
או .gitignore
.
איך להחריג קבצים מהשימוש ב-Gemini Code Assist
השבתה של הצעות קוד שתואמות למקורות שמצוטטים
Gemini Code Assist מספק מידע על ציטוטים כשהוא מצטט ישירות קטע ארוך ממקור אחר, כמו קוד קיים ממקור פתוח. למידע נוסף, תוכלו להיעזר במאמר בנושא איך ומתי Gemini מפנה למקורות שהוא התבסס עליהם.
כדי למנוע הצעות של קוד שתואם למקורות שצוטטו:
בסרגל הפעילות של סביבת הפיתוח המשולבת, לוחצים על ניהול > הגדרות.
בכרטיסייה משתמש של חלון ההגדרות, עוברים אל תוספים > Gemini Code Assist.
גוללים עד שמוצאים את Geminicodeassist > Recitation: Max Cited Length (Geminicodeassist > ציטוט: אורך מקסימלי של ציטוט).
מגדירים את הערך כ-
0
.Gemini Code Assist לא מציע יותר קוד שתואם למקורות שמצוטטים.
בעיות מוכרות
בקטע הזה מפורטות הבעיות הידועות ב-Gemini Code Assist:
VS Code
יכול להיות שהתשובות ב-Chat ייחתכו אם הן כוללות גרסה מעודכנת של קובץ גדול ופתוח
כדי לפתור את הבעיה, בוחרים קטע קוד קטן יותר וכוללים הנחיה נוספת בהנחיה לצ'אט, כמו
only output the selected code.
Vim: אי אפשר לאשר או לדחות הצעות ליצירת קוד אלא אם נמצאים במצב הכנסה
כשמשתמשים בפלאגין Vim במצב רגיל, אי אפשר לאשר או לדחות הצעות לקוד.
כדי לעקוף את הבעיה, מקישים על i כדי להיכנס למצב הוספה, ואז מקישים על Tab כדי לקבל את ההצעה.
Vim: התנהגות לא עקבית כשלוחצים על Esc כדי לסגור הצעות
כשלוחצים על Esc, ההצעות של Gemini Code Assist ושל סביבת הפיתוח המשולבת נסגרות. ההתנהגות הזו שונה מההתנהגות במצב שאינו Vim, שבו לחיצה על Esc מפעילה מחדש את Gemini Code Assist.
ניסיונות הכניסה נכשלים בגלל פסק זמן
אם ניסיונות הכניסה שלכם ממשיכים להיכשל בגלל פסק זמן, נסו להוסיף את ההגדרה
cloudcode.beta.forceOobLogin
לקובץsettings.json
:"cloudcode.beta.forceOobLogin": true
אזהרות לגבי הקראת רישיון לא נשמרות בין סשנים
אם אזהרות לגבי ציטוט רישיון לא נשארות בין סשנים, כדאי לעיין ביומני הרישום הקבועים:
לוחצים על תצוגה > פלט.
בוחרים באפשרות Gemini Code Assist - Citations (Gemini Code Assist – ציטוטים).
בעיות בקישוריות בחלון הפלט של 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
IntelliJ
אין בעיות ידועות ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) אחרות של JetBrains שנתמכות.
שליחת משוב
כדי לשלוח משוב על החוויה שלכם, פועלים לפי השלבים הבאים:
VS Code
אפשר לשלוח משוב באחת מהדרכים הבאות:
- בסרגל הסטטוס, לוחצים על spark Gemini Code Assist, ואז בתפריט בחירה מהירה בוחרים באפשרות שליחת משוב.
- פותחים את לוח הפקודות (
Ctrl
/Command
+Shift
+P
) ובוחרים באפשרות Gemini Code Assist: Send Feedback (Gemini Code Assist: שליחת משוב).
ממלאים את השדות כותרת והערות בטופס.
בטופס משוב על Gemini Code Assist, בוחרים אפשרות מהתפריטים הנפתחים קטגוריית משוב וסוג.
בשדה הערה, כותבים תיאור מפורט של החוויה.
חשוב לכלול בדוח המשוב את היומנים של Gemini Code Assist. האפשרות הזו מסומנת כברירת מחדל.
מסמנים או מבטלים את הסימון של האפשרויות האחרות, לפי הצורך.
לוחצים על שליחת משוב.
IntelliJ
בסרגל הסטטוס, לוחצים על spark Gemini Code Assist.
אחרי שנותנים הנחיה ל-Gemini Code Assist בצ'אט, ואם לא מרוצים מהתשובה, לוחצים על thumb_down שלילי ואז בוחרים באפשרות שליחת משוב.
בשדה הטקסט בחלק העליון של הטופס, מזינים את המשוב.
אם רוצים לשתף את היומנים של Gemini Code Assist, צריך לבחור את קובצי היומן.
לוחצים על שליחת משוב.