הגדרת Gemini במרחבי עבודה

‫Firebase Studio עוזר לכם בתהליכי הפיתוח באמצעות התכונות הבאות של קוד שנוצר בעזרת AI:

  • השלמת קוד מוצעת תוך כדי הקלדה.

  • עזרה מבוססת-AI בצ'אט, שמודעת לסביבת העבודה ומשולבת באופן מלא בקוד. הוא יכול ליצור, לתרגם ולהסביר קוד. בנוסף, אחרי שתבדקו ותאשרו, Gemini יוכל ליצור אינטראקציה ישירות עם סביבת העבודה שלכם כדי לעדכן קבצים, להריץ פקודות בטרמינל, לפרש את פלט הפקודה ולקבוע את השלבים הבאים. מידע נוסף על שימוש ב-Gemini ב-Firebase Studio

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

  • עזרה בכתיבת קוד בתוך השורה.

אתם יכולים להתאים אישית את האופן שבו Gemini עוזר לכם על ידי שינוי ההגדרות שלו והוספה של קובצי כללים של AI:

שימוש ב-Gemini בסביבת העבודה

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

  1. אפשר להשתמש בצ'אט או בסיוע בכתיבת קוד בתוך שורה ב-Workspace:

    • כדי להשתמש בצ'אט: בסביבת העבודה הפתוחה, לוחצים על הניצוץ Gemini בתחתית סביבת העבודה.

    • כדי להשתמש בעזרה בכתיבת קוד בתוך השורה: מתחילים להקליד את הקוד ומקישים על Tab כדי לאשר את ההצעות.

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

    • הצעות בעת ההקלדה, שמאפשרות השלמה אוטומטית של קוד בתוך השורה.
    • אינדוקס של בסיס הקוד, שמאפשר התאמה אישית טובה יותר ותשובות מועילות יותר.

    כדי לשנות את הבחירות האלה בהגדרות של סביבת העבודה בעתיד:

    אפשר גם להחריג קבצים ותיקיות ספציפיים מהוספה לאינדקס של AI. ראו החרגת קבצים מ-Gemini באמצעות קבצי .aiexclude.

Gemini קיצורי דרך

כדי לפתוח במהירות צ'אט עם Gemini: מקישים על Ctrl+Shift+Space (או על Cmd+Shift+Space ב-MacOS).

כדי להציג את הפקודות של Gemini מלוח הפקודות:

  1. פותחים את לוח הפקודות באמצעות Ctrl+Shift+P (או Cmd+Shift+P ב-MacOS).

  2. חיפוש של Gemini.

    תוצג רשימה של פקודות Gemini.

שינוי ההגדרות של השלמת הקוד

כדי לעזור לכם לכתוב קוד, Firebase Studio מספק השלמה של קוד מבוסס-AI שמנבאת וממלאת אוטומטית קוד בכל קובץ פתוח ברגע שמתחילים להקליד.

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

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

  • אם משתמשים בקובץ settings.json, מגדירים את "IDX.aI.enableInlineCompletion" לערך true או false.

  • כדי לעדכן את ההגדרות בFirebase Studio Workspace:

    1. לוחצים על סמל גלגל השיניים ניהול (בחלק התחתון מימין של סביבת העבודה), ואז בוחרים באפשרות 'הגדרות' או לוחצים על Ctrl+, (Cmd+, ב-Mac).

      אם אתם משתמשים בתצוגה App Prototyping agent בPrototyper, לוחצים על סמל של החלפת קוד מעבר לקוד כדי לפתוח את התצוגה Code.

    2. לוחצים על הכרטיסייה Workspace (סביבת עבודה) ומחפשים את ההגדרה Firebase Studio > AI > Enable Inline Completion (הפעלת השלמה אוטומטית בשורה).

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

שינוי ההגדרות של יצירת אינדקס של בסיס הקוד

אתם יכולים לקבוע אם Gemini יבצע אינדוקס של הקוד שלכם. הוספת הקוד לאינדקס מספקת תוצאות מועילות יותר כשמשתמשים בצ'אט או בסיוע AI מוטבע.

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

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

  • אם משתמשים בקובץ settings.json, מגדירים את "IDX.aI.enableCodebaseIndexing" לערך true או false.

  • כדי לעדכן את ההגדרות בFirebase Studio Workspace:

    1. לוחצים על סמל גלגל השיניים ניהול (בחלק התחתון מימין של סביבת העבודה), ואז בוחרים באפשרות 'הגדרות' או לוחצים על Ctrl+, (Cmd+, ב-Mac).

      אם אתם משתמשים בתצוגה App Prototyping agent בPrototyper, לוחצים על סמל של החלפת קוד מעבר לקוד כדי לפתוח את התצוגה Code.

    2. בוחרים בכרטיסייה Workspace, ואז מחפשים את ההגדרה Firebase Studio > AI > Enable Inline Completion.

    3. בוחרים באפשרות Firebase Studio > AI: Enable Codebase Indexing (AI: הפעלת יצירת אינדקס של בסיס קוד).

    4. כדי להשבית את יצירת האינדקס של הקוד, מבטלים את הסימון של AI: Enable Codebase Indexing (AI: הפעלת יצירת אינדקס של בסיס הקוד). צריך לעדכן את הגדרות יצירת האינדקס של הקוד בכל אחד מסביבות העבודה.

התאמה אישית של ההוראות ל-Gemini באמצעות קובץ כללים של AI

כדי להוסיף הקשר ומידע על הנחיית המערכת, יוצרים קובץ של כללי AI:

Gemini chat prioritizes .idx/airules.md but will use GEMINI.md if .idx/airules.md doesn't exist.

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

אפשר להשתמש בקובץ כללי ה-AI כדי לשתף הנחיות בהתאמה אישית, שיטות מומלצות ואפילו הקשר חשוב לגבי הפרויקט עם Gemini כדי להשיג יעדים כמו:

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

יצירה ובדיקה של קובץ כללי AI

כדי ליצור ולבדוק את קובץ כללי ה-AI:

  1. יוצרים קובץ חדש ב-.idx/airules.md (או ב-GEMINI.md) בסביבת העבודה Firebase Studio. אפשר להשתמש באחת מהאפשרויות הבאות:

    • בסייר (Ctrl+Shift+E), לוחצים לחיצה ימנית על ספריית האב ובוחרים באפשרות קובץ חדש. נותנים שם לקובץ ומקישים על Enter.
    • בטרמינל, משתמשים בכלי המועדף לעריכת טקסט כדי לפתוח את GEMINI.md או את .idx/airules.md.

  2. מוסיפים תוכן לקובץ. מומלץ להוסיף מידע על האישיות של Gemini (למשל: "אתה מפתח מומחה ועוזר מועיל שיודע הכול על Next.js"), על תקני הקידוד והשיחה ועל ההקשר של הפרויקט. בדוגמה הבאה אפשר לראות קובץ של כללי AI לדוגמה.

  3. שומרים את הקובץ ופותחים את Gemini.

  4. כדי להתחיל להשתמש בכללי ה-AI, אפשר לבצע אחת מהפעולות הבאות:

    • כדי לבנות מחדש את סביבת העבודה, מרעננים את הדף. אחרי שבונה מחדש, Gemini ישתמש בקובץ הכללים בתוך הצ'אט. השינויים בקובץ הכללים של ה-AI אמורים להשתקף באופן מיידי.
    • אם אתם לא רוצים לבנות מחדש את סביבת העבודה, אתם יכולים לבקש מ-Gemini load GEMINI.md או מ-load airules.md. אם מבצעים שינויים בקובץ במהלך ההפעלה הנוכחית, יכול להיות שיהיה צורך להזין מחדש את ההנחיה ל-Gemini כדי לטעון מחדש את קובץ הכללים.

  5. לשאול שאלות לגבי הקוד. ‫Gemini מגיב באמצעות המידע שכללתם בקובץ הכללים כהקשר.

    ‫Gemini ישתמש (לפי סדר קדימות) ב-.idx/airules.md,‏ GEMINI.md,‏ .gemini/styleguide.md,‏ AGENTS.md או cursorrules.

דוגמה

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

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

לא לכלול קבצים מ-Gemini עם .aiexclude קבצים

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

בדומה לקובץ .gitignore, קובץ .aiexclude עוקב אחרי קבצים שאסור לשתף עם Gemini, כולל חוויית הצ'אט ותכונות מבוססות-AI שפועלות בכלי העריכה. קובץ .aiexclude פועל על קבצים שנמצאים בספרייה שמכילה אותו או בספריות משנה שלה.

קבצים שמוגנים על ידי .aiexclude לא יאונדקסו על ידי Gemini אם Codebase Indexing מופעל. בנוסף, .aiexclude ישפיע על הסיוע המובנה לקבצים המוגנים בדרכים הבאות:

  • עזרה בצ'אט: Gemini לא יוכל לענות על שאלות או להציע הצעות לגבי קבצים שחלים עליהם .aiexclude.
  • השלמת קוד: לא תהיה אפשרות להשלמת קוד מוצעת כשעורכים קבצים מכוסים.
  • עזרה בהקשר: תוכלו ליצור קוד חדש, אבל לא לשנות קוד קיים כשעורכים קבצים שכלולים בכיסוי.

יכול להיות שסביבות פיתוח אחרות, כמו Android Studio, יתייחסו גם לקובצי .aiexclude.

איך כותבים קובצי .aiexclude

קובץ .aiexclude זהה בתחביר שלו לקובץ .gitignore, עם ההבדלים הבאים:

  • קובץ .aiexclude ריק חוסם את כל הקבצים בספרייה שלו ובכל תיקיות המשנה. זהה לקובץ שמכיל את **/*.
  • קבצי .aiexclude לא תומכים בשלילה (הוספת הקידומת ! לתבניות).

דוגמאות

הנה כמה דוגמאות להגדרות של קובץ .aiexclude:

  • חסימה של כל הקבצים שנקראים apikeys.txt בספרייה שמכילה את הקובץ .aiexclude או בספריות שמתחתיה:

    apikeys.txt

  • חסימה של כל הקבצים עם סיומת הקובץ .key בספרייה שמכילה את הקובץ .aiexclude או בספריות שמתחתיה:

    *.key

  • לחסום רק את הקובץ apikeys.txt בספרייה שבה נמצא הקובץ .aiexclude, אבל לא לחסום ספריות משנה:

    /apikeys.txt

  • חסימת כל הקבצים בספרייה my/sensitive/dir ובכל ספריות המשנה. הנתיב צריך להיות יחסי לספרייה שמכילה את הקובץ .aiexclude:

    my/sensitive/dir/

שימוש במודלים אחרים של Gemini בצ'אט

אתם יכולים להגדיר את מודל Gemini שבו משתמש Geminiצ'אט. אתם יכולים לבחור במודל המובנה, במודלים שהוגדרו בחלון הצ'אט או בכל מודל Gemini שיש לכם גישה אליו.

רשימה של כל המודלים הזמינים מופיעה במאמר בנושא מודלים של Gemini.

כדי להגדיר את המפתח ולבחור מודל אחר של Gemini:

  1. בסביבת העבודה הפתוחה, לוחצים על spark Gemini בתחתית סביבת העבודה (או על הכרטיסייה Gemini).

  2. בחלון הצ'אט Gemini, לוחצים על סמל הגדרות ה-AI הגדרות ה-AI. מופיעות הגדרות המשתמש.

  3. בשדה IDX > AI: Gemini Api Key (מזהה > AI: מפתח Gemini API), מזינים את מפתח Gemini API.

  4. בתפריט הנפתח IDX > AI: Model Provider (מספר אינדקס > AI: ספק מודל), בוחרים באפשרות Gemini API.

עכשיו אפשר לבחור כל אחד מהמודלים של Gemini שהוגדרו מראש בצ'אט.

כדי להגדיר מודל Gemini שלא מופיע בתפריט הנפתח:

  1. מזהים את מודל Gemini שרוצים להשתמש בו בצ'אט מהרשימה בGemini מודלים. לדוגמה, מזינים gemini-3-pro-preview כדי להשתמש בGemini 3 Pro Preview מודל התצוגה המקדימה.

  2. בGemini חלון הצ'אט, לוחצים על בורר המודלים ובוחרים באפשרות מזהה של מודל בהתאמה אישית. נפתח הדף הגדרות משתמש.

  3. מעתיקים את שם המודל שבחרתם לשדה IDX > AI: Gemini Model.

  4. סוגרים את חלון הצ'אט ופותחים אותו מחדש על ידי לחיצה על spark Gemini בתחתית סביבת העבודה כדי לרענן את רשימת המודלים.

השלבים הבאים