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 yang cukup tentang Cloud Shell Editor dan sudah terbiasa dengan Google Cloud. Jika ingin, Anda juga dapat mempelajari Gemini Code Assist di Cloud Workstations, Cloud Code for IntelliJ, dan Cloud Code for VS Code.
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 Cloud Shell Editor.
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 Cloud Shell Editor, ikuti langkah-langkah berikut:
Buka Cloud Shell Editor.
Jika Anda menggunakan Editor Lama, klik Coba Editor baru.
Di status bar, klik Cloud Code - Sign In.
Jika diminta untuk memberikan otorisasi pada Cloud Shell Editor untuk melakukan panggilan Google Cloud API, klik Authorize.
Ikuti petunjuk untuk login ke Akun Google Anda.
Anda kini terhubung ke Google Cloud.
Selanjutnya, untuk memilih project Google Cloud yang mengaktifkan Cloud AI Companion API, ikuti langkah-langkah berikut:
Di status bar Gemini Code Assist, klik Gemini Code Assist.
Di menu Gemini Code Assist, pilih Select Gemini Code Assist project.
Pilih project Google Cloud yang telah mengaktifkan Cloud AI Companion API.
Gemini siap digunakan.
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:
Di Cloud Shell Editor, buka palet perintah: tekan Control+Shift+P (untuk Windows dan Linux) atau Command+Shift+P (untuk macOS), lalu jalankan Cloud Code: New Application.
Pilih Kubernetes application.
Pilih template aplikasi Python (Flask): Guestbook.
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:
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 filefront.py.Di panel aktivitas Cloud Shell Editor, klik chat_spark Gemini Code Assist.
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
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 filefront.py.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).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.
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:
Di Cloud Shell Editor, klik menu Menu, lalu buka File > Preferences > Keyboard Shortcuts.
Dalam daftar pintasan keyboard, telusuri Cloud Code: Buat Kode.
Klik Cloud Code: Generate Code, lalu klik edit Change Keybinding.
Pada dialog yang muncul, masukkan pintasan Anda sendiri.
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:
Di Editor Cloud Shell, buka file di project Anda yang berisi kode, atau gunakan file kode yang sama dengan yang Anda gunakan pada langkah sebelumnya.
Di kolom aktivitas, klik chat_spark Gemini Code Assist untuk membuka panel Gemini Code Assist.
Di file kode Anda, pilih blok kode.
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 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:
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 filefront.py.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.
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:
Di Cloud Shell Editor, pilih menu Menu, lalu buka File > Preferences > Settings.
Di tab User pada dialog Settings, buka Extensions > Cloud Code.
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:
Di file kode Anda, pilih blok kode.
Di samping blok kode yang dipilih, klik bohlam Show Code Actions.
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:
Dalam file kode, tekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).
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:
Dalam file kode, pilih fungsi dan buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).
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.
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.
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:
Dalam file kode, buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).
Tekan / untuk melihat daftar perintah cerdas dan deskripsinya.
Pilih
/explain.Gemini menghasilkan penjelasan tentang seluruh file kode di kotak teks inline.
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:
Di file kode, pilih kode yang ingin Anda tambahi komentar.
Buka kotak teks inline dengan menekan Control+I (untuk Windows dan Linux) atau Command+I (untuk macOS).
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.
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
- Dalam file kode, pilih fungsi yang ingin Anda jelaskan.
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
- Di file kode, pilih kode yang ingin Anda tambahi pengujian unit.
- Di panel Gemini Code Assist, masukkan perintah
Write unit tests for my code.
Mendapatkan bantuan terkait kode proses debug
- Dalam file kode, pilih kode yang ingin Anda debug.
- Di panel Gemini Code Assist, masukkan perintah
Help me debug my code.
Membuat kode Anda lebih mudah dibaca
- Dalam file kode Anda, pilih kode yang ingin Anda buat lebih mudah dibaca.
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:
Klik menu Menu > View > Output.
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.comdancloudaicompanion.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:
Di status bar, klik Gemini Code Assist, lalu di menu Quick Pick, pilih Send feedback.
Dalam formulir, isi kolom Judul dan Komentar.
Jika ingin membagikan log Skaffold atau AI Companion, pastikan Anda memilih opsi Send Skaffold logs atau Send AI Companion logs.
Klik Kirim Masukan.
Langkah selanjutnya
- Pelajari cara menulis perintah yang lebih baik.