Kode dengan Gemini Code Assist

Dokumen ini menjelaskan cara menggunakan Gemini Code Assist, kolaborator dengan teknologi AI di Google Cloud, untuk membantu Anda melakukan hal berikut di Cloud Code:

  • Memberikan panduan untuk membantu Anda memecahkan masalah terkait kode.

  • Buat kode untuk project Anda.

  • Terima saran yang disisipkan saat Anda melakukan coding.

Gemini tidak menggunakan perintah Anda atau responsnya sebagai data untuk melatih modelnya. Untuk mengetahui informasi selengkapnya, lihat Cara Gemini untuk Google Cloud menggunakan data Anda.

Untuk membantu Anda mematuhi persyaratan lisensi apa pun untuk kode Anda, Gemini Code Assist menyediakan kutipan sumber saat sarannya mengutip langsung sumber tertentu secara mendetail. Untuk mempelajari lebih lanjut bagaimana dan kapan Gemini mengutip sumber, lihat Cara Gemini membantu Anda membuat kode dan mengutip sumber.

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

Sebelum memulai

  1. Instal ekstensi Cloud Code jika Anda belum melakukannya. Cloud Code terintegrasi dengan Gemini Code Assist di IDE Anda.
  2. Opsional: Jika Anda memilih untuk meng-clone contoh untuk tugas dalam dokumen ini, instal Git. Git diperlukan untuk menyalin sampel ke komputer Anda.

Hubungkan ke Google Cloud dan pilih project

Di bagian ini, Anda akan terhubung ke Google Cloud dan memilih project Google Cloud dengan Cloud AI Companion API yang diaktifkan di IDE Anda.

Jika memilih project Google Cloud tanpa mengaktifkan Cloud AI Companion API, Anda akan menerima notifikasi error dan diminta untuk menghubungi administrator Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Gemini Code Assist untuk sebuah project.

Jika Anda memilih untuk mengikuti panduan Code with Gemini Code Assist langsung di IDE Anda, klik Launch VS Code dan ikuti langkah-langkah dalam panduan untuk terhubung ke Google Cloud dan mengaktifkan Gemini Code Assist.

Luncurkan VS Code

Jika tidak, ikuti langkah berikut:

  1. Luncurkan IDE Anda.

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

    Cloud Code - Tombol Login di status bar.

  3. Saat diminta untuk mengizinkan Cloud Code membuka situs eksternal, klik Open.

  4. Ikuti petunjuk untuk login ke Akun Google Anda.

  5. Saat ditanya apakah Anda mendownload Cloud Code dari Google, klik Sign In.

    Anda kini terhubung ke Google Cloud.

Selanjutnya, untuk memilih project Google Cloud yang mengaktifkan Cloud AI Companion API, ikuti langkah-langkah berikut:

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

    Status bar Gemini tersedia.

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

  3. Pilih project Google Cloud yang telah mengaktifkan Cloud AI Companion API.

    Gemini siap digunakan.

    Ikon Gemini di status bar disetel ke normal.

Untuk menguji kemampuan Gemini Code Assist, buka aplikasi, atau buat aplikasi contoh di bagian berikutnya.

Opsional: Membuat aplikasi contoh

Jika Anda lebih suka menggunakan aplikasi yang sudah ada untuk menguji kemampuan Gemini Code Assist, Anda dapat melewati bagian ini. Jika tidak, untuk membuat aplikasi contoh, ikuti langkah-langkah berikut:

  1. Di IDE, buka palet perintah: tekan Control+Shift+P (untuk Windows dan Linux) atau Command+Shift+P (untuk macOS), lalu jalankan Cloud Code: New Application.

  2. Pilih Kubernetes application.

  3. Pilih template aplikasi Python (Flask): Guestbook.

  4. Simpan aplikasi baru di lokasi pilihan Anda.

    Notifikasi mengonfirmasi bahwa aplikasi Anda telah dibuat, dan jendela baru akan terbuka dengan aplikasi Anda dimuat.

Chat 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 ada.

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

  1. Buat file kode baru atau gunakan yang sudah ada. Jika menggunakan contoh Python (Flask), Anda dapat melakukan tugas ini dalam file front.py: buka Explorer > src > frontend, lalu buka file front.py.

  2. Di panel aktivitas IDE, klik chat_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 ke perintah dan merespons dengan memberikan penjelasan tentang kode Anda.

    Untuk merujuk ke blok kode tertentu, bukan semua kode dalam file, Anda dapat memilih blok tersebut dalam file kode, lalu meminta Gemini.

Reset histori chat

Gemini Code Assist menggunakan histori chat untuk konteks tambahan saat merespons perintah Anda.

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

Buat kode dengan prompt

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

Prompt Gemini Code Assist dalam file kode

  1. Buat file kode baru atau gunakan yang sudah ada. Jika menggunakan contoh Python (Flask), Anda dapat melakukannya di file front.py: buka Explorer > src > frontend, lalu buka file front.py.

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

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

    Di samping teks perintah Anda di file Python, Gemini Code Assist akan membuat kode dalam bentuk ghost text.

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

Opsional: Ubah 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 IDE, klik File (untuk Windows dan Linux) atau Code (untuk macOS), lalu buka Settings > Keyboard Shortcuts.

  2. Di daftar pintasan keyboard, scroll hingga Anda menemukan Cloud Code: Buat kode.

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

    Kini Anda dapat menggunakan pintasan keyboard yang baru ditetapkan untuk membuat kode dengan Gemini Code Assist.

Untuk mempelajari lebih lanjut cara mengubah pintasan di IDE, lihat Binding kunci untuk Kode Visual Studio.

Minta Bantuan Kode Gemini dengan kode yang dipilih menggunakan chat

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

  1. Di IDE, buka file di project Anda yang berisi kode, atau gunakan file kode yang sama dengan yang Anda gunakan pada langkah sebelumnya.

  2. Di kolom aktivitas, klik chat_spark Gemini Code Assist untuk membuka panel Gemini Code Assist.

  3. Di file kode Anda, pilih blok kode.

  4. 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 menulis pengujian unit untuk fungsi yang dipilih.

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

Dapatkan saran inline saat 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. Buat file kode baru atau gunakan yang sudah ada. Jika menggunakan contoh Python (Flask), Anda dapat melakukannya di file front.py: buka Explorer > src > frontend, lalu buka file front.py.

  2. Dalam file kode Anda, pada baris baru, mulailah menulis fungsi. Misalnya, jika Anda berada di file Python, tulis def.

    Gemini menyarankan kode dalam bentuk teks hantu.

  3. Untuk menerima saran kode dari Gemini Code Assist, tekan Tab. Jika tidak, untuk mengabaikan saran, tekan Esc atau lanjutkan menulis kode Anda.

Opsional: Nonaktifkan saran inline

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

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

  2. Di tab User pada 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.

Nonaktifkan saran kode yang cocok dengan sumber yang dikutip

Gemini memberikan informasi kutipan saat langsung mengutip 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 kutipan agar tidak disarankan, Anda dapat mengubah setelan cloudcode.duetAI.recitation.maxCitedLength menjadi 0 dalam file settings.json:

"cloudcode.duetAI.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. Saat memilih kode di editor kode, Anda dapat melihat dan memilih dari daftar tindakan yang relevan dengan konteks Anda.

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

  1. Di file kode Anda, pilih blok kode.

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

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

  3. Pilih tindakan seperti Membuat pengujian unit.

    Gemini menghasilkan respons berdasarkan tindakan yang Anda pilih.

Menguji contoh perintah lainnya

Setelah membaca bagian Buat kode dengan perintah dalam dokumen ini, coba beberapa contoh perintah berikut.

Mendapatkan penjelasan tentang kode

  1. Dalam file kode, pilih fungsi yang ingin Anda jelaskan.

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

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

Membuat rencana pengujian

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

Mendapatkan bantuan terkait kode proses debug

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

Membuat kode Anda lebih mudah dibaca

  1. Dalam file kode Anda, pilih kode yang ingin Anda buat lebih mudah dibaca.

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

    Jika Anda memilih untuk berfokus pada bagian tertentu dari kode, pilih bagian kode yang diinginkan sebelum meminta perintah Gemini.

Masalah umum

Bagian berikut menguraikan masalah umum Gemini Code Assist.

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

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 menolak saran pembuatan kode kecuali dalam mode sisipkan

Saat menggunakan plugin Vim dalam mode normal, Anda tidak dapat menerima atau menolak saran kode.

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

Vim: Perilaku tidak konsisten saat menekan Esc untuk menolak saran

Saat Anda menekan Esc, saran IntelliJ dan Gemini akan ditolak. Perilaku ini berbeda dengan perilaku non-Vim, ketika menekan Esc akan memicu kembali Gemini.

Peringatan pembacaan lisensi tidak terus ada di seluruh sesi

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

  1. Klik Lihat > 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 memungkinkan 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 hal berikut sebelum grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

Berikan masukan

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

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

  2. Dalam formulir, isi kolom Judul dan Komentar.

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

  4. Klik Kirim Masukan.

Langkah selanjutnya