Konfigurowanie Gemini w obszarach roboczych

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

• Sugestie uzupełniania kodu podczas pisania.

• Pomoc AI w czacie, która jest świadoma obszaru roboczego i w pełni zintegrowana z Twoim kodem. Może generować, tłumaczyć i wyjaśniać kod. Po Twoim sprawdzeniu i zatwierdzeniu Gemini może bezpośrednio wchodzić w interakcję z Twoim obszarem roboczym, aby aktualizować pliki, uruchamiać polecenia terminala, interpretować dane wyjściowe poleceń i określać dalsze kroki. Więcej informacji znajdziesz w artykule Wypróbuj czat z Gemini w Firebase Studio.

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

• Pomoc wbudowana przy kodowaniu.

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

• Dostosuj ustawienia uzupełniania kodu.
• Dostosuj ustawienia indeksowania bazy kodu.
• Dostosuj instrukcje dla Gemini za pomocą pliku reguł AI.
• Wyklucz pliki z Gemini za pomocą .aiexclude plików.
• Użyj własnego klucza: używaj innych modeli Gemini na czacie
• Dostosuj sposób, w jaki Gemini sugeruje lub stosuje zmiany w kodzie.

Używanie Gemini w obszarze roboczym

Używaj Gemini, aby zwiększyć wydajność kodowania za pomocą panelu czatu, terminala lub pomocy wbudowanej.

1. W obszarze roboczym użyj czatu lub pomocy wbudowanej:

   • Aby używać czatu: w otwartym obszarze roboczym u dołu kliknij ikonę iskry Gemini.

   • Aby używać pomocy wbudowanej: zacznij pisać kod i naciśnij Tab, aby zaakceptować sugestie.

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

   • Sugestie podczas pisania, która zapewnia uzupełnianie kodu wbudowanego.
   • Indeksowanie bazy kodu, która zapewnia lepsze dostosowywanie i bardziej przydatne odpowiedzi.

   Aby w przyszłości zmienić te ustawienia w obszarze roboczym:

   • Aby zaktualizować ustawienia uzupełniania kodu, przeczytaj artykuł Dostosowywanie ustawień uzupełniania kodu.
   • Aby zaktualizować ustawienia indeksowania kodu, przeczytaj artykuł Dostosowywanie ustawień indeksowania kodu.

   Możesz też wykluczyć z indeksowania przez AI określone pliki i katalogi. Więcej informacji znajdziesz w artykule Wykluczanie plików z Gemini za pomocą .aiexclude plików.

Gemini skróty

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

Aby wyświetlić polecenia Gemini na palecie poleceń:

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

2. Wyszukaj Gemini.

   Pojawi się lista poleceń Gemini.

Dostosowywanie ustawień uzupełniania kodu

Aby ułatwić Ci pisanie kodu, Firebase Studio oferuje uzupełnianie kodu przez AI, które przewiduje i automatycznie uzupełnia kod w dowolnym otwartym pliku, gdy tylko zaczniesz pisać.

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

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 "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 widoku, kliknij Przełącz na kod , aby otworzyć widok Code.

  2. Kliknij kartę Obszar roboczy, a następnie wyszukaj ustawienie Firebase Studio > AI > Włącz uzupełnianie wbudowane

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

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 wbudowanej AI.

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

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 Macu).

     Jeśli używasz App Prototyping agent w Prototyper widoku, kliknij Przełącz na kod , aby otworzyć widok Code.

  2. Kliknij kartę Obszar roboczy, a następnie wyszukaj ustawienie Firebase Studio > AI > Włącz uzupełnianie wbudowane.

  3. Kliknij Firebase Studio > AI: Włącz indeksowanie bazy kodu.

  4. Aby wyłączyć indeksowanie kodu, odznacz opcję AI: Włącz indeksowanie bazy kodu. Ustawienia indeksowania kodu musisz zaktualizować w każdym obszarze roboczym.

Dostosowywanie instrukcji dla Gemini za pomocą pliku reguł AI

Możesz dodać informacje o kontekście i prompcie systemowym, tworząc plik reguł AI:

Czat Gemini traktuje priorytetowo plik .idx/airules.md, ale jeśli ten plik nie istnieje, użyje pliku GEMINI.md..idx/airules.md

Gemini używa Twoich reguł jako instrukcji systemowych i kontekstu, dostosowując odpowiedzi do Twojego przypadku użycia.

Użyj pliku reguł AI, aby udostępnić niestandardowe prompty, sprawdzone metody, a nawet ważne informacje o kontekście projektu dla Gemini, aby osiągnąć takie cele jak:

• wpływanie na osobowość Gemini i specjalizowanie jego wiedzy;
• stosowanie standardów obowiązujących w całym projekcie, takich jak styl kodowania, konwencje i preferencje technologiczne;
• zmniejszenie ilości informacji, które musisz udostępniać w kodzie lub na czacie, dzięki podaniu podstawowych informacji o kontekście projektu.

Tworzenie i testowanie pliku reguł AI

Aby utworzyć i przetestować plik reguł AI:

1. Utwórz nowy plik w lokalizacji .idx/airules.md (lub GEMINI.md) w obszarze roboczym Firebase Studio. Możesz użyć jednej z tych opcji:

   • W Eksploratorze (Ctrl+Shift+E) kliknij prawym przyciskiem myszy katalog nadrzędny i wybierz Nowy plik. Nazwij plik i naciśnij Enter.
   • W terminalu użyj preferowanego edytora tekstu, aby otworzyć plik GEMINI.md lub .idx/airules.md.

2. Dodaj treść do pliku. Możesz dodać informacje o osobowości, Gemini której ma używać (np. „Jesteś doświadczonym programistą i pomocnym asystentem, który wie wszystko o Next.js”), standardach kodowania i konwersacji oraz kontekście projektu. Przykład pliku reguł AI znajdziesz w sekcji Przykład.

3. Zapisz plik i otwórz Gemini.

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

   • Odbuduj obszar roboczy, odświeżając stronę. Po odbudowaniu, Gemini będzie używać pliku reguł na czacie. Zmiany w pliku reguł AI powinny być widoczne od razu.
   • Jeśli nie chcesz odbudowywać obszaru roboczego, możesz poprosić Gemini o load GEMINI.md lub load airules.md. Jeśli wprowadzisz zmiany w pliku podczas bieżącej sesji, może być konieczne ponowne poproszenie Gemini o wczytanie pliku reguł.

5. Zadawaj pytania dotyczące kodu. Gemini odpowiada, używając informacji zawartych w pliku reguł jako kontekstu.

   Gemini będzie używać (w kolejności priorytetu) .idx/airules.md, GEMINI.md, .gemini/styleguide.md, AGENTS.md lub cursorrules.

Przykład

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

Wykluczanie plików 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 pl0ik .gitignore, plik .aiexclude śledzi pliki, które nie powinny być udostępniane Gemini, w tym czat oraz 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.

Pliki objęte plikiem .aiexclude nie będą indeksowane przez Gemini, gdy Indeksowanie bazy kodu jest włączone. Ponadto plik .aiexclude będzie wpływać na pomoc wbudowaną w przypadku objętych nim plików w te sposoby:

• Pomoc na czacie: Gemini nie będzie w stanie odpowiadać na pytania ani oferować sugestii dotyczących plików objętych plikiem .aiexclude.
• Uzupełnianie kodu: podczas edytowania objętych plików nie będą dostępne sugestie uzupełniania kodu.
• Pomoc wbudowana: podczas edytowania objętych plików będzie można generować nowy kod, ale nie modyfikować istniejącego.

Inne środowiska programistyczne, takie jak Android Studio, mogą również uwzględniać .aiexclude pliki.

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 (poprzedzania wzorców znakiem !).

Przykłady

Oto kilka przykładów konfiguracji pliku .aiexclude:

• Zablokuj wszystkie pliki o nazwie apikeys.txt w katalogu, w którym znajduje się plik .aiexclude, i w jego podkatalogach:

  apikeys.txt
  

• Zablokuj wszystkie pliki z rozszerzeniem .key w katalogu, w którym znajduje się plik .aiexclude, i w jego podkatalogach:

  *.key
  

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

  /apikeys.txt
  

• Zablokuj wszystkie pliki w katalogu my/sensitive/dir i we wszystkich podkatalogach. Ścieżka powinna być względna w stosunku do katalogu, w którym znajduje się plik .aiexclude:

  my/sensitive/dir/
  

Użyj własnego klucza: używaj innych Gemini modeli na czacie

Możesz skonfigurować model Gemini, którego używa Gemini czat. Możesz wybrać model wbudowany, modele skonfigurowane w oknie czatu lub dowolny Gemini model, do którego masz dostęp.

Listę wszystkich dostępnych modeli znajdziesz w artykule Gemini modele.

Aby skonfigurować klucz i wybrać inny model Gemini:

1. W otwartym obszarze roboczym u dołu kliknij ikonę iskry Gemini (lub kartę Gemini).

2. W oknie czatu Gemini kliknij Ustawienia AI. Pojawią się Ustawienia użytkownika.

3. W polu IDX > AI: Klucz interfejsu Gemini API, wpisz swój klucz Gemini API.

4. W menu IDX > AI: Dostawca modelu wybierz Gemini API.

Teraz możesz wybrać dowolny ze wstępnie skonfigurowanych Gemini modeli na czacie.

Aby skonfigurować model Gemini, którego nie ma w menu:

1. Na liście w artykule Gemini models znajdź model Gemini, którego chcesz używać na czacie. Aby na przykład używać modelu w wersji Preview gemini-3-pro-preview, wpisz Gemini 3 Pro Preview preview model.

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

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

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

Dalsze kroki

• Wypróbuj Gemini.