Kode dengan Gemini Code Assist

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

• Memberikan panduan untuk membantu Anda menyelesaikan masalah terkait kode.

• Buat kode untuk project Anda.

• Mendapatkan saran inline saat Anda membuat kode.

Pelajari cara dan waktu Gemini untuk Google Cloud menggunakan data Anda.

Penyesuaian kode memungkinkan Anda mendapatkan saran kode berdasarkan codebase pribadi organisasi langsung dari Gemini Code Assist. Pelajari cara mengonfigurasi penyesuaian kode.

Dokumen ini ditujukan bagi developer dari semua tingkat keahlian. Anda dianggap telah memiliki pengetahuan tentang Cloud Workstation dan sudah familier dengan Google Cloud. Jika ingin, Anda juga dapat mempelajari Gemini Code Assist di Cloud Code untuk VS Code, Cloud Code for IntelliJ, dan Cloud Shell Editor.

Sebelum memulai

1. Pastikan Anda memiliki peran IAM Cloud Workstations Admin di project agar Anda dapat membuat konfigurasi workstation.

   Buka IAM

2. Siapkan workstation jika Anda belum melakukannya, dan pastikan untuk memilih Base Editor (Code-OSS) dalam konfigurasi.

3. Sebelum menguji kemampuan Gemini Code Assist dalam file kode, pastikan bahasa coding file Anda didukung. Untuk informasi selengkapnya tentang bahasa coding yang didukung, lihat Bahasa coding yang didukung.

Hubungkan ke Google Cloud lalu pilih project

Di bagian ini, Anda akan terhubung ke Google Cloud dan memilih projectGoogle Cloud dengan Gemini untuk Google Cloud API yang diaktifkan di workstation Anda.

Jika memilih project Google Cloud tanpa mengaktifkan Gemini untuk Google Cloud API, Anda akan menerima notifikasi yang memberi Anda opsi untuk mengaktifkan API dari IDE. Pilih Enable the API di jendela notifikasi untuk mengaktifkan API untuk project Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Gemini Code Assist untuk project.

Agar terhubung ke Google Cloud di workstation, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, luncurkan workstation Anda.

   Meluncurkan workstation

2. Di status bar, klik Cloud Code - Sign In.

   

3. Saat Anda diminta untuk login, klik Proceed to sign in.

4. Untuk meluncurkan Google Cloud alur login, tekan Control (untuk Windows dan Linux) atau Command (untuk macOS), lalu klik URL di konsol.

5. Jika diminta untuk mengizinkan Cloud Workstations membuka situs eksternal, klik Open.

6. Untuk login ke akun Anda, ikuti petunjuknya.

   Jika diminta untuk memastikan bahwa Anda mendownload aplikasi ini dari Google, klik Sign in.

   Tab baru akan terbuka di browser Anda, yang menampilkan kode verifikasi untuk login ke Cloud Code.

7. Salin kode verifikasi dan tempelkan ke terminal yang bertuliskan Enter authorization code, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

   Anda kini terhubung ke Google Cloud.

Selanjutnya, untuk memilih Google Cloud project dengan Gemini untuk Google Cloud API yang telah diaktifkan, ikuti langkah-langkah berikut:

1. Di status bar Gemini Code Assist, klik Gemini Code Assist.

   

2. Di menu Gemini Code Assist, pilih Select Gemini Code project.

3. Pilih project Google Cloud yang mengaktifkan Gemini untuk Google Cloud API.

   Gemini siap digunakan.

   

Mulai percakapan dengan Gemini Code Assist

Di bagian ini, Anda akan mempelajari cara membuka panel Gemini Code Assist dan melakukan chat dengan Gemini Code Assist untuk mendapatkan penjelasan tentang kode yang sudah ada.

Untuk mulai melakukan percakapan dengan Gemini, ikuti langkah-langkah berikut:

1. Buka file kode Anda.

2. Di panel aktivitas workstation, klik spark Gemini Code Assist.

3. Di panel Gemini Code Assist, masukkan perintah Explain this code to me, lalu klik send Send.

   Gemini menggunakan kode dalam file kode Anda sebagai referensi perintah Anda dan merespons dengan memberikan penjelasan mengenai kode Anda.

   Untuk merujuk ke blok kode tertentu, bukan semua kode dalam file, pilih blok kode Anda, lalu beri perintah Gemini.

Reset histori chat

Gemini Code Assist menggunakan histori percakapan sebagai konteks tambahan saat merespons perintah.

Jika histori chat tidak lagi relevan dengan yang ingin Anda capai, Anda dapat mereset histori chat: di panel Gemini Code Assist, klik delete Reset Chat.

Membuat kode dengan perintah

Bagian berikut menunjukkan cara menggunakan Gemini Code Assist untuk membuat kode dengan contoh perintah Function to create a Cloud Storage bucket di dalam file kode Anda. Anda juga dapat memilih bagian kode, lalu meminta bantuan Gemini Code Assist melalui fitur chat, dan menerima serta menyetujui atau menolak saran kode saat Anda melakukan coding.

Memanggil Gemini Code Assist dalam file kode

1. Di file kode Anda, pada baris baru, masukkan komentar Function to create a Cloud Storage bucket, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

2. Untuk membuat kode, tekan Control+Enter (untuk Windows dan Linux) atau Control+Return (untuk macOS).

   Di samping teks perintah dalam file kode Anda, Gemini Code Assist akan membuat kode dalam bentuk teks bayangan (ghost text).

3. Opsional: Untuk menerima kode yang dibuat, tekan Tab.

Opsional: Mengubah pintasan keyboard untuk membuat kode

Jika pintasan keyboard default untuk membuat kode tidak berfungsi seperti yang diuraikan di bagian sebelumnya, Anda dapat mengubah pintasan keyboard dengan mengikuti langkah-langkah berikut:

1. Di tempat kerja Anda, klikmenu Menu, lalu navigasikan ke Mengajukan > Preferensi > Pintasan Keyboard.

2. Dalam daftar pintasan keyboard, telusuri Cloud Code: Generate Code.

3. Klik Cloud Code: Generate Code, lalu klik edit Change Keybinding.

4. Pada dialog yang muncul, masukkan pintasan Anda sendiri.

5. Tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

   Anda kini dapat menggunakan pintasan keyboard yang baru ditetapkan untuk membuat kode dengan Gemini.

Perintahkan Gemini Code Assist dengan kode yang dipilih menggunakan chat

Gemini Code Assist dapat melakukan tugas atau menjawab pertanyaan Anda berdasarkan kode yang Anda pilih. Untuk mendapatkan kode yang dihasilkan berdasarkan perintah dengan kode yang dipilih, ikuti langkah-langkah berikut:

1. Di panel aktivitas, klik spark Gemini Code Assist untuk membuka panel Gemini Code Assist.

2. Di file kode, pilih blok kode.

3. Di kolom teks panel Gemini Code Assist, masukkan perintah untuk kode yang dipilih.

   Misalnya, pilih fungsi dalam kode Anda dan masukkan perintah Write a unit test for this function:

   

   Gemini menggunakan kode pilihan Anda sebagai referensi dan merespons perintah Anda.

Mendapatkan saran inline saat Anda membuat kode

Saat Anda menulis kode, Gemini Code Assist membuat saran kode inline yang dapat Anda terima atau abaikan. Untuk mencoba fitur ini, ikuti langkah-langkah berikut:

1. Di file kode, pada baris baru, mulai tulis fungsi. Misalnya, jika Anda berada di file Python, tulis def.

   Gemini menyarankan kode dalam bentuk teks bayangan (ghost text).

2. Untuk menerima saran kode dari Gemini Code Assist, tekan Tab. Atau, untuk mengabaikan saran, tekan Esc atau lanjutkan menulis kode Anda.

Opsional: Nonaktifkan saran inline

Jika Anda memilih untuk menonaktifkan saran inline di Gemini Code Assist, ikuti langkah-langkah berikut:

1. Di stasiun kerja Anda, pilihmenu Menu, lalu navigasikan ke Mengajukan > Preferensi > Pengaturan.

2. Pada tab User di dialog Settings, buka Extensions > Cloud Code.

3. Scroll hingga Anda menemukan daftar Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto, lalu pilih Off.

   Tindakan ini akan menonaktifkan saran inline. Anda masih dapat menekan Control+Enter (untuk Windows dan Linux) atau Control+Return (untuk macOS) guna memicu saran inline secara manual.

Opsional: Kecualikan file dari konteks dengan file .aiexclude

Anda dapat mengecualikan file agar tidak dipertimbangkan oleh Gemini Code Assist sebagai konteks dengan membuat file .aiexclude. File .aiexclude mengikuti sintaksis serupa dengan file .gitignore, dengan perbedaan berikut:

• File .aiexclude yang kosong atau tidak ada tidak akan memblokir file di direktori dan semua subdirektorinya.
• File .aiexclude tidak mendukung negasi, yang mengharuskan Anda memberikan awalan pada pola dengan tanda seru (!).
• File .aiexclude sangat cocok dengan karakter *. Ini akan mencocokkan secara acak pada direktori dan file. File .aiexclude ini tidak membedakan antara ** atau * sehubungan dengan folder atau file.

Saat ini hanya satu file .aiexclude yang didukung. Untuk mengonfigurasi file .aiexclude, buat file berjudul .aiexclude di root folder ruang kerja Anda. Jika Anda ingin menempatkan file ini di luar root Workspace, atau mengganti nama file, jalur dapat ditetapkan di setelan VS Code di bagian "File Pengecualian Konteks". Nilai jalur yang diberikan dalam setelan ini akan me-resolve sesuai dengan folder root ruang kerja Anda yang terbuka.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi file .aiexclude:

• Blokir semua file bernama apikeys.txt di atau di bawah direktori ruang kerja:

  apikeys.txt
  

• Blokir semua file dengan ekstensi file .key pada atau di bawah direktori ruang kerja:

  *.key
  

• Hanya blokir apikeys.txtfile di direktori yang sama dengan file .aiexclude, tetapi tidak pada subdirektori apa pun:

  /apikeys.txt
  

• Blokir semua file di direktori my/sensitive/dir dan semua subdirektorinya. Jalur harus relatif terhadap direktori utama Workspace.

  my/sensitive/dir/*
  

Nonaktifkan saran kode yang cocok dengan sumber kutipan

Gemini memberikan informasi kutipan saat secara langsung mengutip dari sumber lain, seperti kode open source yang sudah ada. Untuk informasi selengkapnya, lihat Bagaimana dan kapan Gemini mencantumkan sumber kutipan.

Untuk mencegah saran kode yang cocok dengan sumber kutipan, Anda dapat mengubah setelan geminicodeassist.recitation.maxCitedLength menjadi 0 dalam file settings.json:

"geminicodeassist.recitation.maxCitedLength": 0

Menggunakan tindakan cerdas

Untuk membantu Anda menjadi lebih produktif sekaligus meminimalkan pengalihan konteks, Gemini Code Assist menyediakan tindakan cerdas yang didukung AI langsung di editor kode Anda. Jika memilih kode di editor kode, Anda dapat melihat dan memilih dari daftar tindakan yang relevan dengan konteks.

Untuk menggunakan tindakan cerdas di kode Anda, ikuti langkah-langkah berikut:

1. Di file kode, pilih blok kode.

2. Di samping blok kode yang dipilih, klik lightbulb Show Code Actions.

   

3. Pilih tindakan seperti Buat pengujian unit.

   Gemini menghasilkan respons yang didasarkan pada tindakan yang Anda pilih.

Menggunakan transformasi kode

Gemini Code Assist menyediakan Transformasi kode, yang memungkinkan Anda memilih bagian file kode dan meminta modifikasi pada kode yang sudah ada melalui perintah dalam bahasa alami, menggunakan kotak teks inline.

Dengan Transformasi kode, Anda dapat melakukan hal berikut:

• Buat baris komentar untuk mendokumentasikan kode Anda
• Memecahkan masalah kode yang bermasalah
• Meningkatkan keterbacaan kode
• Membuat kode lebih efisien

Anda juga dapat melihat sumber konteks respons yang dihasilkan di panel Gemini: Chat.

Instruksikan Gemini Code Assist dengan kotak teks inline

Kotak teks inline memungkinkan Anda berinteraksi dengan Gemini Code Assist langsung di file kode.

Untuk membuka kotak teks inline dan memerintahkan Gemini, ikuti langkah-langkah berikut:

1. Dalam file kode Anda, tekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).

2. Masukkan perintah, seperti Write a function to create a Cloud Storage bucket, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

   Gemini Code Assist membuat kode berdasarkan perintah Anda.

Lihat perbedaan kode yang difaktorkan ulang

Dengan tampilan perbedaan yang disertakan ke dalam kotak teks inline, Anda dapat melihat perubahan yang disarankan Gemini dan kode asli Anda. Anda kemudian dapat menerima atau menghapus perubahan yang disarankan.

Untuk melihat perbedaan kode yang difaktorkan ulang dari kotak teks inline, lakukan langkah-langkah berikut:

1. Dalam file kode Anda, pilih fungsi dan buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).

2. Masukkan perintah, seperti Add comments, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

   Saat Gemini membuat perubahan kode pada fungsi yang Anda pilih, tampilan perbedaan akan muncul.

   

3. Untuk menyetujui atau menghapus perubahan, klik Setuju atau Hapus.

Melihat sumber konteks respons yang dihasilkan

Fitur tampilan konteks mencantumkan file project Anda (sumber konteks) yang digunakan sebagai referensi untuk menghasilkan respons terhadap perintah Anda. Mengetahui file mana yang digunakan sebagai referensi akan membantu Anda meningkatkan kualitas perintah dan mendapatkan respons yang lebih spesifik. Sumber konteks akan ditampilkan setiap kali Anda menggunakan Gemini Chat.

Untuk melihat sumber konteks respons yang dihasilkan, di panel Gemini: Chat, scroll hingga Anda melihat cuplikan Sumber Konteks. Luaskan cuplikan untuk melihat semua sumber konteks.

Menggunakan perintah cerdas

Perintah cerdas adalah perintah yang dapat Anda gunakan dalam kotak teks inline untuk melakukan tindakan tertentu pada kode Anda.

Untuk mendapatkan penjelasan tentang seluruh file kode dengan perintah smart /explain, ikuti langkah-langkah berikut:

1. Dalam file kode Anda, buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).

2. Tekan / untuk melihat daftar perintah cerdas dan deskripsinya.

3. Pilih /explain.

   Gemini menghasilkan penjelasan seluruh file kode di kotak teks inline.

4. Opsional: Jika Anda ingin melihat respons yang dihasilkan di panel Gemini: Chat, klik Lihat di Chat.

Melihat histori perintah

Mengakses histori perintah akan menghemat waktu saat Anda harus memasukkan perintah yang sama dalam file kode besar.

Untuk mengakses histori perintah, dalam file kode Anda, buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS), lalu tekan Control+Up panah (untuk Windows dan Linux) atau Command+Panah atas (untuk macOS). Dengan demikian, Anda dapat melihat perintah lama dan menggunakannya kembali saat diperlukan.

Meningkatkan keterbacaan kode untuk pengguna yang tidak berbahasa Inggris

Jika Anda adalah penutur bahasa Inggris yang tidak menguasai bahasa Inggris dan mengandalkan aplikasi terjemahan, Anda dapat menggunakan kotak teks inline untuk membuat komentar dalam bahasa lain.

Untuk mengonversi komentar bahasa Inggris ke bahasa lain atau menambahkan komentar baru dalam bahasa lain, ikuti langkah-langkah berikut:

1. Di file kode Anda, pilih kode yang ingin Anda tambahi komentar.

2. Buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).

3. Masukkan perintah, seperti Add spanish comments, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

   Gemini akan membuat komentar dalam bahasa yang Anda tentukan di perintah & melihat perbedaannya.

4. Untuk menyetujui atau menghapus perubahan ini pada kode Anda, klik Accept atau Discard.

Menguji contoh perintah lainnya

Setelah membaca bagian Generate code with prompts pada dokumen ini, coba beberapa contoh perintah berikut.

Mendapatkan penjelasan kode

1. Di file kode Anda, pilih fungsi yang ingin dijelaskan.

2. Di panel Gemini Code Assist, masukkan perintah Explain this code to me.

   Gemini menggunakan kode pilihan Anda sebagai referensi dan merespons dengan penjelasan fungsi yang dipilih.

Buat rencana pengujian

1. Di file kode, pilih kode yang ingin Anda tambahkan pengujian unitnya.
2. Di panel Gemini Code Assist, masukkan perintah Write unit tests for my code.

Mendapatkan bantuan terkait kode proses debug

1. Di file kode, pilih kode yang ingin Anda debug.
2. Di panel Gemini Code Assist, masukkan perintah Help me debug my code.

Membuat kode lebih mudah dibaca

1. Di file kode, pilih kode yang ingin Anda jadikan lebih mudah dibaca.

2. Di panel Gemini Code Assist, masukkan perintah Make my code more readable.

   Jika Anda ingin berfokus pada bagian tertentu dari kode, pilih bagian kode yang diinginkan sebelum memerintahkan Gemini.

Masalah umum

Bagian berikut menguraikan masalah umum Gemini Code Assist.

Peringatan pembacaan lisensi tidak akan terus ada di seluruh sesi

Jika peringatan pembacaan lisensi tidak tetap ada di seluruh sesi, lihat log persisten:

1. Klik menu Menu > View > Output.

2. Pilih Gemini Code Assist - Kutipan.

Masalah konektivitas di jendela output Gemini Code Assist

Jika Anda melihat error koneksi atau masalah konektivitas lainnya di jendela output Gemini Code Assist, coba langkah berikut:

• Konfigurasi firewall Anda untuk mengizinkan akses ke oauth2.googleapis.com dan cloudaicompanion.googleapis.com.

• Konfigurasi firewall Anda untuk mengizinkan komunikasi melalui HTTP/2, yang digunakan gRPC.

Anda dapat menggunakan alat grpc-health-probe untuk menguji konektivitas. Pemeriksaan yang berhasil akan menghasilkan output berikut:

$ 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

Pemeriksaan yang gagal akan menghasilkan output berikut:

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

Untuk mendapatkan detail selengkapnya, jalankan perintah berikut sebelum grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

Gemini Code Assist dan Gateway JetBrains

Gemini Code Assist tidak berjalan melalui Gateway JetBrains. Akibatnya, Gemini Code Assist tidak berjalan di IDE Cloud Workstations yang memerlukan Gateway JetBrains agar dapat terhubung.

'Aktifkan Gemini Code Assist' masih muncul setelah memilih project Gemini Code Assist

Jika Anda telah memilih project sesuai petunjuk dalam panduan ini, termasuk cara mengaktifkan Gemini untuk Google Cloud API, mungkin ada masalah dengan server LS.

Untuk mengetahui detail selengkapnya tentang masalah Anda, lakukan tindakan berikut:

1. Di status bar, klik spark Gemini Code Assist lalu pilih Kirim masukan.

2. Klik Show untuk file log mana pun guna melihat detail selengkapnya dan membantu memecahkan masalah.

Berikan masukan

Untuk memberikan masukan tentang pengalaman Anda, ikuti langkah-langkah berikut:

1. Di status bar, klik Gemini Code Assist, lalu di menu Quick Choose, pilih Send feedback.

2. Di formulir, isi kolom Judul dan Komentar.

3. Jika Anda ingin membagikan log Skaffold atau AI Companion, pastikan Anda memilih opsi Send Skaffold logs atau Send AI Companion logs.

4. Klik Kirim Masukan.

Langkah berikutnya

• Pelajari cara menulis perintah yang lebih baik.