הגדרת Gemini ב-Firebase בתוך סביבות עבודה

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

  • הצעות להשלמת קוד בזמן ההקלדה.

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

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

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

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

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

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

  1. אתם יכולים לקבל עזרה בצ'אט או בקוד בתוך שורה בסביבת העבודה:

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

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

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

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

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

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

Gemini בקיצורי הדרך של Firebase

כדי לפתוח במהירות צ'אט עם 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:

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

      אם משתמשים ב-App Prototyping agent ב-Prototyper view, click Code switch icon Switch to Code to open Code view.

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

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

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

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

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

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

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

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

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

      אם משתמשים ב-App Prototyping agent ב-Prototyper view, click Code switch icon Switch to Code to open Code view.

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

    3. בוחרים באפשרות Firebase Studio > AI: Enable Codebase Indexing.

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

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

כדי להוסיף הקשר ומידע על הנחיות המערכת, אפשר ליצור קובץ כללים של AI‏ (.idx/airules.md). ‏Gemini ב-Firebase משתמש בכללים שלכם בתור הנחיות ורקע למערכת, כדי להבטיח שהתשובות שלו יותאמו לתרחישים לדוגמה שלכם.

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה

בהמשך מופיעה דוגמה בסיסית לקובץ כללים שאפשר להשתמש בו במשחק קל שנוצר באמצעות 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 כשהוספת קוד לאינדקס מופעלת. בנוסף, .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 ב-Firebase chat משתמש. אפשר לבחור את המודל המובנה, מודלים שהוגדרו בחלון הצ'אט (כולל מודלים של Gemini 2.5) או כל מודל Gemini שיש לכם גישה אליו.

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

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

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

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

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

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

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

  1. בוחרים את מודל Gemini שבו רוצים להשתמש בצ'אט מהרשימה שבקטע מודלים של Gemini. לדוגמה, מזינים gemini-2.0-flash-lite כדי להשתמש במודל Gemini 2.0 Flash‑Lite היציב האחרון.

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

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

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

השלבים הבאים