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

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

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

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

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

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

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

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

• שינוי ההגדרות של השלמת הקוד.
• שינוי הגדרות האינדוקס של בסיס הקוד
• איך מתאימים אישית את ההוראות ל-Gemini באמצעות קובץ כללי AI
• לא לכלול קבצים מ-Gemini באמצעות .aiexclude files.
• שימוש במפתח משלכם: שימוש במודלים אחרים של Gemini בצ'אט
• איך משנים את האופן שבו 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 בתחתית סביבת העבודה.

   • כדי להשתמש ב-Gemini CLI: פותחים את הטרמינל ומזינים gemini לממשק Gemini CLI, או משתמשים בפקודה gemini -p כדי להשתמש ב-Gemini CLI במצב לא אינטראקטיבי.

   • כדי להשתמש בעזרה בכתיבת קוד בתוך השורה: מתחילים להקליד את הקוד ומקישים על 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 באמצעות קובץ כללים של AI

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

• ‫Gemini CLI בלבד משתמש ב-GEMINI.md.
• ‫Gemini בFirebaseצ'אט נותן עדיפות ל.idx/airules.md אבל ישתמש ב-GEMINI.md אם .idx/airules.md לא קיים.

‫Gemini ב-Firebase משתמש בכללים שלכם כהוראות מערכת וכקונטקסט, ומספק תשובות מותאמות אישית לתרחיש השימוש שלכם.

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

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

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

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

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

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

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

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

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

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

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

כדאי לדעת: אם פיתחתם קובצי כללים עבור סביבות פיתוח משולבות אחרות עם AI, אתם יכולים להעתיק אותם ישירות לקובץ הכללים של Gemini. ‫Gemini CLI משתמש רק ב-GEMINI.md כקובץ הכללים שלו, אבל Gemini ב-Firebase ישתמש ב-.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.

טיפ: כללי ה-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 CLI

• הגדרות: יוצרים קובץ .gemini/settings.json כדי לשנות את העיצוב, להפעיל או להשבית את איסוף נתוני השימוש, להתאים את הכלים של Gemini CLI שיש להם גישה, להגדיר את התכונה של יצירת נקודות ביקורת ועוד.
• הגדרות: מידע נוסף על שינוי ההגדרות זמין במאמר Gemini CLI.
• משתני סביבה: Gemini CLI טוען אוטומטית משתני סביבה מהקובץ .env. כאן צריך לאחסן את GEMINI_API_KEY (חובה), וגם אפשר לציין את מודל Gemini שרוצים להשתמש בו, את מזהה הפרויקט Google Cloud ועוד.
• הוראות: כדי לשנות את ההקשר שבו Gemini CLI משתמש כשמבצעים הוראות, יוצרים קובץ GEMINI.md. כך תוכלו לתת ל-Gemini הוראות ספציפיות לפרויקט, מדריכים לסגנון קידוד או מידע רלוונטי על הרקע, כדי שהתשובות שלו יהיו מותאמות ומדויקות יותר לצרכים שלכם. שימו לב שאם תיצרו את הקובץ הזה, Gemini ב-Firebase יקבל את אותן ההוראות, אלא אם תיצרו גם קובץ .idx/airules.md (במקרה כזה, Gemini CLI ישתמש ב-GEMINI.md ו-Gemini ב-Firebase ישתמש ב-airules.md).

מידע נוסף על שינוי ההגדרות, משתני הסביבה וההוראות זמין במסמכי התיעוד של Gemini CLI.

השלבים הבאים

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