Pisanie kodu z Gemini Code Assist dla osób prywatnych

Uwaga: jeśli korzystasz z konta służbowego lub chcesz uzyskać więcej korzyści na poziomie zespołu, rozważ przejście na Gemini Code Assist Standard lub Enterprise.

Ten dokument opisuje, jak korzystać z Gemini Code Assist, opartej na AI usługi wspomagającej w środowisku IDE, która ułatwi Ci wykonywanie tych czynności w VS Code lub IntelliJ i innych obsługiwanych środowiskach IDE JetBrains:

• Generuj kod do projektu za pomocą przekształcania kodu.
• Otrzymuj sugestie uzupełniania kodu podczas pisania.
• Korzystaj z inteligentnych działań.

Jeśli korzystasz z Gemini Code Assist Enterprise, możesz używać dostosowywania kodu, które umożliwia uzyskiwanie sugestii kodu na podstawie prywatnej bazy kodu organizacji bezpośrednio z Gemini Code Assist Enterprise. Dowiedz się, jak skonfigurować dostosowywanie kodu.

Ten dokument jest przeznaczony dla deweloperów na wszystkich poziomach zaawansowania. Zakłada się, że masz praktyczną wiedzę o VS Code lub IntelliJ i innych obsługiwanych środowiskach IDE JetBrains. Możesz też użyć Gemini w Android Studio.

Uwaga: działanie funkcji generowania, uzupełniania i przekształcania kodu jest nieokreślone, gdy są one używane jednocześnie z innymi wtyczkami, które implementują te same skróty lub używają tego samego interfejsu API platformy do przetwarzania tych działań.

Zanim zaczniesz

VS Code

1. skonfigurować Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobisz;

2. Zanim przetestujesz funkcje Gemini Code Assist w pliku z kodem, upewnij się, że język kodowania pliku jest obsługiwany. Więcej informacji o obsługiwanych językach kodowania znajdziesz w artykule Obsługiwane języki kodowania.

3. Jeśli wolisz używać środowiska IDE za serwerem proxy, zapoznaj się z artykułem Połączenia sieciowe w Visual Studio Code.

IntelliJ

1. skonfigurować Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobisz;

2. Zanim przetestujesz funkcje Gemini Code Assist w pliku z kodem, upewnij się, że język kodowania pliku jest obsługiwany. Więcej informacji o obsługiwanych językach kodowania znajdziesz w artykule Obsługiwane języki kodowania.

3. Jeśli wolisz używać IDE za serwerem proxy, zapoznaj się z sekcją Serwer proxy HTTP.

Generowanie kodu za pomocą promptów

W kolejnych sekcjach dowiesz się, jak używać Gemini Code Assist do generowania kodu z przykładowym promptem Function to create a Cloud Storage bucket w pliku z kodem. Możesz też wybrać fragment kodu, a następnie poprosić Gemini Code Assist o pomoc za pomocą funkcji czatu oraz otrzymywać i akceptować lub odrzucać sugestie dotyczące kodu podczas pisania.

Wywoływanie Gemini Code Assist za pomocą przekształcenia kodu

Transformacja kodu umożliwia używanie poleceń lub promptów w języku naturalnym w menu szybkiego wyboru w celu poproszenia o zmiany w kodzie. Zapewnia też widok różnic, który pokazuje oczekujące zmiany w kodzie. Aby poprosić Gemini Code Assist o przekształcenie kodu, wykonaj te czynności:

VS Code

1. W pliku kodu w nowym wierszu naciśnij Ctrl+I (Windows i Linux) lub Command+I (macOS), aby otworzyć menu Szybki wybór Gemini Code Assist.

2. W menu za pomocą polecenia /generate wpisz /generate function to create a Cloud Storage bucket, a następnie naciśnij Enter (w systemach Windows i Linux) lub Return (w systemie macOS).

   

   Gemini Code Assist generuje kod na podstawie prompta w widoku różnic.

   

3. Opcjonalnie: aby zaakceptować te zmiany, kliknij Zaakceptuj.

IntelliJ

1. W pliku kodu w nowym wierszu naciśnij Alt+\ (Windows i Linux) lub Cmd+\ (macOS), aby otworzyć menu Szybki wybór Gemini Code Assist.

2. W menu za pomocą polecenia /generate wpisz /generate function to create a Cloud Storage bucket, a następnie naciśnij Enter (w systemach Windows i Linux) lub Return (w systemie macOS).

   

   Gemini Code Assist generuje kod na podstawie prompta w widoku różnic.

   

3. Opcjonalnie: aby zaakceptować te zmiany, kliknij Zaakceptuj zmiany.

   W środowisku IDE możesz używać tych poleceń przekształcania kodu:

   • /fix: rozwiąż problemy lub błędy w kodzie. Przykład: /fix potential NullPointerExceptions in my code.
   • /generate: wygeneruj kod. Przykład: /generate a function to get the current time.
   • /doc: Dodaj dokumentację do kodu. Przykład: /doc this function.
   • /simplify: uprość kod. Przykład: /simplify if statement in this code.

Wysyłanie promptów do Gemini Code Assist w pliku z kodem za pomocą komentarza

Jeśli wolisz, możesz też wywołać Gemini Code Assist w pliku kodu za pomocą komentarza, wykonując te czynności:

VS Code

1. W nowym wierszu wpisz komentarz Function to create a Cloud Storage bucket, a następnie naciśnij Enter (w systemach Windows i Linux) lub Return (w systemie macOS).

2. Aby wygenerować kod, naciśnij Ctrl+Enter (Windows i Linux) lub Ctrl+Return (macOS).

   Obok tekstu prompta w pliku z kodem Gemini Code Assist generuje kod w postaci szarego tekstu.

3. Opcjonalnie: aby zaakceptować wygenerowany kod, naciśnij Tab.

IntelliJ

1. W pliku z kodem w nowym wierszu wpisz komentarz Function to create a Cloud Storage bucket.

2. Aby wygenerować kod, naciśnij Alt+G (Windows i Linux) lub Option+G (macOS). Możesz też kliknąć prawym przyciskiem myszy obok komentarza i wybrać Generuj kod.

   Gemini Code Assist generuje kod pod komentarzem w formie tekstu widma.

3. Opcjonalnie: aby zaakceptować wygenerowany kod, naciśnij Tab.

Opcjonalnie: zmiana skrótu klawiszowego do generowania kodu

Jeśli domyślny skrót klawiszowy do generowania kodu nie działa zgodnie z opisem w poprzedniej sekcji, możesz zmienić skrót klawiszowy.

Uzupełnianie kodu

Podczas pisania kodu Gemini Code Assist wyświetla sugestie kodu w tekście, zwane też uzupełnianiem kodu, które możesz zaakceptować lub zignorować. Aby uzyskać uzupełnianie kodu, wykonaj te czynności:

VS Code

1. W pliku kodu w nowym wierszu zacznij pisać funkcję. Jeśli na przykład jesteś w pliku Pythona, wpisz def.

   Gemini Code Assist sugeruje kod w formie tekstu widma.

2. Aby zaakceptować sugestię kodu od Gemini Code Assist, naciśnij Tab. Aby zignorować sugestię, naciśnij Esc lub kontynuuj pisanie kodu.

IntelliJ

1. W pliku kodu w nowym wierszu zacznij pisać funkcję. Jeśli na przykład jesteś w pliku Pythona, wpisz def.

   Gemini Code Assist sugeruje kod w formie sugestii w tekście.

2. Aby zaakceptować sugestię kodu od Gemini Code Assist, naciśnij Tab. Aby zignorować sugestię, naciśnij Esc lub kontynuuj pisanie kodu.

3. Opcjonalnie: jeśli wolisz użyć innego klawisza skrótu, aby zaakceptować sugestię w tekście, umieść wskaźnik myszy nad sugestią i kliknij wyświetlone menu Tab. Następnie wybierz preferowany skrót lub kliknij Niestandardowy, aby wpisać własny skrót.

   

Opcjonalnie: wyłącz uzupełnianie kodu

Uzupełnianie kodu jest domyślnie włączone. Jeśli chcesz wyłączyć uzupełnianie kodu, wykonaj te czynności:

VS Code

1. W IDE kliknij Code (macOS) lub File (Windows i Linux), a następnie otwórz Settings > Settings.

2. Na karcie Użytkownik w oknie Ustawienia kliknij Rozszerzenia > Gemini Code Assist.

3. Przewiń, aż znajdziesz listę Duet AI: sugestie w tekście: włącz automatyczne, a następnie wybierz Wyłącz.

   Spowoduje to wyłączenie sugestii w tekście. Nadal możesz nacisnąć Ctrl+Enter (Windows i Linux) lub Ctrl+Return (macOS), aby ręcznie wywołać sugestie w tekście.

IntelliJ

Na pasku stanu IDE kliknijspark Gemini Code Assist: Active (Gemini Code Assist: aktywny) i wybierz Enable AI Code Completion (Włącz uzupełnianie kodu przez AI).

Spowoduje to wyłączenie ustawienia uzupełniania kodu, a Gemini Code Assist nie będzie już wyświetlać sugestii w tekście, dopóki nie włączysz ponownie tego ustawienia.

Korzystanie z inteligentnych działań

Aby zwiększyć produktywność przy jednoczesnym ograniczeniu przełączania kontekstu, Gemini Code Assist udostępnia inteligentne działania oparte na AI bezpośrednio w edytorze kodu. Gdy wybierzesz kod w edytorze, możesz wyświetlić listę działań odpowiednich w danym kontekście i wybrać z niej jedno z nich.

Aby używać inteligentnych działań w kodzie, wykonaj te czynności:

VS Code

1. W pliku z kodem wybierz blok kodu.

2. Obok wybranego bloku kodu kliknij lightbulb Pokaż działania związane z kodem.

   

3. Wybierz działanie, np. Generuj testy jednostkowe.

   Gemini Code Assist generuje odpowiedź na podstawie wybranego działania.

IntelliJ

1. W pliku z kodem wybierz wiersz lub blok kodu.

2. Kliknij prawym przyciskiem myszy wybrany kod i wybierz inteligentne działanie, np. Generuj testy jednostkowe.

   Wybranie inteligentnego działania spowoduje automatyczne wyświetlenie promptu w Gemini Code Assist, który wygeneruje odpowiedź w oknie narzędzia.

Korzystanie z szybkiej poprawki przekształcenia kodu

Jeśli w kodzie wystąpi błąd, Gemini Code Assist umożliwia zastosowanie szybkiej poprawki, która przekształci kod.

Aby zastosować szybką poprawkę w pliku z kodem, wykonaj te czynności:

VS Code

1. W pliku kodu najedź kursorem na linię błędu i wybierz Szybka poprawka, a następnie /fix.

   

2. Po zastosowaniu szybkiej poprawki pojawi się widok różnic. Aby zaakceptować te zmiany, kliknij Akceptuję.

IntelliJ

1. W pliku z kodem kliknij czerwoną ikonę żarówki, która wskazuje błąd w kodzie, i wybierz Popraw za pomocą Gemini.

   

2. Po zastosowaniu poprawki pojawi się widok różnic. Aby zaakceptować te zmiany, kliknij Akceptuj.

Wykluczanie plików z kontekstu lokalnego

Domyślnie Gemini Code Assist wyklucza pliki z lokalnego użycia w kontekście uzupełniania kodu, generowania kodu, przekształcania kodu i czatu, jeśli pliki są określone w pliku .aiexclude lub .gitignore.

Aby dowiedzieć się, jak wykluczyć pliki z użycia lokalnego, przeczytaj artykuł Wykluczanie plików z użycia w Gemini Code Assist.

Wyłączanie sugestii kodu pasujących do cytowanych źródeł

Uwaga: wyłączanie sugestii kodu, które pasują do cytowanych źródeł, nie jest obsługiwane w środowisku IntelliJ ani w innych środowiskach IDE JetBrains.

Gemini Code Assist podaje informacje o źródle, gdy przytacza bezpośredni cytat z innego źródła, np. z istniejącego kodu open source. Więcej informacji znajdziesz w artykule Jak i kiedy Gemini podaje źródła.

Aby zapobiec sugerowaniu kodu pasującego do cytowanych źródeł:

1. Na pasku aktywności IDE kliknij Zarządzaj > Ustawienia.

2. Na karcie Użytkownik w oknie ustawień kliknij Rozszerzenia > Gemini Code Assist.

3. Przewiń w dół, aż zobaczysz Geminicodeassist > Recitation: Max Cited Length (Geminicodeassist > Recitation: Max Cited Length).

4. Ustaw wartość na 0.

   Gemini Code Assist nie będzie już sugerować kodu, który pasuje do cytowanych źródeł.

Znane problemy

W tej sekcji znajdziesz informacje o znanych problemach z Gemini Code Assist:

VS Code

• Odpowiedzi na czacie mogą być obcięte, jeśli zawierają zaktualizowaną wersję dużego otwartego pliku

  Aby obejść ten problem, wybierz mniejszą sekcję kodu i dodaj do promptu na czacie dodatkową dyrektywę, np. only output the selected code.

• Vim: nie można zaakceptować ani odrzucić sugestii generowania kodu, chyba że w trybie wstawiania

  Gdy używasz wtyczki Vim w trybie normalnym, nie możesz akceptować ani odrzucać sugestii kodu.

  Aby obejść ten problem, naciśnij i, aby przejść do trybu wstawiania, a następnie naciśnij Tab, aby zaakceptować sugestię.

• Vim: niespójne działanie po naciśnięciu klawisza Esc w celu odrzucenia sugestii

  Gdy naciśniesz Esc, zostaną odrzucone zarówno sugestie IDE, jak i Gemini Code Assist. To zachowanie różni się od zachowania w przypadku edytora innego niż Vim, w którym naciśnięcie klawisza Esc ponownie aktywuje Gemini Code Assist.

• Próby logowania ciągle przekraczają limit czasu

  Jeśli próby logowania nadal będą przekraczać limit czasu, spróbuj dodać ustawienie cloudcode.beta.forceOobLogin do pliku settings.json:

   "cloudcode.beta.forceOobLogin": true
  

• Ostrzeżenia dotyczące recytowania licencji nie są zachowywane między sesjami

  Jeśli ostrzeżenia dotyczące recytacji licencji nie utrzymują się w różnych sesjach, zapoznaj się z trwałymi dziennikami:

  1. Kliknij Widok > Dane wyjściowe.

  2. Wybierz Gemini Code Assist – cytaty.

• Problemy z łącznością w oknie wyjściowym Gemini Code Assist

  Jeśli w oknie danych wyjściowych funkcji Gemini Code Assist zobaczysz błąd połączenia lub inne problemy z łącznością, wypróbuj te rozwiązania:

  • Skonfiguruj zaporę sieciową, aby zezwalała na dostęp do oauth2.googleapis.com i cloudaicompanion.googleapis.com.

  • Skonfiguruj zaporę sieciową tak, aby zezwalała na komunikację przez HTTP/2, z którego korzysta gRPC.

  Do testowania połączenia możesz użyć narzędzia grpc-health-probe. A Pomyślne sprawdzenie daje te dane wyjściowe:

  $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

  Nieudana weryfikacja powoduje wyświetlenie tego komunikatu:

  timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

  Aby uzyskać więcej informacji, przed uruchomieniem polecenia grpc-health-probe wykonaj to działanie:

  export GRPC_GO_LOG_SEVERITY_LEVEL=info
  

IntelliJ

Nie ma znanych problemów z Gemini Code Assist w IntelliJ i innych obsługiwanych środowiskach IDE JetBrains.

Wyślij opinię

Aby przesłać opinię o swoich wrażeniach, wykonaj te czynności:

VS Code

1. Możesz przesłać opinię na jeden z tych sposobów:

   • Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu Szybki wybór wybierz Prześlij opinię.
   • Otwórz paletę poleceń (Ctrl/Command + Shift + P), a następnie wybierz Gemini Code Assist: Send Feedback (Gemini Code Assist: prześlij opinię).

2. Wypełnij pola Tytuł i Komentarze.

3. W formularzu Opinia o Gemini Code Assist wybierz opcję z menu Kategoria opinii i Typ.

4. W polu Komentarz szczegółowo opisz swoje wrażenia.

5. Pamiętaj, aby w raporcie z opinią uwzględnić logi Gemini Code Assist. Ta opcja jest domyślnie zaznaczona.

6. Zaznacz lub odznacz inne opcje zgodnie z potrzebami.

7. Kliknij Prześlij opinię.

IntelliJ

1. Na pasku stanu kliknij spark Gemini Code Assist.

2. Po wywołaniu Gemini Code Assist na czacie i jeśli nie jesteś zadowolony(-a) z odpowiedzi, kliknij thumb_down Negatywna, a następnie wybierz Prześlij opinię.

3. W polu tekstowym u góry formularza wpisz swoją opinię.

4. Jeśli chcesz udostępnić logi Gemini Code Assist, wybierz pliki logów.

5. Kliknij Prześlij opinię.

Co dalej?

• Dowiedz się, jak Gemini w Google Cloud korzysta z Twoich danych.
• Dowiedz się więcej o cenach Gemini Code Assist Standard i Enterprise.