Ten dokument opisuje, jak korzystać z Gemini Code Assist, czyli opartej na AI usługi wspomagającej w IDE, która ułatwia wykonywanie tych czynności w VS Code, IntelliJ i innych obsługiwanych środowiskach IDE JetBrains:
- Przekazują wskazówki, które pomogą Ci rozwiązać problemy z kodem.
- wygenerować kod dla projektu;
- otrzymywać sugestie w tekście podczas kodowania,
Dowiedz się, jak i kiedy Gemini dla Google Cloud korzysta z Twoich danych
Aby pomóc Ci w spełnianiu wymagań licencyjnych dotyczących kodu, Gemini Code Assist podaje źródło, gdy jego sugestie bezpośrednio cytują fragmenty z konkretnego źródła. Więcej informacji o tym, jak i kiedy Gemini podaje źródła, znajdziesz w artykule Jak Gemini pomaga generować kod i podawać źródła.
Ten dokument jest przeznaczony dla deweloperów na każdym poziomie zaawansowania. Zakładamy, że znasz środowisko IDE VS Code lub IntelliJ oraz inne obsługiwane środowiska IDE JetBrains. Jeśli wolisz, możesz też zapoznać się z Gemini Code Assist w Cloud Shell i Cloud Workstations.
Zanim zaczniesz
- Zanim przetestujesz możliwości Gemini Code Assist w pliku kodu, sprawdź, czy język kodowania pliku jest obsługiwany. Więcej informacji o obsługiwanych językach kodowania znajdziesz w artykule Obsługiwane języki kodowania.
- Jeśli wolisz używać środowiska IDE za pośrednictwem serwera proxy, zapoznaj się z artykułem Połączenia sieciowe w Visual Studio Code.
Zanim przetestujesz możliwości Gemini Code Assist w pliku kodu, sprawdź, czy język kodowania pliku jest obsługiwany. Więcej informacji o obsługiwanych językach kodowania znajdziesz w artykule Obsługiwane języki kodowania.
Jeśli wolisz używać IDE za pośrednictwem serwera proxy, zapoznaj się z artykułem Serwer proxy HTTP.
Czat z Gemini Code Assist
W tej sekcji poprosisz Gemini Code Assist o wyjaśnienie istniejącego kodu.
Aby uzyskać wyjaśnienie kodu:
Otwórz plik kodu.
Na pasku działań w IDE kliknij spark Gemini Code Assist.
W panelu Gemini Code Assist wpisz prompt
Explain this code to me
i kliknij send Wyślij.Gemini używa kodu w pliku kodu jako odniesienia do prompta i odpowiada wyjaśnieniem kodu.
Aby odwoływać się do konkretnego bloku kodu zamiast całego kodu w pliku, możesz wybrać blok w pliku kodu, a potem poprosić Gemini o pomoc.
Aby uzyskać wyjaśnienie kodu:
W swojej IDE otwórz plik kodu.
W oknie narzędzia Gemini Code Assist wpisz prompt
Explain this code to me
i kliknij Prześlij.
Gemini Code Assist używa kodu w pliku kodu jako odniesienia do promptu i odpowiada wyjaśnieniem kodu.
Jeśli chcesz wyjaśnienie tylko określonej części kodu, możesz ją wybrać, a potem ponownie uruchomić Gemini Code Assist. Gemini Code Assist będzie używać wybranego kodu tylko jako odniesienia do wygenerowanej odpowiedzi.
Gdy Gemini Code Assist podaje kod w odpowiedzi, możesz wybrać jedną z tych opcji podanych na końcu odpowiedzi:
Wstaw w miejscu kursora: wstawia wygenerowany kod do bieżącego pliku w miejscu, w którym znajduje się kursor.
Wstaw do nowego pliku: otwiera nowy plik i wstawia wygenerowany kod.
Te opcje są dostępne, gdy Gemini Code Assist rozpozna język użyty w bloku kodu i gdy jest on obsługiwany w Twoim obecnym środowisku IDE.
Wyświetlanie historii zapytań
Jeśli chcesz ponownie użyć poprzednich promptów, znajdziesz je w historii zapytań w oknie narzędzia Gemini Code Assist. Aby je wyświetlić, kliknij schedule Pokaż historię zapytań.
Zresetuj historię czatu
Gemini Code Assist korzysta z historii czatu, aby uzyskać dodatkowy kontekst, gdy odpowiada na Twoje prompty. Jeśli historia czatu nie jest już przydatna, możesz ją zresetować:
W panelu Gemini Code Assist kliknijdelete Zresetuj czat.
W oknie narzędzia Gemini Code Assist kliknij delete Wyczyść historię rozmów. Spowoduje to też wyczyszczenie historii zapytań.
Generowanie kodu z promptami
W kolejnych sekcjach dowiesz się, jak użyć Gemini Code Assist do wygenerowania kodu z przykładowym promptem Function to create a Cloud Storage
bucket
w pliku kodu. Możesz też wybrać część kodu, a potem poprosić Gemini Code Assist o pomoc za pomocą funkcji czatu. Podczas kodowania możesz też akceptować lub odrzucać sugestie dotyczące kodu.
Prompt Gemini Code Assist with code transformation
Transformacja kodu umożliwia używanie poleceń lub promptów w języku naturalnym w menu Szybki wybór, aby żądać modyfikacji kodu. Zapewnia też widok różnic, który pokazuje oczekujące zmiany w kodzie. Aby poprosić Gemini Code Assist o przekształcenie kodu:
W pliku kodu na nowej linii naciśnij Control+I (w Windows i Linux) lub Command+I (w macOS), aby otworzyć pasek Szybki wybór w Gemini Code Assist.
W menu za pomocą polecenia
/generate
wpisz/generate function to create a Cloud Storage bucket
, a następnie naciśnij Enter (w systemie Windows lub Linux) lub Return (w systemie macOS).Gemini Code Assist generuje kod na podstawie prompta w widoku różnic.
Opcjonalnie: aby zaakceptować te zmiany, kliknij Zaakceptuj.
Wywołaj Gemini Code Assist w pliku kodu za pomocą komentarza
Jeśli wolisz, możesz też poprosić Gemini Code Assist o pomoc w pliku kodu, dodając komentarz. Aby to zrobić:
Na nowej linii wpisz komentarz
Function to create a Cloud Storage bucket
, a następnie naciśnij Enter (w systemie Windows i Linux) lub Return (w systemie macOS).Aby wygenerować kod, naciśnij Control + Enter (w systemie Windows i Linux) lub Control + Return (w systemie macOS).
Obok tekstu promptu w pliku kodu Gemini Code Assist generuje kod w postaci tekstu niewidocznego.
Opcjonalnie: aby zaakceptować wygenerowany kod, naciśnij Tab.
Wysyłanie zapytania do Gemini Code Assist dotyczące wybranego kodu za pomocą czatu
Gemini Code Assist może wykonywać zadania lub odpowiadać na pytania na podstawie wybranego przez Ciebie kodu. Aby uzyskać wygenerowany kod na podstawie prompta z wybranym kodem, wykonaj te czynności:
Na pasku działań kliknij spark Gemini Code Assist, aby otworzyć panel Gemini Code Assist.
W pliku kodu wybierz blok kodu.
W polu tekstowym na panelu Gemini Code Assist wpisz prompt dla wybranego kodu.
Wybierz na przykład funkcję w kodzie i wpisz prompt
Write a unit test for this function
:Gemini używa wybranego kodu jako odniesienia i odpowiada na Twoje prompty.
Prompt Gemini Code Assist with code transformation
Transformacja kodu umożliwia korzystanie z komend lub poleceń w języku naturalnym w menu Szybki wybór, aby poprosić o modyfikację kodu. 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:
W pliku kodu na nowej linii naciśnij Alt + \ (w przypadku systemu Windows lub Linux) albo Cmd + \ (w przypadku systemu macOS), aby otworzyć menu Szybki wybór asystenta kodu Gemini.
W menu za pomocą polecenia
/generate
wpisz/generate function to create a Cloud Storage bucket
, a następnie naciśnij Enter (w systemie Windows lub Linux) lub Return (w systemie macOS).Gemini Code Assist generuje kod na podstawie prompta w widoku różnic.
Opcjonalnie: aby zaakceptować te zmiany, kliknij Zaakceptuj zmiany.
W swoim środowisku IDE możesz używać tych poleceń przekształcania kodu:
/fix
: rozwiązywanie problemów lub błędów 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
.
Wywołaj Gemini Code Assist w pliku kodu za pomocą komentarza
W pliku kodu na nowej linii wpisz komentarz
Function to create a Cloud Storage bucket
.Aby wygenerować kod, naciśnij Alt + G (w Windows i Linux) lub Option + G (w macOS). Możesz też kliknąć prawym przyciskiem myszy obok komentarza i wybrać Generuj kod.
Gemini Code Assist generuje kod pod Twoim komentarzem w postaci tekstu niewidocznego.
Opcjonalnie: aby zaakceptować wygenerowany kod, naciśnij Tab.
Wysyłanie zapytania do Gemini Code Assist dotyczące wybranego kodu za pomocą czatu
Gemini Code Assist może wykonywać zadania lub odpowiadać na pytania na podstawie wybranego przez Ciebie kodu. Aby uzyskać wygenerowany kod na podstawie prompta z wybranym kodem, wykonaj te czynności:
Na pasku działań kliknij spark Gemini Code Assist, aby otworzyć okno narzędzia Gemini Code Assist.
W pliku kodu wybierz blok kodu.
W polu tekstowym okna narzędzia Gemini Code Assist wpisz prompt dla wybranego kodu.
Wybierz na przykład funkcję w kodzie i wpisz prompt
Write a unit test for this function.
Gemini Code Assist używa wybranego kodu jako odniesienia i reaguje na prompt.
Opcjonalnie: zmień skrót klawiszowy do generowania kodu
Jeśli domyślny skrót klawiszowy do generowania kodu nie działa zgodnie z opisem w poprzedniej sekcji, możesz go zmienić w ten sposób:
W swojej IDE kliknij Plik (w przypadku systemu Windows i Linux) lub Kod (w przypadku systemu macOS), a potem wybierz Ustawienia > Skróty klawiszowe.
Na liście skrótów klawiszowych przewiń do Gemini Code Assist: wygeneruj kod.
Kliknij Gemini Code Assist: wygeneruj kod, a potem kliknij edit Zmień skrót klawiszowy.
W wyświetlonym oknie wpisz własny skrót.
Naciśnij Enter (w systemie Windows lub Linux) lub Return (w systemie macOS).
Możesz teraz używać nowo przypisanego skrótu klawiaturowego do generowania kodu za pomocą Gemini Code Assist.
Więcej informacji o zmianie skrótów w IDE znajdziesz w artykule Kombinacje klawiszy w Visual Studio Code.
Kliknij settings IDE i ustawienia projektu > Ustawienia > Mapa klawiszy > Gemini Code Assist.
Kliknij prawym przyciskiem myszy Gemini Code Assist i wybierz Dodaj skrót klawiszowy.
Wpisz preferowany skrót klawiszowy i kliknij OK.
Kliknij Gemini Code Assist prawym przyciskiem myszy i wybierz UsuńAlt+G (w przypadku systemu Windows i Linux) lub Usuń Option+G (w przypadku systemu macOS).
Możesz teraz użyć nowego skrótu klawiszowego, aby wygenerować kod w pliku kodu.
Pobieranie uzupełnień kodu
Podczas pisania kodu Gemini Code Assist przedstawia sugestie kodu w tekście, zwane też uzupełnianiem kodu. Możesz je zaakceptować lub zignorować. Aby uzyskać uzupełnienie kodu:
W pliku kodu na nowym wierszu zacznij pisać funkcję. Jeśli na przykład pracujesz w pliku Pythona, wpisz
def
.Gemini Code Assist sugeruje kod w postaci tekstu niewidocznego.
Aby zaakceptować sugestię kodu z Gemini Code Assist, naciśnij Tab. Aby zignorować sugestię, naciśnij Esc lub kontynuuj pisanie kodu.
W pliku kodu na nowym wierszu zacznij pisać funkcję. Jeśli na przykład pracujesz w pliku Pythona, wpisz
def
.Gemini Code Assist sugeruje kod w postaci sugestii w ramach kodu.
Aby zaakceptować sugestię kodu z Gemini Code Assist, naciśnij Tab. Aby zignorować sugestię, naciśnij Esc lub kontynuuj pisanie kodu.
Opcjonalnie: jeśli wolisz używać innego klawisza skrótu, aby zaakceptować sugestię w tekście, umieść wskaźnik na sugestii w tekście i kliknij 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ć autouzupełnianie kodu, wykonaj te czynności:
W swojej IDE kliknij Kod (w przypadku systemu macOS) lub Plik (w przypadku systemu Windows lub Linux), a potem otwórz Ustawienia > Ustawienia.
Na karcie Użytkownik w oknie Ustawienia kliknij Rozszerzenia > Gemini Code Assist.
Przewiń, aż znajdziesz listę Duet AI: Sugerowane zmiany w tekście: włącz automatyczne, a następnie wybierz Wył.
Spowoduje to wyłączenie sugestii w tekście. Aby ręcznie wywołać sugestie wbudowane, możesz nadal nacisnąć Control + Enter (w systemie Windows i Linux) lub Control + Return (w systemie macOS).
Na pasku stanu IDE kliknij spark Gemini Code Assist: Aktywny i wybierz Włącz uzupełnianie kodu przez AI.
Spowoduje to wyłączenie ustawienia uzupełniania kodu. Gemini Code Assist nie będzie już wyświetlać sugestii w tekście, dopóki nie włączysz tego ustawienia ponownie.
Korzystanie z inteligentnych działań
Aby pomóc Ci zwiększyć produktywność przy jednoczesnym minimalizowaniu potrzeby przełączania kontekstu, Gemini Code Assist udostępnia inteligentne działania oparte na AI bezpośrednio w edytorze kodu. Gdy wybierzesz kod w edytorze kodu, możesz wyświetlić listę działań odpowiednich dla Twojego kontekstu i wybrać jedno z nich.
Aby używać inteligentnych działań w kodzie, wykonaj te czynności:
W pliku kodu wybierz blok kodu.
Obok wybranego bloku kodu kliknij lightbulb Pokaż kod.
Wybierz działanie, np. Generowanie testów jednostkowych.
Gemini generuje odpowiedź na podstawie wybranego przez Ciebie działania.
W pliku kodu wybierz wiersz lub blok kodu.
Kliknij prawym przyciskiem myszy wybrany kod i wybierz inteligentne działanie, np. Wygeneruj testy jednostkowe.
Wybranie działania inteligentnego automatycznie spowoduje, że Gemini Code Assist wygeneruje odpowiedź na prompt w oknie narzędzia Gemini Code Assist.
Szybka poprawka dotycząca transformacji kodu
Jeśli w Twoim kodzie wystąpi błąd, Gemini Code Assist umożliwia zastosowanie szybkiej poprawki, która przekształci kod.
Aby zastosować szybkie rozwiązanie w pliku kodu:
W pliku kodu najedź kursorem na falowane okienko z błędem, a potem wybierz Szybka poprawka, a następnie /fix.
Po zastosowaniu szybkiego rozwiązania pojawi się widok różnic. Aby zaakceptować te zmiany, kliknij Zaakceptuj.
W pliku kodu kliknij czerwoną ikonę żarówki, która wskazuje błąd w kodzie, i wybierz Popraw za pomocą Gemini.
Po zastosowaniu poprawki pojawi się widok różnic. Aby zaakceptować te zmiany, kliknij Zaakceptuj.
wyświetlanie promptów dotyczących konkretnych plików w obszarze roboczym z uwzględnieniem kodu źródłowego lokalnego;
Zrozumienie lokalnego kodu źródłowego pomaga w generowaniu wysokiej jakości sugestii kodu, które są poprawne pod względem składni i znaczeniowo trafne w szerszym kontekście kodu źródłowego. Wystarczy, że określisz pliki, których Gemini Code Assist ma użyć jako kontekstu.
Aby wskazać pliki w prośbie o czat, wpisz @ i wybierz pliki, które chcesz wskazać.
Aby dowiedzieć się, czym różnią się 2 pliki w Twojej bazie kodu:
Na pasku działań kliknij spark Gemini Code Assist.
W panelu Pomoc w pisaniu kodu w Gemini wpisz prompt
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
i naciśnij Enter (w systemie Windows i Linux) lub Return (w systemie macOS) albo Tab. Możesz też kliknąć nazwę pliku na liście, aby go wybrać. Kliknięcie nazwy pliku powoduje dodanie pliku do kontekstu prompta i otworzenie go w Twoim IDE.Gemini Code Assist odpowiada na prompt, korzystając z 2 plików, które zostały przez Ciebie określone jako kontekst. Gemini Code Assist uwzględnia też pliki określone w sekcji Źródła kontekstu.
Po określeniu tych plików możesz zadawać kolejne pytania lub prompty w tej samej historii czatu bez konieczności ponownego ich wskazywania.
Przykład: w panelu Pomoc w programie Gemini Code Assist wpisz prompt How can I
improve YOUR_FILE_NAME_1?
(bez symbolu @) i naciśnij Enter (w systemie Windows i Linux) lub Return (w systemie macOS).
Gemini Code Assist odpowiada na Twoje zapytanie dotyczące pliku określonego w promptzie.
Opcjonalnie: wykluczanie plików z kontekstu za pomocą pliku .aiexclude
Możesz wykluczyć pliki z uwzględniania przez Gemini Code Assist w kontekście, tworząc plik .aiexclude
. Plik .aiexclude
ma podobną składnię do pliku .gitignore
, ale z tymi różnicami:
- Plik
.aiexclude
, który jest pusty lub nie istnieje, nie blokuje żadnych plików w katalogu ani w podkatalogach. - Plik
.aiexclude
nie obsługuje zaprzeczenia, w którym wzorce są poprzedzone wykrzyknikiem (!
). - Plik
.aiexclude
pasuje do*
znaków. Dopasowanie będzie bezwzględne w przypadku katalogów i plików. Ten plik.aiexclude
nie rozróżnia**
i*
w przypadku folderów i plików.
Obecnie obsługiwany jest tylko jeden plik .aiexclude
. Aby skonfigurować plik .aiexclude
, utwórz plik o nazwie .aiexclude
w katalogu głównym folderu obszaru roboczego.
Przykłady
Przykłady poniżej pokazują, jak skonfigurować plik .aiexclude
:
Zablokuj wszystkie pliki o nazwie
apikeys.txt
w katalogu obszaru roboczego lub poniżej:apikeys.txt
Zablokuj wszystkie pliki z rozszerzeniem
.key
w katalogu obszaru roboczego lub poniżej:*.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ć ścieżką względną względem katalogu katalogu głównego obszaru roboczego.my/sensitive/dir/*
Wyłączanie sugestii kodu pasujących do cytowanych źródeł
Gemini Code Assist podaje informacje o cytacie, 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, który pasuje do cytowanych źródeł:
Na pasku aktywności w IDE kliknij Zarządzaj > Ustawienia.
W oknie ustawień na karcie Użytkownik kliknij Rozszerzenia > Gemini Code Assist.
Przewiń, aż znajdziesz Duet AI > Recitation: Max Cited Length (Recytacja: maksymalna długość cytatu).
Ustaw wartość na
0
.Gemini Code Assist nie sugeruje już kodu, który pasuje do cytowanych źródeł.
Znane problemy
W tej sekcji opisano znane problemy z Gemini Code Assist:
Odpowiedzi na czacie mogą zostać obcięte, jeśli zawierają zaktualizowaną wersję dużego otwartego pliku
Aby obejść ten problem, wybierz mniejszą sekcję kodu i uwzględnij w prośbie o rozmowę na czacie dodatkową instrukcję, taką jak
only output the selected code.
Vim: nie można zaakceptować ani odrzucić sugestii dotyczącej generowania kodu, chyba że jest włączony tryb wstawiania
Podczas korzystania z wtyczki Vim w trybie normalnym nie można 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ójność działania po naciśnięciu Esc w celu odrzucenia sugestii
Gdy naciśniesz Esc, sugestie IDE i Gemini zostaną odrzucone. To zachowanie różni się od zachowania w przypadku innych aplikacji, w których naciśnięcie klawisza Esc powoduje ponowne uruchomienie Gemini.
Próby logowania się są przerywane przez limit czasu
Jeśli próby logowania się są ciągle przerywane, spróbuj dodać ustawienie
cloudcode.beta.forceOobLogin
do plikusettings.json
:"cloudcode.beta.forceOobLogin": true
Ostrzeżenia dotyczące odczytania licencji nie są zachowywane w kolejnych sesjach
Jeśli ostrzeżenia o wymowie licencji nie są zachowywane w przypadku kolejnych sesji, zapoznaj się z trwałymi logami:
Kliknij Widok > Wyjście.
Wybierz Gemini Code Assist – cytaty.
Problemy z połączeniem w oknie wyników Gemini Code Assist
Jeśli w oknie wyjściowym Gemini Code Assist zobaczysz błąd połączenia lub inne problemy z połączeniem, wykonaj te czynności:
Skonfiguruj zaporę sieciową, aby zezwolić na dostęp do adresów
oauth2.googleapis.com
icloudaicompanion.googleapis.com
.Skonfiguruj zaporę sieciową tak, aby zezwalała na komunikację przez HTTP/2, której używa gRPC.
Aby przetestować połączenie, możesz użyć narzędzia
grpc-health-probe
. Pomyślna kontrola kończy się wyświetleniem następujących danych wyjściowych:$ 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 spowoduje wyświetlenie tego komunikatu:
timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s
Aby uzyskać więcej informacji, przed poleceniem
grpc-health-probe
wykonaj te czynności:export GRPC_GO_LOG_SEVERITY_LEVEL=info
Nie ma żadnych znanych problemów z Gemini Code Assist w IntelliJ i innych obsługiwanych środowiskach IDE JetBrains.
Prześlij komentarz
Aby przesłać opinię o spotkaniu:
Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu Szybki wybór wybierz Prześlij opinię.
W formularzu wypełnij pola Tytuł i Komentarze.
Jeśli chcesz udostępnić logi Skaffold lub AI Companion, wybierz opcję Wyślij logi Skaffold lub Wyślij logi AI Companion.
Kliknij Prześlij opinię.
Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu wybierz Prześlij opinię.
W polu tekstowym u góry formularza wpisz opinię.
Jeśli chcesz udostępnić logi Gemini Code Assist, wybierz pliki logów.
Kliknij Prześlij opinię.
Co dalej?
- Dowiedz się, jak Gemini dla Google Cloud korzysta z Twoich danych.
- Dowiedz się więcej o cenach Gemini Code Assist.