Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat masalah di CodeCatalyst
<a name="issues-create-issue"></a>

Tim pengembangan membuat 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 ke pengguna lain dalam proyek, menggunakan label untuk membantu Anda melacak pekerjaan Anda, dan banyak lagi.

Ikuti instruksi ini untuk membuat masalah di CodeCatalyst.

**Untuk membuat masalah**

1. Buka CodeCatalyst konsol di [ https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Arahkan ke proyek tempat Anda ingin membuat masalah.

1. Pada halaman beranda proyek, pilih ** Buat masalah**. Atau, di panel navigasi, pilih ** Masalah**.

1. Pilih ** Buat masalah**.
**catatan**  
Anda juga dapat menambahkan masalah sebaris saat menggunakan tampilan kisi.

1. Masukkan judul untuk masalah tersebut.

1. (Opsional) Masukkan ** Deskripsi**. Anda dapat menggunakan Markdown untuk menambahkan pemformatan.

1. (Opsional) Pilih ** Status**, ** Prioritas**, dan ** Estimasi ** untuk masalah tersebut. 
**catatan**  
Jika pengaturan estimasi proyek disetel ke ** Sembunyikan perkiraan**, tidak akan ada ** bidang ** Estimasi.

1. (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 menyusunnya kembali dengan memilih dan menyeret tugas dari sisi kiri kotak centang.

1. (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.

   1. Untuk membuat label baru dan menambahkannya, masukkan nama label yang ingin Anda buat di bidang pencarian dan tekan enter.

1. (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](getting-started-project-assistance.md). Fitur ini hanya tersedia di Wilayah AS Barat (Oregon).  
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang tersebut. Untuk informasi selengkapnya, lihat M [ engelola fitur ](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html) AI generatif. 

1. (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.

   1. Untuk membuat bidang kustom baru dan menambahkannya, masukkan nama bidang kustom yang ingin Anda buat di bidang pencarian dan tekan enter. Kemudian pilih jenis bidang kustom yang ingin Anda buat dan tetapkan nilai.

1. 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 C ** oba Ulang ** untuk mengedit dan mencoba lagi membuat masalah, atau pilih Bu ** ang ** untuk membuang masalah. Kedua opsi akan mengabaikan pemberitahuan.
**catatan**  
Anda tidak dapat menautkan permintaan tarik ke masalah saat Anda membuatnya. Namun, Anda dapat [ mengedit ](issues-edit-issue.md) nya setelah Anda membuatnya untuk menambahkan tautan ke permintaan tarik.

## Praktik terbaik saat membuat dan menangani masalah yang ditugaskan ke Amazon Q
<a name="issues-create-issue-assign-genai-best-practices"></a>

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

**catatan**  
**Didukung oleh Amazon Bedrock**: AWS menerapkan deteksi [ penyalahgunaan ](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) otomatis. Karena fitur **Tuliskan deskripsi untuk saya**, **Buat rangkuman konten**, **Rekomendasikan tugas**, **Gunakan Amazon Q untuk membuat atau menambahkan fitur ke proyek**, dan **Tugaskan masalah ke Amazon Q** dengan Amazon Q Developer Agent 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 untuk Amazon Q untuk dikerjakan.

**penting**  
Fitur AI generatif hanya tersedia di Wilayah AS Barat (Oregon).
+ **Tetap sederhana**. Amazon Q melakukan yang terbaik dengan perubahan dan perbaikan kode sederhana 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 tersebut. Jika memungkinkan, sertakan detail spesifik seperti nama API yang ingin diubah, metode yang ingin Anda perbarui, pengujian yang perlu diubah, 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 suatu masalah sebelum Anda menetapkannya ke Amazon Q.
+ **Hanya menetapkan masalah yang memerlukan perubahan kode dalam repositori sumber tunggal**. Amazon Q hanya dapat bekerja pada kode dalam repositori sumber tunggal 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 diambil. 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 memperbaiki 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 tinjau dengan cermat pendekatan yang disarankan oleh Amazon Q**. Setelah Anda menyetujui pendekatannya, Amazon Q akan mulai bekerja untuk 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 mencakup pembuatan atau pembaruan ALUR KERJA YAML 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.

Untuk informasi selengkapnya, lihat [Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda](getting-started-project-assistance.md) dan M [ engelola fitur ](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html) AI generatif.