Kode dengan Gemini Code Assist

Dokumen ini menjelaskan cara menggunakan Gemini Code Assist, kolaborator yang didukung teknologi AI di Google Cloud, untuk membantu Anda melakukan hal-hal berikut di editor dasar Cloud Workstations:

• Memberikan panduan untuk membantu Anda memecahkan 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.

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

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

Dokumen ini ditujukan untuk developer dari semua tingkat keterampilan. Tutorial ini mengasumsikan bahwa Anda memiliki pengetahuan dasar tentang Cloud Workstation dan memahami Google Cloud. Jika mau, Anda juga dapat menjelajahi Gemini Code Assist di Cloud Code untuk VS Code, Cloud Code untuk IntelliJ, dan Cloud Shell Editor.

Sebelum memulai

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

   Buka IAM

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

   Penting: Untuk menggunakan Gemini Code Assist, Anda harus memilih Base Editor (Code-OSS) saat membuat konfigurasi workstation.
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.

Menghubungkan ke Google Cloud dan memilih project

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

Jika memilih project Google Cloud tanpa mengaktifkan Gemini for 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 sebuah project.

Tips: Anda dapat menentukan variabel lingkungan GEMINI_DEFAULT_PROJECT dalam konfigurasi workstation untuk menetapkan Gemini untuk project Google Cloud API secara otomatis di semua workstation.

Untuk 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 alur login Google Cloud, 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 Login.

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

7. Salin kode verifikasi dan tempelkan ke terminal Anda di bagian 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 project Google Cloud yang mengaktifkan Gemini untuk Google Cloud API, 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

Sebagai teknologi tahap awal, Gemini untuk Google Cloud produk dapat menghasilkan output yang tampaknya masuk akal tetapi sebenarnya tidak benar. Sebaiknya Anda memvalidasi semua output dari produk Gemini untuk Google Cloud sebelum Anda menggunakannya. Untuk informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

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. 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 dan klik send Send.

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

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

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

Catatan: Histori chat akan otomatis direset saat Anda beralih ruang kerja atau keluar dari workstation.

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 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 Anda di file kode, Gemini Code Assist akan menghasilkan 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 workstation, klik menu Menu, lalu buka File > Preferences > Keyboard Shortcuts.

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.

Meminta 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 yang Anda pilih 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 dalam file Python, tulis def.

   Gemini menyarankan kode dalam bentuk teks bayangan.

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

Opsional: Menonaktifkan saran inline

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

1. Di workstation, pilih menu Menu, lalu buka File > Preferences > Settings.

2. Di tab User dalam dialog Settings, buka Extensions > Cloud Code.

3. Scroll hingga Anda menemukan daftar Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto, 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.

Opsional: Mengecualikan file dari konteks dengan file .aiexclude

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

• File .aiexclude yang kosong atau tidak ada tidak akan memblokir file apa pun di direktorinya dan semua subdirektori.
• File .aiexclude tidak mendukung negasi, tempat Anda menambahkan awalan pola dengan tanda seru (!).
• File .aiexclude cocok dengan karakter * secara rakus. Ini akan cocok tanpa pandang bulu 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 ruang kerja, atau mengganti nama file, jalur dapat ditetapkan di setelan VS Code di bagian "Context Exclusion File". Nilai jalur yang diberikan dalam setelan ini akan di-resolve secara relatif terhadap folder root ruang kerja terbuka Anda.

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 di atau di bawah direktori ruang kerja:

  *.key
  

• Hanya blokir file apikeys.txt di direktori yang sama dengan file .aiexclude, tetapi tidak di subdirektori mana pun:

  /apikeys.txt
  

• Blokir semua file di direktori my/sensitive/dir dan semua subdirektorinya. Jalur harus relatif terhadap direktori root ruang kerja.

  my/sensitive/dir/*
  

Menonaktifkan saran kode yang cocok dengan sumber yang dikutip

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

Untuk mencegah kode yang cocok dengan sumber yang dikutip 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. 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:

1. Di file kode, pilih blok kode.

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

   

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 sebagian file kode dan meminta modifikasi pada kode yang ada melalui perintah dalam bahasa alami, menggunakan kotak teks inline.

Dengan Transformasi kode, Anda dapat melakukan hal berikut:

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

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

Meminta Gemini Code Assist dengan kotak teks inline

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

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

1. Di file kode, 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 menghasilkan kode berdasarkan perintah Anda.

Melihat perbedaan kode yang telah difaktorkan ulang

Dengan tampilan perbedaan yang terintegrasi ke dalam kotak teks inline, Anda dapat melihat perubahan yang disarankan Gemini dan kode asli Anda. Kemudian, Anda dapat menerima atau menolak perubahan yang disarankan.

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

1. Di 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 Terima atau Hapus.

Melihat sumber konteks respons yang dihasilkan

Fitur tampilan konteks mencantumkan file project Anda (sumber konteks) yang digunakan sebagai referensi untuk membuat 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 ditampilkan setiap kali Anda menggunakan percakapan Gemini.

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 smart command

Perintah smart adalah perintah yang dapat Anda gunakan di kotak teks langsung untuk melakukan tindakan tertentu pada kode Anda.

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

1. Di 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 smart beserta 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 perlu memasukkan perintah yang sama dalam file kode yang besar.

Untuk mengakses histori perintah, di file kode, buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS), lalu tekan Control+Panah atas (untuk Windows dan Linux) atau Command+Panah atas (untuk macOS). Hal ini memungkinkan Anda beralih ke perintah lama dan menggunakannya kembali jika diperlukan.

Meningkatkan keterbacaan kode untuk penutur non-native bahasa Inggris

Jika Anda bukan penutur asli bahasa Inggris yang 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, pilih kode yang ingin Anda beri 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 menghasilkan komentar dalam bahasa yang Anda tentukan dalam perintah dan melihat perbedaan saran ini.

4. Untuk menyetujui atau menghapus perubahan ini pada kode Anda, klik Setuju atau Hapus.

Menguji contoh perintah lainnya

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

Mendapatkan penjelasan kode

1. Di 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 fungsi yang dipilih.

Membuat 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 proses debug kode

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 Anda lebih mudah dibaca

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

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

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

Masalah umum

Bagian berikut menguraikan masalah umum Gemini Code Assist.

Peringatan pembacaan lisensi tidak akan dipertahankan di seluruh sesi

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

1. Klik menu Menu > Lihat > 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.

• Konfigurasikan 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 JetBrains Gateway

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

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

Jika Anda memilih project sesuai 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.

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

Langkah selanjutnya

• Pelajari cara menulis perintah yang lebih baik.