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

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

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

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

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

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

חשוב: במדריך הזה מוסבר איך להגדיר את Gemini ב-Firebase בסביבות עבודה (תצוגה של Code). למידע על Gemini ב-Firebase כשמשתמשים ב-App Prototyping agent, אפשר לעיין במאמר איך מתחילים להשתמש ב-App Prototyping agent.

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

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

חשוב: Gemini ב-Firebase יכול ליצור פלט שנראה סביר אבל כולל עובדות שגויות. יכול להיות שהתשובות יכילו מידע לא מדויק שלא מייצג את הדעות של Google. מומלץ לאמת כל פלט של Gemini לפני שמשתמשים בו, ולא להשתמש בקוד שנוצר ולא נבדק לצורכי פיתוח. אל תזינו בצ'אט פרטים אישיים מזהים (PII) או נתוני משתמשים.

שימוש ב-Gemini ב-Firebase ב-Workspace

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

הערה: אם אתם משתמשים ב-App Prototyping agent ב-Prototyper view, click Switch to Code to open Code view.

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 Switch to Code to open Code view.

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

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

הערה: כדי שההגדרה הזו תישמר בכל סביבות העבודה, צריך להגדיר אותה בכרטיסייה משתמש. כך תוכלו לוודא שההגדרות יחולו על כל סביבת עבודה שתהיה לכם גישה אליה באמצעות חשבון המשתמש. אם משתפים את סביבת העבודה, עדיין צריך להגדיר את ההגדרה של Workspace.

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

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

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

כדאי לדעת: אתם יכולים לקבוע אילו קבצים יאונדקסו על ידי Gemini ב-Firebase. מידע נוסף על החרגת קבצים מ-Gemini באמצעות קובצי .aiexclude

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

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

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

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

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

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

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

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

הערה: כדי שההגדרה הזו תישמר בכל סביבות העבודה, צריך להגדיר אותה בכרטיסייה משתמש. כך תוכלו לוודא שההגדרות יחולו על כל סביבת עבודה שתהיה לכם גישה אליה באמצעות חשבון המשתמש. אם משתפים את סביבת העבודה, עדיין צריך להגדיר את ההגדרה של Workspace.

התאמה אישית של ההוראות ל-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 מגיב באמצעות המידע שכללתם בקובץ הכללים כהקשר.

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

דוגמה

הדוגמה הבאה היא של קובץ כללים בסיסי שאפשר להשתמש בו במשחק קליל שפותח באמצעות 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.

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

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

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

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

הערה: קבצים שמוגדרים כקבצים שצריך להתעלם מהם ב-.gitignore במאגר שלכם מוחרגים באופן אוטומטי, גם אם הם לא מופיעים בקובץ .aiexclude.

כשCodebase Indexing מופעל, קבצים שמוגנים על ידי .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.

חשוב: Firebase Studio הגדרות ה-AI הן הגדרות משתמש. המשמעות היא שההגדרות יישארו מוגדרות עבורכם בכמה תחנות עבודה.

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

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

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

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

   הערה: יכול להיות שהשדה הזה כבר יאוכלס אם השתמשתם ב-App Prototyping agent והוא יצר עבורכם פרויקט Firebase ומפתח Gemini API.

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

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

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

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

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

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

השלבים הבאים

• אפשר לנסות את Gemini ב-Firebase.