Tur Duet AI untuk Developer

1. Pengantar

Di lab ini, Anda akan menggunakan Duet AI, kolaborator berteknologi AI di Google Cloud. Anda akan memahami cara menggunakan Chat Duet AI dan bantuan kode inline untuk membuat kode, memahami kode, dan banyak lagi.

Yang akan Anda lakukan ...

Anda akan menggunakan Cloud Shell IDE untuk mendownload template kode yang sudah ada untuk aplikasi Web.
Anda akan menggunakan Chat Duet AI di Cloud Shell IDE untuk mengajukan pertanyaan umum terkait Google Cloud.
Anda akan menggunakan bantuan kode Inline Duet AI di Cloud Shell IDE untuk membuat, meringkas, dan menyelesaikan kode.

Yang akan Anda pelajari ...

Cara menggunakan Duet AI untuk beberapa tugas developer seperti pembuatan kode, penyelesaian kode, dan perangkuman kode.
Cara menggunakan Duet AI untuk mempelajari Google Cloud.

Yang Anda butuhkan ...

Browser web Chrome
Akun Gmail
Project Cloud dengan penagihan diaktifkan
Duet AI untuk Project Cloud Anda diaktifkan

Lab ini ditujukan bagi developer dari semua level, termasuk para pemula. Meskipun aplikasi contoh menggunakan bahasa Python, Anda tidak harus familier dengan pemrograman Python untuk memahami maksudnya. Fokus kita memahami kemampuan Duet AI bagi developer.

2. Penyiapan

Bagian ini membahas semua hal yang perlu Anda lakukan untuk memulai lab ini.

Aktifkan Duet AI di Project Google Cloud

Sekarang kita akan mengaktifkan Duet AI API di Project Google Cloud. Ikuti langkah-langkah berikut:

Buka https://console.cloud.google.com dan pastikan Anda telah memilih Project Google Cloud yang akan digunakan untuk lab ini. Klik ikon Duet AI yang Anda lihat di kanan atas.

Jendela chat Duet AI akan terbuka di sisi kanan konsol. Klik tombol Enable seperti yang ditunjukkan di bawah ini. Jika tombol Enable tidak ada dan yang terlihat adalah antarmuka Chat, Anda mungkin telah mengaktifkan Duet AI untuk project tersebut dan Anda dapat langsung melanjutkan ke langkah berikutnya.

Setelah diaktifkan, Anda dapat menguji Duet AI dengan mengajukan satu atau dua kueri. Beberapa contoh kueri ditampilkan, tetapi Anda dapat mencoba, misalnya, What is Cloud Run?

Duet AI akan merespons dengan menjawab pertanyaan Anda. Anda dapat mengklik ikon di pojok kanan atas untuk menutup jendela chat Duet AI.

Aktifkan Duet AI di Cloud Shell IDE

Kita akan menggunakan Cloud Shell IDE untuk langkah-langkah berikutnya dalam codelab ini. Kita perlu mengaktifkan dan mengonfigurasi Duet AI di Cloud Shell IDE dan langkah-langkahnya dijelaskan di bawah ini:

Luncurkan Cloud Shell melalui ikon yang ditunjukkan di bawah. Mungkin perlu waktu satu atau dua menit untuk memulai instance Cloud Shell.

Klik tombol Editor atau Open Editor (mana pun yang tersedia) dan tunggu hingga Cloud Shell IDE muncul. Jika Anda melihat tombol Try the new editor, klik tombol tersebut.

Klik tombol Cloud Code - Sign in di status bar bawah seperti yang ditunjukkan. Otorisasi plugin seperti yang ditunjukkan. Jika Anda melihat "Cloud Code - no project" di status bar, pilih opsi tersebut, lalu pilih Project Google Cloud tertentu dari daftar project yang akan dikerjakan.

(Opsional). Jika tidak melihat Duet AI di status bar di bagian kanan bawah, Anda harus mengaktifkan Duet AI di Cloud Code. Sebelum Anda melakukannya, pastikan Duet AI telah diaktifkan di IDE dengan membuka Cloud Code Extension → Settings, lalu masukkan teks Duet AI: Enable seperti yang ditunjukkan di bawah. Pastikan kotak centang sudah dipilih. IDE Anda harus dimuat ulang. Tindakan ini akan mengaktifkan Duet AI di Cloud Code, dan status bar Duet AI akan muncul di IDE Anda.

Klik tombol Duet AI di pojok kanan bawah seperti yang ditunjukkan, lalu pilih project Google Cloud yang tepat dengan Cloud AI Companion API yang sudah diaktifkan.

Setelah memilih project Google Cloud, pastikan Anda dapat melihatnya di pesan status Cloud Code di status bar dan Duet AI juga sudah diaktifkan di sebelah kanan status bar seperti yang ditunjukkan di bawah:

Duet AI siap digunakan.

3. Membuat Aplikasi contoh

Kita akan membuat aplikasi contoh (aplikasi Python Flask) yang akan digunakan untuk mengeksplorasi fitur Duet AI.

Ikuti langkah-langkah berikut:

Klik nama project Google Cloud di status bar di bawah.

Daftar opsi akan muncul. Klik Aplikasi Baru dari daftar di bawah.

Pilih aplikasi Cloud Run.
Pilih template aplikasi Python (Flask): Cloud Run.
Simpan aplikasi baru di lokasi pilihan Anda.
Sebagai konfirmasi, notifikasi akan muncul dan memberi tahu bahwa aplikasi Anda telah dibuat, lalu aplikasi Anda akan dimuat di jendela baru yang terbuka seperti yang ditunjukkan di bawah. File README.md dibuka. Untuk saat ini, Anda dapat menutup tampilan tersebut.

4. Melakukan chat dengan Duet AI

Kita akan mulai dengan mempelajari cara melakukan chat dengan Duet AI. Duet AI tersedia sebagai asisten chat di dalam Cloud Shell IDE sebagai bagian dari ekstensi Cloud Code di VS Code. Anda dapat menampilkannya dengan mengklik tombol Duet AI di menu navigasi sebelah kiri. Cari ikon Duet AI di toolbar navigasi sebelah kiri, lalu klik ikon tersebut.

Tindakan ini akan menampilkan panel Duet AI di dalam Cloud Shell IDE dan Anda dapat melakukan chat dengan Duet AI untuk mendapatkan bantuan di Google Cloud.

Mari kita gunakan panel Duet AI untuk memasukkan perintah dan melihat respons dari Duet AI. Masukkan perintah berikut:

What is Cloud Run?

Duet AI akan merespons dengan memberikan detail tentang Cloud Run. Perintah adalah pertanyaan atau pernyataan yang menjelaskan bantuan yang Anda butuhkan. Perintah dapat menyertakan konteks dari kode yang sudah ada yang dianalisis Google Cloud untuk memberikan respons yang lebih bermanfaat atau lengkap. Untuk mengetahui informasi selengkapnya tentang cara menulis perintah agar dapat menghasilkan respons yang baik, baca Menulis perintah yang lebih baik untuk Duet AI.

Cobalah contoh perintah berikut atau perintah buatan Anda sendiri untuk mengajukan pertanyaan tentang Google Cloud:

What is the difference between Cloud Run and Cloud Functions?
What services are available on Google Cloud to run containerized workloads?
What are the best practices to optimize costs while working with Google Cloud Storage?

5. Penjelasan Kode

Untuk membantu Anda menjadi lebih produktif sekaligus meminimalkan pengalihan konteks, Duet AI 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.

Anda dapat menggunakan Duet AI untuk membantu memahami bagian-bagian dari kode aplikasi. Kembali ke aplikasi yang telah kita buat pada langkah sebelumnya dan Anda dapat menggunakan Duet AI untuk menjelaskan file dan kode yang tersedia di IDE Anda.

Jika file tidak terlihat, klik Explorer ( ) di panel aktivitas IDE.
Di panel Explorer, pilih Dockerfile.
Pilih bagian mana pun dari konten file, klik bohlam ( ), lalu klik Explain this. Misalnya, pilih baris yang diawali dengan ENTRYPOINT, klik bohlam ( ), lalu klik Explain this. Duet AI memberikan penjelasan selengkapnya mengenai informasi bagian tertentu dari Dockerfile yang Anda butuhkan menggunakan bahasa yang natural. Duet AI merespons dengan detail petunjuk ENTRYPOINT. Anda akan mempelajari bahwa, dengan petunjuk ini, Docker akan menjalankan file app.py saat container diluncurkan.
Untuk melihat konten file app.py, di panel aktivitas, klik Explorer ( ), lalu pilih app.py
Pada definisi fungsi hello(), Anda dapat memilih baris jika ingin mengetahui informasi selengkapnya. Kemudian klik bohlam ( ), lalu klik Explain this. Dalam contoh ini, kita memilih dua baris kode berikut, lalu memicu tindakan Explain this.

Duet AI merespons dengan penjelasan mendetail tentang kedua variabel lingkungan Cloud Run ini (K_SERVICE, K_REVISION) dan cara keduanya digunakan dalam kode aplikasi. Perlu diperhatikan bahwa Duet AI dengan pengetahuannya tentang Google Cloud dan layanan seperti Cloud Run tidak hanya menjelaskan kode Python, tetapi juga memberikan konteks terkait arti variabel tersebut dalam Cloud Run.

Coba cara tambahan berikut untuk mendapatkan penjelasan kode:

Biarkan app.py sebagai file yang sedang dibuka di IDE. Buka panel chat Duet AI di menu navigasi sebelah kiri di VS Code, lalu masukkan perintah Explain this file. Cara ini akan mempertimbangkan seluruh file dan menjelaskannya kepada Anda.
Anda juga dapat memilih bagian mana pun dari file, lalu menggunakan panel chat Duet AI di sebelah kiri, lalu memasukkan perintah Explain this. Tindakan ini hanya akan menjelaskan bagian file yang dipilih. Fungsinya mirip dengan mengklik bohlam ( ) lalu mengklik Explain this.
Anda juga dapat memilih bagian teks dan mengklik Duet AI Smart Actions dari kanan atas di IDE seperti yang ditunjukkan di bawah untuk mendapatkan daftar tindakan yang dapat dilakukan pada teks yang dipilih. Salah satu opsi tersebut adalah tindakan Explain this:

6. Membuat kode dengan perintah

Bagian ini menunjukkan cara menggunakan Duet AI untuk membuat kode dari komentar.

Mari kita coba fitur-fitur ini. Ikuti langkah-langkah berikut:

Buat file baru bernama utils.py.
Di file kode baru Anda, pada baris baru, masukkan # Function to print a list of blobs in a Google Cloud Storage bucket, lalu tekan Enter (untuk Windows dan Linux ) atau Return (untuk MacOS). Duet mungkin mencoba membuat kode saat Anda mengetik, tetapi jangan menerimanya. Kita akan secara khusus memicu pembuatan kode di langkah berikutnya.
Untuk memicu pembuatan kode, tekan Control+Enter (untuk Windows dan Linux) atau Control+Return (untuk MacOS). Di samping teks perintah Anda di file Python, Duet AI akan menghasilkan kode dalam bentuk teks bayangan (ghost text). Alat ini akan memberi Anda satu atau beberapa saran kode dengan toolbar, yang dapat digunakan untuk berpindah dari satu saran kode ke yang lain (jika ada beberapa saran). Anda bahkan dapat menerima saran kode apa pun melalui toolbar. Jika Anda tidak dapat melihatnya atau toolbar menghilang, arahkan kursor ke kode yang dihasilkan agar muncul kembali.
Opsional: Untuk menerima kode yang dibuat, tekan Tab. Jika ada beberapa saran, Anda dapat menekan Tab beberapa kali untuk membuka dari satu cuplikan kode yang disarankan ke cuplikan kode berikutnya.

Tindakan ini akan menyisipkan kode yang Anda terima di file utils.py. Contoh screenshot ditampilkan di bawah ini. Kode yang diberikan kepada Anda mungkin berbeda dengan yang ditunjukkan di bawah.

Perhatikan garis berlekuk-lekuk di sekitar kode. Berikut contoh Kutipan kode. Jika Anda mengarahkan kursor ke salah satu baris, atribusi kode dan informasi relevan lainnya seputar pemberian lisensi akan ditampilkan. Contohnya ditampilkan di bawah ini:

Anda dapat memilih untuk mengabaikan peringatan kutipan dengan mengklik Quick Fix .... Tindakan ini akan menampilkan saran Quick Fix, yang contohnya ditampilkan di bawah:

Anda dapat memilih Ignore Citation Warning jika Anda bersedia menerima lisensi kode.

(Opsional) Berikut beberapa saran lain yang dapat dicoba untuk pembuatan kode:

Anda juga dapat menggunakan fitur chat Duet AI untuk meminta perintah yang sama dan mendapatkan respons di jendela chat. Kemudian, antarmuka Chat akan menampilkan opsi untuk menyalin kode atau menyisipkannya ke dalam file saat ini.
Coba perintah Anda sendiri untuk mendapatkan kode contoh yang diinginkan. Beberapa saran dapat dilihat di bawah (dengan asumsi bahwa Anda berada di salah satu file Phyton): atau pilih dari beberapa perintah yang diberikan di bawah:

Tulis kode Python untuk memublikasikan pesan ke Google Cloud Pub/Sub
Tulis kode Python untuk melakukan inisialisasi klien BigQuery
Tulis kode Python untuk menghubungkan aplikasi saya ke Cloud SQL

7. Mendapatkan saran kode inline saat Anda membuat kode

Saat Anda menulis kode, Duet AI membuat saran kode inline yang dapat Anda terima atau abaikan. Untuk mencoba fitur ini, kita akan mengubah file utils.py yang telah dibuat di bagian sebelumnya:

Buka file utils.py sebagai file saat ini di Cloud Shell IDE.
Salah satu hal yang dapat kita lakukan adalah memberikan pernyataan import yang benar, jika file tersebut tidak ada di kode yang dihasilkan.
Mulai ketik kata import dan Anda akan melihat Duet AI yang menyarankan kode dalam bentuk teks bayangan (ghost text). Untuk menerima saran kode dari Duet AI, tekan Tab. Atau, untuk mengabaikan saran, tekan Esc atau lanjutkan menulis kode Anda. Pada layar contoh di bawah, sebaiknya impor class storage karena sedang digunakan dalam kode. Tekan Tab untuk menerima saran kode. Pernyataan import os juga disarankan, tetapi karena tidak diperlukan, kita dapat menghapusnya.

Lihat akhir file utils.py dan tambahkan baris untuk memanggil fungsi, jika tidak disediakan. Dalam kasus ini, yang dimaksud adalah fungsi list_blobs. Anda bisa mulai mengetik nama fungsi dan penyelesaian kode akan membantu Anda menyelesaikan pernyataan.
Anda harus memberikan bucket_name dan dapat menggunakan nama bucket publik berikut: duetai-tour-bucket. Contoh panggilan untuk fungsi tersebut ditampilkan di bawah. Perhatikan bahwa Anda mungkin melihat perbedaan kecil terkait nama fungsi, dll.

(Opsional) Jalankan kode contoh

Karena kita menulis kode untuk mencantumkan blob di bucket Google Cloud Storage, kita perlu menginstal library Python google-cloud-storage.

Buka file requirements.txt dan tambahkan baris baru dengan dependensi google-cloud-storage seperti yang ditunjukkan di bawah. Contoh file requirements.txt ditampilkan di bawah.

Flask==2.3.3
requests==2.31.0
debugpy # Required for debugging.
google-cloud-storage

Simpan file requirements.txt tersebut.

Untuk melihat cara kerja kode ini, kita harus meluncurkan sesi Terminal baru dari Cloud Shell IDE melalui ikon menu di sebelah kiri atas. Klik ikon menu, lalu Terminal → New Terminal seperti yang ditunjukkan di bawah:

Pada sesi Terminal, instal dependensi Python melalui perintah berikut:

pip install -r requirements.txt

Terakhir, Anda dapat menjalankan file utils.py melalui perintah berikut:

python utils.py

Tindakan ini akan menampilkan blob yang ada di bucket Google Cloud Storage publik. Idealnya, Anda akan melihat 2 blob yang tercantum dalam output (file1.txt dan file2.txt).

Pemecahan masalah

Jika muncul error "akses" saat menampilkan objek dalam bucket publik di atas, Anda dapat memilih untuk membuat bucket Google Cloud Storage sendiri dan menggunakannya, alih-alih menggunakan duetai-tour-bucket. Bagian berikutnya akan menunjukkan cara melakukannya.

(Opsional) Buat bucket Cloud Storage Anda sendiri

Kita akan meminta bantuan Duet AI untuk menghasilkan perintah membuat bucket, menjadikannya dapat diakses secara publik, dan mengupload objek contoh ke dalam bucket.

Mulai dengan perintah berikut: "What is the gcloud command to create a public bucket in Google Cloud Storage?" (Apa perintah gcloud untuk membuat bucket publik di Google Cloud Storage?)

Anda dapat menggunakan perintah gcloud ini untuk membuat bucket. Perintah tepatnya ditampilkan di bawah:

gcloud storage buckets create gs://<BUCKET_NAME>

Pilih nama unik untuk <BUCKET_NAME> dan jalankan perintah tersebut di terminal.

Setelah membuat bucket, kita perlu menjadikannya dapat diakses oleh publik. Mari kita sampaikan perintahnya ke Duet AI menggunakan perintah berikut: "How do I make a google cloud storage bucket publicly accessible?" (Bagaimana cara membuat bucket Google Cloud Storage dapat diakses secara publik)

Anda dapat menggunakan perintah gcloud ini untuk menjadikannya dapat diakses secara publik. Responsnya kurang lebih akan seperti ini:

gcloud storage buckets add-iam-policy-binding gs://<BUCKET_NAME> --member=allUsers --role=roles/storage.objectViewer

Ganti <BUCKET_NAME> dengan nama bucket yang Anda gunakan sebelumnya lalu jalankan perintah.

Terakhir, kita akan mengupload beberapa file contoh ke bucket. Jalankan perintah berikut di terminal (Jangan lupa mengganti variabel <BUCKET_NAME> dengan nama bucket Anda).

touch f1.txt
touch f2.txt

gcloud storage cp f1.txt gs://<BUCKET_NAME>
gcloud storage cp f2.txt gs://<BUCKET_NAME>

Kini, Anda dapat menjalankan file utils.py menggunakan <BUCKET_NAME> Anda, alih-alih menggunakan duetai-tour-bucket.

8. Selamat!

Selamat! Anda telah berhasil bekerja dengan Duet AI dalam sebuah project contoh untuk memahami bagaimana Duet AI dapat membantu Pembuatan Kode, Penyelesaian Kode, Peringkasan Kode, dan membantu Anda mendapatkan jawaban atas pertanyaan tentang Google Cloud.