כתיבה של קוד עם Gemini Code Assist לאנשים פרטיים

במסמך הזה נסביר איך להשתמש ב-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

  1. מגדירים את Gemini Code Assist ללקוחות פרטיים, את Gemini Code Assist Standard או את Gemini Code Assist Enterprise, אם עדיין לא עשיתם זאת.

  2. לפני שבודקים את היכולות של Gemini Code Assist בקובץ הקוד, צריך לוודא ששפת התכנות של הקובץ נתמכת. למידע נוסף על שפות התכנות הנתמכות, ראו שפות התכנות הנתמכות.

  3. אם אתם מעדיפים להשתמש בסביבת הפיתוח המשולבת מאחורי שרת proxy, תוכלו לעיין במאמר חיבורי רשת ב-Visual Studio Code.

IntelliJ

  1. מגדירים את Gemini Code Assist ללקוחות פרטיים, את Gemini Code Assist Standard או את Gemini Code Assist Enterprise, אם עדיין לא עשיתם זאת.

  2. לפני שבודקים את היכולות של Gemini Code Assist בקובץ הקוד, צריך לוודא ששפת התכנות של הקובץ נתמכת. למידע נוסף על שפות התכנות הנתמכות, ראו שפות התכנות הנתמכות.

  3. אם אתם מעדיפים להשתמש בסביבת הפיתוח המשולבת מאחורי שרת proxy, תוכלו לעיין במאמר שרת proxy מסוג HTTP.

יצירת קוד באמצעות הנחיות

בסעיפים הבאים נסביר איך להשתמש ב-Gemini Code Assist כדי ליצור קוד עם ההנחיה לדוגמה Function to create a Cloud Storage bucket בקובץ הקוד. אפשר גם לבחור קטע בקוד ולבקש עזרה מ-Gemini Code Assist באמצעות תכונת הצ'אט, ולקבל הצעות לקוד ולקבל או לדחות אותן בזמן הכתיבה.

הנחיה ל-Gemini Code Assist עם טרנספורמציה של קוד

בעזרת טרנספורמציית קוד אפשר להשתמש בפקודות או בהנחיות בשפה טבעית בתפריט Quick Pick כדי לבקש שינויים בקוד, וגם לקבל תצוגת diff שמציגה את השינויים שבהמתנה בקוד. כדי להפעיל את Gemini Code Assist לצורך טרנספורמציה של קוד, מבצעים את הפעולות הבאות:

VS Code

  1. בקובץ הקוד, בשורה חדשה, מקישים על Control+I (ב-Windows וב-Linux) או על Command+I (ב-macOS) כדי לפתוח את התפריט Gemini Code Assist Quick Pick.

  2. בתפריט, באמצעות הפקודה /generate, מזינים /generate function to create a Cloud Storage bucket ואז מקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).

    יצירת קוד ב-Gemini Code Assist מתבצעת באמצעות הפקודה ‎ /generate.

    Gemini Code Assist יוצר את הקוד על סמך ההנחיה שלכם בתצוגת diff.

    ב-Gemini Code Assist נפתחת תצוגת diff כדי להציג את הקוד שנוצר.

  3. אופציונלי: כדי לאשר את השינויים האלה, לוחצים על אישור.

IntelliJ

  1. בקובץ הקוד, בשורה חדשה, מקישים על Alt+\ (ב-Windows וב-Linux) או על Cmd+\ (ב-macOS) כדי לפתוח את התפריט Gemini Code Assist Quick Pick.

  2. בתפריט, באמצעות הפקודה /generate, מזינים /generate function to create a Cloud Storage bucket ואז מקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).

    יצירת פונקציה של טרנספורמציית קוד ב-IntelliJ Gemini Code Assist

    Gemini Code Assist יוצר את הקוד על סמך ההנחיה שלכם בתצוגת diff.

    תצוגת ההבדלים בין קוד המקור לקוד המתורגם ב-IntelliJ Gemini Code Assist

  3. אופציונלי: כדי לאשר את השינויים האלה, לוחצים על אישור השינויים.

    אפשר להשתמש בפקודות הבאות לשינוי קוד בסביבת הפיתוח המשולבת (IDE):

    • /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

  1. בשורה חדשה, מזינים את התגובה Function to create a Cloud Storage bucket ומקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).

  2. כדי ליצור קוד, מקישים על Control+Enter (ב-Windows וב-Linux) או על Control+Return (ב-macOS).

    לצד טקסט ההנחיה בקובץ הקוד, הקוד שנוצר על ידי Gemini Code Assist יופיע כטקסט רפאים.

  3. אופציונלי: כדי לאשר את הקוד שנוצר, מקישים על Tab.

IntelliJ

  1. בקובץ הקוד, בשורה חדשה, מזינים את התגובה Function to create a Cloud Storage bucket.

  2. כדי ליצור קוד, מקישים על Alt+G (ב-Windows וב-Linux) או על Option+G (ב-macOS). לחלופין, אפשר ללחוץ לחיצה ימנית לצד התגובה ולבחור באפשרות יצירת קוד.

    הקוד שנוצר על ידי Gemini Code Assist יופיע מתחת לתגובה שלכם כטקסט רפאים.

  3. אופציונלי: כדי לאשר את הקוד שנוצר, מקישים על Tab.

אופציונלי: שינוי מקש הקיצור ליצירת קוד

אם מקשי הקיצור שמוגדרים כברירת מחדל ליצירת קוד לא פועלים כפי שמתואר בקטע הקודם, תוכלו לשנות את מקשי הקיצור באופן הבא:

VS Code

  1. בסביבת הפיתוח המשולבת, לוחצים על File (ב-Windows וב-Linux) או על Code (ב-macOS), ואז עוברים אל Settings‏ > Keyboard Shortcuts.

  2. ברשימת מקשי הקיצור, גוללים עד שמוצאים את האפשרות Gemini Code Assist: Generate code.

  3. לוחצים על Gemini Code Assist: Generate Code ואז על edit Change Keybinding.

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

  5. מקישים על Enter (ב-Windows וב-Linux) או על Return (ב-macOS).

    עכשיו אפשר להשתמש בקיצור הדרך החדש שהוקצה כדי ליצור קוד באמצעות Gemini Code Assist.

מידע נוסף על שינוי מקשי קיצור בסביבת הפיתוח המאוחדת זמין במאמר קיצורי מקשים ל-Visual Studio Code.

IntelliJ

  1. עוברים אל settings IDE and Project Settings (הגדרות IDE ופרויקט) > Settings (הגדרות) > Keymap (מקש מפה) > Gemini Code Assist (Gemini Code Assist).

  2. לוחצים לחיצה ימנית על Gemini Code Assist ובוחרים באפשרות Add Keyboard Shortcut.

  3. מזינים את מקש הקיצור המועדף ולוחצים על אישור.

  4. לוחצים לחיצה ימנית על Gemini Code Assist ובוחרים באפשרות הסרה Alt+G (ב-Windows וב-Linux) או הסרה Option+G (ב-macOS).

עכשיו אפשר להשתמש במקשי הקיצור החדשים כדי ליצור קוד בקובץ קוד.

אחזור השלמות קוד

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

VS Code

  1. בקובץ הקוד, בשורה חדשה, מתחילים לכתוב פונקציה. לדוגמה, אם אתם בקובץ Python, כותבים def.

    ‏Gemini Code Assist מציע קוד בצורת טקסט רפאים.

  2. כדי לאשר את הצעת הקוד מ-Gemini Code Assist, מקישים על Tab. לחלופין, כדי להתעלם מההצעה, מקישים על Esc או ממשיכים לכתוב את הקוד.

IntelliJ

  1. בקובץ הקוד, בשורה חדשה, מתחילים לכתוב פונקציה. לדוגמה, אם אתם בקובץ Python, כותבים def.

    ‏Gemini Code Assist מציע קוד בצורת הצעה בתוך הטקסט.

  2. כדי לאשר את הצעת הקוד מ-Gemini Code Assist, מקישים על Tab. לחלופין, כדי להתעלם מההצעה, מקישים על Esc או ממשיכים לכתוב את הקוד.

  3. אופציונלי: אם אתם מעדיפים להשתמש במקש קיצור אחר כדי לאשר את ההצעה שמוצגת בשורה, מעבירים את הסמן מעל ההצעה שמוצגת בשורה ולוחצים על התפריט הנפתח Tab שמופיע. לאחר מכן, בוחרים את מקש הקיצור המועדף או לוחצים על Custom (התאמה אישית) כדי להזין מקש קיצור משלכם.

    ב-Gemini יש תפריט נפתח שמאפשר לשנות את מקש הקיצור כדי לאשר הצעה בתוך הטקסט.

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

השלמת הקוד מופעלת כברירת מחדל. כדי להשבית את השלמת הקוד:

VS Code

  1. בסביבת הפיתוח המשולבת, לוחצים על Code (ב-macOS) או על File (ב-Windows וב-Linux), ואז עוברים אל Settings > Settings.

  2. בכרטיסייה User (משתמש) בתיבת הדו-שיח Settings (הגדרות), עוברים אל Extensions (תוספים) > Gemini Code Assist (Gemini Code Assist).

  3. גוללים עד שמוצאים את הרשימה Duet AI: Inline Suggestions: Enable Auto ובוחרים באפשרות Off.

    הפעולה הזו תשבית את ההצעות בשורה. עדיין תוכלו להקיש על Control+Enter (ב-Windows וב-Linux) או על Control+Return (ב-macOS) כדי להציג הצעות בזמן ההקלדה באופן ידני.

IntelliJ

בסרגל הסטטוס של סביבת הפיתוח המשולבת, לוחצים על spark Gemini Code Assist: Active ובוחרים באפשרות Enable AI Code Completion.

לחצן השלמת הקוד של Gemini בשורת הסטטוס של IntelliJ.

הפעולה הזו משביתה את ההגדרה של השלמת הקוד, ותכונת Gemini Code Assist לא תציע יותר הצעות בתוך השורה עד שתפעילו אותה שוב.

שימוש בפעולות חכמות

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

כדי להשתמש בפעולות חכמות בקוד:

VS Code

  1. בקובץ הקוד, בוחרים בלוק קוד.

  2. לצד בלוק הקוד שנבחר, לוחצים על lightbulb הצגת פעולות הקוד.

    סמל נורת החשמל של הפעולות החכמות מופיע אחרי שבוחרים בלוק קוד ב-VS Code.

  3. בוחרים פעולה, למשל יצירת בדיקות יחידה.

    Gemini Code Assist יוצר תשובה על סמך הפעולה שבחרתם.

IntelliJ

  1. בקובץ הקוד, בוחרים שורה או בלוק של קוד.

  2. לוחצים לחיצה ימנית על הקוד שנבחר ובוחרים פעולה חכמה, כמו יצירת בדיקות יחידה.

    בחירת הפעולה החכמה תגרום ל-Gemini Code Assist ליצור תשובה להנחיה באופן אוטומטי בחלון הכלי Gemini Code Assist.

שימוש בתיקון מהיר של טרנספורמציית קוד

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

כדי להחיל תיקון מהיר בקובץ הקוד:

VS Code

  1. בקובץ הקוד, מעבירים את הסמן מעל שורת השגיאה המקווקונת ובוחרים באפשרות Quick Fix ואז באפשרות ‎/fix.

    תיקון מהיר של טרנספורמציית קוד בסביבת הפיתוח המשולבת (IDE).

  2. כשמפעילים את התיקון המהיר, מופיעה תצוגת diff. כדי לאשר את השינויים האלה, לוחצים על אישור.

IntelliJ

  1. בקובץ הקוד, לוחצים על סמל נורת השגיאה האדום, שמציין שגיאה בקוד, ובוחרים באפשרות תיקון באמצעות Gemini.

    אפשרות להמרת קוד לצורך תיקון באמצעות Gemini בסביבת הפיתוח המשולבת (IDE).

  2. כשהתיקון מוחל, מופיעה תצוגת diff. כדי לאשר את השינויים האלה, לוחצים על אישור.

השבתת הצעות לקוד שתואמות למקורות שצוינו

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

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

  1. בסרגל הפעילות של סביבת הפיתוח המשולבת, לוחצים על ניהול > הגדרות.

  2. בכרטיסייה User בחלון ההגדרות, עוברים אל Extensions > Gemini Code Assist.

  3. גוללים עד שמוצאים את האפשרות Duet AI > Recitation: Max Cited Length.

  4. מגדירים את הערך כ-0.

    מערכת Gemini Code Assist לא מציעה יותר קוד שתואם למקורות שצוינו.

בעיות מוכרות

בקטע הזה מפורטות הבעיות הידועות ב-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 
  • אזהרות על קריאת הרישיון לא נשארות בין סשנים

    אם האזהרות על קריאת הרישיון לא מופיעות בכל הסשנים, כדאי לעיין ביומני הקבע:

    1. לוחצים על View (תצוגה) > Output (פלט).

    2. בוחרים באפשרות 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 

IntelliJ

אין בעיות ידועות ב-Gemini Code Assist ל-IntelliJ ולסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.

שליחת משוב

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

VS Code

  1. בסרגל הסטטוס, לוחצים על spark Gemini Code Assist ובתפריט Quick Pick בוחרים באפשרות Send feedback.

  2. בטופס, ממלאים את השדות כותרת ותגובות.

  3. אם רוצים לשתף את היומנים של Skaffold או של AI Companion, צריך לבחור באפשרות Send Skaffold logs או Send AI Companion logs.

  4. לוחצים על שליחת משוב.

IntelliJ

  1. בסרגל הסטטוס, לוחצים על spark Gemini Code Assist ובתפריט בוחרים באפשרות שליחת משוב.

  2. מזינים את המשוב בשדה הטקסט שבחלק העליון של הטופס.

  3. אם רוצים לשתף את היומנים של Gemini Code Assist, צריך לוודא שבוחרים את קובצי היומן.

  4. לוחצים על שליחת משוב.

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