Kode dengan Gemini Code Assist

Dokumen ini menjelaskan cara menggunakan Gemini Code Assist, kolaborator berteknologi 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.

• Menerima 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 menyediakan kutipan sumber saat sarannya mengutip langsung 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 Anda langsung dari Gemini Code Assist. Pelajari cara mengonfigurasi penyesuaian kode.

Dokumen ini ditujukan bagi developer dengan semua tingkat keterampilan. Hal ini mengasumsikan bahwa Anda memiliki pengetahuan dasar tentang Cloud Workstations dan sudah memahami Google Cloud. Jika mau, Anda juga dapat menjelajahi Gemini Code Assist di VS Code, IntelliJ, dan Cloud Shell Editor.

Sebelum memulai

1. Pastikan Anda memiliki peran IAM Cloud Workstations Admin di project sehingga Anda 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 Anda, pastikan bahasa coding file Anda didukung. Untuk informasi selengkapnya tentang bahasa coding yang didukung, lihat Bahasa coding yang didukung.

Hubungkan ke Google Cloud dan pilih project

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

Jika Anda memilih project yang Google Cloud belum 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 otomatis menetapkan project Gemini API untuk Google Cloud di semua workstation.

Untuk terhubung ke Google Cloud in workstation Anda, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , luncurkan workstation Anda.

   Luncurkan workstation

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

3. Ikuti perintah untuk login ke Gemini Code Assist, jika Anda belum login.

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

5. 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, menampilkan kode verifikasi untuk login ke Cloud Code.

6. 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. Gemini siap digunakan.

Mulai percakapan dengan Gemini Code Assist

Sebagai teknologi tahap awal, Gemini untuk produk Google Cloud dapat menghasilkan output yang seolah masuk akal, tetapi mengandung fakta yang salah. Sebaiknya Anda memvalidasi semua output dari Gemini untuk Google Cloud produk sebelum Anda menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

Di bagian ini, pelajari cara membuka panel Gemini Code Assist dan melakukan percakapan dengan Gemini Code Assist untuk mendapatkan penjelasan kode Anda.

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

1. Buka file sumber.

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

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

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

   Untuk berfokus pada blok kode tertentu, pilih blok tersebut di file yang terbuka sebelum memasukkan perintah.

Mereset histori chat

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

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

Catatan: Histori chat akan otomatis direset saat Anda mengganti 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. Anda juga dapat memilih bagian kode Anda, lalu meminta bantuan Gemini Code Assist melalui fitur chat, serta menerima dan menyetujui atau menolak saran kode saat Anda menulis kode.

Memasukkan perintah ke Gemini Code Assist dalam file

1. Di file sumber, 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 menghasilkan kode, tekan Control+Enter (untuk Windows dan Linux) atau Control+Return (untuk macOS).

   Di samping teks perintah Anda di file, 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 Anda, 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 Chat Gemini Code Assist.

2. Dalam file sumber, pilih blok kode.

3. Di kolom teks Chat 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. Dalam file sumber, pada baris baru, mulai tulis fungsi. Misalnya, jika Anda berada dalam 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: Menonaktifkan saran sebaris

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

1. Di workstation Anda, 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 Off.

   Tindakan ini akan menonaktifkan saran inline. Anda tetap 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 sama dengan file .gitignore, dengan perbedaan berikut:

• File .aiexclude yang kosong atau tidak ada tidak memblokir file apa pun dalam direktorinya dan semua subdirektori.
• File .aiexclude tidak mendukung negasi, yaitu Anda memberi awalan pola dengan tanda seru (!).
• File .aiexclude cocok dengan karakter * secara rakus. Tindakan ini akan mencocokkan direktori dan file secara acak. File .aiexclude ini tidak membedakan ** atau * terkait 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 "File Pengecualian Konteks". Nilai jalur yang diberikan dalam setelan ini akan diselesaikan relatif terhadap folder root ruang kerja 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 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 bersifat relatif terhadap direktori root ruang kerja.

  my/sensitive/dir/*
  

Menonaktifkan saran kode yang cocok dengan sumber yang dikutip

Gemini menyediakan informasi kutipan saat mengutip langsung secara signifikan dari sumber lain, seperti kode sumber yang tersedia secara publik. Untuk mengetahui informasi selengkapnya, lihat Bagaimana dan kapan Gemini mencantumkan sumber kutipan.

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

"geminicodeassist.recitation.maxCitedLength": 0

Menggunakan tindakan smart

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

Untuk menggunakan tindakan smart, ikuti langkah-langkah berikut:

1. Dalam file sumber, pilih blok kode.

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

   

3. Pilih tindakan seperti Buat pengujian unit.

   Gemini akan membuat respons berdasarkan tindakan yang Anda pilih.

Menggunakan transformasi kode

Gemini Code Assist menyediakan Transformasi kode, yang memungkinkan Anda memilih sebagian kode dalam file 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 yang bermasalah
• Meningkatkan keterbacaan kode
• Membuat kode lebih efisien

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

Memberi perintah Gemini Code Assist dengan kotak teks inline

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

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

1. Di file sumber, 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 difaktorkan ulang

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

Untuk melihat perbedaan kode yang di-refactor dari kotak teks inline, lakukan langkah-langkah berikut:

1. Dalam file sumber, 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 menerima 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 atas perintah Anda. Mengetahui file mana yang digunakan sebagai referensi akan membantu Anda menyempurnakan perintah dan mendapatkan respons yang lebih spesifik. Sumber konteks ditampilkan setiap kali Anda menggunakan percakapan Gemini.

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

Menggunakan perintah smart

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

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

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

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

3. Pilih /explain.

   Gemini menghasilkan penjelasan seluruh file 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 Anda saat Anda ingin menggunakan kembali perintah dalam file sumber yang besar.

Untuk mengakses histori perintah, di file Anda, buka kotak teks sebaris 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 melihat-lihat perintah lama dan menggunakannya kembali jika diperlukan.

Meningkatkan keterbacaan kode bagi yang bukan penutur asli 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 berbahasa Inggris ke bahasa lain atau menambahkan komentar baru dalam bahasa lain, ikuti langkah-langkah berikut:

1. Dalam file sumber, 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 membuat komentar dalam bahasa yang Anda tentukan dalam perintah dan melihat perbedaan saran ini.

4. Untuk menerima atau menghapus perubahan ini pada kode Anda, klik Terima atau Hapus.

Menguji contoh perintah lainnya

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

Mendapatkan penjelasan kode

1. Dalam file sumber, pilih fungsi yang ingin Anda minta penjelasannya.

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. Dalam file sumber, 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 men-debug kode

1. Dalam file sumber, 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 sumber, 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 suka berfokus pada bagian kode tertentu, 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 berlanjut di seluruh sesi, lihat log persisten:

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

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

Jika Anda memilih project sesuai petunjuk dalam panduan ini, yang mencakup pengaktifan Gemini API for Google Cloud, 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. Dalam formulir, isi kolom Judul dan Komentar.

3. Untuk membagikan log Skaffold atau AI Companion Anda, pilih opsi Kirim log Skaffold atau Kirim log AI Companion.

4. Klik Kirim Masukan.

Langkah berikutnya

• Pelajari cara menulis perintah yang lebih baik.