Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda - Amazon CodeCatalyst
PrasyaratMenggunakan Amazon Q untuk memilih cetak biru saat membuat proyek atau menambahkan fungsionalitasTambahkan ringkasan yang dibuat secara otomatis saat membuat permintaan tarikBuat ringkasan komentar yang tersisa pada perubahan kode dalam permintaan tarikBuat masalah dan tetapkan ke Amazon QBuat masalah dan minta tugas yang direkomendasikan untuk itu oleh Amazon QPembersihan sumber daya

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

Tutorial: Menggunakan fitur AI CodeCatalyst generatif untuk mempercepat pekerjaan pengembangan Anda

Jika Anda memiliki proyek dan repositori sumber CodeCatalyst di Amazon di ruang di mana fitur AI generatif diaktifkan, Anda dapat menggunakan fitur ini untuk membantu mempercepat pengembangan perangkat lunak. Pengembang sering memiliki lebih banyak tugas yang harus dilakukan daripada waktu untuk menyelesaikannya. Mereka sering tidak meluangkan waktu untuk menjelaskan perubahan kode mereka kepada rekan tim mereka saat membuat permintaan tarik untuk meninjau perubahan tersebut, mengharapkan pengguna lain menemukan perubahan yang cukup jelas. Pembuat dan pengulas permintaan tarik juga tidak punya waktu untuk menemukan dan membaca semua komentar pada permintaan tarik secara menyeluruh, terutama jika permintaan tarik memiliki beberapa revisi. CodeCatalyst terintegrasi dengan Agen Pengembang Amazon Q untuk pengembangan perangkat lunak guna menyediakan fitur AI generatif yang dapat membantu anggota tim menyelesaikan tugas mereka dengan lebih cepat, dan meningkatkan waktu yang mereka miliki untuk fokus pada bagian terpenting dari pekerjaan mereka.

Amazon Q Developer adalah asisten percakapan bertenaga AI generatif yang dapat membantu Anda memahami, membangun, memperluas, dan mengoperasikan aplikasi. AWS Untuk mempercepat pembangunan Anda AWS, model yang mendukung Amazon Q ditambah dengan AWS konten berkualitas tinggi untuk menghasilkan jawaban yang lebih lengkap, dapat ditindaklanjuti, dan direferensikan. Untuk informasi selengkapnya, lihat Apa itu Pengembang Amazon Q? di Panduan Pengguna Pengembang Amazon Q.

catatan

Didukung oleh Amazon Bedrock: AWS mengimplementasikan deteksi penyalahgunaan otomatis. Karena deskripsi Tulis untuk saya, Buat ringkasan konten, Rekomendasikan tugas, Gunakan Amazon Q untuk membuat atau menambahkan fitur ke proyek, dan Menetapkan masalah ke fitur Amazon Q dengan Agen Pengembang Amazon Q untuk fitur 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.

Dalam tutorial ini, Anda akan belajar cara menggunakan fitur AI generatif CodeCatalyst untuk membantu Anda membuat proyek dengan cetak biru, serta menambahkan cetak biru ke proyek yang ada. Selain itu, Anda akan belajar cara meringkas perubahan antar cabang saat membuat permintaan tarik dan meringkas komentar yang tersisa pada permintaan tarik. Anda juga akan belajar cara membuat masalah dengan ide Anda untuk perubahan atau peningkatan kode dan menetapkannya ke Amazon Q. Sebagai bagian dari menangani masalah yang ditetapkan ke Amazon Q, Anda akan belajar cara mengizinkan Amazon Q menyarankan tugas dan cara menetapkan dan mengerjakan tugas apa pun yang dibuatnya sebagai bagian dari mengerjakan suatu masalah.

Prasyarat

Untuk bekerja dengan CodeCatalyst fitur-fitur dalam tutorial ini, Anda harus terlebih dahulu menyelesaikan dan memiliki akses ke sumber daya berikut:

  • Anda memiliki ID AWS Pembangun atau identitas sign-on (SSO) tunggal untuk masuk. CodeCatalyst

  • Anda berada di ruang yang memiliki fitur AI generatif diaktifkan. Untuk informasi selengkapnya, lihat Mengelola fitur AI generatif.

  • Anda memiliki peran administrator Kontributor atau Proyek dalam proyek di ruang tersebut.

  • Kecuali Anda membuat proyek dengan AI generatif, proyek Anda yang ada memiliki setidaknya satu repositori sumber yang dikonfigurasi untuknya. Repositori tertaut tidak didukung.

  • Saat menetapkan masalah untuk memiliki solusi awal yang dibuat oleh AI generatif, proyek tidak dapat dikonfigurasi dengan ekstensi Perangkat Lunak Jira. Ekstensi tidak didukung untuk fitur ini.

Untuk informasi lebih lanjut, lihat Menciptakan ruang, Lacak dan atur pekerjaan dengan masalah di CodeCatalyst, Tambahkan fungsionalitas ke proyek dengan ekstensi di CodeCatalyst, dan Memberikan akses dengan peran pengguna .

Tutorial ini didasarkan pada proyek yang dibuat menggunakan cetak biru aplikasi web tiga tingkat Modern dengan Python. Jika Anda menggunakan proyek yang dibuat dengan cetak biru yang berbeda, Anda masih dapat mengikuti langkah-langkahnya, tetapi beberapa spesifik akan bervariasi, seperti kode sampel dan bahasa.

Menggunakan Amazon Q untuk memilih cetak biru saat membuat proyek atau menambahkan fungsionalitas

Sebagai pengembang proyek, Anda dapat berkolaborasi dengan Amazon Q, asisten AI generatif, saat membuat proyek baru atau menambahkan komponen ke proyek yang ada. Anda dapat menyediakan Amazon Q dengan persyaratan untuk proyek Anda dengan berinteraksi dengannya dalam antarmuka seperti obrolan. Berdasarkan kebutuhan Anda, Amazon Q menyarankan cetak biru dan juga menguraikan persyaratan yang tidak dapat dipenuhi. Jika ruang Anda memiliki cetak biru khusus, Amazon Q mempelajari dan menyertakan cetak biru tersebut dalam rekomendasi juga. Anda kemudian dapat melanjutkan dengan saran Amazon Q jika Anda puas, dan itu akan membuat sumber daya yang diperlukan seperti repositori sumber dengan kode untuk kebutuhan Anda. Amazon Q juga menciptakan masalah untuk persyaratan yang tidak dapat dipenuhi dengan cetak biru. Untuk mempelajari selengkapnya tentang CodeCatalyst cetak biru yang tersedia, lihat. Membuat proyek yang komprehensif dengan CodeCatalyst cetak biru Untuk mempelajari selengkapnya tentang menggunakan Amazon Q dengan cetak biru, lihat. Praktik terbaik saat menggunakan Amazon Q untuk membuat proyek atau menambahkan fungsionalitas dengan cetak biru

Untuk membuat proyek dengan Amazon Q

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Di CodeCatalyst konsol, arahkan ke ruang tempat Anda ingin membuat cetak biru.

  3. Di dasbor ruang, pilih Buat dengan Amazon Q.

  4. Di bidang input teks prompt Amazon Q, berikan instruksi dengan menulis deskripsi singkat tentang proyek yang ingin Anda bangun. Misalnya, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Opsional) Di bawah contoh Coba, Anda dapat menggunakan prompt yang telah ditulis sebelumnya dengan memilih cetak biru. Misalnya, jika Anda memilih aplikasi React, prompt berikut disediakan: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Pilih Kirim untuk mengirimkan instruksi Anda ke Amazon Q. Asisten AI generatif memberikan saran dan menguraikan persyaratan yang tidak dapat dipenuhi oleh cetak biru. Misalnya, Amazon Q mungkin menyarankan hal berikut berdasarkan kriteria Anda:

    I recommend using the Modern three-tier web application blueprint based on 
                    your requirements. Blueprints are dynamic and can always be updated and edited later.

Modern three-tier web application
By Amazon Web Services

This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
and serverless code functions.

Version: 0.1.163

View details

The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.

  6. (Opsional) Untuk melihat detail mendalam dari cetak biru yang disarankan, pilih Lihat detail.

  7. Lakukan salah satu hal berikut ini:

    1. Pilih Ya, gunakan cetak biru ini jika Anda puas dengan sarannya.

    2. Pilih Edit prompt jika Anda ingin mengubah prompt.

    3. Pilih Mulai dari awal jika Anda ingin menghapus prompt sepenuhnya.

  8. Lakukan salah satu hal berikut ini:

    1. Pilih Konfigurasi jika Anda ingin mengonfigurasi cetak biru yang disarankan. Anda juga dapat mengonfigurasi cetak biru di lain waktu.

    2. Pilih Lewati jika Anda tidak ingin mengubah konfigurasi cetak biru saat ini.

  9. Jika Anda memilih untuk mengonfigurasi cetak biru, pilih Lanjutkan setelah memodifikasi sumber daya proyek.

  10. Saat diminta, masukkan nama yang ingin Anda tetapkan ke proyek Anda dan nama sumber daya yang terkait. Nama harus unik di dalam ruang Anda.

  11. Pilih Buat proyek untuk membuat proyek dengan cetak biru. Amazon Q membuat sumber daya menggunakan cetak biru. Misalnya, jika Anda membuat proyek dengan cetak biru aplikasi Single-page, repositori sumber untuk kode dan alur kerja yang relevan untuk CI/CD akan dibuat.

  12. (Opsional) Secara default, Amazon Q juga membuat masalah untuk persyaratan yang tidak dipenuhi oleh cetak biru. Anda dapat memilih item mana yang tidak ingin Anda buat masalah. Setelah Anda memilih untuk membiarkan Amazon Q membuat masalah, Anda kemudian dapat menetapkan masalah ke Amazon Q juga. Ini akan menganalisis masalah dalam konteks repositori sumber yang diberikan, memberikan ringkasan file sumber dan kode yang relevan. Lihat informasi selengkapnya di Menemukan dan melihat masalah, Buat masalah dan tetapkan ke Amazon Q, dan Praktik terbaik saat membuat dan menangani masalah yang ditetapkan ke Amazon Q.

Setelah membuat proyek dengan Amazon Q, Anda juga dapat menggunakan Amazon Q untuk menambahkan komponen baru karena menyarankan CodeCatalyst cetak biru berdasarkan kebutuhan Anda.

Untuk menambahkan cetak biru dengan Amazon Q

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Di CodeCatalyst konsol, arahkan ke proyek tempat Anda ingin menambahkan cetak biru.

  3. Pilih Tambahkan dengan Amazon Q.

  4. Di bidang input teks prompt Amazon Q, berikan instruksi dengan menulis deskripsi singkat tentang proyek yang ingin Anda bangun. Misalnya, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Opsional) Di bawah contoh Coba, Anda dapat menggunakan prompt yang telah ditulis sebelumnya dengan memilih cetak biru. Misalnya, jika Anda memilih aplikasi React, prompt berikut disediakan: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Pilih Kirim untuk mengirimkan instruksi Anda ke Amazon Q. Asisten AI generatif memberikan saran dan menguraikan persyaratan yang tidak dapat dipenuhi oleh cetak biru. Misalnya, Amazon Q mungkin menyarankan hal berikut berdasarkan kriteria Anda:

    I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.

Single-page application
By Amazon Web Services

This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.

Version: 0.2.15
View details

The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO

  6. (Opsional) Untuk melihat detail mendalam dari cetak biru yang disarankan, pilih Lihat detail.

  7. Lakukan salah satu hal berikut ini:

    1. Pilih Ya, gunakan cetak biru ini jika Anda puas dengan sarannya.

    2. Pilih Edit prompt jika Anda ingin mengubah prompt.

    3. Pilih Mulai dari awal jika Anda ingin menghapus prompt sepenuhnya.

  8. Lakukan salah satu hal berikut ini:

    1. Pilih Konfigurasi jika Anda ingin mengonfigurasi cetak biru yang disarankan. Anda juga dapat mengonfigurasi cetak biru di lain waktu.

    2. Pilih Lewati jika Anda tidak ingin mengubah konfigurasi cetak biru saat ini.

  9. Jika Anda memilih untuk mengonfigurasi cetak biru, pilih Lanjutkan setelah memodifikasi sumber daya proyek.

  10. Pilih Tambahkan ke proyek untuk menambahkan sumber daya ke proyek dengan cetak biru. Amazon Q membuat sumber daya menggunakan cetak biru. Misalnya, jika Anda menambahkan proyek dengan cetak biru aplikasi Single-page, repositori sumber untuk kode dan alur kerja yang relevan untuk CI/CD akan dibuat.

  11. (Opsional) Secara default, Amazon Q juga membuat masalah untuk persyaratan yang tidak dipenuhi oleh cetak biru. Anda dapat memilih item mana yang tidak ingin Anda buat masalah. Setelah Anda memilih untuk membiarkan Amazon Q membuat masalah, Anda kemudian dapat menetapkan masalah ke Amazon Q juga. Ini akan menganalisis masalah dalam konteks repositori sumber yang diberikan, memberikan ringkasan file sumber dan kode yang relevan. Untuk informasi selengkapnya, lihat Buat masalah dan tetapkan ke Amazon Q dan Praktik terbaik saat membuat dan menangani masalah yang ditetapkan ke Amazon Q.

Buat ringkasan perubahan kode antar cabang saat membuat permintaan tarik

Permintaan tarik adalah cara utama Anda dan anggota proyek lainnya dapat meninjau, mengomentari, dan menggabungkan perubahan kode dari satu cabang ke cabang lainnya. Anda dapat menggunakan permintaan tarik untuk meninjau perubahan kode secara kolaboratif untuk perubahan kecil atau perbaikan, penambahan fitur utama, atau versi baru dari perangkat lunak yang dirilis. Meringkas perubahan kode dan maksud di balik perubahan sebagai bagian dari deskripsi permintaan tarik sangat membantu orang lain yang akan meninjau kode, dan juga membantu dengan pemahaman historis tentang perubahan kode dari waktu ke waktu. Namun, pengembang sering mengandalkan kode mereka untuk menjelaskan dirinya sendiri atau memberikan detail yang ambigu daripada menggambarkan perubahan mereka dengan detail yang cukup bagi pengulas untuk memahami apa yang mereka ulas atau apa maksud di balik perubahan dalam kode.

Anda dapat menggunakan fitur Tulis deskripsi untuk saya saat membuat permintaan tarik agar Amazon Q membuat deskripsi perubahan yang terkandung dalam permintaan tarik. Saat Anda memilih opsi ini, Amazon Q menganalisis perbedaan antara cabang sumber yang berisi perubahan kode dan cabang tujuan tempat Anda ingin menggabungkan perubahan ini. Ini kemudian menciptakan ringkasan tentang apa perubahan itu, serta interpretasi terbaiknya tentang maksud dan efek dari perubahan tersebut.

catatan

Fitur ini tidak bekerja dengan submodul Git. Ini tidak akan meringkas perubahan apa pun dalam submodul Git yang merupakan bagian dari permintaan tarik.

Fitur ini tidak tersedia untuk permintaan tarik di repositori tertaut.

Anda dapat mencoba fitur ini dengan permintaan tarik apa pun yang Anda buat, tetapi dalam tutorial ini, kami akan mengujinya dengan membuat beberapa perubahan sederhana pada kode yang terkandung dalam proyek yang dibuat dalam cetak biru aplikasi web tiga tingkat Modern berbasis Python.

Tip

Jika Anda menggunakan proyek yang dibuat dengan cetak biru yang berbeda atau kode Anda sendiri, Anda masih dapat mengikuti tutorial ini, tetapi contoh dalam tutorial ini tidak akan cocok dengan kode dalam proyek Anda. Alih-alih contoh yang disarankan di bawah ini, buat perubahan sederhana pada kode proyek Anda di cabang, lalu buat permintaan tarik untuk menguji fitur seperti yang ditunjukkan pada langkah-langkah berikut.

Pertama, Anda akan membuat cabang di repositori sumber. Anda kemudian akan membuat perubahan kode cepat ke file di cabang itu menggunakan editor teks di konsol. Anda kemudian akan membuat permintaan tarik, dan menggunakan fitur Write description for me untuk meringkas perubahan yang Anda buat.

Untuk membuat cabang (konsol)

  1. Di CodeCatalyst konsol, arahkan ke proyek tempat repositori sumber Anda berada.

  2. Pilih nama repositori dari daftar repositori sumber untuk proyek. Atau, di panel navigasi, pilih Kode, lalu pilih Repositori sumber.

  3. Pilih repositori tempat Anda ingin membuat cabang.

  4. Pada halaman ikhtisar repositori, pilih Lainnya, lalu pilih Buat cabang.

  5. Masukkan nama untuk cabang.

  6. Pilih cabang untuk membuat cabang, lalu pilih Buat.

Setelah Anda memiliki cabang, edit file di cabang itu dengan perubahan sederhana. Dalam contoh ini, Anda akan mengedit test_endpoint.py file untuk mengubah jumlah percobaan ulang untuk pengujian dari 3 5.

Tip

Anda juga dapat memilih untuk membuat atau menggunakan Dev Environment untuk membuat perubahan kode ini. Untuk informasi selengkapnya, lihat Membuat Lingkungan Dev.

Untuk mengedit test_endpoint.py file di konsol

  1. Pada halaman ikhtisar untuk repositori mysfits sumber, pilih drop-down cabang dan pilih cabang yang Anda buat dalam prosedur sebelumnya.

  2. Di File, navigasikan ke file yang ingin Anda edit. Misalnya, untuk mengedit test_endpoint.py file, memperluas tes, memperluas integ, dan kemudian memilihtest_endpoint.py.

  3. Pilih Edit.

  4. Pada baris 7, ubah berapa kali semua tes akan dicoba ulang dari:

    def test_list_all(retry=3):

    ke:

    def test_list_all(retry=5):

  5. Pilih Komit dan komit perubahan Anda ke cabang Anda.

Sekarang Anda memiliki cabang dengan perubahan, Anda dapat membuat permintaan tarik.

Buat permintaan tarik dengan ringkasan perubahan

  1. Pada halaman ikhtisar repositori, pilih Lainnya, lalu pilih Buat permintaan tarik.

  2. Di cabang Tujuan, pilih cabang untuk menggabungkan kode setelah ditinjau.

    Tip

    Pilih cabang tempat Anda membuat cabang Anda dari prosedur sebelumnya untuk demonstrasi paling sederhana dari fitur ini. Misalnya, jika Anda membuat cabang dari cabang default repositori, pilih cabang itu sebagai cabang tujuan untuk permintaan tarik Anda.

  3. Di cabang Sumber, pilih cabang yang berisi perubahan yang baru saja Anda komit ke test_endpoint.py file.

  4. Dalam judul permintaan tarik, masukkan judul yang membantu pengguna lain memahami apa yang perlu ditinjau dan alasannya.

  5. Dalam deskripsi permintaan tarik, pilih Tulis deskripsi agar saya meminta Amazon Q membuat deskripsi perubahan yang terkandung dalam permintaan tarik.

  6. Ringkasan perubahan muncul. Tinjau teks yang disarankan lalu pilih Terima dan tambahkan ke deskripsi.

  7. Secara opsional, ubah ringkasan untuk lebih mencerminkan perubahan yang Anda buat pada kode. Anda juga dapat memilih untuk menambahkan pengulas atau masalah tautan ke permintaan tarik ini. Setelah selesai membuat perubahan tambahan yang Anda inginkan, pilih Buat.

Buat ringkasan komentar yang tersisa pada perubahan kode dalam permintaan tarik

Saat pengguna meninjau permintaan tarik, mereka sering meninggalkan beberapa komentar tentang perubahan permintaan tarik itu. Jika ada banyak komentar dari banyak pengulas, mungkin sulit untuk memilih tema umum dalam umpan balik, atau bahkan pastikan bahwa Anda telah meninjau semua komentar di semua revisi. Anda dapat menggunakan fitur Buat ringkasan komentar agar Amazon Q menganalisis semua komentar yang tersisa pada perubahan kode dalam permintaan tarik dan membuat ringkasan komentar tersebut.

catatan

Ringkasan komentar bersifat sementara. Jika Anda menyegarkan permintaan tarik, ringkasan akan hilang. Ringkasan konten tidak menyertakan komentar pada permintaan tarik keseluruhan, cukup komentar yang tersisa tentang perbedaan kode dalam revisi permintaan tarik.

Fitur ini tidak berfungsi dengan komentar apa pun yang tersisa pada perubahan kode di submodul Git.

Fitur ini tidak tersedia untuk permintaan tarik di repositori tertaut.

Untuk membuat ringkasan komentar dalam permintaan tarik

  1. Arahkan ke permintaan tarik yang Anda buat di prosedur sebelumnya.

    Tip

    Jika mau, Anda dapat menggunakan permintaan tarik terbuka apa pun di proyek Anda. Di bilah navigasi, pilih Kode, pilih Permintaan tarik, dan pilih permintaan tarik terbuka.

  2. Tambahkan beberapa komentar ke permintaan tarik di Perubahan jika permintaan tarik belum memiliki komentar.

  3. Di Ikhtisar, pilih Buat ringkasan komentar. Setelah selesai, bagian Ringkasan komentar akan diperluas.

  4. Tinjau ringkasan komentar yang tersisa pada perubahan kode dalam revisi permintaan tarik, dan bandingkan dengan komentar dalam permintaan tarik.

Buat masalah dan tetapkan ke Amazon Q

Tim pengembangan membuat masalah untuk melacak dan mengelola pekerjaan mereka, tetapi terkadang masalah tetap ada karena tidak jelas siapa yang harus mengerjakannya, atau masalah tersebut memerlukan penelitian ke bagian tertentu dari basis kode, atau pekerjaan mendesak lainnya harus dihadiri terlebih dahulu. CodeCatalyst termasuk integrasi dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak. Anda dapat menetapkan masalah ke 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 Anda pada masalah yang memerlukan perhatian Anda, sementara Amazon Q bekerja pada solusi untuk masalah yang tidak memiliki sumber daya untuk segera ditangani.

Tip

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.

Ketika Anda menetapkan masalah ke Amazon Q, CodeCatalyst akan menandai masalah sebagai diblokir sampai Anda mengonfirmasi bagaimana Anda ingin Amazon Q bekerja pada masalah tersebut. Ini mengharuskan Anda untuk menjawab tiga pertanyaan sebelum dapat melanjutkan:

  • Apakah Anda ingin mengonfirmasi setiap langkah yang diperlukan atau apakah Anda ingin melanjutkan tanpa umpan balik. Jika Anda memilih untuk mengonfirmasi setiap langkah, Anda dapat membalas Amazon Q dengan umpan balik tentang pendekatan yang dibuatnya sehingga dapat mengulangi pendekatannya jika diperlukan. Amazon Q juga dapat meninjau umpan balik yang ditinggalkan pengguna pada permintaan tarik apa pun yang dibuatnya jika Anda memilih opsi ini. Jika Anda memilih untuk tidak mengonfirmasi setiap langkah, Amazon Q mungkin menyelesaikan pekerjaannya lebih cepat, tetapi Amazon Q tidak akan meninjau umpan balik apa pun yang Anda berikan dalam masalah atau permintaan tarik apa pun yang dibuatnya.

  • Apakah Anda ingin mengizinkannya memperbarui file alur kerja sebagai bagian dari pekerjaannya. 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 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.

  • Apakah Anda ingin mengizinkannya menyarankan membuat tugas untuk memecah pekerjaan dalam masalah menjadi peningkatan yang lebih kecil yang dapat ditetapkan secara individual kepada pengguna, termasuk Amazon Q itu sendiri. Mengizinkan Amazon Q untuk menyarankan dan membuat tugas dapat membantu mempercepat pengembangan pada masalah kompleks dengan memungkinkan banyak orang untuk mengerjakan bagian-bagian terpisah dari masalah tersebut. Ini juga dapat membantu mengurangi kompleksitas pemahaman keseluruhan pekerjaan karena pekerjaan yang diperlukan untuk menyelesaikan setiap tugas idealnya lebih sederhana daripada masalah yang dimilikinya.

  • Repositori sumber apa yang Anda inginkan untuk berfungsi. Bahkan jika proyek Anda memiliki beberapa repositori sumber, Amazon Q hanya dapat bekerja pada kode dalam satu repositori sumber. Repositori tertaut tidak didukung.

Setelah Anda membuat dan mengonfirmasi pilihan Anda, Amazon Q akan memindahkan masalah ke status Sedang berlangsung saat mencoba menentukan permintaan berdasarkan judul masalah dan deskripsinya, serta kode di repositori yang ditentukan. Ini akan membuat komentar yang disematkan di mana ia akan memberikan pembaruan tentang status pekerjaannya. Setelah meninjau data, Amazon Q akan merumuskan pendekatan potensial untuk solusi. Amazon Q mencatat tindakannya dengan memperbarui komentar yang disematkan dan mengomentari kemajuannya pada masalah ini di setiap tahap. Tidak seperti komentar dan balasan yang disematkan, itu tidak menyimpan catatan kronologis pekerjaannya secara ketat. Sebaliknya, ini menempatkan informasi yang paling relevan tentang pekerjaannya di tingkat atas komentar yang disematkan. Ini akan mencoba membuat kode berdasarkan pendekatannya dan analisisnya terhadap kode yang sudah ada di repositori. Jika berhasil menghasilkan solusi potensial, itu akan membuat cabang dan kode komit ke cabang itu. Kemudian membuat permintaan tarik yang akan menggabungkan cabang itu dengan cabang default. Ketika Amazon Q menyelesaikan pekerjaannya, ia memindahkan masalah ke Dalam tinjauan sehingga Anda dan tim Anda tahu ada kode yang siap untuk Anda evaluasi.

catatan

Fitur ini hanya tersedia melalui Masalah di Wilayah Barat AS (Oregon). Ini tidak tersedia jika Anda telah mengonfigurasi proyek Anda untuk menggunakan Jira dengan ekstensi Perangkat Lunak Jira. Selain itu, jika Anda telah menyesuaikan tata letak papan Anda, masalah mungkin tidak mengubah status. Untuk hasil terbaik, hanya gunakan fitur ini dengan proyek yang memiliki tata letak papan standar.

Fitur ini tidak bekerja dengan submodul Git. Itu tidak dapat membuat perubahan pada submodul Git apa pun yang termasuk dalam repositori.

Setelah Anda menetapkan masalah ke Amazon Q, Anda tidak dapat mengubah judul atau deskripsi masalah atau menetapkannya kepada orang lain. Jika Anda membatalkan penetapan Amazon Q dari masalah, itu akan menyelesaikan langkahnya saat ini dan kemudian berhenti bekerja. Itu tidak dapat melanjutkan pekerjaan atau dipindahkan ke masalah setelah tidak ditetapkan.

Masalah dapat secara otomatis dipindahkan ke kolom Dalam tinjauan jika ditetapkan ke Amazon Q jika pengguna memilih untuk mengizinkannya membuat tugas. Namun, masalah di Dalam tinjauan mungkin masih memiliki tugas yang berada dalam keadaan berbeda, seperti dalam status Sedang berlangsung.

Di bagian tutorial ini, Anda akan membuat tiga masalah berdasarkan fitur potensial untuk kode yang disertakan dalam proyek yang dibuat dengan cetak biru aplikasi web tiga tingkat Modern: satu untuk menambahkan untuk membuat makhluk mysfit baru, satu untuk menambahkan fitur pengurutan, dan satu untuk memperbarui alur kerja untuk menyertakan cabang bernama. test

catatan

Jika Anda bekerja dalam proyek dengan kode yang berbeda, buat masalah dengan judul dan deskripsi yang berhubungan dengan basis kode tersebut.

Untuk membuat masalah dan memiliki solusi yang dihasilkan untuk Anda evaluasi

  1. Di panel navigasi, pilih Masalah dan pastikan Anda berada di tampilan Papan.

  2. Pilih Buat masalah.

  3. Berikan judul yang menjelaskan apa yang ingin Anda lakukan dalam bahasa sederhana. Misalnya, untuk masalah ini, masukkan judulCreate another mysfit named Quokkapus. Dalam Deskripsi, berikan detail berikut:

    Expand the table of mysfits to 13, and give the new mysfit the following characteristics:

Name: Quokkapus

Species: Quokka-Octopus hybrid

Good/Evil: Good

Lawful/Chaotic: Chaotic

Age: 216

Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
her to grow, and keep that coffee coming.

  4. (Opsional) Lampirkan gambar untuk digunakan sebagai thumbnail dan gambar profil untuk mysfit ke masalah tersebut. Jika Anda melakukan ini, perbarui deskripsi untuk menyertakan detail gambar apa yang ingin Anda gunakan dan mengapa. Misalnya, Anda dapat menambahkan yang berikut ke deskripsi: “Mysfit membutuhkan file gambar untuk disebarkan ke situs web. Tambahkan gambar-gambar ini yang dilampirkan pada masalah ini ke repositori sumber sebagai bagian dari pekerjaan, dan menyebarkan gambar ke situs web.

    catatan

    Gambar terlampir mungkin atau mungkin tidak disebarkan ke situs web selama interaksi dalam tutorial ini. Anda dapat menambahkan gambar ke situs web sendiri, dan kemudian meninggalkan komentar untuk Amazon Q untuk memperbarui kodenya untuk menunjuk ke gambar yang ingin Anda gunakan setelah membuat permintaan tarik.

    Tinjau deskripsi dan pastikan berisi semua detail yang mungkin diperlukan sebelum Anda melanjutkan ke langkah berikutnya.

  5. Di Penerima Tugas, pilih Tetapkan ke Amazon Q.

  6. Di repositori Sumber, pilih repositori sumber yang berisi kode proyek.

  7. Geser Require Amazon Q untuk berhenti setelah setiap langkah dan tunggu peninjauan pemilih kerjanya ke status aktif jika perlu.

    catatan

    Memilih opsi untuk menghentikan Amazon Q setelah setiap langkah memungkinkan Anda mengomentari masalah atau tugas apa pun yang dibuat untuk memiliki opsi agar Amazon Q mengubah pendekatannya hingga tiga kali berdasarkan komentar Anda. Jika Anda memilih opsi untuk tidak menghentikan Amazon Q setelah setiap langkah sehingga Anda dapat meninjau pekerjaannya, pekerjaan mungkin berjalan lebih cepat karena Amazon Q tidak menunggu umpan balik Anda, tetapi Anda tidak akan dapat memengaruhi arah Amazon Q mengambil dengan meninggalkan komentar. Amazon Q juga tidak akan menanggapi komentar yang tersisa dalam permintaan tarik jika Anda memilih opsi itu.

  8. Biarkan Izinkan Amazon Q untuk memodifikasi pemilih file alur kerja dalam keadaan tidak aktif.

  9. Geser Izinkan Amazon Q untuk menyarankan membuat pemilih tugas ke status aktif.

  10. Pilih Buat masalah. Tampilan Anda berubah ke papan Masalah.

  11. Pilih Buat masalah untuk membuat masalah lain, kali ini dengan judulChange the get_all_mysfits() API to return mysfits sorted by the Age attribute. Tetapkan masalah ini ke Amazon Q dan buat masalah.

  12. Pilih Buat masalah untuk membuat masalah lain, kali ini dengan judulUpdate the OnPullRequest workflow to include a branch named test in its triggers. Secara opsional link ke alur kerja dalam deskripsi. Tetapkan masalah ini ke Amazon Q tetapi kali ini pastikan bahwa pemilih Izinkan Amazon Q memodifikasi file alur kerja disetel ke status aktif. Buat masalah untuk kembali ke papan Masalah.

    Tip

    Anda dapat mencari file, termasuk file alur kerja, dengan memasukkan simbol at (@) dan memasukkan nama file.

Setelah Anda membuat dan menetapkan masalah, masalah akan pindah ke Sedang berlangsung. Amazon Q akan menambahkan komentar yang melacak kemajuannya di dalam masalah dalam komentar yang disematkan. Jika mampu mendefinisikan pendekatan untuk solusi, itu akan memperbarui deskripsi masalah dengan bagian Latar Belakang yang berisi analisis basis kode dan bagian Pendekatan yang merinci pendekatan yang diusulkan untuk membuat solusi. Jika Amazon Q berhasil menemukan solusi untuk masalah yang dijelaskan dalam masalah ini, Amazon Q akan membuat cabang dan perubahan kode di cabang yang mengimplementasikan solusi yang diusulkan. Jika kode yang diusulkan berisi kesamaan dengan kode sumber terbuka yang diketahui Amazon Q, itu akan menyediakan file yang menyertakan tautan ke kode itu sehingga Anda dapat memeriksanya. Setelah kode siap, ia membuat permintaan tarik sehingga Anda dapat meninjau perubahan kode yang disarankan, menambahkan tautan ke permintaan tarik itu ke masalah, dan memindahkan masalah ke Dalam tinjauan.

penting

Anda harus selalu meninjau setiap perubahan kode dalam permintaan tarik sebelum menggabungkannya. Menggabungkan perubahan kode yang dibuat oleh Amazon Q, seperti perubahan kode lainnya, dapat berdampak negatif pada basis kode dan kode infrastruktur Anda jika kode gabungan tidak ditinjau dengan benar dan berisi kesalahan saat digabungkan.

Untuk meninjau masalah dan permintaan tarik tertaut yang berisi perubahan yang dibuat oleh Amazon Q

  1. Dalam Masalah, pilih masalah yang ditetapkan ke Amazon Q yang sedang berlangsung. Tinjau komentar untuk memantau kemajuan Amazon Q. Jika ada, tinjau latar belakang dan dekati catatan dalam deskripsi masalah. Jika Anda memilih untuk mengizinkan Amazon Q menyarankan tugas, tinjau tugas apa pun yang diusulkan dan lakukan tindakan apa pun yang diperlukan. Misalnya, jika Amazon Q menyarankan tugas dan Anda ingin mengubah urutan atau menetapkan tugas ke pengguna tertentu, pilih Ubah, tambahkan, atau susun ulang tugas dan lakukan pembaruan apa pun yang diperlukan. Setelah selesai melihat masalah, pilih X untuk menutup panel masalah.

    Tip

    Untuk melihat kemajuan tugas, pilih tugas dari daftar tugas dalam masalah. Tugas tidak muncul sebagai item terpisah di papan tulis dan hanya dapat diakses melalui masalah. Jika tugas ditetapkan ke Amazon Q, Anda harus membuka tugas untuk menyetujui tindakan apa pun yang ingin dilakukannya. Anda juga harus membuka tugas untuk melihat permintaan tarik tertaut karena tidak akan muncul sebagai tautan dalam masalah, hanya dalam tugas. Untuk kembali ke masalah dari tugas, pilih tautan ke masalah.

  2. Sekarang pilih masalah yang ditetapkan ke Amazon Q yang ada di Dalam ulasan. Tinjau latar belakang dan dekati catatan dalam deskripsi masalah. Tinjau komentar untuk memahami tindakan yang dilakukannya. Tinjau tugas apa pun yang dibuat untuk pekerjaan yang terkait dengan masalah ini, termasuk kemajuannya, tindakan apa pun yang mungkin perlu Anda ambil, dan komentar apa pun. Di Permintaan tarik, pilih tautan ke permintaan tarik di sebelah label Buka untuk meninjau kode.

    Tip

    Permintaan tarik yang dihasilkan untuk tugas hanya muncul sebagai permintaan tarik tertaut dalam tampilan tugas. Mereka tidak muncul sebagai permintaan tarik tertaut untuk masalah ini.

  3. Dalam permintaan tarik, tinjau perubahan kode. Untuk informasi selengkapnya, lihat Meninjau permintaan tarik. Tinggalkan komentar pada permintaan tarik jika Anda ingin Amazon Q mengubah kode yang disarankan. Jadilah spesifik saat meninggalkan komentar untuk Amazon Q untuk hasil terbaik.

    Misalnya, saat meninjau permintaan tarik yang dibuat untukCreate another mysfit named Quokkapus, Anda mungkin memperhatikan bahwa ada kesalahan ketik dalam deskripsi. Anda dapat meninggalkan komentar untuk Amazon Q yang menyatakan “Ubah deskripsi untuk memperbaiki kesalahan ketik” needsa “dengan menambahkan spasi antara “kebutuhan” dan “a”. Atau, Anda dapat meninggalkan komentar yang memberi tahu Amazon Q untuk memperbarui deskripsi dan memberikan seluruh deskripsi yang direvisi untuk digabungkan.

    Jika Anda mengunggah gambar untuk mysfit baru ke situs web, Anda dapat meninggalkan komentar untuk Amazon Q untuk memperbarui mysfit dengan pointer ke gambar dan thumbnail yang akan digunakan untuk mysfit baru.

    catatan

    Amazon Q tidak akan menanggapi komentar individual. Amazon Q hanya akan memasukkan umpan balik yang tersisa di komentar dalam permintaan tarik jika Anda memilih opsi default untuk berhenti setelah setiap langkah untuk persetujuan saat Anda membuat masalah.

  4. (Opsional) Setelah Anda dan pengguna proyek lainnya meninggalkan semua komentar yang Anda inginkan untuk perubahan kode, pilih Buat revisi agar Amazon Q membuat revisi permintaan tarik yang menggabungkan perubahan yang Anda minta dalam komentar. Kemajuan kemajuan pembuatan revisi akan dilaporkan oleh Amazon Q di Ikhtisar, bukan dalam Perubahan. Pastikan untuk menyegarkan browser Anda untuk melihat pembaruan terbaru dari Amazon Q tentang membuat revisi.

    catatan

    Hanya pengguna yang membuat masalah yang dapat membuat revisi permintaan tarik. Anda hanya dapat meminta satu revisi permintaan tarik. Pastikan bahwa Anda telah mengatasi semua masalah dengan komentar, dan bahwa Anda puas dengan konten komentar, sebelum Anda memilih Buat revisi.

  5. Alur kerja dijalankan untuk setiap permintaan tarik dalam proyek contoh ini. Pastikan bahwa Anda melihat alur kerja yang berhasil dijalankan sebelum Anda menggabungkan permintaan tarik. Anda juga dapat memilih untuk membuat alur kerja dan lingkungan tambahan untuk menguji kode sebelum Anda menggabungkannya. Untuk informasi selengkapnya, lihat Memulai dengan alur kerja.

  6. Bila Anda puas dengan revisi terbaru dari pull request, pilih Merge.

Buat masalah dan minta tugas yang direkomendasikan untuk itu oleh Amazon Q

Suatu masalah terkadang dapat berisi jumlah pekerjaan yang kompleks atau panjang. CodeCatalyst termasuk integrasi dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak. Anda dapat meminta Amazon Q untuk menganalisis masalah berdasarkan judul dan deskripsinya, dan merekomendasikan pemecahan logis pekerjaan menjadi tugas terpisah. Ini akan mencoba untuk membuat daftar tugas yang direkomendasikan yang kemudian dapat meninjau, memodifikasi, dan memilih apakah akan membuat. Ini dapat membantu Anda dan tim Anda untuk menetapkan bagian-bagian individual dari pekerjaan kepada pengguna dengan cara yang lebih mudah dikelola yang dapat dicapai lebih cepat.

Untuk membuat dan meninjau daftar tugas yang direkomendasikan untuk suatu masalah

  1. Di panel navigasi, pilih Masalah dan pastikan Anda berada di tampilan Papan.

  2. Pilih Buat masalah.

  3. Berikan judul yang menjelaskan apa yang ingin Anda lakukan dalam bahasa sederhana. Misalnya, untuk masalah ini, masukkan judulChange the get_all_mysfits() API to return mysfits sorted by the Good/Evil attribute. Dalam Deskripsi, berikan detail berikut:

    Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.

  4. Tinjau deskripsi dan pastikan berisi semua detail yang mungkin diperlukan sebelum Anda melanjutkan ke langkah berikutnya.

  5. Di Penerima Tugas, pilih untuk menetapkan masalah untuk diri Anda sendiri.

  6. Pilih Buat masalah. Tampilan Anda berubah ke papan Masalah.

  7. Pilih masalah yang baru saja Anda buat untuk membukanya. Pilih Rekomendasikan tugas.

  8. Pilih repositori sumber yang berisi kode untuk penerbitan. Pilih Mulai merekomendasikan tugas.

Dialog akan ditutup dan Amazon Q akan mulai menganalisis masalah untuk kompleksitas. Jika masalahnya rumit, ini akan menyarankan pemecahan pekerjaan menjadi tugas yang terpisah dan berurutan. Saat daftar sudah siap, pilih Lihat tugas yang disarankan. Anda dapat menambahkan tugas tambahan, memodifikasi tugas yang disarankan, dan menyusun ulang tugas. Jika Anda setuju dengan rekomendasi, memilih Buat tugas akan membuat tugas. Anda kemudian dapat menetapkan tugas-tugas tersebut kepada pengguna untuk mengerjakannya, atau bahkan ke Amazon Q itu sendiri.

Pembersihan sumber daya

Setelah Anda menyelesaikan tutorial ini, pertimbangkan untuk mengambil tindakan berikut untuk membersihkan sumber daya apa pun yang Anda buat selama tutorial ini yang tidak lagi Anda butuhkan.

  • Batalkan penugasan Amazon Q dari masalah apa pun yang tidak lagi dikerjakan. Jika Amazon Q telah menyelesaikan pekerjaannya pada suatu masalah atau tidak dapat menemukan solusi, pastikan untuk membatalkan penetapan Amazon Q untuk menghindari mencapai kuota maksimum untuk fitur AI generatif. Untuk informasi selengkapnya, lihat Mengelola fitur dan Harga AI generatif.

  • Pindahkan masalah apa pun di mana pekerjaan selesai ke Selesai.

  • Jika proyek tidak lagi diperlukan, hapus proyek.