Konfigurowanie Gemini w Firebase w obszarach roboczych

Firebase Studio ułatwia procesy programowania dzięki tym funkcjom kodu wspomaganym przez AI:

• Sugestie uzupełniania kodu podczas pisania.

• pomoc AI na czacie, która jest zintegrowana z Twoim kodem i uwzględnia kontekst przestrzeni roboczej; Może generować, tłumaczyć i wyjaśniać kod. Po Twojej weryfikacji i zatwierdzeniu Gemini w Firebase może bezpośrednio wchodzić w interakcje z Twoim obszarem roboczym, aby aktualizować pliki, uruchamiać polecenia terminala, interpretować wyniki poleceń i określać kolejne kroki. Więcej informacji znajdziesz na stronie Wypróbuj czat z Gemini.

• Działania w wierszu, które możesz wykonać na wybranych fragmentach kodu. Możesz na przykład poprosić Gemini o zwiększenie czytelności wybranego kodu.

• Pomoc przy pisaniu kodu w tekście.

Ważne: ten przewodnik opisuje konfigurowanie Gemini w Firebase w przestrzeniach roboczych (widok Code). Informacje o Gemini w Firebase podczas korzystania z App Prototyping agent znajdziesz w artykule Pierwsze kroki z App Prototyping agent.

Możesz dostosować sposób, w jaki Gemini w Firebase Ci pomaga, zmieniając jego ustawienia i dodając pliki reguł AI:

• Dostosuj ustawienia uzupełniania kodu.
• Dostosuj ustawienia indeksowania bazy kodu.
• Dostosowywanie instrukcji dla Gemini za pomocą pliku reguł AI
• Wyklucz pliki z Gemini za pomocą .aiexclude plików.
• Używanie własnego klucza: korzystanie z innych modeli Gemini na czacie

Ważne: Gemini w Firebase może generować wyniki, które wydają się wiarygodne, ale są nieprawdziwe. Może odpowiadać niedokładnymi informacjami, które nie odzwierciedlają poglądów Google. Przed użyciem zweryfikuj wszystkie dane wyjściowe z Gemini i nie używaj w środowisku produkcyjnym nieprzetestowanego wygenerowanego kodu. Nie podawaj na czacie informacji umożliwiających identyfikację osoby ani danych użytkownika.

Korzystanie z Gemini w Firebase w Workspace

Korzystaj z Gemini w Firebase, aby zwiększyć produktywność podczas kodowania za pomocą panelu czatu lub pomocy w kodzie wbudowanym.

Uwaga: jeśli używasz App Prototyping agent w Prototyper view, click Switch to Code to open Code view.

1. Skorzystaj z pomocy na czacie lub pomocy dotyczącej kodu wbudowanego w przestrzeni roboczej:

   • Aby korzystać z czatu: w otwartym obszarze roboczym kliknij iskrę Gemini u dołu obszaru roboczego.

   • Aby skorzystać z pomocy dotyczącej kodu wbudowanego: zacznij pisać kod i naciśnij Tab, aby zaakceptować sugestie.

2. Pamiętaj, że domyślnie włączone są te 2 opcje:

   • Sugestie podczas pisania, które zapewniają uzupełnianie kodu w tekście.
   • Indeksowanie bazy kodu, które zapewnia lepsze dostosowywanie i bardziej przydatne odpowiedzi.

   Aby w przyszłości zmienić te ustawienia obszaru roboczego:

   • Aby zaktualizować ustawienia uzupełniania kodu, przeczytaj artykuł Dostosowywanie ustawień uzupełniania kodu.
   • Aby zaktualizować ustawienia indeksowania kodu, zapoznaj się z artykułem Dostosowywanie ustawień indeksowania kodu.

   Możesz też wykluczyć z indeksowania przez AI konkretne pliki i katalogi. Zobacz Wykluczanie plików z Gemini za pomocą plików .aiexclude.

Skróty Gemini w Firebase

Aby szybko otworzyć czat z użytkownikiem Gemini, naciśnij Ctrl+Shift+Space (lub Cmd+Shift+Space w systemie macOS).

Aby wyświetlić polecenia Gemini z palety poleceń:

1. Otwórz paletę poleceń, naciskając Ctrl+Shift+P (lub Cmd+Shift+P w systemie macOS).

2. Wyszukaj: Gemini.

   Pojawi się lista Gemini poleceń.

Dostosowywanie ustawień uzupełniania kodu

Aby ułatwić Ci pisanie kodu, Firebase Studio udostępnia funkcję uzupełniania kodu AI, która przewiduje i automatycznie uzupełnia kod w dowolnym otwartym pliku, gdy tylko zaczniesz pisać.

Pamiętaj, że domyślnie włączone jest uzupełnianie kodu.

Aby włączyć lub wyłączyć uzupełnianie kodu, dostosuj ustawienia uzupełniania kodu za pomocą jednej z tych metod:

• Jeśli używasz pliku settings.json, ustaw wartość "IDX.aI.enableInlineCompletion" na true lub false.

• Aby zaktualizować ustawienia w obszarze roboczym Firebase Studio:

  1. Kliknij  Zarządzaj (w lewym dolnym rogu obszaru roboczego), a następnie wybierz Ustawienia lub naciśnij Ctrl+, (Cmd+, na Macu).

     Jeśli używasz App Prototyping agent w Prototyper view, click Switch to Code to open Code view.

  2. Wybierz kartę Workspace (Przestrzeń robocza), a następnie wyszukaj ustawienie Firebase Studio > AI > Enable Inline Completion (AI > Włącz uzupełnianie w tekście).

  3. Aby wyłączyć uzupełnianie kodu, odznacz opcję Włącz uzupełnianie kodu wbudowanego podczas pisania.

Wskazówka: aby zachować to ustawienie we wszystkich obszarach roboczych, skonfiguruj je na karcie Użytkownik. Dzięki temu ustawienia będą stosowane w każdym obszarze roboczym, do którego uzyskasz dostęp za pomocą konta użytkownika. Jeśli udostępniasz obszar roboczy, nadal musisz skonfigurować ustawienie obszaru roboczego.

Dostosowywanie ustawień indeksowania bazy kodu

Możesz określić, czy Gemini ma indeksować Twój kod. Indeksowanie kodu zapewnia bardziej przydatne wyniki podczas korzystania z czatu lub pomocy AI w tekście.

Pamiętaj, że indeksowanie bazy kodu jest domyślnie włączone.

Wskazówka: możesz określić, które pliki Gemini w Firebase ma indeksować. Więcej informacji znajdziesz w artykule Wykluczanie plików z Gemini za pomocą plików .aiexclude.

Aby włączyć lub wyłączyć indeksowanie kodu, dostosuj ustawienia indeksowania bazy kodu za pomocą jednej z tych metod:

• Jeśli używasz pliku settings.json, ustaw "IDX.aI.enableCodebaseIndexing" na true lub false.

• Aby zaktualizować ustawienia w obszarze roboczym Firebase Studio:

  1. Kliknij Zarządzaj (w lewym dolnym rogu obszaru roboczego), a następnie wybierz Ustawienia lub naciśnij Ctrl+, (Cmd+, na komputerze Mac).

     Jeśli używasz App Prototyping agent w Prototyper view, click Switch to Code to open Code view.

  2. Wybierz kartę Workspace (Miejsce pracy), a następnie wyszukaj ustawienie Firebase Studio > AI > Enable Inline Completion (Włącz uzupełnianie w tekście).

  3. Wybierz Firebase Studio > AI: Enable Codebase Indexing (AI: włącz indeksowanie bazy kodu).

  4. Aby wyłączyć indeksowanie kodu, odznacz opcję AI: Enable Codebase Indexing (AI: włącz indeksowanie bazy kodu). Ustawienia indeksowania kodu musisz zaktualizować w przypadku każdego obszaru roboczego.

Wskazówka: aby zachować to ustawienie we wszystkich obszarach roboczych, skonfiguruj je na karcie Użytkownik. Dzięki temu ustawienia będą stosowane w każdym obszarze roboczym, do którego uzyskasz dostęp za pomocą konta użytkownika. Jeśli udostępniasz obszar roboczy, nadal musisz skonfigurować ustawienie obszaru roboczego.

Dostosowywanie instrukcji dla Gemini w Firebase za pomocą pliku reguł AI

Możesz dodać kontekst i informacje o prompcie systemowym, tworząc plik reguł AI (.idx/airules.md). Gemini w Firebase używa Twoich reguł jako instrukcji systemowych i kontekstu, dzięki czemu jego odpowiedzi są dostosowane do Twojego przypadku użycia.

Użyj pliku reguł AI, aby udostępniać Gemini niestandardowe prompty, sprawdzone metody, a nawet ważne informacje o projekcie. Dzięki temu możesz osiągać takie cele jak:

• wpływać na osobowość Gemini i specjalizować się w określonych dziedzinach.
• stosowanie standardów obowiązujących w całym projekcie, takich jak styl kodowania, konwencje i preferencje dotyczące technologii;
• Zmniejszenie ilości informacji, które musisz udostępniać w kodzie lub na czacie, dzięki podaniu podstawowych informacji o projekcie.

Skonfigurowane reguły są używane przez Gemini w Google Chat.

Tworzenie i testowanie pliku reguł AI

Aby utworzyć i przetestować plik reguł AI:

1. Utwórz nowy plik w .idx/airules.md w obszarze roboczym Firebase Studio (w tym samym katalogu co plik dev.nix). Możesz skorzystać z jednej z tych opcji:

   • W Eksploratorze (Ctrl+Shift+E) kliknij prawym przyciskiem myszy .idx i wybierz Nowy plik. Nazwij plik airules.md i naciśnij Enter.
   • W terminalu otwórz plik .idx/airules.md w preferowanym edytorze tekstu.

2. Dodaj treść do pliku. Możesz dodać informacje o osobie, której Geminima używać model (np. „Jesteś doświadczonym deweloperem i pomocnym asystentem, który wie wszystko o Next.js”), standardy kodowania i konwersacji oraz kontekst projektu. Poniżej znajdziesz przykład pliku reguł AI.

3. Zapisz plik i otwórz Gemini w Firebase.

4. Aby zacząć korzystać z reguł AI, możesz wykonać jedną z tych czynności:

   • Odbuduj przestrzeń roboczą, odświeżając stronę. Po ponownym utworzeniu Gemini w Firebase będzie używać pliku reguł w czacie. Zmiany w pliku reguł AI powinny być od razu widoczne na czacie.
   • Jeśli nie chcesz ponownie tworzyć przestrzeni roboczej, możesz poprosić o to Geminiza pomocą czatu.load airules.md Jeśli w trakcie bieżącej sesji wprowadzisz zmiany w pliku, może być konieczne ponowne poproszenie Gemini o ponowne wczytanie pliku reguł.

5. zadawać pytania dotyczące kodu; Gemini odpowiada, korzystając z informacji zawartych w pliku reguł jako kontekstu.

Wskazówka: jeśli masz pliki reguł opracowane dla innych IDE z AI, możesz je skopiować bezpośrednio do .idx/airules.md. Jeśli w katalogu głównym projektu znajduje się plik .cursorrules, Gemini będzie go używać, chyba że obecny jest też plik .idx/airules.md. Jeśli występują zarówno tagi .cursorrules, jak i .idx/airules.md, tag airules.md ma pierwszeństwo.

Przykład

Oto podstawowy przykład pliku reguł, którego możesz użyć w przypadku prostej gry opracowanej w 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.

Wskazówka: reguły AI wpływają na ogólny rozmiar kontekstu, dlatego zalecamy utrzymywanie pliku reguł AI w rozsądnych granicach, aby zapewnić najlepszą skuteczność modelu.

Wyklucz pliki z Gemini za pomocą plików .aiexclude

Możesz określić, które pliki w bazie kodu mają być ukryte przed Gemini, dodając do projektu pliki .aiexclude. Dzięki temu możesz szczegółowo kontrolować kontekst projektu, który udostępniasz Gemini.

Podobnie jak plik .gitignore, plik .aiexclude śledzi pliki, które nie powinny być udostępniane Gemini, w tym czat i funkcje AI działające w edytorze. Plik .aiexclude działa na plikach znajdujących się w katalogu, w którym się znajduje, lub w jego podkatalogach.

Uwaga: pliki ignorowane przez pliki .gitignore w repozytorium są automatycznie wykluczane, nawet jeśli nie są wymienione w pliku .aiexclude.

Pliki objęte .aiexclude nie będą indeksowane przez Gemini, gdy włączone jest indeksowanie bazy kodu. Dodatkowo .aiexclude wpłynie na pomoc w edycji plików w ten sposób:

• Pomoc na czacie: Gemini nie będzie w stanie odpowiadać na pytania ani udzielać sugestii dotyczących plików objętych .aiexclude.
• Uzupełnianie kodu: sugerowane uzupełnienia kodu nie będą dostępne podczas edytowania objętych plików.
• Pomoc w tekście: podczas edytowania objętych plików możesz generować nowy kod, ale nie możesz modyfikować istniejącego kodu.

Inne środowiska programistyczne, takie jak Android Studio, również mogą obsługiwać pliki .aiexclude.

Jak pisać pliki .aiexclude

Plik .aiexclude ma taką samą składnię jak plik .gitignore, z tymi różnicami:

• Pusty plik .aiexclude blokuje wszystkie pliki w swoim katalogu i we wszystkich podkatalogach. Jest to to samo co plik zawierający **/*.
• Pliki .aiexclude nie obsługują negacji (wzorców z prefiksem !).

Przykłady

Oto kilka przykładowych konfiguracji plików .aiexclude:

• Zablokuj wszystkie pliki o nazwie apikeys.txt w katalogu zawierającym plik .aiexclude lub w jego podkatalogach:

  apikeys.txt
  

• Zablokuj wszystkie pliki z rozszerzeniem .key w katalogu zawierającym plik .aiexclude lub w jego podkatalogach:

  *.key
  

• Zablokuj tylko plik apikeys.txt w tym samym katalogu co .aiexclude, ale nie w żadnych podkatalogach:

  /apikeys.txt
  

• Blokuj wszystkie pliki w katalogu my/sensitive/dir i we wszystkich podkatalogach. Ścieżka powinna być względna w stosunku do katalogu zawierającego plik .aiexclude:

  my/sensitive/dir/
  

Korzystanie z własnego klucza: używanie innych modeli Gemini w Google Chat

Eksperymentalna: ta funkcja jest eksperymentalna.

Możesz skonfigurować model Gemini, z którego korzysta Gemini w Firebase Google Chat. Możesz wybrać model wbudowany, modele skonfigurowane w oknie czatu (w tym modele Gemini 2.5) lub dowolny model Gemini, do którego masz dostęp.

Listę wszystkich dostępnych modeli znajdziesz w sekcji Geminimodele.

Ważne: ustawienia AI Firebase Studio to ustawienia użytkownika. Oznacza to, że będą one skonfigurowane na wielu stacjach roboczych.

Aby skonfigurować klucz i wybrać inny model Gemini:

1. W otwartym obszarze roboczym kliknij iskrę Gemini u dołu obszaru roboczego (lub kartę Gemini).

2. W oknie czatu Gemini w Firebase kliknij menu z nazwą modelu, a potem kliknij link Gemini API klucz. Wyświetlą się Ustawienia użytkownika.

3. W polu IDX > AI: Gemini Api Key (IDX > AI: klucz interfejsu Gemini API) wpisz klucz Gemini API.

   Uwaga: to pole może być już wypełnione, jeśli używasz App Prototyping agent i utworzono dla Ciebie projekt Firebase oraz klucz Gemini API.

Teraz możesz wybrać dowolny wstępnie skonfigurowany model Gemini na czacie.

Aby skonfigurować model Gemini, którego nie ma na liście:

1. Na liście Gemini modeli znajdź model Gemini, którego chcesz użyć w czacie. Na przykład wpisz gemini-2.0-flash-lite, aby użyć najnowszego stabilnego Gemini 2.0 Flash‑Lite modelu.

2. W oknie czatu Gemini Firebase kliknij selektor modelu, a następnie wybierz Identyfikator modelu niestandardowego. Otworzą się Ustawienia użytkownika.

3. Skopiuj wybraną nazwę modelu do pola IDX > AI: Gemini Model.

4. Zamknij okno czatu, a następnie otwórz je ponownie, klikając iskrę Gemini u dołu obszaru roboczego, aby odświeżyć listę modeli.

Dalsze kroki

• Wypróbuj Gemini w Firebase.