Czat z Gemini Code Assist dla użytkowników indywidualnych

Uwaga: jeśli pracujesz w firmie lub chcesz uzyskać więcej korzyści na poziomie zespołu, rozważ zakup Gemini Code Assist Standard lub Enterprise.

Ten dokument opisuje, jak możesz korzystać z Gemini Code Assist, czyli opartej na AI usługi wspomagającej w Twoim środowisku IDE, aby wykonywać te czynności w VS Code lub IntelliJ i innych obsługiwanych środowiskach IDE JetBrains:

• otrzymywać wskazówki, które pomogą Ci rozwiązać problemy z kodem;
• wygenerować kod dla projektu;
• Zarządzaj kontekstem projektu, określając pliki i foldery.
• tworzyć niestandardowe polecenia i reguły.

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. Możesz też korzystać z Gemini w Android Studio.

Uwaga: działanie generowania, wypełniania i przekształcania kodu jest niedeterministyczne, gdy jest 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. Skonfiguruj Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobiono.

2. 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.

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

IntelliJ

1. Skonfiguruj Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobiono.

2. 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.

3. Jeśli wolisz używać IDE za pośrednictwem serwera proxy, zapoznaj się z artykułem Serwer proxy HTTP.

Wyjaśnianie kodu za pomocą czatu Gemini Code Assist

W tej sekcji poprosisz Gemini Code Assist o wyjaśnienie istniejącego kodu.

VS Code

Aby uzyskać wyjaśnienie kodu:

1. Otwórz plik kodu.

2. Na pasku działań w IDE kliknij spark Gemini Code Assist.

3. W panelu Gemini Code Assist wpisz prompt Explain this code to me i kliknij send Wyślij.

   Gemini Code Assist 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 użyć funkcji Gemini Code Assist.

IntelliJ

Aby uzyskać wyjaśnienie kodu:

1. W swojej IDE otwórz plik kodu.

2. 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 prompta i odpowiada wyjaśnieniem kodu.

Jeśli chcesz wyjaśnienie tylko określonej części kodu, wybierz ją, a potem ponownie poproś Gemini Code Assist o pomoc. 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 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ć wcześniejszych promptów, znajdziesz je w historii zapytań w oknie narzędzia Gemini Code Assist. Aby je wyświetlić, kliknij schedule Pokaż historię zapytań.

Tworzenie wielu czatów

Możesz utworzyć wiele czatów z Gemini Code Assist, które będą zawierać własny kontekst, oddzielony od innych czatów. Historia czatu zawiera pierwszy czat i sygnaturę czasową ostatniej aktualizacji. Możesz prowadzić maksymalnie 20 rozmów. Gdy osiągniesz ten limit, najstarszy czat zostanie automatycznie usunięty, gdy dodasz nowy.

VS Code

1. Aby dodać nowy czat, kliknij Dodaj Nowy czat i wpisz prompt w polu tekstowym. Po wprowadzeniu prompta Gemini Code Assist utworzy nowy czat.
2. Aby uzyskać dostęp do poprzedniego czatu, kliknij historia Wznów poprzedni czat. Pojawi się lista Twoich czatów. Wybierz czat, który chcesz wyświetlić.
3. Aby usunąć wątek czatu, kliknij Wznów poprzedni czat, a następnie kliknij usuń Usuń obok czatu, który chcesz usunąć.

IntelliJ

Ta funkcja nie jest obecnie obsługiwana w Gemini Code Assist w IntelliJ i innych obsługiwanych środowiskach IDE JetBrains.

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ż istotna dla tego, czego próbujesz dokonać, możesz zresetować historię czatu.

Przekazanie wybranego kodu do Gemini Code Assist za pomocą czatu

Gemini Code Assist może wykonywać zadania lub odpowiadać na Twoje pytania na podstawie wybranego przez Ciebie kodu. Aby uzyskać wygenerowany kod na podstawie prompta z wybranym kodem, wykonaj te czynności:

VS Code

1. Na pasku działań kliknij spark Gemini Code Assist, aby otworzyć panel Gemini Code Assist.

2. W pliku kodu wybierz blok kodu.

3. W polu tekstowym panelu Gemini Code Assist wpisz prompt dla wybranego kodu.

   Na przykład wybierz funkcję w kodzie i wpisz prompt Write a unit test for this function.

   Gemini używa wybranego kodu jako odniesienia i reaguje na prompt.

IntelliJ

1. Na pasku działań kliknij spark Gemini Code Assist, aby otworzyć okno narzędzia Gemini Code Assist.

2. W pliku kodu wybierz blok kodu.

3. 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 Twoje prompty.

wyświetlanie promptów dotyczących konkretnych plików i folderów w Workspace z uwzględnieniem kodu źródłowego na komputerze lokalnym;

Podgląd

Określanie folderów do użycia jako kontekstu w Gemini Code Assist to funkcja w wersji wstępnej. Produkty i funkcje w wersji testowej są dostępne w stanie „takim, jaki jest”.

Zrozumienie lokalnej bazy kodu pomaga w generowaniu wysokiej jakości sugestii kodu, które są poprawne pod względem składni i znaczeniowo trafne w szerszym kontekście bazy kodu. Wystarczy, że określisz pliki lub foldery, które Gemini Code Assist ma użyć jako kontekst.

Gdy określisz folder, Gemini Code Assist użyje plików w tym folderze, a także plików w podfolderach jako kontekstu.

Uwaga: gdy dodasz folder, Gemini Code Assist wybierze maksymalnie 100 plików znalezionych w tym folderze i jego podfolderach. Jeśli potrzebujesz dostępu do kodu źródłowego poza tym limitem, rozważ dostosowywanie kodu.

VS Code

Aby określić pliki lub foldery w promptach czatu, wpisz @ i wybierz plik lub folder, który chcesz określić.

Aby uzyskać wyjaśnienie różnic między 2 plikami w Twojej bazie kodu:

1. Na pasku działań kliknij spark Gemini Code Assist.

2. 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 spowoduje dodanie go do kontekstu prompta i otworzenie w Twoim środowisku IDE.

Gemini Code Assist odpowiada na prompt, korzystając z 2 plików, które zostały określone przez Ciebie 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 promptach.

Uwaga: jeśli wykasujesz historię czatu, Gemini Code Assist przestanie używać Twoich plików do kontekstu. Jeśli chcesz dowiedzieć się więcej o tych plikach, musisz ponownie je podać w panelu czatu, używając symbolu @.

IntelliJ

Aby wskazać pliki lub foldery w promptach czatu, wpisz @ i wybierz pliki lub foldery, które chcesz wskazać.

Aby uzyskać wyjaśnienie różnic między 2 plikami w Twojej bazie kodu:

1. Na pasku działań kliknij spark Gemini Code Assist.

2. 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 spowoduje dodanie go do kontekstu prompta i otworzenie w Twoim środowisku IDE.

Gemini Code Assist odpowiada na prompt, korzystając z 2 plików, które zostały określone przez Ciebie 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 ich ponownego określania.

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 pytanie dotyczące pliku wskazanego w promptach.

Uwaga: jeśli wykasujesz historię czatu, Gemini Code Assist przestanie używać plików jako kontekstu. Jeśli chcesz dowiedzieć się więcej o tych plikach, musisz ponownie podać ich nazwy lub foldery w panelu czatu, używając symbolu @.

Zarządzanie plikami i folderami w panelu kontekstowym

Gdy określisz plik lub folder, który ma być używany jako kontekst promptów Gemini Code Assist, te pliki i foldery zostaną umieszczone w schowku kontekstowym, gdzie możesz je wyświetlić i usunąć z kontekstu promptu.

Aby zarządzać plikami i folderami w panelu kontekstowym, wykonaj te czynności:

VS Code

Uwaga: czaty utworzone za pomocą Gemini Code Assist w VS Code przed wersją 2.34.0 nie będą zachowywać ani wyświetlać zapisanego kontekstu w panelu kontekstowym. Może to powodować problemy z wyświetlaniem prawidłowego kontekstu czatu. Aby utworzyć i zatrzymać kontekst rozmów, zalecamy usunięcie rozmów z czasu poprzedzającego tę wersję.

1. Na pasku działań w IDE kliknij spark Gemini Code Assist.

2. Aby wyświetlić pliki i foldery w panelu kontekstowym, kliknij Elementy kontekstowe.

   

3. Aby usunąć elementy z menu kontekstowego, kliknij close Usuń.

IntelliJ

1. Na pasku działań kliknij spark Gemini Code Assist.

2. Aby wyświetlić pliki i foldery w panelu kontekstowym, kliknij Kontekst.

   

3. Aby usunąć pliki i foldery z panelu kontekstowego, kliknij close Usuń.

Tworzenie niestandardowych poleceń

Domyślnie Gemini Code Assist udostępnia takie polecenia jak /generate w VS Code i Generuj kod w IntelliJ i innych obsługiwanych środowiskach IDE JetBrains. Możesz też tworzyć własne polecenia, które pomogą Ci szybciej wykonywać powtarzalne czynności w IDE.

W tej sekcji utworzysz polecenie niestandardowe o nazwie add-comments, które dodaje komentarze do kodu w pliku kodu. W IntelliJ i innych obsługiwanych środowiskach IDE JetBrains możesz tworzyć, zapisywać i wykonywać niestandardowe polecenia z poziomu biblioteki promptów oraz promptu w edytorze.

VS Code

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

2. W menu znajdź i kliknij Ustawienia: otwórz Ustawienia (UI).

3. W polu Ustawienia wyszukiwania wpisz Geminicodeassist: Custom Commands.

4. W polu Polecenia niestandardowe kliknij Dodaj element.

5. W polu Element wpisz add-comments jako nazwę polecenia.

6. W polu Wartość wpisz add comments to all functions without comments in my code jako prompt.

7. Kliknij OK.

Możesz teraz używać w swoim IDE niestandardowego polecenia add-comments. Polecenie to znajduje się na liście poleceń w menu Szybki wybór w pomocniku Gemini Code Assist (Control+I w systemie Windows i Linux lub Command+I w systemie macOS).

IntelliJ

1. W swojej IDE otwórz Ustawienia > Narzędzia > Gemini > Biblioteka promptów.

   

2. W oknie Prompt Library kliknij add Dodaj.

3. Nazwij polecenie niestandardowe add-comments.

4. W polu tekstowym Biblioteki promptów wpisz prompt: Add comments to all functions without comments in this code.

5. Zaznacz pole wyboru Pokaż w prośbie w edytorze, jeśli nie jest zaznaczone.

6. Kliknij OK, aby zapisać niestandardowe polecenie w bibliotece promptów.

7. W pliku kodu zaznacz kod, który chcesz zmodyfikować.

8. Kliknij prawym przyciskiem myszy wyróżniony kod, a potem przejdź do Gemini > Bibliotek promptów i wybierz komendę niestandardową add-comments.

   Gemini Code Assist wykonuje polecenie add-comments i dodaje komentarze do wyróżnionego kodu.

Możesz też wywołać polecenie niestandardowe za pomocą prompta w edytorze, wykonując te czynności:

1. W pliku kodu zaznacz kod, który chcesz zmodyfikować, i naciśnij Alt + (w Windows i Linux) lub Cmd + (w macOS), aby otworzyć menu Szybki wybór asystenta kodu Gemini.

2. W menu wybierz niestandardowe polecenie add-comments.

   Gemini Code Assist wykonuje polecenie add-comments i dodaje komentarze do wyróżnionego kodu.

Tworzenie reguł

Możesz utworzyć reguły, których Gemini Code Assist ma przestrzegać. Reguły te są uwzględniane w każdym promptu czatu.

VS Code

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

2. W menu znajdź i kliknij Ustawienia: otwórz Ustawienia (UI).

3. W polu Ustawienia wyszukiwania wpisz Geminicodeassist: Rules.

4. W polu tekstowym wpisz regułę, np. Always generate unit tests when creating a new function. Możesz też dodać jedną lub więcej reguł z wieloma wierszami w polu tekstowym.

   Po dodaniu reguł w ustawieniach reguł Gemini Code Assist będzie stosować je do każdego promptu lub żądania.

   Aby usunąć regułę, usuń zawartość z pola tekstowego Reguły.

IntelliJ

Ta funkcja nie jest obecnie obsługiwana w Gemini Code Assist w IntelliJ i innych obsługiwanych środowiskach IDE JetBrains.

Znane problemy

W tej sekcji omówiliśmy znane problemy z Gemini Code Assist:

VS Code

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

  Aby obejść ten problem, wybierz mniejszy fragment kodu i dodaj dodatkową instrukcję w promptu czatu, na przykład 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 Code Assist zostaną odrzucone. To zachowanie różni się od zachowania w przypadku innych przeglądarek niż Vim, w których naciśnięcie klawisza Esc ponownie uruchamia Gemini Code Assist.

• 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 pliku settings.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:

  1. Kliknij Widok > Wyjście.

  2. 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 i cloudaicompanion.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
  

IntelliJ

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

Wyślij opinię

Aby przesłać opinię o spotkaniu:

VS Code

1. Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu Szybki wybór wybierz Prześlij opinię.

2. W formularzu wypełnij pola Tytuł i Komentarze.

3. Jeśli chcesz udostępnić logi Skaffold lub AI Companion, wybierz opcję Wyślij logi Skaffold lub Wyślij logi AI Companion.

4. Kliknij Prześlij opinię.

IntelliJ

1. Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu wybierz Prześlij opinię.

2. W polu tekstowym u góry formularza wpisz opinię.

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

4. 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.