Konfigurowanie Gemini w Firebase w obszarach roboczych

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

• sugerowane uzupełnienie kodu podczas pisania,

• pomoc AI w czacie, która uwzględnia Workspace i jest w pełni zintegrowana z Twoim kodem; Może generować, tłumaczyć i wyjaśniać kod. Po sprawdzeniu i zatwierdzeniu przez Ciebie Gemini w Firebase może bezpośrednio wchodzić w interakcje z Twoim obszarem roboczym, aby aktualizować pliki, wykonywać polecenia terminala, interpretować dane wyjściowe poleceń i określać kolejne kroki. Więcej informacji znajdziesz w czacie z Gemini.

• Działania w tekście, które możesz wykonać na wybranych fragmentach kodu. Możesz na przykład poprosić Gemini o ułatwienie odczytania wybranego kodu.

• Pomoc dotycząca kodu wbudowanego.

Możesz dostosować sposób działania Gemini w Firebase, dostosowując jego ustawienia i dodając pliki reguł AI:

• Dostosuj ustawienia uzupełniania kodu.
• Dostosuj ustawienia indeksowania kodu źródłowego.
• Dostosuj instrukcje dotyczące Gemini za pomocą pliku z regułami AI.
• Wyklucz pliki z Gemini z .aiexclude plikami.
• Własny klucz: korzystanie z innych modeli Gemini na czacie

Korzystanie z Gemini w Firebase w Twoim obszarze roboczym

Korzystaj z Gemini w Firebase, aby zwiększyć produktywność w programowaniu dzięki panelowi czatu lub pomocy w kodowaniu wstawianym w tekście.

1. Aby uzyskać pomoc, skorzystaj z czatu lub pomocy dotyczącej kodu wbudowanego w Workspace:

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

   • Aby skorzystać z pomocy wbudowanej w kod: zacznij pisać kod i naciśnij Tab, aby zaakceptować sugestie.

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

   • Sugeście podczas pisania, które umożliwiają uzupełnianie kodu w tekście.
   • indeksowanie kodu źródłowego, które zapewnia lepsze dostosowanie i przydatniejsze odpowiedzi;

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

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

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

Gemini w skrótach 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 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 udostępnia uzupełnianie kodu oparte na AI, które przewiduje i wypeł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, zmień ustawienia uzupełniania kodu za pomocą jednej z tych metod:

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

• Aby zaktualizować ustawienia w obszarze roboczym Firebase Studio:

  1. Kliknij  Zarządz (znajduje się 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. Kliknij kartę Workspace (Praca zespołowa), a następnie odszukaj ustawienie Firebase Studio > AI > Włącz dopełnianie w tekście.

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

Dostosowywanie ustawień indeksowania kodu źródłowego

Możesz kontrolować, czy Gemini indeksuje Twój kod. Indeksowanie kodu zapewnia bardziej przydatne wyniki podczas korzystania z czatu lub pomocy AI.

Pamiętaj, że indeksowanie kodu źródłowego jest domyślnie włączone.

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

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

• Aby zaktualizować ustawienia w obszarze roboczym Firebase Studio:

  1. Kliknij Zarządzaj (znajduje się 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. Kliknij kartę Workspace (Praca zespołowa), a następnie odszukaj ustawienie Firebase Studio > AI > Włącz dopełnianie w tekście.

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

  4. Aby wyłączyć indeksowanie kodu, odznacz AI: Enable Codebase Indexing (AI: włącz indeksowanie bazy kodu). Musisz zaktualizować ustawienia indeksowania kodu w przypadku każdej ze swoich przestrzeni roboczych.

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

Możesz dodać kontekst i informacje o promptach systemowych, tworząc plik reguł AI (.idx/airules.md). Gemini w Firebase używa Twoich reguł jako instrukcji i kontekstu, aby odpowiedzi były dostosowane do Twojego przypadku użycia.

Użyj pliku reguł AI, aby udostępnić Gemini niestandardowe prompty, sprawdzone metody i ważny kontekst dotyczący projektu, aby osiągnąć takie cele jak:

• Wpływ na osobowość i specjalizację Gemini.
• Stosowanie standardów dotyczących całego projektu, takich jak styl kodowania, konwencje i preferencje dotyczące technologii.
• zmniejszenie ilości informacji, które musisz udostępniać w konkretnym kodzie lub czacie, poprzez podanie istotnego kontekstu dotyczącego projektu;

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

Tworzenie i testowanie pliku reguł AI

Aby utworzyć i przetestować plik reguł AI:

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

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

2. Dodaj treść do pliku. Możesz dodać informacje o osobach, które Gemini powinna używać (np. „Jesteś doświadczonym programistą i pomocnym asystentem, który wie wszystko o Next.js”), standardy kodowania i rozmowy oraz kontekst projektu. Przykładowy plik reguł AI znajdziesz w sekcji Przykład.

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

4. Aby zacząć korzystać z reguł AI, wykonaj jedną z tych czynności:

   • Odbuduj obszar roboczy, odświeżając stronę. Po ponownym utworzeniu Gemini w Firebase będzie używać pliku z regułami w czacie. Zmiany w pliku z regułami AI powinny być natychmiast widoczne w czacie.
   • Jeśli nie chcesz ponownie tworzyć workspace’a, możesz poprosić o pomoc Gemini za pomocą czatu load airules.md. Jeśli w trakcie bieżącej sesji wprowadzisz zmiany w pliku, konieczne może być ponowne wyświetlenie prośby o Gemini, aby ponownie załadować plik reguł.

5. zadawać pytania na temat kodu; Gemini odpowiada, używając informacji zawartych w pliku z regułami jako kontekstu.

Przykład

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

Możesz określić, które pliki w kodzie źródłowym powinny być ukryte przed Gemini, dodając do projektu pliki .aiexclude. Dzięki temu możesz szczegółowo kontrolować kontekst projektu udostępniany Gemini.

Podobnie jak plik .gitignore, plik .aiexclude śledzi pliki, które nie powinny być udostępniane usłudze Gemini, w tym czat i funkcje AI działające w edytorze. Plik .aiexclude działa na plikach w katalogu, który go zawiera, lub w katalogach podrzędnych.

Pliki objęte .aiexclude nie będą indeksowane przez Gemini, gdy włączona jest opcja Indeksowanie kodu źródłowego. Dodatkowo .aiexclude wpłynie na pomoc wbudowaną w pliki objęte wsparciem w następujący sposób:

• Pomoc na czacie: Gemini nie będzie mogła odpowiadać na pytania ani proponować sugestii dotyczących plików objętych usługą .aiexclude.
• Kompletowanie kodu: sugerowane uzupełnienia kodu nie będą dostępne podczas edycji objętych plików.
• Pomoc w ramach kodu: podczas edytowania objętych plików możesz wygenerować nowy kod, ale nie możesz zmodyfikować istniejącego kodu.

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:

• Puste pliki .aiexclude blokują wszystkie pliki w katalogu i jego podkatalogach. To samo dotyczy pliku zawierającego **/*.
• Pliki .aiexclude nie obsługują zaprzeczenia (prefixing patterns with !).

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 o rozszerzeniu .key w katalogu lub podkatalogu zawierającym plik .aiexclude:

  *.key
  

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

  /apikeys.txt
  

• Blokowanie wszystkich plików w katalogu my/sensitive/dir i wszystkich podkatalogów. Ścieżka powinna być względna do katalogu zawierającego plik .aiexclude:

  my/sensitive/dir/
  

Korzystanie z własnych kluczy: używanie innych modeli Gemini w Google Chat

Możesz skonfigurować model Gemini, którego używa Gemini w Firebaseczacie. Możesz wybrać wbudowany model, 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 Geminimodeli.

Aby skonfigurować klucz i wybrać inny model Gemini:

1. W otwartym obszarze roboczym kliknij spark Gemini u dołu obszaru roboczego (lub na karcie Gemini).

2. W oknie czatu Gemini Firebase kliknij menu nazwy modelu, a potem kliknij link Gemini API klucz. Pojawi się strona Ustawienia użytkownika.

3. W polu IDX > AI: klucz Gemini Api wpisz klucz Gemini API.

W czacie możesz teraz wybrać dowolny z wstępnie skonfigurowanych modeli Gemini.

Aby skonfigurować model Gemini, który nie jest dostępny w menu:

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

2. W oknie czatu Gemini w Firebase kliknij selektor modelu, a następnie wybierz Niestandardowy identyfikator modelu. Otworzy się strona Ustawienia użytkownika.

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

4. Zamknij okno czatu, a potem 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.