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

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

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

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

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

• עזרה בתכנות בתוך השורה.

חשוב: במדריך הזה מתואר הצ'אט האינטראקטיבי של Gemini שמוגדר כברירת מחדל. אפליקציות שנוצרו באמצעות App Prototyping agent מוגדרות כברירת מחדל לצ'אט של Prototyper בתצוגה של Code. כדי להשתמש בצ'אט אינטראקטיבי של Gemini, בקטע Gemini לוחצים על + ובוחרים באפשרות New Chat. כדי לחזור לשיחה עם Prototyper, לוחצים על שיחות אחרונות ואז על שיחה עם Prototyper. למידע על הצ'אט של Prototyper, קראו את המאמר איך מתחילים לעבוד עם App Prototyping agent.

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

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

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

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

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

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

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

   • כדי להשתמש בצ'אט: בסביבת העבודה הפתוחה, לוחצים על הניצוץ 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:

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

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

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

  3. כדי להשבית את השלמת הקוד, מבטלים את הבחירה באפשרות Enable inline code completion as you type.

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

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

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

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

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

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

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

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

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

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

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

  3. לוחצים על Firebase Studio > AI: Enable Codebase Indexing.

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

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

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

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

בצ'אט של Gemini, העדיפות היא ל-.idx/airules.md, אבל אם .idx/airules.md לא קיים, המערכת תשתמש ב-GEMINI.md.

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

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

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

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

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

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

   • ב-Explorer (Ctrl+Shift+E), לוחצים לחיצה ימנית על ספריית האם ובוחרים באפשרות New file. נותנים שם לקובץ ולוחצים על 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.

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

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

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

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

הערה: קבצים שקובצי .gitignore במאגר מתעלמים מהם מוחרגים באופן אוטומטי, גם אם הם לא מופיעים בקובץ .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 ב-Chat

ניסיוני: התכונה הזו היא ניסיונית.

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

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

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

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

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

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

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

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

4. בתפריט הנפתח IDX > AI: Model Provider, בוחרים באפשרות Gemini API.

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

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

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

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

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

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

השלבים הבאים

• כדאי לנסות את Gemini.