Praktik terbaik untuk masalah yang ditetapkan ke Amazon Q

Membuat masalah di CodeCatalyst

Tim pengembangan menciptakan masalah untuk membantu melacak dan mengelola pekerjaan mereka. Anda dapat membuat masalah dalam proyek berdasarkan kebutuhan Anda. Misalnya, Anda dapat membuat masalah untuk melacak pembaruan variabel dalam kode Anda. Anda dapat menetapkan masalah kepada pengguna lain dalam proyek, menggunakan label untuk membantu Anda melacak pekerjaan Anda, dan banyak lagi.

Ikuti petunjuk ini untuk membuat masalah di CodeCatalyst.

Untuk membuat masalah

Buka CodeCatalyst konsol di https://codecatalyst.aws/.
Arahkan ke proyek tempat Anda ingin membuat masalah.
Pada halaman beranda proyek, pilih Buat masalah. Atau, di panel navigasi, pilih Masalah.
Pilih Buat masalah.

catatan
Anda juga dapat menambahkan masalah sebaris saat menggunakan tampilan kisi.
Masukkan judul untuk masalah ini.
(Opsional) Masukkan Deskripsi. Anda dapat menggunakan Markdown untuk menambahkan pemformatan.
(Opsional) Pilih Status, Prioritas, dan Estimasi untuk masalah ini.

catatan
Jika pengaturan estimasi proyek disetel ke Sembunyikan estimasi, tidak akan ada bidang Estimasi.
(Opsional) Tambahkan tugas ke masalah. Tugas dapat digunakan untuk memecah pekerjaan suatu masalah menjadi tujuan yang lebih kecil. Untuk menambahkan tugas, pilih + Tambahkan tugas. Kemudian, masukkan nama tugas di bidang teks dan tekan enter. Setelah menambahkan tugas, Anda dapat menandainya sebagai selesai dengan memilih kotak centang, atau menyusun ulang dengan memilih dan menyeret tugas dari sisi kiri kotak centang.
(Opsional) Tambahkan label yang ada atau buat label baru dan tambahkan dengan memilih + Tambahkan label.
1. Untuk menambahkan label yang ada, pilih label dari daftar. Anda dapat memasukkan istilah pencarian di bidang untuk mencari semua label yang berisi istilah itu dalam proyek.
2. Untuk membuat label baru dan menambahkannya, masukkan nama label yang ingin Anda buat di bidang pencarian dan tekan enter.
(Opsional) Tambahkan penerima tugas dengan memilih + Tambahkan penerima tugas. Anda dapat dengan cepat menambahkan diri Anda sebagai penerima tugas dengan memilih + Tambahkan saya.

Tip
Anda dapat memilih untuk menetapkan masalah ke Amazon Q agar Amazon Q mencoba menyelesaikan masalah tersebut. Untuk informasi selengkapnya, lihat Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda. Fitur ini hanya tersedia di Wilayah AS Barat (Oregon).
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang tersebut. Untuk informasi selengkapnya, lihat Mengelola fitur AI generatif.
(Opsional) Tambahkan bidang kustom yang ada atau buat bidang kustom baru. Masalah dapat memiliki beberapa bidang khusus.
1. Untuk menambahkan bidang kustom yang ada, pilih bidang kustom dari daftar. Anda dapat memasukkan istilah pencarian di bidang untuk mencari semua bidang kustom yang berisi istilah itu dalam proyek.
2. Untuk membuat bidang khusus baru dan menambahkannya, masukkan nama bidang khusus yang ingin Anda buat di bidang pencarian dan tekan enter. Kemudian pilih jenis bidang khusus yang ingin Anda buat dan tetapkan nilainya.
Pilih Buat masalah. Pemberitahuan muncul di sudut kanan bawah: Jika masalah berhasil dibuat, pesan konfirmasi muncul yang mengatakan masalah berhasil dibuat. Jika masalah tidak berhasil dibuat, pesan kesalahan dengan alasan kegagalan muncul. Anda kemudian dapat memilih Coba lagi untuk mengedit dan mencoba lagi membuat masalah, atau memilih Buang untuk membuang masalah. Kedua opsi akan mengabaikan notifikasi.

catatan
Anda tidak dapat menautkan permintaan tarik ke masalah saat Anda membuatnya. Namun, Anda dapat mengeditnya setelah Anda membuatnya untuk menambahkan tautan ke permintaan tarik.

Praktik terbaik saat membuat dan menangani masalah yang ditetapkan ke Amazon Q

Saat Anda membuat masalah, terkadang beberapa di antaranya berlama-lama. Penyebabnya bisa kompleks dan bervariasi. Terkadang itu karena tidak jelas siapa yang harus mengerjakannya. Di lain waktu masalah ini membutuhkan penelitian atau keahlian dengan bagian tertentu dari basis kode dan kandidat terbaik untuk pekerjaan sibuk dengan masalah lain. Seringkali ada pekerjaan mendesak lainnya yang harus dihadiri terlebih dahulu. Salah satu atau semua penyebab ini dapat mengakibatkan masalah yang tidak dikerjakan. CodeCatalyst Termasuk integrasi dengan asisten AI generatif yang disebut Amazon Q yang dapat menganalisis masalah berdasarkan judul dan deskripsinya. Jika Anda menetapkan masalah ke Amazon Q, itu akan mencoba membuat solusi draf untuk Anda evaluasi. Ini dapat membantu Anda dan tim Anda untuk fokus dan mengoptimalkan pekerjaan pada masalah yang memerlukan perhatian Anda, sementara Amazon Q bekerja pada solusi untuk masalah yang tidak memiliki sumber daya untuk segera ditangani.

catatan

Didukung oleh Amazon Bedrock: AWS mengimplementasikan deteksi penyalahgunaan otomatis. Karena fitur Tetapkan masalah ke Amazon Q dengan Agen Pengembang Amazon Q untuk pengembangan perangkat lunak dibangun di Amazon Bedrock, pengguna dapat memanfaatkan sepenuhnya kontrol yang diterapkan di Amazon Bedrock untuk menegakkan keselamatan, keamanan, dan penggunaan kecerdasan buatan (AI) yang bertanggung jawab.

Amazon Q berkinerja terbaik pada masalah sederhana dan masalah langsung. Untuk hasil terbaik, gunakan bahasa sederhana untuk menjelaskan dengan jelas apa yang ingin Anda lakukan. Berikut ini adalah beberapa praktik terbaik untuk membantu Anda membuat masalah yang dioptimalkan agar Amazon Q dapat dikerjakan.

penting

Fitur AI generatif hanya tersedia di Wilayah AS Barat (Oregon).

Tetap sederhana. Amazon Q melakukan yang terbaik dengan perubahan kode sederhana dan perbaikan yang dapat dijelaskan dalam judul dan deskripsi masalah. Jangan menetapkan masalah dengan judul yang tidak jelas atau deskripsi yang terlalu berbunga-bunga atau kontradiktif.
Jadilah spesifik. Semakin banyak informasi yang dapat Anda berikan tentang perubahan tepat yang diperlukan untuk menyelesaikan masalah, semakin besar kemungkinan Amazon Q akan dapat membuat solusi yang memecahkan masalah. Jika memungkinkan, sertakan detail spesifik seperti nama API yang ingin diubah, metode yang ingin diperbarui, pengujian yang memerlukan perubahan, dan detail lainnya yang dapat Anda pikirkan.
Pastikan Anda memiliki semua detail yang disertakan dalam judul dan deskripsi masalah sebelum menetapkannya ke Amazon Q. Anda tidak dapat mengubah judul atau deskripsi masalah setelah Anda menetapkannya ke Amazon Q, jadi pastikan Anda memiliki semua informasi yang diperlukan dalam masalah sebelum Anda menetapkannya ke Amazon Q.
Hanya tetapkan masalah yang memerlukan perubahan kode dalam satu repositori sumber. Amazon Q hanya dapat bekerja pada kode dalam satu repositori sumber di. CodeCatalyst Repositori tertaut tidak didukung. Pastikan bahwa masalah hanya memerlukan perubahan dalam satu repositori sumber sebelum Anda menetapkan masalah itu ke Amazon Q.
Gunakan default yang disarankan oleh Amazon Q untuk menyetujui setiap langkah. Secara default, Amazon Q akan memerlukan persetujuan Anda untuk setiap langkah yang diperlukan. Ini memungkinkan Anda untuk berinteraksi dengan Amazon Q dalam komentar tidak hanya tentang masalah ini, tetapi juga pada permintaan tarik apa pun yang dibuatnya. Ini memberikan pengalaman yang lebih interaktif dengan Amazon Q yang membantu Anda menyesuaikan pendekatannya dan menyempurnakan kode yang dibuatnya untuk menyelesaikan masalah.

catatan
Amazon Q tidak menanggapi komentar individu dalam masalah atau permintaan tarik, tetapi akan meninjaunya ketika diminta untuk mempertimbangkan kembali pendekatannya atau membuat revisi.
Selalu hati-hati meninjau pendekatan yang disarankan oleh Amazon Q. Setelah Anda menyetujui pendekatannya, Amazon Q akan mulai bekerja menghasilkan kode berdasarkan pendekatan itu. Pastikan pendekatannya tampak benar dan mencakup semua detail yang Anda harapkan sebelum Anda memberi tahu Amazon Q untuk melanjutkan.
Pastikan untuk hanya mengizinkan Amazon Q bekerja pada alur kerja jika Anda tidak memiliki alur kerja yang ada yang mungkin menerapkannya sebelum ditinjau. Proyek Anda mungkin memiliki alur kerja yang dikonfigurasi untuk mulai berjalan pada peristiwa permintaan tarik. Jika demikian, permintaan tarik apa pun yang dibuat Amazon Q yang menyertakan pembuatan atau pembaruan alur kerja YAMAL dapat memulai menjalankan alur kerja yang disertakan dalam permintaan tarik. Sebagai praktik terbaik, jangan memilih untuk mengizinkan Amazon Q bekerja pada file alur kerja kecuali Anda yakin tidak ada alur kerja dalam proyek Anda yang akan secara otomatis menjalankan alur kerja ini sebelum Anda meninjau dan menyetujui permintaan tarik yang dibuatnya.