Kode dengan Gemini Code Assist Standard dan Enterprise

Dokumen ini menjelaskan cara menggunakan Gemini Code Assist Standard dan Enterprise, kolaborator yang didukung teknologi AI di IDE, untuk membantu Anda melakukan hal-hal berikut di VS Code atau IntelliJ dan IDE JetBrains lain yang didukung:

  • Buat kode untuk project Anda dengan transformasi kode.
  • Menerima penyelesaian kode saat Anda melakukan coding.
  • Gunakan tindakan cerdas.

Jika menggunakan Gemini Code Assist Enterprise, Anda dapat menggunakan Penyesuaian kode, yang memungkinkan Anda mendapatkan saran kode berdasarkan codebase pribadi organisasi Anda langsung dari Gemini Code Assist Enterprise. Pelajari cara mengonfigurasi penyesuaian kode.

Dokumen ini ditujukan untuk developer dari semua tingkat keterampilan. Hal ini mengasumsikan bahwa Anda memiliki pengetahuan tentang VS Code atau IntelliJ dan IDE JetBrains lain yang didukung, serta memahami Google Cloud. Jika mau, Anda juga dapat mempelajari Gemini Code Assist di Cloud Shell Editor, Cloud Workstations, dan Android Studio.

Sebelum memulai

VS Code

  1. Siapkan Gemini Code Assist Standard atau Enterprise, jika Anda belum melakukannya.

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

  3. Jika Anda lebih suka menggunakan IDE di belakang proxy, lihat Koneksi Jaringan di Visual Studio Code.

IntelliJ

  1. Siapkan Gemini Code Assist Standard atau Enterprise, jika Anda belum melakukannya.

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

  3. Jika Anda lebih suka menggunakan IDE di balik proxy, lihat Proxy HTTP.

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.

Meminta Gemini Code Assist dengan transformasi kode

Transformasi kode memungkinkan Anda menggunakan perintah atau perintah bahasa alami di menu Pilih Cepat untuk meminta modifikasi pada kode, dan memberi Anda tampilan perbedaan untuk menampilkan perubahan yang tertunda pada kode Anda. Untuk meminta Gemini Code Assist melakukan transformasi kode, ikuti langkah-langkah berikut:

VS Code

  1. Di file kode Anda, pada baris baru, tekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS) untuk membuka menu Gemini Code Assist Quick Pick.

  2. Di menu, menggunakan perintah /generate, masukkan /generate function to create a Cloud Storage bucket, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

    Gemini Code Assist membuat kode dengan perintah /generate.

    Gemini Code Assist menghasilkan kode berdasarkan perintah Anda dalam tampilan perbedaan.

    Gemini Code Assist membuka tampilan perbedaan untuk menampilkan kode yang dihasilkan.

  3. Opsional: Untuk menerima perubahan ini, klik Terima.

IntelliJ

  1. Di file kode Anda, pada baris baru, tekan Alt+\ (untuk Windows dan Linux) atau Cmd+\ (untuk macOS) untuk membuka menu Gemini Code Assist Quick Pick.

  2. Di menu, menggunakan perintah /generate, masukkan /generate function to create a Cloud Storage bucket, lalu tekan Enter (untuk Windows dan Linux) atau Return (untuk macOS).

    Fungsi pembuatan transformasi kode di IntelliJ Gemini Code Assist

    Gemini Code Assist menghasilkan kode berdasarkan perintah Anda dalam tampilan perbedaan.

    Tampilan perbedaan transformasi kode di IntelliJ Gemini Code Assist

  3. Opsional: Untuk menerima perubahan ini, klik Setujui Perubahan.

    Anda dapat menggunakan perintah transformasi kode berikut di IDE:

    • /fix: Memperbaiki masalah atau error dalam kode Anda. Contoh: /fix potential NullPointerExceptions in my code.
    • /generate: Buat kode. Contoh: /generate a function to get the current time.
    • /doc: Menambahkan dokumentasi ke kode Anda. Contoh: /doc this function.
    • /simplify: Menyederhanakan kode Anda. Contoh: /simplify if statement in this code.

Meminta Gemini Code Assist dalam file kode dengan komentar

Jika mau, Anda juga dapat meminta Gemini Code Assist di file kode dengan komentar dengan mengikuti langkah-langkah berikut:

VS Code

  1. 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 Anda dalam file kode, Gemini Code Assist akan menghasilkan kode dalam bentuk teks bayangan.

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

IntelliJ

  1. Di file kode Anda, pada baris baru, masukkan komentar Function to create a Cloud Storage bucket.

  2. Untuk membuat kode, tekan Alt+G (untuk Windows dan Linux) atau Option+G (untuk macOS). Atau, Anda dapat mengklik kanan di samping komentar dan memilih Generate Code.

    Gemini Code Assist akan menghasilkan kode di bawah komentar Anda dalam bentuk teks bayangan.

  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:

VS Code

  1. Di IDE, klik File (untuk Windows dan Linux) atau Code (untuk macOS), lalu buka Settings > Keyboard Shortcuts.

  2. Dalam daftar pintasan keyboard, scroll hingga Anda menemukan Gemini Code Assist: Generate code.

  3. Klik Gemini Code Assist: 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 Code Assist.

Untuk mempelajari lebih lanjut cara mengubah pintasan di IDE, lihat Penautan Tombol untuk Visual Studio Code.

IntelliJ

  1. Buka settings IDE and Project Settings > Settings > Keymap > Gemini Code Assist.

  2. Klik kanan Gemini Code Assist, lalu pilih Add Keyboard Shortcut.

  3. Masukkan pintasan keyboard yang Anda inginkan, lalu klik OK.

  4. Klik kanan Gemini Code Assist, lalu pilih Hapus Alt+G (untuk Windows dan Linux), atau Hapus Option+G (untuk macOS).

Anda kini dapat menggunakan pintasan keyboard baru untuk membuat kode dalam file kode.

Mendapatkan penyelesaian kode

Saat Anda menulis kode, Gemini Code Assist membuat saran kode inline, yang juga dikenal sebagai penyelesaian kode, yang dapat Anda terima atau abaikan. Untuk mendapatkan penyelesaian kode, ikuti langkah-langkah berikut:

VS Code

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

    Gemini Code Assist 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.

IntelliJ

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

    Gemini Code Assist menyarankan kode dalam bentuk sugesti inline.

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

  3. Opsional: Jika Anda lebih suka menggunakan tombol pintasan lain untuk menerima saran langsung, arahkan kursor ke saran langsung, lalu klik dropdown Tab yang muncul. Kemudian, pilih pintasan yang diinginkan atau klik Kustom untuk memasukkan pintasan Anda sendiri.

    Gemini menyediakan menu dropdown untuk mengubah pintasan Anda agar menerima saran inline.

Opsional: Menonaktifkan pelengkapan kode

Penyelesaian kode diaktifkan secara default. Jika Anda ingin menonaktifkan penyelesaian kode, ikuti langkah-langkah berikut:

VS Code

  1. Di IDE, klik Code (untuk macOS) atau File (untuk Windows dan Linux), lalu buka Settings > Settings.

  2. Di tab User pada dialog Settings, buka Extensions > Gemini Code Assist.

  3. Scroll hingga Anda menemukan daftar Duet AI: Saran Inline: Aktifkan Otomatis, lalu pilih Nonaktif.

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

IntelliJ

Di status bar IDE, klik spark Gemini Code Assist: Active, lalu pilih Enable AI Code Completion.

Tombol Penyelesaian Kode Gemini di status bar IntelliJ.

Tindakan ini akan menonaktifkan setelan penyelesaian kode, dan Gemini Code Assist tidak akan lagi membuat saran inline hingga Anda mengaktifkan setelan tersebut lagi.

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 dalam kode Anda, ikuti langkah-langkah berikut:

VS Code

  1. Di file kode, pilih blok kode.

  2. Di samping blok kode yang dipilih, klik lightbulb Tampilkan Action Kode.

    Ikon bohlam tindakan cerdas muncul setelah memilih blok kode di VS Code.

  3. Pilih tindakan seperti Buat pengujian unit.

    Gemini Code Assist menghasilkan respons yang didasarkan pada tindakan yang Anda pilih.

IntelliJ

  1. Di file kode, pilih baris atau blok kode.

  2. Klik kanan kode yang dipilih, lalu pilih tindakan cerdas, seperti Buat pengujian unit.

    Memilih tindakan cerdas akan otomatis meminta Gemini Code Assist untuk membuat respons terhadap perintah di jendela alat Gemini Code Assist.

Menggunakan perbaikan cepat transformasi kode

Jika ada error dalam kode Anda, Gemini Code Assist memberi Anda opsi untuk menerapkan perbaikan cepat pada error dengan transformasi kode.

Untuk menerapkan perbaikan cepat dalam file kode, ikuti langkah-langkah berikut:

VS Code

  1. Di file kode, arahkan kursor ke baris error bergelombang dan pilih Quick Fix, lalu pilih /fix.

    Perbaikan cepat transformasi kode di IDE.

  2. Saat perbaikan cepat diterapkan, tampilan perbedaan akan muncul. Untuk menerima perubahan ini, klik Setuju.

IntelliJ

  1. Di file kode, klik ikon bohlam error merah, yang menunjukkan error dalam kode Anda, lalu pilih Perbaiki dengan Gemini.

    Opsi transformasi kode untuk diperbaiki dengan Gemini di IDE.

  2. Saat perbaikan diterapkan, tampilan perbedaan akan muncul. Untuk menerima perubahan ini, klik Terima.

Mengecualikan file dari konteks lokal

Secara default, Gemini Code Assist mengecualikan file dari penggunaan lokal dalam konteks untuk penyelesaian kode, pembuatan kode, transformasi kode, dan chat jika file ditentukan dalam file .aiexclude atau .gitignore.

Untuk mempelajari cara mengecualikan file dari penggunaan lokal, lihat Mengecualikan file dari penggunaan Gemini Code Assist.

Menonaktifkan saran kode yang cocok dengan sumber yang dikutip

Gemini Code Assist memberikan informasi kutipan saat secara langsung mengutip secara mendetail dari sumber lain, seperti kode open source yang ada. Untuk mengetahui informasi selengkapnya, lihat Cara dan waktu Gemini mengutip sumber.

Untuk mencegah kode yang cocok dengan sumber yang dikutip agar tidak disarankan kepada Anda, lakukan hal berikut:

  1. Di panel aktivitas IDE, klik Kelola > Setelan.

  2. Di tab User pada jendela setelan, buka Extensions > Gemini Code Assist.

  3. Scroll hingga Anda menemukan Geminicodeassist > Recitation: Max Cited Length.

  4. Tetapkan nilai ke 0.

    Gemini Code Assist tidak lagi menyarankan kode kepada Anda yang cocok dengan sumber yang dikutip.

Masalah umum

Bagian ini menguraikan masalah umum Gemini Code Assist:

VS Code

  • Respons chat dapat terpotong jika menyertakan versi terbaru dari file terbuka yang besar

    Untuk mengatasi masalah ini, pilih bagian kode yang lebih kecil dan sertakan perintah tambahan dalam perintah chat, seperti only output the selected code.

  • Vim: Tidak dapat menerima atau menutup saran pembuatan kode kecuali dalam mode sisipan

    Saat menggunakan plugin Vim dalam mode normal, Anda tidak dapat menerima atau menutup sugesti kode.

    Untuk mengatasi masalah ini, tekan i untuk masuk ke mode sisipan, lalu tekan Tab untuk menerima saran.

  • Vim: Perilaku yang tidak konsisten saat menekan Esc untuk menutup saran

    Saat Anda menekan Esc, saran IDE dan Gemini Code Assist akan ditutup. Perilaku ini berbeda dengan perilaku non-Vim, yaitu menekan Esc akan memicu ulang Gemini Code Assist.

  • Upaya login terus habis waktunya

    Jika waktu tunggu login Anda terus habis, coba tambahkan setelan cloudcode.beta.forceOobLogin ke file settings.json:

     "cloudcode.beta.forceOobLogin": true
    
  • Peringatan pembacaan lisensi tidak dipertahankan di seluruh sesi

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

    1. Klik View > Output.

    2. Pilih Gemini Code Assist - Citations.

  • 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:

    • Konfigurasikan 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
    
  • 'Aktifkan Gemini Code Assist' masih muncul setelah memilih project Gemini Code Assist

    Jika Anda memilih project sesuai dengan petunjuk dalam panduan ini, yang mencakup pengaktifan 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 Tampilkan untuk file log mana pun guna melihat detail selengkapnya dan membantu memecahkan masalah.

IntelliJ

Tidak ada masalah umum untuk Gemini Code Assist untuk IntelliJ dan IDE JetBrains lainnya yang didukung.

Berikan masukan

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

VS Code

  1. Di status bar, klik spark Gemini Code Assist, lalu di menu Quick Pick, 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 Kirim log Skaffold atau Kirim log AI Companion.

  4. Klik Kirim Masukan.

IntelliJ

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

  2. Di kolom teks di bagian atas formulir, masukkan masukan Anda.

  3. Jika Anda ingin membagikan log Gemini Code Assist, pastikan Anda memilih file log.

  4. Klik Kirim Masukan.

Langkah berikutnya