Kode dengan Gemini Code Assist

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

  • 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 dasar tentang Cloud Workstation dan sudah terbiasa dengan Google Cloud. Jika ingin, Anda juga dapat mempelajari 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 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.

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

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.

    Cloud Code - Tombol Login di status bar.

  3. Saat Anda diminta untuk login, klik Lanjutkan untuk login.

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

  5. Untuk login ke akun Anda, ikuti petunjuknya.

    Saat diminta untuk mengizinkan Google Cloud SDK mengakses Akun Google Anda dan menyetujui persyaratannya, klik Allow.

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

  6. Salin kode verifikasi dan tempelkan ke terminal Anda yang bertuliskan Masukkan kode otorisasi, 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 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 workstation Anda, 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. Masukkan nama untuk aplikasi contoh Anda, lalu klik OK untuk menyimpannya.

    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 workstation Anda, 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 workstation, klik menu Menu, lalu buka File > Preferences > Keyboard Shortcuts.

  2. Dalam daftar pintasan keyboard, telusuri 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.

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 workstation, 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 workstation Anda, pilih menu Menu, lalu buka File > Preferences > 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 Shell dan Workstation.

  3. Pilih tindakan seperti Membuat pengujian unit.

    Gemini menghasilkan respons berdasarkan tindakan yang Anda pilih.

Pratinjau: Menggunakan Transformasi Kode

Gemini Code Assist menyediakan Transformasi Kode, yang memungkinkan Anda memilih bagian file kode dan meminta modifikasi pada kode yang ada melalui perintah dalam natural language, 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 dari respons yang dihasilkan di panel Gemini: Chat.

Prompt Gemini Code Assist dengan kotak teks inline

Kotak teks inline memungkinkan Anda berinteraksi dengan Bantuan Kode Gemini secara langsung dalam file kode.

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

  1. Dalam 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 membuat kode berdasarkan perintah Anda.

Lihat perbedaan kode yang difaktorkan ulang

Dengan tampilan perbedaan yang disertakan 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 telah difaktorkan ulang dari kotak teks inline, lakukan langkah-langkah berikut:

  1. Dalam file kode, 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 dipilih, tampilan perbedaan akan muncul.

    Sumber konteks yang tercantum di panel Chat Gemini.

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

Melihat sumber konteks dari 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 menyaring perintah dan mendapatkan respons yang lebih spesifik. Sumber konteks ditampilkan setiap kali Anda menggunakan chat Gemini.

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

Sumber konteks yang tercantum di panel Chat Gemini.

Menggunakan perintah cerdas

Perintah smart 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, 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 tentang seluruh file kode di kotak teks inline.

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

Lihat histori perintah

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

Untuk mengakses histori perintah, pada file kode, 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 panah Command+Up (untuk macOS). Dengan begitu, Anda dapat melihat kembali perintah lama dan menggunakannya kembali saat diperlukan.

Meningkatkan keterbacaan kode untuk penutur bahasa Inggris non-native

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

Peringatan pembacaan lisensi tidak terus ada di seluruh sesi

Jika peringatan pembacaan lisensi tidak dipertahankan 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 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

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.

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