Konfigurowanie Gemini w obszarach roboczych

Firebase Studio ułatwia proces programowania dzięki tym funkcjom kodu opartym na AI:

• Sugestie uzupełniania kodu podczas pisania.

• Pomoc AI na czacie, która jest dostosowana do przestrzeni roboczej i w pełni zintegrowana z Twoim kodem. Może generować, tłumaczyć i wyjaśniać kod. Po sprawdzeniu i zatwierdzeniu przez Ciebie Gemini może bezpośrednio wchodzić w interakcje z Twoją przestrzenią roboczą, aby aktualizować pliki, uruchamiać polecenia terminala, interpretować wyniki poleceń i określać dalsze kroki. Więcej informacji znajdziesz w artykule Wypróbuj czat z Gemini w Firebase Studio.

• Działania w tekście, 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 kodowaniu w tekście.

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
• Dostosowywanie instrukcji dla Gemini za pomocą pliku reguł AI
• Wyklucz pliki z Gemini za pomocą .aiexclude plików.
• Przynieś własny klucz: używaj innych modeli Gemini na czacie
• Dostosuj sposób, w jaki Gemini sugeruje lub wprowadza zmiany w kodzie.

Używanie Gemini w obszarze roboczym

Użyj Gemini, aby zwiększyć produktywność podczas kodowania dzięki panelowi czatu, terminalowi lub pomocy w kodzie wbudowanym.

1. Korzystaj z pomocy na czacie lub w kodzie w swoim obszarze roboczym:

   • 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, przeczytaj artykuł 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.

Gemini skrótu

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 automatyczne 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 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 komputerze Mac).

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

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

  3. Aby wyłączyć uzupełnianie kodu, odznacz opcję Włącz wbudowane uzupełnianie kodu 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 AI w tekście.

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

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

  3. Kliknij 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). Musisz zaktualizować ustawienia indeksowania kodu w przypadku każdego obszaru roboczego.

Dostosowywanie instrukcji dla Gemini za pomocą pliku reguł AI

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

Gemini czat traktuje priorytetowo .idx/airules.md, ale użyje GEMINI.md, jeśli .idx/airules.md nie istnieje.

Gemini wykorzystuje Twoje reguły jako instrukcje systemowe i kontekst, dostosowując odpowiedzi do Twojego przypadku użycia.

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

• wpływać na profil Gemini i specjalizować się w określonych dziedzinach.
• Stosowanie standardów dotyczących całego projektu, 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 projekcie.

Tworzenie i testowanie pliku reguł AI

Aby utworzyć i przetestować plik reguł AI:

1. Utwórz nowy plik w folderze .idx/airules.md (lub GEMINI.md) w obszarze roboczym Firebase Studio. Możesz skorzystać z 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 otwórz plik GEMINI.md lub .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. Przykład pliku reguł AI znajdziesz w przykładzie poniżej.

3. Zapisz plik i otwórz Gemini.

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 będzie używać pliku reguł na czacie. Zmiany w pliku reguł AI powinny być widoczne od razu.
   • Jeśli nie chcesz ponownie tworzyć obszaru roboczego, możesz poprosić o Geminiload GEMINI.md lub 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.

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

Przykład

Poniżej znajdziesz podstawowy przykład pliku reguł, którego możesz używać w przypadku gry rekreacyjnej 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.

Wyklucz pliki z Gemini z .aiexclude plikami

Możesz określić, które pliki w bazie kodu mają być ukryte przed Gemini, dodając do projektu pliki .aiexclude. Pozwala to 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 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 .aiexclude nie będą indeksowane przez Gemini, gdy włączone jest indeksowanie bazy kodu. Dodatkowo .aiexclude wpłynie na pomoc w tekście w przypadku objętych 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.

Inne środowiska programistyczne, takie jak Android Studio, mogą też 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. 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ć podana w odniesieniu do katalogu zawierającego plik .aiexclude:

  my/sensitive/dir/
  

Korzystanie z własnego klucza: używanie innych modeli Gemini na czacie

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

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

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 kliknij Ustawienia AI. Pojawią się Ustawienia użytkownika.

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

4. W menu IDX > AI: Dostawca modelu wybierz 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. Aby na przykład użyć Gemini 3 Pro Preview modelu podglądu, wpisz gemini-3-pro-preview.

2. W oknie czatu Geminikliknij selektor modelu, a potem 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