Mengembangkan fitur dengan Amazon Q Developer

Amazon Q Developer dapat membantu Anda mengembangkan fitur kode atau membuat perubahan kode pada proyek di lingkungan pengembangan terintegrasi (IDE) Anda. Anda menjelaskan tugas yang ingin Anda selesaikan, dan Amazon Q menggunakan konteks proyek atau ruang kerja Anda saat ini untuk menghasilkan kode guna mengimplementasikan perubahan. Amazon Q dapat membantu Anda membangun AWS proyek atau aplikasi Anda sendiri.

Anda dapat memulai proyek yang sama sekali baru, atau mengerjakan proyek terbuka di IDE Anda. Saat Anda mengembangkan proyek yang sudah ada, Amazon Q menggunakan semua file yang relevan di root ruang kerja Anda sebagai konteks untuk menghasilkan kode. Amazon Q memfilter file atau folder yang ditentukan dalam .gitignore file, dan hanya menggunakan jenis file yang didukung untuk menghasilkan kode. Untuk daftar jenis file yang didukung, lihat GitHub tautan berikut untuk IDE Anda:

• Jenis file yang didukung untuk JetBrains IDEs – https://github.com/aws/aws-toolkit-jetbrains/blob/main/plugins/core/jetbrains-community/src/software/aws/toolkits/jetbrains/services/telemetry/TelemetryUtils.kt

• Jenis file yang didukung untuk Visual Studio Code – https://github.com/aws/aws-toolkit-vscode/blob/master/packages/core/src/shared/filetypes.ts

Untuk memulai, buka proyek baru atau yang sudah ada dan masukkan /dev di panel obrolan Amazon Q. Tab obrolan baru terbuka di mana Anda berinteraksi dengan Amazon Q untuk menghasilkan kode baru untuk fitur Anda.

Topik

• Kembangkan fitur dengan /dev

• Praktik terbaik

• Contoh tugas

• Kuota

• Menguji saran kode yang dihasilkan oleh perintah Amazon Q '/dev'

• Memecahkan masalah dengan pengembangan fitur dengan Amazon Q Developer

Kembangkan fitur dengan /dev

Untuk mengerjakan tugas kode dengan Amazon Q di IDE Anda, selesaikan langkah-langkah berikut.

1. Di IDE Anda, buka proyek atau ruang kerja baru atau yang sudah ada tempat Anda ingin mengembangkan fitur.

2. Pilih ikon Amazon Q untuk membuka panel obrolan Amazon Q.

3. Masukkan /dev di panel obrolan Amazon Q diikuti dengan deskripsi tugas yang ingin Anda selesaikan atau masalah yang ingin Anda selesaikan. Anda dapat memberikan gambaran singkat tentang suatu tugas, atau menambahkan detail lebih lanjut. Amazon Q menggunakan deskripsi Anda dan kode dalam proyek Anda untuk menghasilkan kode.

   Berikut ini adalah contoh perubahan kode yang dapat Anda minta Amazon Q untuk diterapkan:

   /dev Create a new REST API endpoint /api/authenticate to handle user authentication. This endpoint should accept POST requests with user credentials and return a JWT token upon successful authentication. Additionally, update the user management system to integrate with the new authentication endpoint and enforce authentication for relevant API endpoints.

   Anda juga dapat memasukkan /dev hanya untuk melihat contoh tugas.

4. Tab baru terbuka. Jika Anda belum melakukannya, masukkan deskripsi tugas atau masalah Anda.

5. Amazon Q mulai menghasilkan kode untuk tugas yang telah Anda jelaskan. Selama pembuatan kode, Amazon Q memberikan ringkasan langkah-langkah yang diambil dan file yang digunakan atau diperbarui untuk menyarankan kode baru. Langkah ini bisa memakan waktu beberapa menit.

   Jika Anda ingin Amazon Q berhenti menghasilkan kode, pilih Berhenti. Pembuatan kode yang tidak lengkap akan dihitung terhadap kuota pembuatan kode untuk tugas ini. Setelah Anda menghentikan satu generasi, Anda memiliki opsi untuk memasukkan deskripsi tugas lain untuk terus mengerjakan tugas Anda.

   Secara opsional, Amazon Q dapat menguji saran kodenya di lingkungan dev terpisah sebelum menyajikannya kepada Anda di jendela obrolan. Untuk informasi selengkapnya, lihat Menguji saran '/dev'.

6. Setelah Amazon Q menghasilkan kode untuk tugas Anda, Amazon Q menyediakan daftar file dengan perubahan yang disarankan. Pilih file untuk melihat perbedaan file dengan perubahan.

7. Untuk memperbarui file Anda dengan semua perubahan kode yang disarankan, pilih Terima semua perubahan. Anda juga dapat menerima dan menolak perubahan pada file individual. Untuk menerima perubahan file individual, arahkan kursor Anda ke nama file dan pilih tanda centang hijau. Untuk menolak perubahan, pilih X merah. Anda juga dapat memilih Terima perubahan yang tersisa untuk menerapkan perubahan yang belum Anda terima.

   Setelah Anda menerima perubahan kode, Anda tidak dapat membatalkan itu. Jika Anda menolak perubahan kode, Anda dapat mengembalikannya dengan mengarahkan kursor ke nama file dan memilih panah. Anda kemudian memiliki opsi untuk menerima atau menolak perubahan kode lagi.

8. Jika Anda tidak puas dengan perubahan yang diusulkan, Anda dapat memberikan umpan balik tentang apa yang dapat ditingkatkan. Pilih Berikan umpan balik & buat ulang, lalu jelaskan perubahan yang Anda ingin Amazon Q lakukan.

   Amazon Q menghasilkan kode baru berdasarkan umpan balik Anda. Ketika kode yang dihasilkan memenuhi persyaratan Anda, pilih Terima semua perubahan atau terima file individual untuk memperbarui kode di proyek atau ruang kerja Anda.

9. Setelah memperbarui kode, Amazon Q meminta Anda untuk mulai mengerjakan tugas baru.

   Untuk mulai mengerjakan tugas lain di proyek atau ruang kerja Anda, pilih Ya, saya punya tugas lain. Percakapan Anda sebelumnya dan kode yang dihasilkan tidak digunakan sebagai konteks untuk tugas baru.

   Untuk mengakhiri sesi pengembangan fitur, pilih Tidak, terima kasih. Untuk terus mengobrol atau memulai alur kerja lain dengan Amazon Q, buka tab obrolan baru.

Praktik terbaik

Untuk memaksimalkan pengembangan fitur dengan Amazon Q, ikuti praktik terbaik berikut:

• Berikan penjelasan rinci tentang fitur baru atau perubahan kode yang ingin Anda buat, termasuk spesifikasi apa yang harus dicapai oleh kode. Ini memungkinkan Amazon Q untuk mengusulkan perubahan kode yang komprehensif dan dapat diterapkan. Sebagai contoh, lihat Contoh tugas.

• Fitur Anda seharusnya tidak memerlukan pembaruan ke lebih dari 5 file sekaligus. Meminta Amazon Q untuk membuat perubahan yang lebih besar dapat memengaruhi kualitas dan pengelolaan implementasi fitur Anda. Jika perbedaan file Anda menyertakan perubahan pada banyak file, coba kurangi cakupan deskripsi fitur Anda.

Contoh tugas

Berikut ini adalah contoh tugas pengembangan fitur yang dapat Anda minta Amazon Q untuk dilakukan, dengan deskripsi yang sesuai yang mungkin Anda berikan.

• Perbarui Gaya CSS untuk Tata Letak Responsif: Tingkatkan respons tata letak aplikasi dengan memperbarui gaya CSS. Fokus pada penyesuaian tata letak untuk ukuran layar yang berbeda, memastikan tampilan optimal di berbagai perangkat.

• Perbaiki Unggahan Gambar Profil Pengguna: Selesaikan masalah yang mencegah pengguna mengunggah gambar profil. Selidiki proses pengunggahan file, pastikan validasi jenis file yang tepat, dan atasi kesalahan sisi server yang mencegah unggahan berhasil.

• Kode Refactor untuk Keterbacaan Kode: Tingkatkan keterbacaan modul kode tertentu dengan memfaktorkannya kembali. Pecah fungsi kompleks menjadi unit yang lebih kecil dan lebih mudah dikelola, dan terapkan nama variabel dan fungsi yang bermakna untuk kejelasan yang lebih baik.

• Menerapkan Validasi Input untuk Formulir Kontak: Tambahkan validasi masukan sisi klien dan sisi server ke formulir kontak untuk mencegah pengiriman data kosong atau tidak valid. Menampilkan pesan kesalahan yang sesuai kepada pengguna untuk setiap kegagalan validasi.

• Selesaikan Tautan Rusak di Menu Navigasi: Selidiki dan perbaiki tautan yang rusak di menu navigasi aplikasi. Perbarui URLs atau rute untuk memastikan semua tautan navigasi mengarah ke halaman yang benar.

• Optimalkan Pemuatan Gambar untuk Pemuatan Halaman Lebih Cepat: Optimalkan pemuatan gambar pada halaman utama aplikasi untuk mengurangi waktu muat halaman. Terapkan teknik pemuatan lambat atau pemuatan asinkron untuk memprioritaskan tampilan konten yang terlihat.

• Tambahkan Pencatatan Kesalahan untuk Titik Akhir API Kritis: Tingkatkan penanganan kesalahan dengan menerapkan logging untuk titik akhir API kritis. Log detail kesalahan yang relevan seperti parameter permintaan dan jejak tumpukan untuk memfasilitasi debugging dan pemecahan masalah.

• Perbarui Dokumentasi untuk Titik Akhir API: Tinjau dan perbarui dokumentasi untuk titik akhir API yang ada untuk mencerminkan perubahan atau penambahan terbaru. Pastikan keakuratan dan kelengkapan informasi bagi pengembang yang menggunakan API.

• Refactor Database Query for Efficiency: Menganalisis dan mengoptimalkan kueri database untuk meningkatkan efisiensi dan mengurangi konsumsi sumber daya. Identifikasi dan hilangkan kueri yang berlebihan, optimalkan pengindeksan, dan pertimbangkan strategi caching jika berlaku.

Kuota

Pengembangan fitur dengan Amazon Q mempertahankan kuota berikut:

• Generasi kode per tugas — Berapa kali Anda dapat memberikan umpan balik untuk meregenerasi kode untuk tugas pengembangan tertentu, termasuk pembuatan kode awal. Kuota ini diatur ulang setiap kali Anda memulai tugas baru.

• Ukuran proyek kode - Ukuran maksimum file kode atau folder yang dapat digunakan Amazon Q sebagai konteks untuk menghasilkan kode baru.

Kuota

Sumber Daya	Kuota
Generasi kode per tugas	10
Ukuran proyek kode	200 MB tidak terkompresi 50 MB terkompresi