כתיבה של קוד עם 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. אם אתם מעדיפים להשתמש ב-IDE מאחורי proxy, תוכלו לעיין במאמר בנושא חיבורי רשת ב-Visual Studio Code.

IntelliJ

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

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

  3. אם אתם מעדיפים להשתמש ב-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

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

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

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

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

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

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

IntelliJ

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

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

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

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

    תצוגת ההבדלים (diff) של שינוי הקוד ב-Gemini Code Assist ב-IntelliJ

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

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

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

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

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

השלמת קוד

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

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

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

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

VS Code

  1. ב-IDE, לוחצים על Code (ב-macOS) או על File (ב-Windows וב-Linux), ואז עוברים אל Settings > Settings.

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

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

IntelliJ

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

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

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

החרגת קבצים מההקשר המקומי

כברירת מחדל, Gemini Code Assist לא כולל קבצים בשימוש מקומי בהקשר של השלמת קוד, יצירת קוד, שינוי קוד וצ'אט אם הקבצים מצוינים בקובץ .aiexclude או .gitignore.

איך להחריג קבצים מהשימוש ב-Gemini Code Assist

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

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

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

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

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

  3. גוללים עד שמוצאים את Geminicodeassist > Recitation: Max Cited Length (Geminicodeassist > ציטוט: אורך מקסימלי של ציטוט).

  4. מגדירים את הערך כ-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
    
  • אזהרות לגבי הקראת רישיון לא נשמרות בין סשנים

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

    1. לוחצים על תצוגה > פלט.

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

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

    • בסרגל הסטטוס, לוחצים על spark Gemini Code Assist, ואז בתפריט בחירה מהירה בוחרים באפשרות שליחת משוב.
    • פותחים את לוח הפקודות (‎Ctrl/Command + Shift + P) ובוחרים באפשרות Gemini Code Assist: Send Feedback (Gemini Code Assist: שליחת משוב).
  2. ממלאים את השדות כותרת והערות בטופס.

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

  4. בשדה הערה, כותבים תיאור מפורט של החוויה.

  5. חשוב לכלול בדוח המשוב את היומנים של Gemini Code Assist. האפשרות הזו מסומנת כברירת מחדל.

  6. מסמנים או מבטלים את הסימון של האפשרויות האחרות, לפי הצורך.

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

IntelliJ

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

  2. אחרי שנותנים הנחיה ל-Gemini Code Assist בצ'אט, ואם לא מרוצים מהתשובה, לוחצים על thumb_down שלילי ואז בוחרים באפשרות שליחת משוב.

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

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

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

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