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

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

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

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

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

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

.

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

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

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

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

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

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

    • כדי להשתמש בעזרה בכתיבת קוד בתוך השורה: מתחילים להקליד את הקוד ומקישים על 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. לוחצים על סמל גלגל השיניים ניהול (בחלק התחתון הימני של סביבת העבודה), ואז בוחרים באפשרות 'הגדרות' או לוחצים על 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 סביבת העבודה:

    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 CLI בלבד משתמש ב-GEMINI.md.
  • 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. יוצרים קובץ חדש ב-~/GEMINI.md (ל-Gemini CLI) או ב-.idx/airules.md (לצ'אט Gemini) בסביבת העבודה שלכם ב-Firebase Studio. אפשר להשתמש באחת מהאפשרויות הבאות:

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

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

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

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

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

כש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 צ'אט משתמש. אתם יכולים לבחור במודל המובנה, במודלים שהוגדרו בחלון הצ'אט או בכל מודל 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 מודל התצוגה המקדימה.

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

  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, אלא אם תיצרו גם קובץ .idx/airules.md (במקרה כזה, Gemini CLI ישתמש ב-GEMINI.md ו-Gemini ישתמש ב-airules.md).

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

השלבים הבאים