Konfigurowanie Gemini w obszarach roboczych

Firebase Studio ułatwia procesy programistyczne dzięki następującym funkcjom kodu wspomaganym przez AI:

• Sugerowane uzupełnianie kodu podczas pisania.

• pomoc AI na czacie, która uwzględnia obszar roboczy i jest w pełni zintegrowana z kodem; Może generować, tłumaczyć i wyjaśniać kod. Po sprawdzeniu i zatwierdzeniu przez Ciebie Gemini może bezpośrednio korzystać z Twojego obszaru roboczego, 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, które możesz wykonać na wybranych fragmentach kodu. Możesz na przykład poprosić Gemini o zwiększenie czytelności wybranego kodu.

• Wspomaganie kodowania w tekście.

Ważne: ten przewodnik opisuje domyślny interaktywny czat Gemini. Aplikacje utworzone za pomocą App Prototyping agent domyślnie korzystają z czatu Prototyper w widoku Code. Aby zamiast tego użyć interaktywnego czatu Gemini, w sekcji Gemini kliknij +, a następnie wybierz Nowy czat. Aby wrócić do czatu Prototyper, kliknij Ostatnie czaty, a następnie wybierz Czat z Prototyperem. Informacje o czacie Prototyper znajdziesz w artykule Pierwsze kroki z App Prototyping agent.

Możesz dostosować sposób, w jaki Gemini Ci pomaga, zmieniając 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
• Exclude files from with files (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 stosuje zmiany w kodzie aplikacji.

Ważne: Gemini może generować wyniki, które wydają się wiarygodne, ale są niezgodne z prawdą. Może on podawać niedokładne informacje, których nie należy utożsamiać z opiniami Google. Zanim użyjesz danych wyjściowych z Gemini, sprawdź je. Nie używaj nieprzetestowanego wygenerowanego kodu w środowisku produkcyjnym. Nie podawaj na czacie informacji umożliwiających identyfikację ani danych użytkownika.

Używanie Gemini w obszarze roboczym

Używaj Gemini, aby zwiększyć produktywność podczas kodowania dzięki panelowi czatu, terminalowi lub kodowi wbudowanemu.

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

1. Użyj czatu lub wspomagania kodowania wbudowanego w obszarze roboczym:

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

   • Aby korzystać ze wspomagania kodowania w tekście: zacznij wpisywać kod i naciśnij Tab, aby zaakceptować sugestie.

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

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

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

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

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

Gemini skrótów

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 poleceń Gemini.

Dostosowywanie ustawień uzupełniania kodu

Aby ułatwić Ci pisanie kodu, Firebase Studio udostępnia funkcję uzupełniania kodu opartą na AI, która 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 widoku App Prototyping agent w Prototyper, kliknij Przełącz na kod, aby otworzyć widok Code.

  2. Wybierz kartę Workspace (Obszar roboczy), 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 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 we wszystkich obszarach roboczych, do których masz dostęp za pomocą swojego konta użytkownika. Jeśli udostępniasz obszar roboczy, musisz jeszcze skonfigurować ustawienie Workspace.

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

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

  2. Wybierz kartę Workspace (Obszar roboczy), a następnie wyszukaj ustawienie Firebase Studio > AI > Enable Inline Completion (Włącz uzupełnianie kodu).

  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). Musisz zaktualizować ustawienia indeksowania kodu w każdym obszarze roboczym.

Wskazówka: aby zachować to ustawienie we wszystkich obszarach roboczych, skonfiguruj je na karcie Użytkownik. Dzięki temu ustawienia będą stosowane we wszystkich obszarach roboczych, do których masz dostęp za pomocą swojego konta użytkownika. Jeśli udostępniasz obszar roboczy, musisz jeszcze skonfigurować ustawienie Workspace.

Dostosowywanie instrukcji dla Gemini za pomocą pliku reguł AI

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

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

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 projekcieGemini, aby osiągnąć takie cele jak:

• Wpływanie na osobowość i specjalizację modelu Gemini.
• 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 niezbędnego kontekstu dotyczącego projektu;

Tworzenie i testowanie pliku reguł AI

Aby utworzyć i przetestować plik reguł AI:

1. Utwórz nowy plik w .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 otwórz plik GEMINI.md lub .idx/airules.md za pomocą preferowanego edytora tekstu.

2. Dodaj treść do pliku. Możesz dodać informacje o osobie, którą Gemini powinien naśladować (np. „Jesteś ekspertem w dziedzinie programowania i pomocnym asystentem, który wie wszystko o Next.js”), standardach kodowania i rozmowy oraz kontekście projektu. Przykładowy plik reguł AI znajdziesz w sekcji Przykład poniżej.

3. Zapisz plik i otwórz Gemini.

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

   • Odśwież stronę, aby ponownie utworzyć obszar roboczy. Po ponownym utworzeniu Gemini będzie używać pliku reguł w Google Chat. Zmiany w pliku reguł AI powinny zostać odzwierciedlone natychmiast.
   • Jeśli nie chcesz ponownie tworzyć obszaru roboczego, możesz poprosić użytkownika 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 załadowanie pliku reguł.

5. zadawać pytania dotyczące kodu; Gemini odpowiada, wykorzystując informacje zawarte w pliku reguł jako kontekst.

   Gemini będzie używać (w kolejności pierwszeństwa) .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żyć 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.

Wskazówka: reguły AI wpływają na ogólny rozmiar kontekstu, dlatego zalecamy, aby plik z regułami AI nie przekraczał rozsądnego limitu. Pozwoli to zapewnić najlepszą wydajność modelu.

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. Dzięki temu możesz szczegółowo kontrolować kontekst projektu, który udostępniasz usłudze Gemini.

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

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

Pliki objęte przez .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 następujący sposób:

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

Inne środowiska programistyczne, takie jak Android Studio, mogą również 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 wszystkich podkatalogach. To samo co plik zawierający **/*.
• Pliki .aiexclude nie obsługują negacji (wzorców z prefiksem !).

Przykłady

Oto kilka przykładowych konfiguracji pliku .aiexclude:

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

  apikeys.txt
  

• Blokuj wszystkie pliki z rozszerzeniem pliku .key w katalogu, który zawiera plik .aiexclude, lub w jego podkatalogach:

  *.key
  

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

  /apikeys.txt
  

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

  my/sensitive/dir/
  

Przynieś własny klucz: używaj innych modeli Gemini na czacie

Eksperymentalna: ta funkcja jest eksperymentalna.

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

Listę wszystkich dostępnych modeli znajdziesz w artykule o modelach Gemini.

Ważne: ustawienia Firebase Studio AI 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 ikonę Spark 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 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 w Firebase oraz klucz Gemini API.

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

Możesz teraz wybrać dowolny ze wstępnie skonfigurowanych modeli Gemini na czacie.

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

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

2. W oknie czatu Gemini kliknij selektor modelu, a następnie wybierz Identyfikator modelu niestandardowego. Otworzy się okno 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.