Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan Pengembang Amazon Q di IDE
Gunakan Amazon Q Developer di lingkungan pengembangan terintegrasi (IDEs) untuk mempelajari AWS dan mendapatkan bantuan dengan kebutuhan pengembangan perangkat lunak Anda. Di IDEs, Amazon Q mencakup kemampuan untuk memberikan panduan dan dukungan di berbagai aspek pengembangan perangkat lunak, seperti menjawab pertanyaan tentang membangun, membuat dan memperbarui kode AWS, pemindaian keamanan, dan pengoptimalan dan refactoring kode.
Untuk menginstal Amazon Q di IDE Anda, lihat[Menginstal ekstensi atau plugin Amazon Q Developer di IDE Anda](q-in-IDE-setup.md).
**Topics**
+ [Fitur yang didukung IDEs dan tersedia](#supported-ides-features)
+ [Menginstal ekstensi atau plugin Amazon Q Developer di IDE Anda](q-in-IDE-setup.md)
+ [Mengobrol dengan Amazon Q Developer tentang kode](q-in-IDE-chat.md)
+ [Menghasilkan saran sebaris dengan Pengembang Amazon Q](inline-suggestions.md)
+ [Bahasa yang didukung untuk Pengembang Amazon Q di IDE](q-language-ide-support.md)
## Fitur yang didukung IDEs dan tersedia
Fitur yang dapat Anda akses bergantung pada IDE tempat Anda menggunakan Amazon Q. Tabel berikut menjelaskan yang IDEs didukung oleh Amazon Q dan ketersediaan serta batasan fitur di setiap IDE.
Jika tidak ada dukungan bahasa yang ditentukan, IDE mendukung bahasa yang tercantum dalam topik [Bahasa yang didukung](q-language-ide-support.md).
****
| Fitur | VSCode | JetBrains | Gerhana | Studio Visual |
| --- | --- | --- | --- | --- |
| [Obrolan](q-in-IDE-chat.md) | Ya | Ya | Ya | Ya |
| [Pengkodean agen](q-in-IDE-chat.md#agentic-coding) | Ya | Ya | Ya | Ya |
| [Server MCP](mcp-ide.md) | Ya | Ya | Ya | Ya |
| [Konteks dalam obrolan](ide-chat-context.md) | Ya | Ya | Ya | Ya |
| [Obrolan sebaris](q-in-IDE-inline-chat.md) | Ya | Ya | Ya | Tidak |
| [Konteks ruang kerja dalam obrolan](workspace-context.md) | Ya | Ya | Ya | Ya |
| [Saran sebaris](inline-suggestions.md) | Ya | Ya | Ya | Ya |
| [Transformasi](transform-java.md) | Ya | Ya | Tidak | Ya |
| | Ya | Ya | Ya | Tidak |
Anda juga dapat menghasilkan saran sebaris di lingkungan AWS pengkodean. Untuk informasi selengkapnya, lihat [Menghasilkan saran sebaris di lingkungan AWS pengkodean](setting-up-AWS-coding-env.md).
# Menginstal ekstensi atau plugin Amazon Q Developer di IDE Anda
Untuk menyiapkan Amazon Q Developer di lingkungan pengembangan terintegrasi (IDE) Anda, selesaikan langkah-langkah berikut. Setelah menginstal ekstensi atau plugin Amazon Q, autentikasi melalui IAM Identity Center atau. ID AWS Builder Anda dapat menggunakan Amazon Q secara gratis, tanpa AWS akun, dengan mengautentikasi dengan Builder ID.
Untuk memulai, unduh ekstensi atau plugin Amazon Q untuk IDE Anda:
+ [Unduh Amazon Q untuk Eclipse](https://marketplace.eclipse.org/content/amazon-q)
+ [Unduh Amazon Q untuk Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)
+ [Unduh Amazon Q untuk JetBrains IDEs](https://plugins.jetbrains.com/plugin/24267-amazon-q/)
+ [Unduh Amazon Q di AWS Toolkit for Visual Studio](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.AWSToolkitforVisualStudio2022)
**catatan**
Secara umum, durasi default untuk sesi yang diautentikasi melalui IAM Identity Center adalah 8 jam. Namun, dalam kasus Amazon Q, sesi default berlangsung selama 90 hari (jika Anda menyiapkan Pusat Identitas IAM pada 18 April 2024 atau lebih baru). Untuk informasi selengkapnya lihat [Cara memperpanjang durasi sesi untuk Amazon Q di IDE](https://docs.aws.amazon.com/singlesignon/latest/userguide/configure-user-session.html#90-day-extended-session-duration) di *Panduan AWS IAM Identity Center Pengguna*
Untuk masuk dan mengautentikasi, selesaikan langkah-langkah di bagian ini.
**Topics**
+ [Prasyarat: Versi IDE yang didukung](#q-in-IDE-setup-prereqs)
+ [Mengautentikasi di Eclipse IDEs](#setup-eclipse)
+ [Mengautentikasi di JetBrains IDEs](#setup-jetbrains)
+ [Mengautentikasi di Visual Studio Code](#setup-vscode)
+ [Otentikasi di Visual Studio](#setup-vs)
+ [Menggunakan prinsipal IAM di konsol Anda AWS](#q-no-IAM-in-IDEs)
## Prasyarat: Versi IDE yang didukung
+ Versi minimum yang Eclipse didukung oleh Amazon Q adalah 2024-06 (4.32).
+ Versi minimum JetBrains IDEs (termasuk IntelliJ danPyCharm) yang didukung oleh Amazon Q adalah 2024.3.
+ Versi minimum yang Visual Studio Code didukung oleh Amazon Q adalah 1.85.0.
+ Hanya Visual Studio for yang Windows didukung oleh Amazon Q. Versi minimum Visual Studio yang didukung adalah Visual Studio 2022 versi 17.7. Semua edisi Visual Studio 2022 didukung.
## Mengautentikasi di Eclipse IDEs
Anda dapat mengautentikasi secara gratis dengan ID AWS Builder atau dengan Pusat Identitas IAM dengan langganan Amazon Q Developer Pro. Pilih metode otentikasi Anda untuk melihat langkah-langkah untuk mulai menggunakan Amazon Q inEclipse.
------
#### [ Builder ID ]
Prosedur ini tidak mengharuskan Anda untuk memiliki Builder ID. Jika Anda belum mendaftar untuk Builder ID, Anda akan memiliki kesempatan untuk melakukannya selama proses login.
1. Instal [plugin Amazon Q](https://marketplace.eclipse.org/content/amazon-q) diEclipse.
1. Pilih ikon Amazon Q di sudut kanan atas IDE.
1. Tab Amazon Q terbuka di bagian bawah IDE. Di bawah **Pilih opsi masuk**, pilih **Akun pribadi**, lalu pilih **Lanjutkan**. Anda dialihkan ke browser Anda.
1. Ikuti petunjuk di browser Anda untuk mengautentikasi dengan Builder ID. Setelah Anda menyelesaikan otentikasi, kembali ke Eclipse IDE.
1. Untuk mulai menggunakan Amazon Q, pilih ikon Amazon Q untuk membuka panel obrolan Amazon Q.
------
#### [ IAM Identity Center ]
Sebelum Anda memulai prosedur ini, administrator Anda harus memiliki:
+ Membuat identitas untuk Anda di IAM Identity Center
+ Berlangganan identitas itu ke Amazon Q Developer Pro
Setelah identitas Anda berlangganan Amazon Q Developer Pro, selesaikan langkah-langkah berikut untuk mengautentikasi:
1. Instal [plugin Amazon Q](https://marketplace.eclipse.org/content/amazon-q) diEclipse.
1. Pilih ikon Amazon Q di sudut kanan atas IDE.
1. Tab Amazon Q terbuka di bagian bawah IDE. Di bawah **Pilih opsi masuk**, pilih **Akun perusahaan**, lalu pilih **Lanjutkan**.
1. Masukkan **URL Mulai** yang didapat administrator Anda [dari konsol langganan Amazon Q](manage-account-details.md).
1. Pilih Wilayah AWS di mana administrator Anda mengatur [instans Pusat Identitas IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html) Anda.
1. Pilih **Lanjutkan**. Anda dialihkan ke browser Anda.
1. Ikuti petunjuk di browser Anda untuk mengautentikasi dengan IAM Identity Center. Setelah Anda menyelesaikan otentikasi, kembali ke Eclipse IDE.
1. Untuk mulai menggunakan Amazon Q, pilih ikon Amazon Q untuk membuka panel obrolan Amazon Q.
------
## Mengautentikasi di JetBrains IDEs
Anda dapat mengautentikasi secara gratis dengan ID AWS Builder atau dengan Pusat Identitas IAM dengan langganan Amazon Q Developer Pro. Pilih metode otentikasi Anda untuk melihat langkah-langkah untuk mulai menggunakan Amazon Q di JetBrains IDE Anda.
------
#### [ Builder ID ]
Prosedur ini tidak mengharuskan Anda untuk memiliki Builder ID. Jika Anda belum mendaftar untuk Builder ID, Anda akan memiliki kesempatan untuk melakukannya selama proses login.
1. Instal [plugin Amazon Q](https://plugins.jetbrains.com/plugin/24267-amazon-q/) di JetBrains IDE Anda.
1. Pilih ikon Amazon Q di IDE Anda.
Ikon akan berada di sisi antarmuka secara default.
1. Ikuti petunjuk di browser Anda untuk mengautentikasi dengan Builder ID.
1. Untuk mulai menggunakan Amazon Q, pilih ikon Amazon Q untuk mengobrol dengan Amazon Q, atau pilih **Amazon Q** dari bilah navigasi di bagian bawah IDE Anda.
------
#### [ IAM Identity Center ]
Sebelum Anda memulai prosedur ini, administrator Anda harus memiliki:
+ Membuat identitas untuk Anda di IAM Identity Center
+ Berlangganan identitas itu ke Amazon Q Developer Pro
Setelah identitas Anda berlangganan Amazon Q Developer Pro, selesaikan langkah-langkah berikut untuk mengautentikasi:
1. Instal [plugin Amazon Q](https://plugins.jetbrains.com/plugin/24267-amazon-q/) di JetBrains IDE Anda.
1. Pilih ikon Amazon Q di IDE Anda.
Ikon akan berada di sisi antarmuka secara default.
1. Pilih **Akun Perusahaan**.
1. Berikan **URL Mulai** yang didapat administrator Anda [dari konsol langganan Amazon Q](manage-account-details.md).
1. Berikan Wilayah AWS tempat administrator Anda menyiapkan [instans](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html) Pusat Identitas IAM Anda.
1. Pilih **Lanjutkan**. Fokus akan beralih ke browser web Anda.
1. Ikuti petunjuk di browser Anda untuk mengautentikasi dengan IAM Identity Center, lalu kembali ke IDE.
1. Jika administrator Anda telah mengonfigurasi lebih dari satu profil Pengembang Amazon Q, Anda akan melihat profil yang dapat Anda akses. Pilih profil yang memenuhi kebutuhan kerja Anda saat ini, atau administrator Anda telah menginstruksikan Anda untuk menggunakannya. Untuk informasi selengkapnya tentang profil, lihat [Apa profil Pengembang Amazon Q?](subscribe-understanding-profile.md).
Jika hanya ada satu profil yang tersedia, profil itu akan dipilih secara otomatis dan Anda dapat mulai menggunakan Amazon Q.
Untuk mengubah profil Pengembang Amazon Q Anda, pilih **Amazon Q** dari bagian bawah IDE, lalu pilih **Ubah profil**. Dari jendela yang muncul, pilih profil yang ingin Anda gunakan.
1. Untuk mulai menggunakan Amazon Q, pilih ikon Amazon Q untuk mengobrol dengan Amazon Q, atau pilih **Amazon Q** dari bilah navigasi di bagian bawah IDE Anda.
------
## Mengautentikasi di Visual Studio Code
Anda dapat mengautentikasi secara gratis dengan ID AWS Builder atau dengan Pusat Identitas IAM dengan langganan Amazon Q Developer Pro. Pilih metode otentikasi Anda untuk melihat langkah-langkah untuk mulai menggunakan Amazon Q inVS Code.
------
#### [ Builder ID ]
Prosedur ini tidak mengharuskan Anda untuk memiliki Builder ID. Jika Anda belum mendaftar untuk Builder ID, Anda akan memiliki kesempatan untuk melakukannya selama proses login.
1. Instal [ekstensi Amazon Q](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode) diVS Code.
1. Pilih ikon Amazon Q di IDE Anda.
Ikon akan berada di sisi antarmuka secara default.
1. Ikuti petunjuk di browser Anda untuk mengautentikasi dengan Builder ID.
1. Untuk mulai menggunakan Amazon Q, pilih ikon Amazon Q untuk mengobrol dengan Amazon Q, atau pilih **Amazon Q** dari bilah navigasi di bagian bawah IDE Anda.
------
#### [ IAM Identity Center ]
Sebelum Anda memulai prosedur ini, administrator Anda harus memiliki:
+ Membuat identitas untuk Anda di IAM Identity Center
+ Berlangganan identitas itu ke Amazon Q Developer Pro
Setelah identitas Anda berlangganan Amazon Q Developer Pro, selesaikan langkah-langkah berikut untuk mengautentikasi:
1. Instal [ekstensi Amazon Q](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode) diVS Code.
1. Pilih ikon Amazon Q di IDE Anda.
Ikon akan berada di sisi antarmuka secara default.
1. Pilih **Akun Perusahaan**.
1. Berikan **URL Mulai** yang didapat administrator Anda [dari konsol langganan Amazon Q](manage-account-details.md).
1. Berikan Wilayah AWS tempat administrator Anda menyiapkan [instans](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html) Pusat Identitas IAM Anda.
1. Pilih **Lanjutkan**. Fokus akan beralih ke browser web Anda.
1. Ikuti petunjuk di browser Anda untuk mengautentikasi dengan IAM Identity Center, lalu kembali ke IDE.
1. Jika administrator Anda telah mengonfigurasi lebih dari satu profil Pengembang Amazon Q, Anda akan melihat profil yang dapat Anda akses. Pilih profil yang memenuhi kebutuhan kerja Anda saat ini, atau administrator Anda telah menginstruksikan Anda untuk menggunakannya. Untuk informasi selengkapnya tentang profil, lihat [Apa profil Pengembang Amazon Q?](subscribe-understanding-profile.md).
Jika hanya ada satu profil yang tersedia, profil itu akan dipilih secara otomatis dan Anda dapat mulai menggunakan Amazon Q.
Untuk mengubah profil Pengembang Amazon Q Anda, pilih **Amazon Q** dari bagian bawah IDE, lalu pilih **Ubah profil**. Dari palet perintah, pilih profil yang ingin Anda gunakan.
1. Untuk mulai menggunakan Amazon Q, pilih ikon Amazon Q untuk mengobrol dengan Amazon Q, atau pilih **Amazon Q** dari bilah navigasi di bagian bawah IDE Anda.
------
## Otentikasi di Visual Studio
Untuk menyambung ke AWS akun Anda dari Toolkit for Visual Studio, buka **Memulai dengan AWS ** Antarmuka Pengguna Toolkit (UI koneksi) dengan menyelesaikan prosedur berikut.
1. Dari menu utama Visual Studio, perluas **Extensions lalu perluas AWS ** **Toolkit**.
1. Dari opsi menu **AWS Toolkit** pilih **Memulai**.
1. **Memulai dengan UI koneksi AWS Toolkit** terbuka di Visual Studio.
Anda dapat mengautentikasi secara gratis dengan ID AWS Builder atau dengan Pusat Identitas IAM dengan langganan Amazon Q Developer Pro. Pilih metode otentikasi Anda untuk melihat langkah-langkah untuk mulai menggunakan Amazon Q di Visual Studio.
------
#### [ Builder ID ]
1. Dari Visual Studio, perluas **Extensions** dari menu utama dan kemudian perluas sub-menu **AWS Toolkit**.
1. Pilih **Memulai**. Tab **Memulai** terbuka di jendela editor Visual Studio.
1. Di bagian **Amazon Q**, pilih **Aktifkan**.
1. Dari bagian **Tingkat Gratis**, pilih tombol **Daftar atau Masuk**.
1. Konfirmasikan bahwa Anda ingin membuka portal permintaan AWS Otorisasi di browser web default Anda.
1. Ikuti petunjuk di browser web default Anda. Anda diberi tahu ketika proses otorisasi selesai, dan aman untuk menutup browser Anda dan kembali ke Visual Studio.
------
#### [ IAM Identity Center ]
1. Dari Visual Studio, perluas **Extensions** dari menu utama dan kemudian perluas sub-menu **AWS Toolkit**.
1. Pilih **Memulai**. Tab **Memulai** terbuka di jendela editor Visual Studio.
1. Di bagian **Amazon Q**, pilih **Aktifkan**. Anda akan mengisi bagian Tingkat Profesional untuk mengautentikasi.
1. Profil kredensialnya terdiri dari Nama Profil, URL Mulai, Wilayah Profil, atau Wilayah SSO yang disediakan oleh administrator di perusahaan atau organisasi Anda. Untuk informasi rinci tentang kredenal Pusat Identitas IAM, lihat [Apa itu Pusat Identitas IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)? di *Panduan Pengguna Pusat Identitas IAM*.
**Jika Anda memiliki profil kredensial yang ada, pilih dari menu tarik-turun di panel tingkat Profesional, lalu pilih Connect.**
Untuk membuat profil kredensional baru, isi kolom berikut dari bagian Tingkat Profesional:
1. Di bidang teks **Nama Profil**, masukkan nama profil Pusat Identitas IAM yang ingin Anda autentikasi.
1. Di bidang teks **URL Mulai**, masukkan URL awal yang dilampirkan ke kredenal Pusat Identitas IAM Anda.
1. Dari menu drop-down **Profile Region (default ke us-east-1)**, pilih yang ditentukan oleh profil pengguna IAM Identity Center Wilayah AWS yang Anda autentikasi.
1. ****Dari menu drop-down **Wilayah SSO (default ke us-east-1**), pilih Wilayah **SSO** yang ditentukan oleh kredenal Pusat Identitas IAM Anda, lalu pilih tombol Connect untuk membuka dialog Login with IAM Identity Center. AWS ****
1. Konfirmasikan bahwa Anda ingin membuka portal permintaan AWS Otorisasi di browser web default Anda.
1. Ikuti petunjuk di browser web default Anda. Anda diberi tahu ketika proses otorisasi selesai, dan aman untuk menutup browser Anda dan kembali ke Visual Studio.
1. Jendela **Masuk ke Amazon Q** muncul. Di dropdown profil kredensial, pilih profil yang Anda gunakan untuk mengautentikasi pada langkah sebelumnya.
1. Jika administrator Anda telah mengonfigurasi lebih dari satu profil Pengembang Amazon Q, Anda akan diminta untuk memilih profil Pengembang Q dari menu tarik-turun. Pilih profil yang memenuhi kebutuhan kerja Anda saat ini, atau administrator Anda telah menginstruksikan Anda untuk menggunakannya. Untuk informasi selengkapnya tentang profil, lihat [Apa profil Pengembang Amazon Q?](subscribe-understanding-profile.md).
Jika hanya ada satu profil yang tersedia, profil itu akan dipilih secara otomatis dan Anda dapat mulai menggunakan Amazon Q.
Untuk mengubah profil Pengembang Amazon Q Anda, pilih **Amazon Q** dari bagian bawah IDE, lalu pilih **Ubah Profil Pengembang Q**. Dari jendela yang muncul, pilih profil yang ingin Anda gunakan.
Anda juga dapat mengubah profil Anda dengan memilih menu overflow di sudut kanan atas jendela obrolan, lalu memilih **Ubah Profil Pengembang Q**.
------
*Untuk informasi selengkapnya tentang autentikasi di Toolkit for Visual Studio, [lihat Memulai](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html) di Panduan Pengguna AWS Toolkit for Visual Studio .*
## Menggunakan prinsipal IAM di konsol Anda AWS
Bergantung pada bagaimana Anda menggunakan AWS, Anda mungkin terbiasa menggunakan kredensi IAM Anda untuk masuk ke konsol untuk semua layanan. AWS Namun, Anda tidak dapat menggunakan Amazon Q Developer di IDE sebagai prinsipal IAM, atau dengan peran IAM. Anda harus mengautentikasi dengan kredensi dari Pusat Identitas IAM atau ID Pembangun.
# Mengobrol dengan Amazon Q Developer tentang kode
Mengobrol dengan Amazon Q Developer di lingkungan pengembangan terintegrasi (IDE) Anda untuk mengajukan pertanyaan tentang membangun di AWS dan untuk bantuan pengembangan perangkat lunak. Amazon Q dapat menjelaskan konsep pengkodean dan cuplikan kode, menghasilkan pengujian kode dan unit, serta meningkatkan kode, termasuk debugging atau refactoring.
**Topics**
+ [Bekerja dengan Amazon Q di IDE Anda](#working-with-q-in-IDE)
+ [Contoh tugas](#example-tasks)
+ [Contoh pertanyaan](#example-topics-questions)
+ [Melaporkan masalah dengan tanggapan dari Amazon Q](#report-issues)
+ [Meninjau kode dengan Pengembang Amazon Q](code-reviews.md)
+ [Mengubah kode dalam IDE dengan Pengembang Amazon Q](transform-in-IDE.md)
+ [Menjelaskan dan memperbarui kode dengan Pengembang Amazon Q](explain-update-code.md)
+ [Mengobrol sebaris dengan Pengembang Amazon Q](q-in-IDE-inline-chat.md)
+ [Menambahkan konteks ke obrolan Pengembang Amazon Q di IDE](ide-chat-context.md)
+ [Pemadatan riwayat obrolan di Pengembang Amazon Q](ide-chat-history-compaction.md)
+ [Melihat, menghapus, dan mengekspor riwayat percakapan Pengembang Amazon Q](ide-chat-conversation.md)
+ [Menggunakan tombol pintas dalam obrolan dengan Pengembang Amazon Q](q-in-ides-chat-shortcuts.md)
+ [Memilih model untuk obrolan Amazon Q di IDEs](q-in-ides-chat-models.md)
## Bekerja dengan Amazon Q di IDE Anda
### Menggunakan obrolan
Untuk mulai mengobrol dengan Amazon Q, pilih ikon Amazon Q dari bilah navigasi di IDE Anda dan masukkan pertanyaan Anda di bilah teks. Untuk mulai mengobrol dengan Amazon Q di Visual Studio, pilih **Lihat** dari menu utama dan kemudian pilih **obrolan Amazon Q**.
Saat Anda mengajukan pertanyaan kepada Amazon Q, ia menggunakan file saat ini yang terbuka di IDE Anda sebagai konteks, termasuk bahasa pemrograman dan jalur file. Anda dapat menambahkan lebih banyak konteks dalam prompt Anda atau menentukan file, folder, atau seluruh ruang kerja Anda sebagai konteks di seluruh sesi obrolan. Untuk informasi selengkapnya, lihat [Menambahkan konteks ke obrolan](ide-chat-context.md).
Jika Amazon Q menyertakan kode dalam tanggapannya, Anda dapat menyalin kode atau memasukkannya langsung ke file Anda dengan memilih **Sisipkan di kursor**. Amazon Q mungkin menyertakan referensi sebaris ke sumbernya dalam tanggapannya.
Amazon Q mempertahankan konteks percakapan Anda dalam sesi tertentu menginformasikan tanggapan future. Anda dapat mengajukan pertanyaan tindak lanjut atau merujuk ke pertanyaan dan tanggapan sebelumnya selama sesi Anda. Untuk memulai percakapan baru dengan Amazon Q, buka tab baru di panel. Anda dapat membuka hingga 10 tab sekaligus. Amazon Q tidak mempertahankan konteks di berbagai percakapan.
#### Perintah obrolan
Perintah berikut membantu Anda mengelola obrolan dengan Amazon Q.
+ **/clear** - Gunakan perintah ini untuk menghapus percakapan saat ini. Ini menghapus semua percakapan sebelumnya dari panel obrolan dan menghapus konteks yang dimiliki Amazon Q tentang percakapan Anda sebelumnya.
+ **/compact** - Gunakan perintah ini untuk memadatkan riwayat obrolan Anda saat jendela konteks mendekati batas kapasitasnya. Ini menciptakan ringkasan singkat percakapan Anda sambil menyimpan informasi penting.
+ **/help** - Gunakan perintah ini untuk melihat ikhtisar tentang apa yang Amazon Q bisa dan tidak bisa lakukan, contoh pertanyaan, dan fitur yang tersedia.
### Pengkodean agen
Dengan pengkodean agen, Amazon Q bertindak sebagai mitra pengkodean Anda, mengobrol dengan Anda saat Anda berkembang. Pengkodean agen aktif secara default di IDE. Anda dapat mengaktifkan atau menonaktifkan pengkodean agen dengan `` ikon di bagian bawah panel obrolan.
Ketika Anda meminta Amazon Q untuk meningkatkan kode Anda, itu memperbarui file Anda secara langsung. Anda dapat melihat perubahan dalam diff dan memiliki opsi untuk membatalkannya.
Sementara Amazon Q sedang berpikir atau mengerjakan tugas, Anda dapat terus menambahkan instruksi di panel obrolan, dan itu akan memasukkannya ke dalam pekerjaannya.
Saat Anda mendiskusikan proyek Anda dengan Amazon Q, itu akan menawarkan saran untuk perintah shell. Terkadang, ketika menganggap perintah-perintah itu berisiko rendah, ia akan menjalankannya sendiri.
### Mengobrol dalam bahasa alami
Amazon Q Developer menyediakan dukungan multi-bahasa saat Anda mengobrol di IDE. Bahasa alami yang didukung termasuk Mandarin, Prancis, Jerman, Italia, Jepang, Spanyol, Korea, Hindi, dan Portugis, dengan lebih banyak bahasa yang tersedia. Untuk memanfaatkan fungsi ini, Anda dapat memulai percakapan dengan Amazon Q di IDE menggunakan bahasa alami pilihan Anda. Amazon Q secara otomatis mendeteksi bahasa dan memberikan tanggapan dalam bahasa yang sesuai.
## Contoh tugas
### Mengembangkan fitur kode
**catatan**
Kemampuan ini digunakan untuk disebut sebagai /dev dalam dokumentasi ini dan dalam IDE.
Amazon Q dapat membantu Anda mengembangkan fitur kode, membuat perubahan kode pada proyek, dan menjawab pertanyaan tentang tugas pengembangan perangkat lunak 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 yang dapat Anda terapkan ke basis kode Anda. Amazon Q dapat membantu Anda membangun AWS proyek atau aplikasi Anda sendiri.
### Generasi uji unit
**catatan**
Kemampuan ini digunakan untuk disebut sebagai /test dalam dokumentasi ini dan dalam IDE.
Amazon Q dapat menghasilkan pengujian unit sehingga Anda dapat mengotomatiskan pengujian di seluruh siklus hidup pengembangan perangkat lunak. Fitur ini membantu pengembang fokus pada percepatan pengembangan fitur sambil memastikan kualitas kode.
### Generasi dokumentasi
**catatan**
Kemampuan ini digunakan untuk disebut sebagai /doc dalam dokumentasi ini dan dalam IDE.
Amazon Q membantu Anda memahami kode Anda dan menjaga dokumentasi tetap up to date dengan membuat READMEs dan dokumentasi lain untuk kode Anda. Ini dapat menghasilkan dokumentasi baru dan memperbarui dokumentasi yang ada di basis kode Anda.
### Ulasan kode
**catatan**
Kemampuan ini digunakan untuk disebut sebagai /review dalam dokumentasi ini dan dalam IDE.
Amazon Q dapat meninjau basis kode Anda untuk kerentanan keamanan dan masalah kualitas kode untuk meningkatkan postur aplikasi Anda selama siklus pengembangan. Untuk informasi selengkapnya tentang cara menggunakan fitur ini, lihat[Meninjau kode dengan Pengembang Amazon Q](code-reviews.md).
### Mengubah kode
Amazon Q dapat mengubah kode Anda di lingkungan pengembangan terintegrasi (IDEs) dengan melakukan peningkatan dan konversi tingkat bahasa dan sistem operasi (OS) otomatis. Anda memberikan kode yang akan diubah, dan Amazon Q menghasilkan perubahan yang dapat Anda tinjau dan terapkan ke file Anda. Untuk informasi selengkapnya, lihat [Mengubah kode](transform-in-IDE.md).
## Contoh pertanyaan
Di dalamnya IDEs, Amazon Q dapat menjawab pertanyaan tentang Layanan AWS dan pengembangan perangkat lunak, selain menghasilkan kode. Amazon Q sangat berguna untuk menjawab pertanyaan yang terkait dengan bidang subjek berikut.
+ Membangun AWS, termasuk Layanan AWS seleksi, batasan, dan praktik terbaik
+ Konsep pengembangan perangkat lunak umum, termasuk sintaks bahasa pemrograman dan pengembangan aplikasi
+ Menulis kode, termasuk menjelaskan kode, men-debug kode, dan menulis tes unit
Berikut adalah beberapa contoh pertanyaan yang dapat Anda tanyakan untuk mendapatkan hasil maksimal dari Amazon Q di IDE Anda:
+ Bagaimana cara men-debug masalah dengan fungsi Lambda saya secara lokal sebelum menerapkan ke AWS?
+ Bagaimana cara memilih antara AWS Lambda dan Amazon EC2 untuk backend aplikasi web yang dapat diskalakan?
+ Apa sintaks mendeklarasikan variabel? TypeScript
+ Bagaimana cara menulis aplikasiReact?
+ Berikan saya deskripsi tentang apa yang dilakukan [*kode atau aplikasi yang dipilih*] ini dan bagaimana cara kerjanya.
+ Hasilkan kasus uji untuk [*kode atau fungsi yang dipilih*].
## Melaporkan masalah dengan tanggapan dari Amazon Q
Anda dapat secara opsional meninggalkan umpan balik untuk setiap respons yang dihasilkan Amazon Q dengan menggunakan ikon jempol ke atas dan jempol ke bawah. Untuk melaporkan masalah dengan respons, pilih ikon jempol ke bawah, dan masukkan informasi di jendela umpan balik yang muncul.
# Meninjau kode dengan Pengembang Amazon Q
Amazon Q Developer dapat meninjau basis kode Anda untuk kerentanan keamanan dan masalah kualitas kode untuk meningkatkan postur aplikasi Anda selama siklus pengembangan. Anda dapat meninjau seluruh basis kode, menganalisis semua file di proyek atau ruang kerja lokal Anda, atau meninjau satu file. Anda juga dapat mengaktifkan ulasan auto yang menilai kode Anda saat Anda menulisnya.
Ulasan didukung oleh AI generatif dan penalaran otomatis berbasis aturan. [Detektor Amazon Q](https://docs.aws.amazon.com/codeguru/detector-library), yang diinformasikan oleh bertahun-tahun AWS dan praktik terbaik keamanan Amazon.com, mendukung ulasan keamanan dan kualitas berbasis aturan. Karena kebijakan keamanan diperbarui dan detektor ditambahkan, ulasan secara otomatis menggabungkan detektor baru untuk memastikan kode Anda sesuai dengan sebagian besar kebijakan. up-to-date
Untuk informasi tentang didukung IDEs untuk fitur ini, lihat[Didukung IDEs](q-in-IDE.md#supported-ides-features). Untuk informasi tentang bahasa yang didukung, lihat[Dukungan bahasa untuk ulasan kode](q-language-ide-support.md#code-reviews-language-support).
**Topics**
+ [Cara kerjanya](#how-code-reviews-work)
+ [Jenis masalah kode](#issue-types)
+ [Kuota](#quotas)
+ [Memulai ulasan kode dengan Amazon Q Developer](start-review.md)
+ [Mengatasi masalah kode dengan Pengembang Amazon Q](address-code-issues.md)
+ [Masalah kode penyaringan](filter-code-issues.md)
+ [Tingkat keparahan masalah kode dalam ulasan kode Pengembang Amazon Q](code-issue-severity.md)
## Cara kerjanya
Selama peninjauan kode, Amazon Q menilai kode kustom dan pustaka pihak ketiga dalam kode Anda. Sebelum memulai peninjauan kode, Amazon Q menerapkan pemfilteran untuk memastikan bahwa hanya kode yang relevan yang ditinjau. Sebagai bagian dari proses penyaringan, Amazon Q mengecualikan bahasa yang tidak didukung, kode pengujian, dan kode sumber terbuka.
Amazon Q dapat meninjau perubahan kode terbaru Anda, atau seluruh file atau proyek. Untuk memulai peninjauan, Anda membuka folder kode di IDE Anda, dan kemudian meminta Amazon Q untuk meninjau kode Anda dari panel obrolan.
Secara default, jika Anda hanya meminta Amazon Q untuk meninjau kode Anda, itu hanya akan meninjau perubahan kode dalam file aktif di IDE Anda. Perubahan kode ditentukan oleh output `git diff` perintah pada file Anda. Jika tidak ada file diff hadir, Amazon Q akan meninjau seluruh file kode. Jika tidak ada file yang terbuka, itu akan mencari perubahan kode apa pun dalam proyek untuk ditinjau.
Demikian pula, jika Anda meminta Amazon Q untuk meninjau seluruh proyek atau ruang kerja Anda, pertama-tama akan mencoba meninjau perubahan kode Anda. Jika tidak ada file diff yang ada, itu akan meninjau seluruh basis kode Anda.
## Jenis masalah kode
Amazon Q meninjau kode Anda untuk jenis masalah kode berikut:
+ **Pemindaian SAST — Mendeteksi kerentanan keamanan dalam kode sumber Anda.** Amazon Q mengidentifikasi berbagai masalah keamanan, seperti kebocoran sumber daya, injeksi SQL, dan skrip lintas situs.
+ **Deteksi rahasia — Mencegah paparan informasi sensitif atau rahasia dalam kode Anda.** Amazon Q meninjau kode dan file teks Anda untuk rahasia seperti kata sandi hardcode, string koneksi database, dan nama pengguna. Temuan rahasia mencakup informasi tentang rahasia yang tidak terlindungi dan bagaimana melindunginya.
+ **Masalah IAC — Evaluasi postur keamanan file infrastruktur Anda.** Amazon Q dapat meninjau infrastruktur Anda sebagai file kode kode (IAc) untuk mendeteksi kesalahan konfigurasi, kepatuhan, dan masalah keamanan.
+ **Masalah kualitas kode - Pastikan kode Anda memenuhi standar kualitas, pemeliharaan, dan efisiensi.** Amazon Q menghasilkan masalah kode yang terkait dengan berbagai masalah kualitas, termasuk namun tidak terbatas pada kinerja, aturan pembelajaran mesin, dan praktik terbaik AWS.
+ **Risiko penerapan kode - Menilai risiko yang terkait dengan penerapan kode.** Amazon Q menentukan apakah ada risiko untuk menerapkan atau merilis kode Anda, termasuk kinerja aplikasi dan gangguan pada operasi.
+ **Analisis Komposisi Perangkat Lunak (SCA) — Mengevaluasi kode pihak ketiga.** Amazon Q memeriksa komponen, pustaka, kerangka kerja, dan dependensi pihak ketiga yang terintegrasi ke dalam kode Anda, memastikan kode pihak ketiga aman dan mutakhir.
Untuk daftar lengkap detektor yang digunakan Amazon Q untuk meninjau kode Anda, lihat [Perpustakaan Amazon Q Detector](https://docs.aws.amazon.com/codeguru/detector-library/).
## Kuota
Pemindaian keamanan Amazon Q mempertahankan kuota berikut:
+ **Ukuran artefak masukan** — Ukuran maksimum semua file dalam ruang kerja proyek IDE, termasuk pustaka pihak ketiga, file JAR build, dan file sementara.
+ **Ukuran kode sumber — Ukuran** maksimum kode sumber yang dipindai Amazon Q setelah memfilter semua pustaka pihak ketiga dan file yang tidak didukung.
Tabel berikut menjelaskan kuota yang dipertahankan untuk pemindaian otomatis dan pemindaian proyek penuh.
| Sumber daya | Ulasan otomatis | Ulasan file atau proyek |
| --- | --- | --- |
| Ukuran artefak masukan | 200 KB | 500 MB |
| Ukuran kode sumber | 200 KB | 50 MB |
# Memulai ulasan kode dengan Amazon Q Developer
Amazon Q dapat meninjau seluruh file atau basis kode Anda, atau meninjau kode Anda secara otomatis saat Anda menulisnya.
Sebelum memulai, pastikan Anda telah menginstal Amazon Q di IDE yang mendukung ulasan kode. Untuk informasi selengkapnya, lihat [Menginstal ekstensi atau plugin Amazon Q Developer di IDE Anda](q-in-IDE-setup.md).
**Topics**
+ [Meninjau file, proyek, atau ruang kerja](#project-review)
+ [Contoh tugas dan petunjuk](#code-review-prompts)
+ [Tinjau saat Anda kode](#auto-scan)
## Meninjau file, proyek, atau ruang kerja
Anda dapat memulai peninjauan dari panel obrolan agar Amazon Q meninjau file atau proyek tertentu. Tinjauan file dan proyek mencakup ulasan berbasis aturan dan generatif yang didukung AI.
Setelah Amazon Q menyelesaikan peninjauan, Anda dapat menyelidiki masalah tersebut dan mendapatkan perbaikan kode untuk memperbaiki masalah tersebut. Untuk informasi selengkapnya, lihat [Mengatasi masalah kode](address-code-issues.md).
Untuk memulai tinjauan file atau proyek, selesaikan langkah-langkah berikut untuk IDE Anda:
------
#### [ JetBrains ]
1. Buka file atau proyek yang ingin Anda tinjau di IDE Anda.
1. Pilih ikon Amazon Q untuk membuka panel obrolan.
1. Menggunakan bahasa alami, jelaskan jenis tinjauan kode yang ingin Anda jalankan. Anda hanya dapat meninjau perubahan kode terbaru Anda, atau seluruh file. Perubahan kode ditentukan berdasarkan output dari perintah git diff pada file Anda. Jika berlaku, Amazon Q hanya akan meninjau perubahan kode Anda secara default kecuali ditentukan lain.
1. Dengan proyek kode atau file terbuka di IDE, Anda dapat memasukkan hal-hal seperti:
1. **Review my code changes**- Amazon Q akan meninjau setiap perubahan kode dalam basis kode Anda
1. **Run a code review on this entire file**— Amazon Q akan meninjau semua kode dalam file Anda, tidak hanya perubahan
1. **Review this repository**— Amazon Q akan meninjau seluruh basis kode Anda, tidak hanya perubahan
Untuk skenario peninjauan kode yang lebih detail dan petunjuk terkait, lihat [Contoh prompt](#code-review-prompts).
1. Amazon Q akan mulai meninjau file atau proyek Anda. Setelah selesai, ini akan merangkum masalah dan pengamatan prioritas tertinggi.
1. Jika ada masalah yang terdeteksi, tab **Masalah Kode** akan terbuka dengan daftar masalah yang ditemukan Amazon Q.
1. Untuk mempelajari lebih lanjut tentang masalah kode, navigasikan ke panel **Masalah Kode**. Dari sana, Anda dapat melakukan hal berikut:
1. Pilih masalah yang akan diarahkan ke area spesifik file tempat kode rentan atau berkualitas rendah terdeteksi.
1. Untuk mendapatkan penjelasan tentang masalah kode, pilih ikon kaca pembesar di sebelah nama masalah kode. Amazon Q akan memberikan detail tentang masalah ini dan menyarankan perbaikan yang dapat Anda masukkan ke dalam kode Anda.
1. Untuk memperbaiki masalah kode, pilih ikon kunci pas di sebelah nama masalah kode. Amazon Q akan memberikan penjelasan singkat tentang perbaikan dan kemudian membuat perbaikan di tempat dalam file kode Anda. Anda akan melihat perubahan kode di file Anda, dan memiliki opsi untuk membatalkan perubahan dari panel obrolan.
1. Anda juga dapat menggunakan bahasa alami untuk menanyakan lebih banyak tentang suatu masalah, mendapatkan penjelasan tentang perbaikan yang diusulkan, atau meminta solusi alternatif.
1. Untuk informasi selengkapnya tentang mengatasi masalah kode, lihat[Mengatasi masalah kode dengan Pengembang Amazon Q](address-code-issues.md).
------
#### [ Kode Studio Visual ]
1. Buka file atau proyek yang ingin Anda tinjau di IDE Anda.
1. Pilih ikon Amazon Q untuk membuka panel obrolan.
1. Menggunakan bahasa alami, jelaskan jenis tinjauan kode yang ingin Anda jalankan. Anda hanya dapat meninjau perubahan kode terbaru Anda, atau seluruh file. Perubahan kode ditentukan berdasarkan output dari perintah git diff pada file Anda. Jika berlaku, Amazon Q hanya akan meninjau perubahan kode Anda secara default kecuali ditentukan lain.
1. Dengan proyek kode atau file terbuka di IDE, Anda dapat memasukkan hal-hal seperti:
1. **Review my code changes**- Amazon Q akan meninjau setiap perubahan kode dalam basis kode Anda
1. **Run a code review on this entire file**— Amazon Q akan meninjau semua kode dalam file Anda, tidak hanya perubahan
1. **Review this repository**— Amazon Q akan meninjau seluruh basis kode Anda, tidak hanya perubahan
Untuk skenario peninjauan kode yang lebih detail dan petunjuk terkait, lihat [Contoh prompt](#code-review-prompts).
1. Amazon Q akan mulai meninjau file atau proyek Anda. Setelah selesai, ini akan merangkum masalah dan pengamatan prioritas tertinggi.
1. Jika ada masalah yang terdeteksi, tab **Masalah Kode** akan terbuka dengan daftar masalah yang ditemukan Amazon Q.
1. Untuk mempelajari lebih lanjut tentang masalah kode, navigasikan ke panel **Masalah Kode**. Dari sana, Anda dapat melakukan hal berikut:
1. Pilih masalah yang akan diarahkan ke area spesifik file tempat kode rentan atau berkualitas rendah terdeteksi.
1. Untuk mendapatkan penjelasan tentang masalah kode, pilih ikon kaca pembesar di sebelah nama masalah kode. Amazon Q akan memberikan detail tentang masalah ini dan menyarankan perbaikan yang dapat Anda masukkan ke dalam kode Anda.
1. Untuk memperbaiki masalah kode, pilih ikon kunci pas di sebelah nama masalah kode. Amazon Q akan memberikan penjelasan singkat tentang perbaikan dan kemudian membuat perbaikan di tempat dalam file kode Anda. Anda akan melihat perubahan kode di file Anda, dan memiliki opsi untuk membatalkan perubahan dari panel obrolan.
1. Anda juga dapat menggunakan bahasa alami untuk menanyakan lebih banyak tentang suatu masalah, mendapatkan penjelasan tentang perbaikan yang diusulkan, atau meminta solusi alternatif.
1. Untuk informasi selengkapnya tentang mengatasi masalah kode, lihat[Mengatasi masalah kode dengan Pengembang Amazon Q](address-code-issues.md).
------
#### [ Visual Studio ]
1. Buka file dari proyek yang ingin Anda pindai di Visual Studio.
1. Pilih ikon Amazon Q di bagian bawah file Anda untuk membuka bilah tugas Amazon Q.
1. Dari bilah tugas, pilih **Jalankan Pemindaian Keamanan**. Amazon Q mulai memindai proyek Anda.
Pada gambar berikut, di Visual Studio, pengguna memilih ikon **Amazon Q**, meminta bilah tugas tempat pengguna dapat memilih **Jalankan Pemindaian Keamanan**.
![\[Visual Studio dengan bilah tugas Amazon Q yang menampilkan “Jalankan Pemindaian Keamanan” sebagai pilihan\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/VS-scans.png)
1. Status pemindaian Anda diperbarui di panel output Visual Studio. Anda diberi tahu saat pemindaian selesai.
Untuk informasi tentang melihat dan menangani temuan, lihat[Mengatasi masalah kode dengan Pengembang Amazon Q](address-code-issues.md).
------
## Contoh tugas dan petunjuk
Ada beberapa skenario yang mungkin Anda hadapi saat memulai tinjauan kode. Berikut ini adalah ikhtisar dari beberapa cara untuk memulai tinjauan kode dan cara meminta Amazon Q untuk menjalankan ulasan yang Anda inginkan.
+ Untuk meninjau hanya perubahan kode untuk satu file:
+ Buka file di IDE Anda dan masukkan **Review my code**
+ Masuk **Review the code in **
+ Untuk meninjau seluruh file kode:
+ Buka file tanpa perubahan dan masukkan **Review my code**
+ Buka file dengan perubahan dan masukkan **Review my entire code file**
+ Masuk **Review all the code in **
+ Untuk meninjau semua perubahan kode di repositori Anda:
+ Buka repositori di IDE Anda dan masukkan **Review my code**
+ Untuk meninjau seluruh repositori Anda, bukan hanya perubahan:
+ Buka repositori di IDE Anda dan masukkan **Review my repository**
## Tinjau saat Anda kode
**catatan**
Ulasan otomatis Amazon Q hanya tersedia dengan [langganan Amazon Q Developer Pro](getting-started-q-dev.md).
Ulasan otomatis adalah ulasan berbasis aturan yang didukung oleh detektor [Amazon](https://docs.aws.amazon.com/codeguru/detector-library/) Q. Amazon Q secara otomatis meninjau file yang Anda kodekan secara aktif, menghasilkan masalah kode segera setelah terdeteksi dalam kode Anda. Saat Amazon Q melakukan tinjauan otomatis, Amazon Q tidak menghasilkan perbaikan kode di tempat.
Ulasan otomatis diaktifkan secara default saat Anda menggunakan Amazon Q. Gunakan prosedur berikut untuk menjeda atau melanjutkan tinjauan otomatis.
**Jeda dan lanjutkan ulasan otomatis**
Untuk menjeda ulasan otomatis, selesaikan langkah-langkah berikut.
1. Pilih **Amazon Q** dari bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka.
1. Pilih **Jeda Ulasan Otomatis**. Untuk melanjutkan ulasan otomatis, pilih **Lanjutkan Ulasan Otomatis**.
# Mengatasi masalah kode dengan Pengembang Amazon Q
Topik di bagian ini menjelaskan cara mengatasi dan menyelesaikan masalah kode, dan, jika berlaku, cara mengabaikan masalah.
**Topics**
+ [Mengatasi masalah kode di JetBrains dan Visual Studio Code](address-issues-jetbrains-visualstudiocode.md)
+ [Mengatasi masalah kode di Visual Studio](address-issues-visualstudio.md)
# Mengatasi masalah kode di JetBrains dan Visual Studio Code
Untuk mengatasi masalah kode di JetBrains danVisual Studio Code, Anda akan memiliki opsi untuk membuat perbaikan di tempat atau menghasilkan penjelasan yang dapat Anda gunakan untuk memperbarui kode Anda secara manual.
Anda dapat mengambil tindakan berikut:
+ Hasilkan perbaikan kode di tempat
+ Jelaskan masalahnya dan dapatkan kode baru
+ Abaikan masalah ini, atau abaikan semua masalah serupa
## Hasilkan perbaikan di tempat untuk file Anda
Amazon Q dapat memperbarui file Anda di tempat untuk secara otomatis memperbaiki masalah kode yang terdeteksi.
Untuk secara otomatis memperbaiki masalah kode di file Anda:
------
#### [ JetBrains ]
1. Di jendela Alat **Masalah**, di tab **Masalah Kode Q Amazon**, pilih masalah kode yang ingin Anda atasi.
1. Panel terbuka dengan informasi lebih lanjut tentang masalah kode. Jika berlaku, Anda akan melihat detail tentang detektor Amazon Q yang digunakan untuk mengidentifikasi masalah kode.
1. Di sepanjang bagian bawah panel, pilih **Fix**.
1. Di panel obrolan, Amazon Q memberikan penjelasan singkat tentang perbaikan dan kemudian menerapkan perbaikan di tempat dalam file kode Anda.
1. Anda akan melihat perubahan kode di file Anda, dan memiliki opsi untuk membatalkan perubahan dari panel obrolan.
------
#### [ Kode Studio Visual ]
1. Di tab **Masalah Kode**, pilih masalah kode yang ingin Anda atasi.
1. Pilih ikon kunci pas.
Gambar berikut menunjukkan ikon kunci pas untuk masalah kode di. Visual Studio Code
![\[Ikon kunci pas untuk masalah kode diVisual Studio Code, digunakan untuk menghasilkan perbaikan kode.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/code-review-fix-vsc.png)
1. Di panel obrolan, Amazon Q memberikan penjelasan singkat tentang perbaikan dan kemudian menerapkan perbaikan di tempat dalam file kode Anda.
1. Anda akan melihat perubahan kode di file Anda, dan memiliki opsi untuk membatalkan perubahan dari panel obrolan.
------
## Jelaskan masalah kode dan dapatkan kode baru
Amazon Q dapat memberikan penjelasan mendalam tentang masalah kode dan memberikan opsi perbaikan dengan kode yang menyertainya untuk Anda tambahkan ke file Anda.
Untuk mendapatkan penjelasan tentang masalah kode:
------
#### [ JetBrains IDEs ]
1. Di jendela Alat **Masalah**, di tab **Masalah Kode Q Amazon**, pilih masalah kode yang ingin Anda atasi.
1. Panel terbuka dengan informasi lebih lanjut tentang masalah kode. Jika berlaku, Anda akan melihat detail tentang detektor Amazon Q yang digunakan untuk mengidentifikasi masalah kode.
1. Di bagian bawah panel, pilih **Jelaskan**.
1. Di panel obrolan, Amazon Q memberikan detail tentang masalah ini dan menyarankan cara memperbaikinya, dengan kode yang dapat Anda masukkan ke dalam file Anda.
1. Untuk memperbarui file Anda, ikuti petunjuk Amazon Q untuk menambah atau mengganti kode, dan salin kode yang disediakan di lokasi yang benar di file Anda. Pastikan untuk menghapus kode rentan saat menambahkan kode yang diperbarui.
------
#### [ Kode Studio Visual ]
1. Di tab **Masalah Kode**, pilih masalah kode yang ingin Anda atasi.
1. Pilih ikon kaca pembesar.
Gambar berikut menunjukkan ikon kaca pembesar untuk masalah kode diVisual Studio Code.
![\[Ikon kaca pembesar untuk masalah kode diVisual Studio Code, digunakan untuk menjelaskan masalah kode.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/code-review-view-details-vsc.png)
1. Di panel obrolan, Amazon Q memberikan detail tentang masalah ini dan menyarankan cara memperbaikinya, dengan kode yang dapat Anda masukkan ke dalam file Anda.
1. Untuk memperbarui file Anda, ikuti petunjuk Amazon Q untuk menambah atau mengganti kode, dan salin kode yang disediakan di lokasi yang benar di file Anda. Pastikan untuk menghapus kode rentan saat menambahkan kode yang diperbarui.
------
## Abaikan masalah kode
Jika masalah kode yang terdeteksi tidak berlaku, Anda dapat memilih untuk mengabaikannya, atau mengabaikannya dan semua masalah serupa (masalah dengan CWE yang sama). Masalah akan dihapus dari tab Masalah Kode.
Untuk mengabaikan masalah kode:
------
#### [ JetBrains ]
1. Di jendela Alat **Masalah**, di tab **Masalah Kode Q Amazon**, pilih masalah kode yang ingin Anda abaikan.
1. Panel terbuka dengan informasi lebih lanjut tentang masalah kode. Di bagian bawah panel, pilih **Abaikan**. Masalah kode dihapus dari panel Masalah Kode.
1. Anda juga dapat memilih **Abaikan Semua** untuk mengabaikan ini dan masalah kode lainnya dengan CWE yang sama.
------
#### [ Kode Studio Visual ]
1. Di tab **Masalah Kode**, pilih masalah kode yang ingin Anda abaikan.
1. Pilih ikon abaikan.
Gambar berikut menunjukkan ikon abaikan untuk masalah kode diVisual Studio Code.
![\[Ikon abaikan untuk masalah kode diVisual Studio Code, digunakan untuk mengabaikan dan menutup masalah kode.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/code-review-ignore-issue-vsc.png)
1. Masalah kode dihapus dari panel Masalah Kode.
1. Untuk mengabaikan masalah serupa, pilih ikon elipses, lalu pilih tombol **Abaikan Masalah Serupa** yang muncul.
------
# Mengatasi masalah kode di Visual Studio
Untuk melihat masalah kode yang terdeteksi oleh Amazon Q di Visual Studio, buka **Daftar Kesalahan** Visual Studio dengan memperluas judul **Tampilan** di menu utama Visual Studio dan memilih **Daftar Kesalahan**.
Anda dapat menggunakan informasi dalam masalah kode untuk memperbarui kode Anda. Setelah memperbarui kode Anda, tinjau kode Anda lagi untuk melihat apakah masalah telah diatasi.
Secara default, **Daftar Kesalahan** Visual Studio menampilkan semua peringatan dan kesalahan untuk basis kode Anda. Untuk memfilter masalah kode Q Amazon Anda dari **Daftar Kesalahan** Visual Studio, buat filter dengan menyelesaikan prosedur berikut.
**catatan**
Masalah kode hanya terlihat setelah Anda menjalankan tinjauan kode di mana Amazon Q mendeteksi masalah.
Masalah kode muncul sebagai peringatan di Visual Studio. Untuk melihat masalah yang terdeteksi oleh Amazon Q di **Daftar Kesalahan**, opsi **Peringatan** di judul **Daftar Kesalahan** harus dipilih.
**Masalah kode filter dalam Daftar Kesalahan**
1. Dari menu utama Visual Studio, pilih tampilan dan kemudian **Daftar Kesalahan** untuk membuka panel **Daftar Kesalahan**.
1. Dari panel **Daftar Kesalahan**, klik kanan baris header untuk membuka menu konteks.
1. Dari menu konteks, perluas **Tampilkan Kolom**, lalu pilih **Alat** di menu yang diperluas.
1. Kolom **Alat** ditambahkan ke **Daftar Kesalahan** Anda.
1. Dari header kolom **Alat**, pilih ikon **Filter** dan pilih **Amazon Q** untuk memfilter masalah kode Q Amazon.
# Masalah kode penyaringan
**catatan**
Anda hanya dapat memfilter masalah kode di JetBrains IDEs danVisual Studio Code.
Saat Anda memfilter masalah kode, hanya masalah yang memenuhi kriteria yang dipilih yang ditampilkan di panel Masalah Kode. Anda dapat memfilter masalah berdasarkan tingkat keparahannya sehingga Anda hanya melihat masalah dengan tingkat keparahan yang dipilih di panel.
Anda juga dapat mengontrol bagaimana masalah kode diatur dalam panel Masalah Kode. Anda dapat mengelompokkan masalah berdasarkan tingkat keparahan atau berdasarkan lokasi file mereka.
Untuk memfilter masalah kode:
------
#### [ JetBrains IDEs ]
1. Dari tab **Amazon Q Code Issues**, pilih ikon filter.
1. Menu pop-up dengan tingkat Keparahan terbuka.
Gambar berikut menunjukkan menu Keparahan di tab Masalah Kode diIntelliJ IDEA.
![\[Menu filter keparahan diIntelliJ IDEA.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/jb-filter-issues.png)
1. Pilih atau batalkan pilihan tingkat keparahan yang ingin Anda filter, lalu pilih **OK**. Hanya masalah dengan tingkat keparahan yang Anda pilih yang akan muncul di panel **Masalah Kode Q Amazon**.
------
#### [ Kode Studio Visual ]
1. Dari panel **Masalah Kode**, pilih ikon filter.
Gambar berikut menunjukkan ikon filter di tab Masalah Kode diVisual Studio Code.
![\[Ikon filter di tab Masalah Kode diVisual Studio Code.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/filter-issues-vsc.png)
1. Menu **Masalah Filter** terbuka.
Pilih atau batalkan pilihan kotak di sebelah tingkat keparahan yang ingin Anda filter, lalu pilih **OK**. Hanya masalah dengan tingkat keparahan yang Anda pilih yang akan muncul di panel **Masalah Kode**.
------
Untuk mengelompokkan masalah kode:
------
#### [ JetBrains IDEs ]
1. Dari panel **Masalah Kode Q Amazon**, pilih ikon pengelompokan.
1. Menu pop-up **Grup By** terbuka.
1. Pilih **Keparahan** untuk mengelompokkan masalah di panel Masalah Kode berdasarkan tingkat keparahannya. Pilih **Lokasi** untuk mengelompokkan masalah berdasarkan file kode mana mereka berada.
------
#### [ Kode Studio Visual ]
1. Dari panel **Masalah Kode**, pilih ikon pengelompokan.
Gambar berikut menunjukkan ikon pengelompokan di tab Masalah Kode diVisual Studio Code.
![\[Ikon pengelompokan di tab Masalah Kode diVisual Studio Code.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/group-issues-vsc.png)
1. Menu **Masalah Grup** terbuka.
1. Pilih **Keparahan** untuk mengelompokkan masalah di panel Masalah Kode berdasarkan tingkat keparahannya. Pilih **Lokasi** untuk mengelompokkan masalah berdasarkan file kode mana mereka berada.
------
# Tingkat keparahan masalah kode dalam ulasan kode Pengembang Amazon Q
Amazon Q menentukan tingkat keparahan masalah kode yang terdeteksi dalam kode Anda sehingga Anda dapat memprioritaskan masalah apa yang harus diatasi dan melacak postur keamanan aplikasi Anda. Bagian berikut menjelaskan metode apa yang digunakan untuk menentukan tingkat keparahan masalah kode dan apa arti setiap tingkat keparahan.
## Bagaimana tingkat keparahan dihitung
Tingkat keparahan masalah kode ditentukan oleh detektor yang menghasilkan masalah. [Detektor di [Amazon Q Detector Library](https://docs.aws.amazon.com/codeguru/detector-library) masing-masing diberi tingkat keparahan menggunakan Common Vulnerability Scoring System (CVSS).](https://nvd.nist.gov/vuln-metrics/cvss/v3-calculator) CVSS mempertimbangkan bagaimana temuan dapat dieksploitasi dalam konteksnya (misalnya, dapatkah itu dilakukan melalui internet, atau diperlukan akses fisik) dan tingkat akses apa yang dapat diperoleh.
Tabel berikut menguraikan bagaimana tingkat keparahan ditentukan berdasarkan tingkat akses dan tingkat upaya yang diperlukan agar aktor jahat berhasil menyerang suatu sistem.
**Matriks penentuan keparahan**
| Tingkat akses | Tingkat usaha | Kepelikan |
| --- | --- | --- |
| Kontrol penuh sistem atau outputnya | Membutuhkan akses ke sistem | Tinggi |
| Kontrol penuh sistem atau outputnya | Internet dengan tingkat usaha yang tinggi | Kritis |
| Kontrol penuh sistem atau outputnya | Melalui internet | Kritis |
| Akses ke informasi sensitif | Membutuhkan akses ke sistem | Sedang |
| Akses ke informasi sensitif | Internet dengan tingkat usaha yang tinggi | Tinggi |
| Akses ke informasi sensitif | Melalui internet | Tinggi |
| Dapat crash atau memperlambat sistem | Membutuhkan akses ke sistem | Rendah |
| Dapat crash atau memperlambat sistem | Internet dengan tingkat usaha yang tinggi | Sedang |
| Dapat crash atau memperlambat sistem | Melalui internet | Sedang |
| Memberikan keamanan tambahan | Tidak bisa dieksploitasi | Info |
| Memberikan keamanan tambahan | Membutuhkan akses ke sistem | Info |
| Memberikan keamanan tambahan | Internet dengan tingkat usaha yang tinggi | Rendah |
| Memberikan keamanan tambahan | Melalui internet | Rendah |
| Praktik terbaik | Tidak bisa dieksploitasi | Info |
## Definisi keparahan
Tingkat keparahan didefinisikan sebagai berikut.
**Kritis - Masalah kode harus segera ditangani untuk menghindari eskalasi.**
Masalah kode kritis menunjukkan bahwa penyerang dapat menguasai sistem atau memodifikasi perilakunya dengan upaya moderat. Disarankan agar Anda memperlakukan temuan kritis dengan sangat mendesak. Anda juga harus mempertimbangkan kekritisan sumber daya.
**Tinggi — Masalah kode harus ditangani sebagai prioritas jangka pendek.**
Masalah kode tingkat keparahan tinggi menunjukkan bahwa penyerang dapat menguasai sistem atau memodifikasi perilakunya dengan upaya tinggi. Disarankan agar Anda memperlakukan temuan tingkat keparahan tinggi sebagai prioritas jangka pendek dan Anda segera mengambil langkah-langkah perbaikan. Anda juga harus mempertimbangkan kekritisan sumber daya.
**Medium — Masalah kode harus ditangani sebagai prioritas paruh waktu.**
Temuan tingkat keparahan sedang dapat menyebabkan crash, tidak responsif, atau tidak tersedianya sistem. Disarankan agar Anda menyelidiki kode yang terlibat pada kenyamanan Anda paling awal. Anda juga harus mempertimbangkan kekritisan sumber daya.
**Rendah - Masalah kode tidak memerlukan tindakan sendiri.**
Temuan tingkat keparahan rendah menunjukkan kesalahan pemrograman atau anti-pola. Anda tidak perlu mengambil tindakan segera pada temuan tingkat keparahan rendah, tetapi mereka dapat memberikan konteks ketika Anda menghubungkannya dengan masalah lain.
**Informasi - Tidak ada tindakan yang disarankan.**
Temuan informasi mencakup saran untuk peningkatan kualitas atau keterbacaan, atau operasi API alternatif. Tidak diperlukan tindakan segera.
# Mengubah kode dalam IDE dengan Pengembang Amazon Q
Amazon Q Developer dapat mengubah kode Anda di lingkungan pengembangan terintegrasi (IDEs) dengan melakukan peningkatan dan konversi tingkat bahasa dan sistem operasi (OS) otomatis. Anda memberikan kode yang akan diubah, dan Amazon Q menghasilkan perubahan yang dapat Anda tinjau dan terapkan ke file Anda.
Untuk memulai, instal Amazon Q di IDE yang mendukung transformasi. Kemudian, lihat topik untuk jenis transformasi yang ingin Anda lakukan dengan Amazon Q.
Untuk informasi selengkapnya tentang transformasi dukungan IDEs tersebut dan cara menginstal Amazon Q, lihat[Menggunakan Pengembang Amazon Q di IDE](q-in-IDE.md).
**Topics**
+ [Mengubah aplikasi Java dengan Pengembang Amazon Q](transform-java.md)
+ [Mengubah aplikasi.NET dengan Pengembang Amazon Q](transform-dotnet-IDE.md)
# Mengubah aplikasi Java dengan Pengembang Amazon Q
**catatan**
AWS Transform custom sekarang tersedia untuk upgrade Java. Agentic AI yang menangani peningkatan versi, migrasi SDK, dan lainnya, serta meningkatkan setiap eksekusi. [Memulai](https://docs.aws.amazon.com/transform/latest/userguide/custom-get-started.html)
Amazon Q mendukung jenis transformasi berikut untuk aplikasi Java:
+ Upgrade bahasa Java dan versi ketergantungan
+ Konversi SQL tertanam untuk migrasi database Oracle ke PostgreSQL
Untuk memulai, lihat topik untuk jenis transformasi yang ingin Anda lakukan.
**Topics**
+ [Kuota](#quotas-java-transformation-ide)
+ [Memutakhirkan versi Java dengan Pengembang Amazon Q](code-transformation.md)
+ [Mengonversi SQL tertanam dalam aplikasi Java dengan Amazon Q Developer](transform-sql.md)
+ [Mengubah kode pada baris perintah dengan Pengembang Amazon Q](transform-CLI.md)
+ [Melihat riwayat pekerjaan transformasi](transformation-job-history.md)
+ [Memecahkan masalah dengan transformasi Java](troubleshooting-code-transformation.md)
## Kuota
Transformasi aplikasi Java dengan Amazon Q di IDE dan baris perintah mempertahankan kuota berikut:
+ **Baris kode per pekerjaan** — Jumlah maksimum baris kode yang dapat diubah Amazon Q dalam pekerjaan transformasi tertentu.
+ **Baris kode per bulan** — Jumlah maksimum baris kode yang dapat diubah Amazon Q dalam sebulan.
+ **Pekerjaan Bersamaan** — Jumlah maksimum pekerjaan transformasi yang dapat Anda jalankan pada saat yang bersamaan. Kuota ini berlaku untuk semua transformasi dalam IDE, termasuk [transformasi.NET di Visual Studio](transform-dotnet-IDE.md).
+ **Pekerjaan per bulan** — Jumlah maksimum pekerjaan transformasi yang dapat Anda jalankan dalam satu bulan.
| Sumber daya | Kuota |
| --- | --- |
| Baris kode per pekerjaan | Tingkat gratis: 1000 baris kode |
| Baris kode per bulan | Tingkat gratis: 2000 baris kode |
| Tugas bersamaan | 1 pekerjaan per pengguna 25 lowongan per AWS akun |
| Pekerjaan per bulan | Tingkat pro: 1000 pekerjaan Tingkat gratis: 100 pekerjaan |
# Memutakhirkan versi Java dengan Pengembang Amazon Q
Amazon Q Developer dapat memutakhirkan aplikasi Java Anda ke versi bahasa yang lebih baru di lingkungan pengembangan terintegrasi (IDE). Perubahan yang dapat dilakukan Amazon Q untuk memutakhirkan kode Anda termasuk memperbarui komponen kode yang tidak digunakan lagi dan APIs juga memutakhirkan pustaka, kerangka kerja, dan dependensi lainnya dalam kode Anda.
Untuk mengubah kode Anda, Amazon Q pertama-tama membuat kode Anda dalam versi bahasa sumber dan memverifikasi bahwa ia memiliki informasi yang diperlukan untuk melakukan transformasi. Setelah Amazon Q berhasil mengubah kode Anda, Anda memverifikasi dan menerima perubahan dalam IDE Anda. Karena Amazon Q Developer membuat perubahan minimal yang diperlukan untuk membuat kode yang ditingkatkan kompatibel dengan JDK target, transformasi tambahan diperlukan untuk meningkatkan pustaka dan dependensi proyek Anda. Untuk informasi selengkapnya tentang cara Amazon Q mengubah kode Anda, lihat[Bagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java](how-CT-works.md).
**Topics**
+ [Upgrade Java yang didukung dan IDEs](#supported-languages-IDEs)
+ [Langkah 1: Prasyarat](#java-upgrade-prerequisites)
+ [Langkah 2: Konfigurasikan proyek Anda](#configure-project)
+ [Langkah 3: Buat file peningkatan ketergantungan (opsional)](#create-dependency-upgrade-file)
+ [Langkah 4: Ubah kode Anda](#transform-code-java)
+ [Bagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java](how-CT-works.md)
## Upgrade Java yang didukung dan IDEs
Amazon Q saat ini mendukung versi kode sumber Java berikut dan versi target untuk transformasi. Mengubah kode ke versi Java yang sama mencakup pemutakhiran pustaka dan dependensi lainnya dalam versi kode sumber.
**Upgrade Java yang didukung**
| Versi kode sumber | Versi target yang didukung |
| --- | --- |
| Java 8 | Java 17 dan Java 21 |
| Java 11 | Java 17 dan Java 21 |
| Jawa 17 | Java 17 dan Java 21 |
| Jawa 21 | Java21 |
Amazon Q mendukung peningkatan Java sebagai berikut: IDEs
+ Modul di JetBrains IDEs
+ Proyek dan ruang kerja di Visual Studio Code
## Langkah 1: Prasyarat
Sebelum melanjutkan, pastikan Anda telah menyelesaikan langkah-langkah dalam [Mengatur Amazon Q di IDE Anda](q-in-IDE-setup.md).
Pastikan bahwa prasyarat berikut terpenuhi sebelum Anda memulai pekerjaan Transformasi Kode:
+ Proyek Anda ditulis dalam [Javaversi yang didukung](#supported-languages-IDEs) dan dibangun di atasnyaMaven.
+ Proyek Anda berhasil dibangun dengan Maven IDE Anda. Maven3.8 atau yang lebih baru saat ini didukung.
+ Sumber proyek Anda JDK tersedia secara lokal dan merupakan versi kode sumber Anda. Misalnya, jika Anda mengubah kode Java 8, instalasi JDK lokal Anda harus JDK 8.
+ Proyek Anda dibangun dalam 55 menit atau kurang.
+ Proyek Anda dikonfigurasi dengan benar, dan versi JDK yang benar ditentukan. Untuk informasi selengkapnya, lihat [Langkah 2: Konfigurasikan proyek Anda](#configure-project).
+ Proyek Anda tidak memerlukan akses ke sumber daya di jaringan pribadi Anda, termasuk virtual private cloud (VPC) atau jaringan on-premise. Misalnya, jika proyek Anda berisi pengujian unit yang terhubung ke database di jaringan Anda, transformasi akan gagal.
+ Proyek Anda tidak menggunakan plugin yang mengemas bahasa selain Java di proyek Java Anda. Misalnya, jika proyek Anda menggunakan kode [frontend-maven-plugin](https://github.com/eirslett/frontend-maven-plugin)untuk mengeksekusi front-end selain JavaScript kode sumber Java Anda, transformasi akan gagal.
+ Jaringan lokal Anda memungkinkan unggahan ke bucket Amazon S3 yang digunakan Amazon Q untuk mengubah kode Anda. Untuk informasi selengkapnya, lihat [Mengizinkan akses ke bucket Amazon S3 di](firewall.md#data-perimeters) perimeter data.
+ Aplikasi Anda hanya menggunakan karakter UTF-8. Jika aplikasi Anda menggunakan karakter non-UTF-8, Amazon Q masih akan mencoba mengubah kode Anda.
## Langkah 2: Konfigurasikan proyek Anda
Untuk mengonfigurasi proyek Anda, gunakan informasi berikut untuk IDE yang Anda gunakan.
### Konfigurasikan proyek di JetBrains
Untuk mengonfigurasi proyek AndaJetBrains, Anda mungkin perlu menentukan pengaturan proyek dan modul berikut.
Jika modul Anda menggunakan JDK dan tingkat bahasa yang sama dengan proyek Anda, Anda tidak perlu memperbarui pengaturan modul.
+ Project SDK — JDK yang digunakan untuk mengkompilasi proyek Anda.
+ Tingkat bahasa proyek - Java Versi yang digunakan dalam proyek Anda.
+ Modul SDK - JDK yang digunakan untuk mengkompilasi modul Anda.
+ Tingkat bahasa modul - Java Versi yang digunakan dalam modul Anda.
+ Maven Runner JRE - JDK tempat Anda membangun modul Anda.
**Perbarui pengaturan proyek dan modul**
Untuk memperbarui pengaturan tingkat SDK dan bahasa untuk proyek atau modul Anda, selesaikan langkah-langkah berikut:
1. Dari JetBrains IDE Anda, pilih **File** dan kemudian **Project Structure**.
1. Jendela Struktur Proyek terbuka. Di bawah **Pengaturan Proyek**, pilih **Proyek**.
1. **Untuk memperbarui JDK proyek Anda, pilih dari daftar tarik-turun di samping SDK.**
1. Untuk memperbarui bahasa proyek Anda, pilih dari dropdown di sebelah tingkat **Bahasa**.
1. Di bawah **Pengaturan Proyek**, pilih **Modul**.
1. **Untuk memperbarui modul JDK Anda, pilih dari daftar tarik-turun di sebelah SDK.**
1. Untuk memperbarui bahasa modul Anda, pilih dari dropdown di sebelah tingkat **Bahasa**.
Untuk informasi selengkapnya, lihat [Pengaturan struktur proyek](https://www.jetbrains.com/help/idea/project-settings-and-structure.html) dan [Pengaturan struktur modul](https://www.jetbrains.com/help/idea/configure-modules.html) dalam JetBrains dokumentasi.
**Perbarui pengaturan Maven**
Untuk memperbarui Maven Runner JRE Anda, selesaikan langkah-langkah berikut:
1. Dari JetBrains IDE Anda, pilih ikon roda gigi, lalu pilih **Pengaturan** di menu yang muncul.
1. **Di jendela **Pengaturan**, pilih **Build, Execution, Deployment,** lalu **Build Tools**, lalu **Maven**, dan kemudian Runner.**
1. Di bidang JRE, pilih JDK yang digunakan untuk membangun modul yang Anda ubah.
### Konfigurasikan proyek di VS Code
Untuk mengonfigurasi proyek AndaVS Code, proyek Anda harus berisi yang berikut:
+ `pom.xml`File di folder root proyek
+ Sebuah `.java` file dalam direktori proyek
Jika proyek Anda berisi Maven wrapper executable (`mvnw`untuk macOS atau `mvnw.cmd` untukWindows), pastikan itu di root proyek Anda. Amazon Q akan menggunakan pembungkusnya, dan tidak ada Maven konfigurasi lain yang diperlukan.
Jika Anda tidak menggunakan Maven pembungkus, instalMaven. Untuk informasi selengkapnya, lihat [Menginstal Apache Maven](https://maven.apache.org/install.html) di Apache Maven dokumentasi.
Setelah menginstalMaven, tambahkan ke `PATH` variabel Anda. Untuk informasi lebih lanjut, lihat `runtime` Variabel Java [Bagaimana cara menambahkan Maven ke saya? `PATH`](troubleshooting-code-transformation.md#add-maven-to-path) Anda juga harus menunjuk ke JDK dan bukan ke JRE. Untuk mengonfirmasi konfigurasi Anda benar, jalankan`mvn -v`. Output harus menunjukkan Maven versi Anda dan `runtime` variabel yang menunjuk ke jalur ke JDK Anda.
## Langkah 3: Buat file peningkatan ketergantungan (opsional)
Anda dapat memberikan Amazon Q dengan *file upgrade dependensi, file* YAMAL yang mencantumkan dependensi project Anda dan versi mana yang akan ditingkatkan selama transformasi. Dengan menyediakan file pemutakhiran dependensi, Anda dapat menentukan dependensi pihak ketiga dan pertama yang mungkin tidak diketahui Amazon Q untuk ditingkatkan.
Dependensi pihak pertama mengacu pada pustaka, plugin, dan kerangka kerja yang dikelola organisasi Anda dan hanya tersedia secara lokal atau di jaringan pribadi organisasi Anda. Amazon Q dapat mengakses dependensi pihak pertama Anda saat menjalankan build di lingkungan lokal Anda. Untuk informasi selengkapnya, lihat [Membangun kode di lingkungan lokal Anda](how-CT-works.md#java-local-builds). Dependensi pihak ketiga tersedia untuk umum atau dependensi open source yang tidak unik untuk organisasi Anda.
Anda dapat menentukan dependensi pihak pertama yang ingin Anda tingkatkan dalam file YAMAL, dan Amazon Q memutakhirkannya selama pemutakhiran JDK (misalnya, Java 8 hingga 17). Anda dapat memulai transformasi terpisah (17 hingga 17 atau 21 hingga 21) setelah pemutakhiran JDK awal untuk meningkatkan dependensi pihak ketiga.
Setelah Amazon Q melakukan upgrade JDK minimum, Anda dapat memulai transformasi terpisah untuk memutakhirkan semua dependensi pihak ketiga. Atau, Anda dapat menentukan dependensi pihak ketiga dan versinya dalam file YAMAL untuk hanya memutakhirkan dependensi tersebut selama transformasi pemutakhiran perpustakaan.
Amazon Q akan meminta Anda untuk memberikan file peningkatan ketergantungan selama transformasi. Jika Anda ingin menyediakannya, pertama-tama pastikan Anda telah mengonfigurasi file dengan benar. Bidang berikut diperlukan dalam file YAMM:
+ name - Nama file upgrade dependensi.
+ deskripsi (opsional) - Deskripsi file peningkatan ketergantungan, dan untuk transformasi mana.
+ DependencyManagement - Berisi daftar dependensi dan plugin untuk meng-upgrade.
+ dependensi - Berisi nama dan versi pustaka untuk ditingkatkan.
+ plugins - Berisi nama dan versi plugin untuk meng-upgrade.
+ identifier - Nama perpustakaan, plugin, atau ketergantungan lainnya.
+ TargetVersion - Versi ketergantungan untuk meng-upgrade ke.
+ versionProperty (opsional) - Versi dependensi yang Anda definisikan, seperti yang ditetapkan dengan `properties` tag dalam file aplikasi Anda. `pom.xml`
+ OriginType - Apakah ketergantungan adalah pihak pertama atau ketiga, ditentukan oleh FIRST\$1PARTY atau THIRD\$1PARTY.
Berikut ini adalah contoh file YAMAL pemutakhiran dependensi, dan konfigurasi yang diperlukan untuk diuraikan Amazon Q:
```
name: dependency-upgrade
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
dependencyManagement:
dependencies:
- identifier: "com.example:library1"
targetVersion: "2.1.0"
versionProperty: "library1.version" # Optional
originType: "FIRST_PARTY"
- identifier: "com.example:library2"
targetVersion: "3.0.0"
originType: "THIRD_PARTY"
plugins:
- identifier: "com.example.plugin"
targetVersion: "1.2.0"
versionProperty: "plugin.version" # Optional
originType: "THIRD_PARTY"
```
## Langkah 4: Ubah kode Anda
Untuk menguji penyiapan IDE Anda, unduh dan unzip proyek sampel, dan selesaikan langkah-langkah berikut untuk IDE Anda. Jika Anda dapat melihat perubahan yang diusulkan dan ringkasan transformasi, Anda siap untuk mengubah proyek kode Anda sendiri. Jika transformasi gagal, IDE Anda tidak dikonfigurasi dengan benar. Untuk mengatasi masalah konfigurasi, tinjau [Langkah 2: Konfigurasikan proyek Anda](#configure-project) dan[Pemecahan masalah](troubleshooting-code-transformation.md).
**catatan**
Jangan mematikan, menutup, atau menidurkan mesin lokal Anda selama transformasi kode. Build awal dan validasi menggunakan lingkungan sisi klien, yang membutuhkan koneksi jaringan yang stabil.
Untuk memutakhirkan versi bahasa proyek atau modul kode Anda, selesaikan langkah-langkah berikut untuk IDE Anda.
------
#### [ JetBrains ]
1. Buka modul yang ingin Anda tingkatkanJetBrains. Pastikan Anda telah berhasil membangun proyek Anda di IDE.
1. Pilih logo Amazon Q, dan minta Amazon Q untuk mengubah aplikasi Anda di panel obrolan yang terbuka.
1. Muncul pop-up **Transform aplikasi Anda**. **Pilih proyek yang ingin Anda tingkatkan dari daftar dropdown, lalu pilih Transform.**
1. Amazon Q meminta Anda untuk menyediakan file ketergantungan pemutakhiran. Jika Anda telah mengonfigurasi YAMAL dengan dependensi dan versi untuk ditingkatkan, tambahkan file Anda. Amazon Q akan memvalidasi file untuk memastikannya dikonfigurasi dengan benar. Jika Anda mendapatkan kesalahan, tinjau format dan bidang wajib yang dijelaskan di[Langkah 3: Buat file peningkatan ketergantungan (opsional)](#create-dependency-upgrade-file).
1. Amazon Q memulai transformasi. Anda dapat melihat kemajuan pada tab **Detail transformasi**.
1. Setelah transformasi selesai, Anda dapat memverifikasi kode yang ditingkatkan sebelum memperbarui proyek Anda. Untuk melihat kode baru, buka tab **Transformation details** dan kemudian pilih **View diff**. Di jendela **Terapkan tambalan** yang muncul, pilih file untuk membuka tampilan diff dengan kode sumber dan kode yang ditingkatkan.
1. Untuk menerima perubahan yang dibuat Amazon Q, pilih **View diff** untuk membuka jendela **Apply patch**. Pilih semua file yang diperbarui, dan pilih **OK** untuk memperbarui proyek Anda di tempat.
1. Untuk mendapatkan detail tentang cara kode Anda ditingkatkan dan disarankan langkah selanjutnya, pada tab **Detail transformasi**, pilih **Lihat ringkasan transformasi**.
------
#### [ Kode Studio Visual ]
1. Buka proyek atau ruang kerja yang ingin Anda tingkatkan. VS Code Pastikan bahwa Anda telah berhasil membangun proyek Anda di IDE.
1. Pilih logo Amazon Q, dan minta Amazon Q untuk mengubah aplikasi Anda di panel obrolan yang terbuka.
1. Pilih proyek yang ingin Anda tingkatkan dari bilah pencarian di bagian atas IDE.
1. Jika Amazon Q tidak dapat menemukan versi kode sumber Anda, Amazon Q meminta Anda untuk memilih versi kode Anda. Pilih versi tempat kode sumber Anda ditulis, lalu pilih **Transform** di pop-up untuk melanjutkan.
1. Jika diminta, masukkan `JAVA_HOME` jalur ke JDK Anda. Untuk informasi selengkapnya, lihat [Mengonfigurasi VS Code proyek Anda](#configure-vsc).
1. Amazon Q meminta Anda untuk menyediakan file ketergantungan pemutakhiran. Jika Anda telah mengonfigurasi YAMAL dengan dependensi dan versi untuk ditingkatkan, tambahkan file Anda. Amazon Q akan memvalidasi file untuk memastikannya dikonfigurasi dengan benar. Jika Anda mendapatkan kesalahan, tinjau format dan bidang wajib yang dijelaskan di[Langkah 3: Buat file peningkatan ketergantungan (opsional)](#create-dependency-upgrade-file).
1. Amazon Q memulai transformasi. Anda dapat melihat kemajuan pada tab **Transformation Hub**.
1. Setelah transformasi selesai, tab **Perubahan yang Diusulkan** terbuka. Untuk memverifikasi kode yang ditingkatkan sebelum memperbarui proyek Anda, pilih **Unduh perubahan yang diusulkan**. Pilih file untuk membuka tampilan diff dengan kode sumber dan kode yang ditingkatkan.
1. Untuk menerima perubahan yang dibuat Amazon Q, buka tab **Perubahan yang Diusulkan** dan pilih **Terima**.
1. Untuk mendapatkan detail tentang cara kode Anda ditingkatkan dan disarankan langkah selanjutnya, pada **Transformation Hub**, pilih tombol elipsis **Views and More Actions**, lalu pilih **Show** Transformation Summary.
------
# Bagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java
Untuk mengubah kode Anda, Amazon Q Developer membuat rencana transformasi yang digunakan untuk meningkatkan versi bahasa kode proyek Anda. Setelah mengubah kode Anda, ini memberikan ringkasan transformasi dan perbedaan file bagi Anda untuk meninjau perubahan sebelum menerimanya. Karena Amazon Q Developer membuat perubahan minimal yang diperlukan untuk membuat kode yang ditingkatkan kompatibel dengan JDK target, transformasi tambahan diperlukan untuk meningkatkan pustaka dan dependensi proyek Anda. Bagian berikut memberikan rincian lebih lanjut tentang bagaimana Amazon Q melakukan transformasi.
## Membangun kode Anda dan membuat rencana transformasi
Untuk mulai mengubah kode Anda, Amazon Q membangun proyek Anda secara lokal dan menghasilkan artefak build yang berisi kode sumber, dependensi proyek, dan log build.
Setelah membuat artefak build, Amazon Q membuat kode Anda di lingkungan build yang aman dan membuat rencana transformasi, yang disesuaikan dengan proyek atau modul yang Anda upgrade. Rencana transformasi menguraikan perubahan spesifik yang akan dilakukan Amazon Q, termasuk versi dependensi baru, perubahan kode utama, dan penggantian yang disarankan untuk kode yang tidak digunakan lagi. Perubahan ini didasarkan pada pembuatan awal kode Anda, dan mungkin berubah selama transformasi.
## Mengubah kode Anda
Untuk mengubah kode Anda, Amazon Q mencoba memutakhirkan kode Anda ke versi Java target berdasarkan perubahan yang diusulkan dalam rencana transformasi. Saat membuat perubahan, ia membangun kembali dan menjalankan pengujian unit yang ada di kode sumber Anda untuk memperbaiki kesalahan yang ditemui secara berulang. Upgrade JDK dapat dilakukan dari versi kode sumber berikut ke versi target:
+ Java 8 hingga 17
+ Java 8 hingga 21
+ Jawa 11 hingga 17
+ Java 11 hingga 21
+ Java 17 hingga 21
Amazon Q membuat perubahan minimal yang diperlukan untuk membuat kode Anda kompatibel dengan versi Java target. Setelah Amazon Q melakukan upgrade JDK minimum, Anda dapat memulai transformasi terpisah untuk memutakhirkan semua dependensi pihak ketiga. Atau, Anda dapat menentukan dependensi pihak ketiga dan versinya dalam file YAMAL untuk hanya memutakhirkan dependensi tersebut selama transformasi pemutakhiran perpustakaan.
Amazon Q mencoba membuat perubahan berikut saat memutakhirkan kode Anda:
+ Perbarui komponen kode usang sesuai dengan rekomendasi versi Java target
+ Tingkatkan pustaka dan kerangka kerja populer ke versi yang kompatibel dengan versi Java target. Ini termasuk memperbarui pustaka dan kerangka kerja berikut ke versi utama terbaru yang tersedia:
+ Apache Commons IO
+ Apache HttpClient
+ bc-fips
+ Mentimun-JVM
+ Hibernasi
+ jackson-annotations
+ JakartaEE
+ Javax
+ javax.servlet
+ jaxb-api
+ jaxb-impl
+ jaxen
+ jcl-over-slf4j
+ json sederhana
+ jsr305
+ junit
+ junit-jupiter-api
+ Log4j
+ Mikronaut
+ Mockito
+ mockito-inti
+ Okio
+ PowerMockito
+ Quarkus
+ slf4j
+ slf4j-api
+ Sepatu Bot Musim Semi
+ Kerangka Musim Semi
+ Keamanan Musim Semi
+ Kesombongan
+ testng
**catatan**
Jangan mematikan atau menutup mesin lokal Anda selama transformasi kode karena build sisi klien memerlukan koneksi jaringan yang stabil.
## Membangun kode di lingkungan lokal Anda
Selama transformasi, Amazon Q melakukan build verifikasi di lingkungan lokal Anda. Amazon Q mengubah kode Anda di sisi server dalam beberapa langkah. Setelah setiap langkah, Amazon Q mengirimkan kode ke lingkungan lokal Anda untuk membangun dan menguji perubahan yang dibuatnya. Kode kemudian dikirim kembali ke sisi server untuk melanjutkan transformasi.
Build di lingkungan lokal Anda membantu memverifikasi kode yang diubah dengan mengizinkan Amazon Q menjalankan pengujian yang memerlukan akses ke sumber daya pribadi. Untuk meminimalkan risiko keamanan yang terkait dengan pembuatan kode yang dihasilkan AI di lingkungan lokal Anda, Amazon Q meninjau dan memperbarui kode yang dihasilkannya untuk mengatasi masalah keamanan.
## Meninjau ringkasan transformasi dan menerima perubahan
Setelah transformasi selesai, Amazon Q memberikan ringkasan transformasi dengan detail tentang perubahan yang dibuat, termasuk status build akhir yang menunjukkan apakah seluruh proyek Anda ditingkatkan. Anda juga dapat melihat ringkasan log build untuk memahami masalah apa pun yang mencegah Amazon Q membuat kode Anda dalam versi yang ditingkatkan.
Ringkasan transformasi juga mencakup perbedaan antara perubahan yang diusulkan dalam rencana transformasi dan perubahan yang akhirnya dibuat Amazon Q untuk meningkatkan kode Anda, dan perubahan tambahan apa pun yang tidak ada dalam paket awal.
Setelah meninjau ringkasan transformasi, Anda dapat melihat perubahan yang diusulkan Amazon Q dalam tampilan diff file. Perubahan kode apa pun yang disarankan Amazon Q tidak akan memengaruhi file proyek Anda saat ini hingga Anda menerima perubahan tersebut. Kode yang diubah tersedia hingga 30 hari setelah transformasi selesai.
## Menyelesaikan transformasi yang berhasil sebagian
Bergantung pada kompleksitas dan spesifikasi basis kode Anda, mungkin ada contoh di mana transformasi sebagian berhasil. Ini berarti Amazon Q hanya dapat mengubah file atau area kode tertentu dalam proyek Anda. Dalam hal ini, Anda harus memperbarui kode yang tersisa secara manual agar proyek Anda dapat dibangun dalam versi bahasa yang diperbarui.
Untuk membantu mengubah sisa kode Anda, Anda dapat menggunakan obrolan Amazon Q di IDE. Anda dapat meminta Amazon Q untuk meninjau file yang diperbarui sebagian dan memberikan kode baru untuk mengatasi masalah, seperti kesalahan kompilasi. Anda juga dapat menggunakan fitur seperti [Pengembangan fitur](q-in-IDE-chat.md#develop-code) dan [konteks Workspace](workspace-context.md) untuk menyertakan lebih banyak proyek Anda sebagai konteks dan mendapatkan saran untuk beberapa file sekaligus.
# Mengonversi SQL tertanam dalam aplikasi Java dengan Amazon Q Developer
Agen Amazon Q Developer untuk transformasi kode dalam IDE dapat membantu Anda mengonversi SQL tertanam untuk menyelesaikan migrasi database Oracle ke PostgreSQL dengan (DMS). AWS Database Migration Service AWS
AWS DMS adalah layanan cloud yang memungkinkan untuk memigrasikan database relasional, gudang data, database NoSQL, dan jenis penyimpanan data lainnya. Konversi Skema DMS di AWS DMS membantu Anda mengonversi skema database dan objek kode yang dapat Anda terapkan ke database target Anda. Untuk informasi lebih lanjut, lihat [Apa itu AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html) dalam *AWS Database Migration Service User Guide*.
Saat Anda menggunakan Konversi Skema AWS DMS dan DMS untuk memigrasikan database, Anda mungkin perlu mengonversi SQL yang disematkan di aplikasi agar kompatibel dengan basis data target Anda. Daripada mengonversinya secara manual, Anda dapat menggunakan Amazon Q di IDE untuk mengotomatiskan konversi. Amazon Q menggunakan metadata dari Konversi Skema DMS untuk mengonversi SQL yang disematkan di aplikasi Anda ke versi yang kompatibel dengan basis data target Anda.
Saat ini, Amazon Q dapat mengonversi SQL dalam aplikasi Java untuk database Oracle yang bermigrasi ke PostgreSQL. Anda hanya akan melihat opsi untuk mengubah kode SQL di IDE jika aplikasi Anda berisi pernyataan Oracle SQL. Lihat prasyarat untuk informasi lebih lanjut.
## Langkah 1: Prasyarat
Sebelum melanjutkan, pastikan Anda telah menyelesaikan langkah-langkah dalam [Mengatur Amazon Q di IDE Anda](q-in-IDE-setup.md).
Sebelum Anda memulai pekerjaan transformasi kode untuk konversi SQL, pastikan prasyarat berikut terpenuhi:
+ Anda memigrasi aplikasi Java dengan SQL tertanam dari database Oracle ke database PostgreSQL. Aplikasi Anda harus berisi pernyataan Oracle SQL agar memenuhi syarat untuk transformasi.
+ Anda telah menyelesaikan proses untuk mengonversi skema database Anda menggunakan Konversi Skema AWS DMS. *Untuk informasi selengkapnya, lihat [Memigrasi database Oracle ke Amazon RDS for PostgreSQL](https://docs.aws.amazon.com/dms/latest/sbs/schema-conversion-oracle-postgresql.html) dengan Konversi Skema DMS dalam Panduan Migrasi Database.*
+ Setelah konversi skema selesai, Anda telah mengunduh file proyek migrasi dari konsol AWS DMS.
## Langkah 2: Konfigurasikan aplikasi Anda
Untuk mengonversi kode SQL tertanam, proyek Java Anda harus berisi setidaknya satu `.java` file.
Jika Anda menggunakan JetBrains IDE, Anda harus mengatur bidang SDK dalam pengaturan Struktur Proyek ke JDK yang berlaku. Untuk informasi tentang mengonfigurasi pengaturan Struktur Proyek, lihat [Pengaturan struktur proyek](https://www.jetbrains.com/help/idea/project-settings-and-structure.html) dalam JetBrains dokumentasi.
## Langkah 3: Konversi SQL tertanam
Untuk mengonversi kode SQL tertanam dalam aplikasi Java Anda ke format yang kompatibel dengan basis data target PostgreSQL Anda, selesaikan langkah-langkah berikut:
1. Di IDE tempat Amazon Q diinstal, buka basis kode Java yang berisi SQL tertanam yang perlu Anda konversi.
1. Pilih ikon Amazon Q untuk membuka panel obrolan.
1. Minta Amazon Q untuk mengubah aplikasi Anda di panel obrolan.
1. Jika aplikasi Java Anda memenuhi syarat untuk konversi SQL, Amazon Q akan meminta Anda untuk memilih jenis transformasi yang ingin Anda lakukan. Masukkan **SQL conversion**.
1. Amazon Q meminta Anda untuk mengunggah file metadata skema yang Anda ambil dari Amazon S3. Dalam obrolan, Amazon Q memberikan instruksi untuk mengambil file.
1. Amazon Q meminta Anda untuk menyediakan proyek yang berisi SQL tertanam serta file skema database. Pilih file yang sesuai dari menu tarik-turun di panel obrolan.
1. Konfirmasikan detail Amazon Q yang diambil dari skema database akurat.
1. Amazon Q mulai mengonversi kode SQL Anda. Ini mungkin memakan waktu beberapa menit.
1. Setelah Amazon Q mengonversi kode SQL, ia memberikan perbedaan dengan pembaruan apa pun yang telah dibuat untuk file Anda. Tinjau perubahan dalam perbedaan, lalu terima perubahan untuk memperbarui kode Anda.
Amazon Q juga menyediakan ringkasan transformasi dengan detail tentang perubahan yang dibuatnya.
1. Setelah memperbarui kode Anda, kembali ke konsol AWS DMS untuk memverifikasi SQL baru kompatibel dengan database yang dimigrasi.
# Mengubah kode pada baris perintah dengan Pengembang Amazon Q
Anda dapat mengubah aplikasi Anda dari baris perintah dengan alat transformasi baris perintah Amazon Q Developer. Untuk mengubah kode Anda, Anda menyediakan jalur ke kode sumber Anda dan file konfigurasi yang diperlukan, dan Amazon Q menghasilkan kode baru dalam serangkaian langkah. Sepanjang transformasi, Amazon Q membuat kode di lingkungan lokal Anda untuk memverifikasi perubahan. Untuk informasi selengkapnya, lihat [Membangun kode di lingkungan lokal Anda](#local-builds). Amazon Q membuat cabang baru di repositori Anda di mana ia melakukan perubahan kode. Ketika transformasi selesai, Anda dapat menggabungkan cabang ke cabang asli Anda untuk memasukkan perubahan ke dalam basis kode Anda.
Untuk memulai, instal alat baris perintah dan otentikasi, lalu lihat perintah untuk mengkonfigurasi dan memulai transformasi.
**Topics**
+ [Membangun kode di lingkungan lokal Anda](#local-builds)
+ [Commands](#commands)
+ [Menjalankan transformasi pada baris perintah dengan Pengembang Amazon Q](run-CLI-transformations.md)
+ [Pemecahan masalah transformasi pada baris perintah](troubleshooting-CLI-transformations.md)
+ [Riwayat versi alat transformasi baris perintah Pengembang Amazon Q](transform-CLI-versions.md)
## Membangun kode di lingkungan lokal Anda
Selama transformasi, Amazon Q melakukan build verifikasi di lingkungan lokal Anda. Amazon Q mengubah kode Anda di sisi server dalam beberapa langkah. Setelah setiap langkah, Amazon Q mengirimkan kode ke lingkungan lokal Anda untuk membangun dan menguji perubahan yang dibuatnya. Kode kemudian dikirim kembali ke sisi server untuk melanjutkan transformasi.
Build di lingkungan lokal Anda membantu memverifikasi kode yang diubah dengan mengizinkan Amazon Q menjalankan pengujian yang memerlukan akses ke sumber daya pribadi. Untuk meminimalkan risiko keamanan yang terkait dengan pembuatan kode yang dihasilkan AI di lingkungan lokal Anda, Amazon Q meninjau dan memperbarui kode yang dihasilkannya untuk mengatasi masalah keamanan.
**catatan**
Amazon Q melakukan transformasi berdasarkan permintaan, deskripsi, dan konten proyek Anda. Untuk menjaga keamanan, hindari menyertakan artefak eksternal yang tidak diperiksa di repositori proyek Anda dan selalu validasi kode yang diubah untuk fungsionalitas dan keamanan.
## Commands
Untuk step-by-step instruksi untuk menjalankan perintah ini, lihat[Menjalankan transformasi pada baris perintah dengan Pengembang Amazon Q](run-CLI-transformations.md).
Untuk mengonfigurasi transformasi dan mengautentikasi ke Amazon Q Developer Pro, jalankan:
```
qct configure
```
Untuk memulai transformasi untuk Java upgrade, jalankan perintah berikut. Untuk**, Anda dapat memasukkan`JAVA_1.8`,`JAVA_8`,`JAVA_11`,`JAVA_17`, atau`JAVA_21`. Untuk**, Anda dapat memasukkan salah satu `JAVA_17` atau`JAVA_21`. Keduanya `--source_version` dan `--target_version` bersifat opsional. `--trust`Bendera memungkinkan transformasi berjalan saat memeriksa kode untuk menjaga keamanan.
```
qct transform --source_folder
--source_version
--target_version
--trust
```
Untuk memulai transformasi SQL konversi, jalankan:
```
qct transform --source_folder
--sql_conversion_config_file
```
Untuk melihat versi alat baris perintah untuk transformasi yang Anda gunakan, jalankan:
```
qct -v
```
Untuk mendapatkan bantuan dengan transformasi, jalankan:
```
qct -h
```
Untuk melihat riwayat pekerjaan transformasi Anda, jalankan:
```
qct history
```
Untuk informasi selengkapnya tentang melihat dan mengelola riwayat pekerjaan transformasi Anda, lihat[Melihat riwayat pekerjaan di baris perintah](transformation-job-history.md#cli-job-history).
# Menjalankan transformasi pada baris perintah dengan Pengembang Amazon Q
Selesaikan langkah-langkah ini untuk mengubah kode Anda pada baris perintah dengan alat baris perintah Amazon Q Developer.
## Prasyarat
Sebelum Anda memulai transformasi pada baris perintah, prasyarat berikut harus dipenuhi:
+ Jika Anda memutakhirkan versi kode Java Anda, proyek Anda memenuhi [prasyarat untuk meningkatkan versi Java dengan Amazon Q](code-transformation.md#java-upgrade-prerequisites).
+ Jika Anda mengonversi SQL tertanam dalam aplikasi Java, aplikasi Anda memenuhi [prasyarat untuk mengonversi](transform-sql.md#sql-transform-prereqs) SQL tertanam dengan Amazon Q.
+ Anda telah menginstal Python di lingkungan baris perintah Anda. Ini adalah bagaimana Anda akan menginstal alat baris perintah. Versi Python minimum yang didukung adalah 3.12.
+ Anda menjalankan transformasi di macOS atau Linux.
+ Ukuran aplikasi Anda adalah 2 GB atau lebih kecil.
+ Jika Anda memiliki dependensi tertentu yang ingin ditingkatkan Amazon Q, Anda telah mengonfigurasi file pemutakhiran [dependensi](#step-3-dependency-upgrade-file).
## Langkah 1: Pilih metode otentikasi dan tambahkan izin
Anda dapat mengautentikasi IAM Identity Center untuk menjalankan transformasi pada baris perintah. Pastikan Anda memiliki izin yang tepat.
**catatan**
Kunci terkelola pelanggan tidak didukung untuk transformasi yang dilakukan pada baris perintah.
### Tambahkan izin
Identitas IAM yang terkait dengan langganan Pengembang Amazon Q yang Anda gunakan untuk mengautentikasi harus memiliki izin untuk melakukan transformasi pada baris perintah. Sebelum melanjutkan, pastikan identitas IAM Anda memiliki izin yang ditentukan. [Izinkan pengguna menjalankan transformasi pada baris perintah](id-based-policy-examples-users.md#id-based-policy-examples-allow-cli-transformations)
### Autentikasi dengan IAM Identity Center melalui langganan Amazon Q Developer
Untuk mengautentikasi dengan IAM Identity Center, Anda [harus berlangganan Amazon Q Developer Pro sebagai pengguna tenaga kerja](subscribe-users.md) oleh administrator Anda, dan Anda harus memberikan URL Mulai untuk mengautentikasi melalui langganan Anda. Anda atau administrator Anda dapat menemukan URL Mulai di konsol Pengembang Amazon Q. Untuk informasi selengkapnya, lihat [Menemukan URL Mulai untuk digunakan dengan Pengembang Amazon Q](manage-account-details.md).
Untuk menambahkan izin yang diperlukan, lihat[Tambahkan izin](#transform-CLI-add-permissions).
Anda memberikan URL Mulai di[Langkah 4: Konfigurasikan dan otentikasi](#step-4-configure-auth).
## Langkah 2: Instal alat
1. [Unduh alat baris perintah Amazon Q untuk transformasi](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.2.zip) dan unzip.
Untuk mengunduh versi sebelumnya dari alat baris perintah, lihat[Riwayat versi](transform-CLI-versions.md).
1. Kami menyarankan Anda mengatur lingkungan virtual dengan Python untuk menginstal alat. Untuk membuat lingkungan virtual, buka jendela terminal di direktori tempat Anda ingin menginstal alat dan jalankan:
```
python -m venv qct-cli
```
1. Untuk mengaktifkan lingkungan virtual, jalankan:
```
source qct-cli/bin/activate
```
1. Untuk menginstal alat pada baris perintah Anda, jalankan perintah berikut dengan jalur ke tempat Anda membuka ritsleting alat, berdasarkan arsitektur mesin Anda:
------
#### [ Linux\$1aarch64 ]
```
pip install /Linux_aarch64/amzn_qct_cli-1.2.2-py3-none-any.whl
```
------
#### [ Linux\$1x86\$164 ]
```
pip install /Linux_x86_64/amzn_qct_cli-1.2.2-py3-none-any.whl
```
------
**catatan**
Jika Anda menggunakan versi lama dari alat baris perintah untuk transformasi, ganti `1.2.2` dengan [versi](transform-CLI-versions.md) yang Anda unduh.
1. Untuk memverifikasi bahwa alat telah diinstal, jalankan:
```
which qct
```
## Langkah 3: Buat file peningkatan ketergantungan (opsional)
Anda dapat memberikan Amazon Q dengan *file upgrade dependensi, file* YAMAL yang mencantumkan dependensi project Anda, dan versi mana yang akan ditingkatkan selama transformasi. Dengan menyediakan file pemutakhiran dependensi, Anda dapat menentukan dependensi pihak ketiga dan pertama yang mungkin tidak diketahui Amazon Q untuk ditingkatkan.
Dependensi pihak pertama mengacu pada pustaka, plugin, dan kerangka kerja yang dikelola organisasi Anda dan hanya tersedia secara lokal atau di jaringan pribadi organisasi Anda. Amazon Q dapat mengakses dependensi pihak pertama Anda saat menjalankan build di lingkungan lokal Anda. Untuk informasi selengkapnya, lihat [Membangun kode di lingkungan lokal Anda](transform-CLI.md#local-builds). Dependensi pihak ketiga tersedia untuk umum atau dependensi open source yang tidak unik untuk organisasi Anda.
Anda dapat menentukan dependensi pihak pertama yang ingin Anda tingkatkan dalam file YAMAL, dan Amazon Q memutakhirkannya selama pemutakhiran JDK (misalnya, Java 8 hingga 17). Anda dapat memulai transformasi terpisah (17 hingga 17 atau 21 hingga 21) setelah pemutakhiran JDK awal untuk meningkatkan dependensi pihak ketiga.
Setelah Amazon Q melakukan upgrade JDK minimum, Anda dapat memulai transformasi terpisah untuk memutakhirkan semua dependensi pihak ketiga. Atau, Anda dapat menentukan dependensi pihak ketiga dan versinya dalam file YAMAL untuk hanya memutakhirkan dependensi tersebut selama transformasi pemutakhiran perpustakaan.
Amazon Q akan meminta Anda untuk memberikan file peningkatan ketergantungan selama transformasi. Jika Anda ingin menyediakannya, pertama-tama pastikan Anda telah mengonfigurasi file dengan benar. Bidang berikut diperlukan dalam file YAMM:
+ name - Nama file upgrade dependensi.
+ deskripsi (opsional) - Deskripsi file peningkatan ketergantungan, dan untuk transformasi mana.
+ DependencyManagement - Berisi daftar dependensi dan plugin untuk meng-upgrade.
+ dependensi - Berisi nama dan versi pustaka untuk ditingkatkan.
+ plugins - Berisi nama dan versi plugin untuk meng-upgrade.
+ identifier - Nama perpustakaan, plugin, atau ketergantungan lainnya.
+ TargetVersion - Versi ketergantungan untuk meng-upgrade ke.
+ versionProperty (opsional) - Versi dependensi yang Anda definisikan, seperti yang ditetapkan dengan `properties` tag dalam file aplikasi Anda. `pom.xml`
+ OriginType - Apakah ketergantungan adalah pihak pertama atau ketiga, ditentukan oleh FIRST\$1PARTY atau THIRD\$1PARTY.
Berikut ini adalah contoh file YAMM pemutakhiran dependensi, dan konfigurasi yang diperlukan untuk diuraikan Amazon Q:
```
name: dependency-upgrade
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
dependencyManagement:
dependencies:
- identifier: "com.example:library1"
targetVersion: "2.1.0"
versionProperty: "library1.version" # Optional
originType: "FIRST_PARTY"
- identifier: "com.example:library2"
targetVersion: "3.0.0"
originType: "THIRD_PARTY"
plugins:
- identifier: "com.example.plugin"
targetVersion: "1.2.0"
versionProperty: "plugin.version" # Optional
originType: "THIRD_PARTY"
```
## Langkah 4: Konfigurasikan dan otentikasi
Sebelum Anda dapat memulai transformasi, Anda harus mengautentikasi dengan IAM Identity Center dan memberikan detail konfigurasi untuk transformasi Anda.
1. Untuk memulai proses konfigurasi transformasi, jalankan perintah berikut:
```
qct configure
```
1. Anda diminta untuk memasukkan jalur JDK untuk setiap versi Java yang didukung. Anda hanya perlu menentukan jalur ke JDK versi sumber aplikasi Java Anda, bukan versi target.
1. Selanjutnya, untuk mengautentikasi dengan IAM Identity Center, Anda diminta untuk memasukkan URL awal untuk profil langganan Amazon Q Developer Pro Anda.
Kemudian, masukkan Wilayah AWS tempat Anda berlangganan dalam format berikut:`us-east-1`. Untuk mengetahui daftar Wilayah yang didukung, lihat [Wilayah yang Didukung](regions.md). Untuk daftar kode Wilayah, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) dalam *Referensi Umum AWS panduan*.
1. Preferensi konfigurasi Anda disimpan ke file configuration.ini.
## Langkah 5: Jalankan transformasi
Pilih jenis transformasi yang Anda lakukan untuk melihat konfigurasi dan perintah yang diperlukan.
**catatan**
Jangan mematikan atau menutup mesin lokal Anda selama transformasi kode karena build sisi klien memerlukan koneksi jaringan yang stabil.
------
#### [ Java upgrade ]
**Memodifikasi rencana transformasi**
Selama upgrade versi Java, Amazon Q menghasilkan rencana transformasi yang dapat Anda tinjau sebelum transformasi dimulai. Anda memiliki opsi untuk meminta perubahan berikut pada paket:
+ Pustaka mana yang ditingkatkan Amazon Q, dari daftar yang termasuk dalam paket
+ Contoh petunjuk:
+ Hanya upgrade,, dan
+ Jangan upgrade atau
+ Versi target untuk memutakhirkan pustaka ke
+ Contoh petunjuk:
+ Tingkatkan ke versi ini sebagai gantinya
+ Langkah mana yang harus dilakukan Amazon Q
+ Contoh petunjuk:
+ Hanya selesaikan langkah 1-7
+ Jangan menjalankan langkah 5-9
+ Tambahkan dependensi tambahan untuk meningkatkan (hanya opsi saat memutakhirkan ke versi JDK yang lebih baru)
+ Contoh petunjuk:
+ Juga tingkatkan ke
**Tingkatkan kode Java**
1. Jalankan perintah berikut untuk memulai transformasi untuk upgrade Java. Ganti `` dengan path ke folder dengan kode yang Anda ubah dan `` dengan salah satu `JAVA_17` atau`JAVA_21`.
```
qct transform --source_folder
--target_version
```
Opsi perintah tambahan:
+ Jika Anda menentukan dependensi untuk ditingkatkan, tambahkan `--dependency_upgrade_file` opsi dengan jalur ke file peningkatan ketergantungan Anda.
+ Jika Anda tidak ingin meninjau atau memperbarui rencana transformasi, tambahkan `--no-interactive` bendera ke perintah Anda. Amazon Q tidak akan meminta umpan balik tentang rencana tersebut, dan Anda tidak akan memiliki kesempatan untuk meminta perubahan.
1. Versi Maven Anda diverifikasi sebelum transformasi dimulai. Jika Anda memiliki setidaknya versi minimum yang didukung, Anda akan melihat output berikut:
```
Running command: mvn --version at: path/to/current/directory
Your Maven version is supported for transformations.
```
Jika Anda tidak memiliki versi Maven yang didukung, Anda harus memperbaruinya untuk melanjutkan. Untuk informasi selengkapnya, lihat [Prasyarat](#CLI-transformation-prerequisites).
1. Jika Anda tidak menambahkan `--no-interactive` bendera, Amazon Q akan meminta Anda untuk memberikan umpan balik tentang rencana transformasi. Anda dapat menjelaskan perubahan yang ingin Anda buat dalam bahasa alami bahasa Inggris, dan Amazon Q akan memperbarui paket jika dapat mendukung perubahan yang Anda minta.
1. Amazon Q memulai transformasi. Ini akan menampilkan pembaruan status selama transformasi. Setelah selesai, Amazon Q menyediakan jalur di mana hasil transformasi, log, dan file konfigurasi dikeluarkan.
Kode Anda yang ditingkatkan akan berkomitmen ke cabang baru Amazon Q yang dibuat. Amazon Q akan mengkomit kode dalam satu atau beberapa komit, tergantung pada pilihan yang Anda buat saat menjalankan`qct configure`.
1. Jika Anda menjalankan transformasi lain setelah memutakhirkan versi Java Anda, mulailah transformasi kedua di cabang yang sama tempat Anda melakukan perubahan dari transformasi pertama.
------
#### [ SQL conversion ]
Sebelum Anda mulai, pastikan Anda telah membaca [Mengonversi SQL tertanam dalam aplikasi Java dengan Amazon Q Developer](transform-sql.md) untuk memahami prasyarat untuk jenis transformasi ini.
1. [Untuk mengonversi SQL yang disematkan, Anda harus terlebih dahulu membuat file YAMAL yang berisi jalur ke file metadata skema dari Konversi Skema Anda.AWS DMS](https://docs.aws.amazon.com/dms/latest/sbs/schema-conversion-oracle-postgresql.html)
Berikut ini adalah format file yang diperlukan:
```
schema_conv_metadata_path:
```
1. Jalankan perintah berikut untuk memulai transformasi untuk konversi SQL. Ganti `` dengan path ke folder dengan kode yang Anda ubah dan `` dengan path ke file YAMAL yang Anda buat di langkah 1.
```
qct transform --source_folder
--sql_conversion_config_file
```
1. Jika Amazon Q menemukan beberapa skema dalam file metadata skema Anda, Amazon Q akan menghentikan transformasi dan memberikan daftar skema yang terdeteksi. Pilih skema mana yang akan digunakan untuk konversi SQL, lalu tambahkan bidang baru `schema: ` ke file YAMM.
1. Amazon Q memulai transformasi. Ini akan menampilkan pembaruan status selama transformasi. Setelah selesai, Amazon Q menyediakan jalur di mana hasil transformasi, log, dan file konfigurasi dikeluarkan.
Kode Anda yang ditingkatkan akan berkomitmen ke cabang baru Amazon Q yang dibuat.
------
## Jeda atau batalkan transformasi
Anda dapat memilih untuk menjeda atau membatalkan pekerjaan transformasi Anda saat ini. Anda dapat menjeda pekerjaan transformasi hingga 12 jam sebelum Anda dapat melanjutkan lagi.
**Untuk menjeda atau membatalkan pekerjaan transformasi kode**
1. Di terminal CLI Anda, tekan **Ctrl\$1C** pada keyboard Anda.
1. Pilih apakah Anda ingin menjeda atau membatalkan tranformasi Anda.
+ Masukkan `1` jika Anda ingin melakukan pekerjaan transformasi kode. Anda dapat melanjutkan pekerjaan dalam waktu 12 jam untuk melanjutkan transformasi kode menggunakan perintah QCT berikut:``qct transform --source_folder=≤/Path/Given/Originally/To/QCT>``.
+ Masukkan `2` jika Anda ingin membatalkan pekerjaan tranformasi kode.
# Pemecahan masalah transformasi pada baris perintah
Informasi berikut dapat membantu Anda memecahkan masalah umum saat mengubah aplikasi pada baris perintah dengan Amazon Q Developer.
## Mengapa token pembawa saya tidak menyegarkan?
Jika Anda melihat kesalahan berikut, itu berarti Anda perlu menyegarkan token pembawa yang digunakan untuk otentikasi.
```
Refreshing bearer token
('Error refreshing bearer token due to: ', InvalidGrantException('An error occurred (InvalidGrantException) when calling the CreateToken operation: '))
('Error getting bearer token due to: ', RuntimeError(('Error refreshing bearer token due to: ', InvalidGrantException('An error occurred (InvalidGrantException) when calling the CreateToken operation: '))))
```
Untuk mengatasi kesalahan ini, jalankan perintah berikut:
```
rm ~/.aws/qcodetransform/credentials.json
```
Setelah Anda menghapus file kredensi yang sudah ketinggalan zaman, jalankan `qct transform` lagi untuk memulai ulang transformasi.
## Mengapa versi terbaru dari alat baris perintah tidak digunakan?
Saat Anda mengunduh versi baru alat baris perintah untuk transformasi, terkadang versi alat sebelumnya masih digunakan.
Untuk membuat Anda menggunakan versi terbaru dari alat ini, unduh [versi terbaru](transform-CLI-versions.md). Kemudian jalankan perintah berikut dengan jalur ke tempat Anda membuka ritsleting alat, berdasarkan arsitektur mesin Anda:
------
#### [ Linux\$1aarch64 ]
```
pip install /Linux_aarch64/amzn_qct_cli-1.2.2-py3-none-any.whl --force-reinstall
```
------
#### [ Linux\$1x86\$164 ]
```
pip install /Linux_x86_64/amzn_qct_cli-1.2.2-py3-none-any.whl --force-reinstall
```
------
**catatan**
Jika Anda menggunakan versi lama alat baris perintah untuk transformasi, ganti `1.2.2` dengan [versi](transform-CLI-versions.md) yang Anda unduh.
# Riwayat versi alat transformasi baris perintah Pengembang Amazon Q
Tinjau informasi berikut untuk detail tentang rilis alat transformasi baris perintah Amazon Q Developer saat ini dan masa lalu. Tabel ini mencakup tautan unduhan, tanggal rilis, dan catatan rilis untuk setiap versi.
****
| Versi | Tanggal rilis | Catatan rilis |
| --- | --- | --- |
| [1.2.2 (terbaru)](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.2.zip) | Februari 26, 2026 | Menambahkan banner promosi untuk AWS Transform custom ke QCT CLI. Tampilan banner pada eksekusi perintah transformasi dan teks bantuan. Bendera --skip-banner baru untuk menekan output banner. |
| [1.2.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.1.zip) | September 9, 2025 | Memperbarui ekstensi Maven untuk menyertakan induk pihak pertama POMs selama unggahan proyek awal |
| [1.2.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.0.zip) | Agustus 7, 2025 | Ditambahkan dukungan untuk melihat riwayat pekerjaan dan untuk visualisasi struktur modul untuk proyek Maven Java. |
| [1.1.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.1.0.zip) | Juli 21, 2025 | Termasuk dukungan untuk mengumpulkan telemetri tentang transformasi. |
| [1.0.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.0.0.zip) | Juni 27, 2025 | Alat transformasi baris perintah umumnya tersedia dan mendukung otentikasi melalui AWS IAM Identity Center dengan langganan Amazon Q Developer Pro saja. Menambahkan dukungan untuk langganan di Wilayah Eropa (Frankfurt). |
| [0.6.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.6.0.zip) | Juni 6, 2025 | Termasuk dukungan untuk menyediakan file peningkatan ketergantungan dan iterasi pada rencana transformasi. |
| [0.5.2](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.2.zip) | April 16, 2025 | Perbaikan bug untuk menyelesaikan masalah saat melanjutkan pekerjaan dan kegagalan untuk aplikasi dengan dependensi pihak pertama. |
| [0.5.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.1.zip) | Maret 13, 2025 | Ketika Anda mengautentikasi dengan IAM, Anda tidak perlu lagi memberikan. Wilayah AWS Juga termasuk perbaikan bug untuk memasukkan status pekerjaan di log keluaran. |
| [0.5.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.0.zip) | Februari 28, 2025 | Termasuk dukungan untuk otentikasi dengan IAM melalui. AWS CLI |
| [0.4.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.4.1.zip) | Februari 17, 2025 | Perbaikan bug untuk menyertakan dukungan untuk memasuki Wilayah AWS tempat langganan Pengembang Amazon Q Anda dikonfigurasi. |
| [0.4.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.4.0.zip) | Februari 14, 2025 | Termasuk dukungan untuk upgrade aplikasi Java ke Java 21. |
| [0.3.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.3.0.zip) | Februari 12, 2025 | Termasuk dukungan untuk mengonversi SQL tertanam dalam aplikasi Java. |
| [0.2.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.2.0.zip) | Februari 3, 2025 | Termasuk dukungan untuk menerima kode Java yang ditingkatkan dalam beberapa komit. |
| [0.1.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.1.0.zip) | November 27, 2024 | Pelepasan awal. Termasuk dukungan untuk memutakhirkan versi kode Java dari baris perintah. |
# Melihat riwayat pekerjaan transformasi
Amazon Q memberikan ikhtisar komprehensif tentang riwayat pekerjaan transformasi Java Anda, memungkinkan Anda untuk melacak dan meninjau pekerjaan transformasi Anda di keduanya IDEs dan baris perintah.
Riwayat pekerjaan transformasi mencakup informasi berikut tentang suatu pekerjaan:
+ **Tanggal** - Ketika pekerjaan transformasi dilaksanakan
+ **Nama proyek** — Nama proyek yang diubah
+ **Status** — Status pekerjaan transformasi saat ini
+ **Durasi** — Berapa lama transformasi selesai
+ **Job ID** — Pengenal unik untuk pekerjaan transformasi
+ **Diff patch** - Sebuah link atau path ke file patch diff akhir yang menunjukkan semua perubahan kode
+ **Ringkasan** — Tautan atau jalur ke file ringkasan transformasi dengan detail tentang perubahan yang dilakukan
**catatan**
Hanya transformasi yang dijalankan sejak fitur ini dirilis yang akan tersedia dalam riwayat pekerjaan. Untuk tanggal rilis fitur, lihat[Riwayat dokumen untuk Panduan Pengguna Pengembang Amazon Q](doc-history.md).
## Melihat riwayat pekerjaan di IDEs
**catatan**
Fitur ini saat ini Visual Studio Code hanya tersedia di.
Hub Transformasi Visual Studio Code memberikan pandangan komprehensif tentang riwayat pekerjaan transformasi Java Anda.
Tabel di Hub Transformasi mencantumkan 10 pekerjaan transformasi terbaru Anda dari 30 hari terakhir. Dari tabel, Anda dapat mengakses artefak transformasi dan menyegarkan pekerjaan untuk melacak kemajuan dan mendapatkan artefak yang hilang.
### Ambil artefak transformasi
Anda dapat mengakses artefak transformasi, seperti patch diff dan file ringkasan, dari tabel riwayat pekerjaan. Pilih tautan yang sesuai untuk membuka perbedaan atau ringkasan di IDE Anda.
Artefak disimpan secara lokal di `.aws/transform` direktori, sehingga Anda juga dapat mengakses artefak transformasi yang diunduh sebelumnya dari pekerjaan sebelumnya.
### Segarkan status pekerjaan
Anda dapat menyegarkan status pekerjaan dari tabel riwayat pekerjaan. Segarkan pekerjaan yang gagal untuk mendapatkan status yang diperbarui dari sisi server yang mungkin belum mencapai server Anda, seperti saat Amazon Q dapat melanjutkan pekerjaan yang gagal. Anda juga dapat menyegarkan pekerjaan yang telah selesai untuk mengunduh artefak yang mungkin belum muncul.
### Bagaimana riwayat pekerjaan disimpan untuk pekerjaan yang dijalankan di IDE
UntukVisual Studio Code, semua informasi pekerjaan transformasi dan artefak disimpan secara lokal di direktori. `.aws/transform` Penyimpanan diatur sebagai berikut:
```
.aws/transform/
├── [project-name-1]/
│ ├── [job-id-1]/
│ │ ├── diff.patch
│ │ ├── [summary-1]/
│ │ │ └── summary.md
│ │ │ └── buildCommandOutput.log
│ └── [job-id-2]/
│ ├── diff.patch
│ ├── [summary-2]/
│ │ └── summary.md
│ │ └── buildCommandOutput.log
└── [project-name-2]/
└── [job-id-3]/
├── diff.patch
├── [summary-3]/
│ └── summary.md
│ └── buildCommandOutput.log
```
## Melihat riwayat pekerjaan di baris perintah
Untuk transformasi pada baris perintah, **qct history** perintah menyediakan akses ke riwayat pekerjaan transformasi Anda dengan opsi penyesuaian.
Untuk CLI, informasi riwayat pekerjaan transformasi disimpan secara lokal di direktori. `.aws/qcodetransform/history/`
### Menggunakan perintah qct history
Perintah dasar untuk melihat riwayat pekerjaan transformasi Anda adalah:
```
qct history
```
Secara default, perintah ini menampilkan 10 pekerjaan transformasi terbaru, selain pekerjaan yang dijeda atau sedang berlangsung.
Anda juga dapat menentukan berapa banyak entri riwayat pekerjaan yang akan ditampilkan dengan **--limit** bendera. Misalnya, untuk menampilkan 20 pekerjaan, jalankan:
```
qct history --limit 20
```
# Memecahkan masalah dengan transformasi Java
Informasi berikut dapat membantu Anda memecahkan masalah umum saat mengubah aplikasi Java dengan Amazon Q Developer.
**Topics**
+ [Mengapa Amazon Q tidak dapat mengunggah proyek saya?](#project-upload-fail)
+ [Mengapa Maven perintah saya gagal?](#maven-commands-failing)
+ [Bagaimana cara menambahkan Maven ke saya? `PATH`](#add-maven-to-path)
+ [Mengapa Amazon Q tidak dapat membangun kode saya?](#build-fail)
+ [Mengapa transformasi saya gagal setelah 55 menit?](#build-time-limit)
+ [Mengapa saya tidak dapat mengunduh kode saya yang diubah?](#download-code-fail)
+ [Bagaimana cara mengakses log transformasi kode?](#logs)
+ [Bagaimana cara menemukan ID pekerjaan transformasi saya?](#job-id)
## Mengapa Amazon Q tidak dapat mengunggah proyek saya?
Jika proyek Anda gagal diunggah, kemungkinan karena salah satu masalah berikut. Lihat topik yang sesuai dengan kesalahan yang Anda lihat dari Amazon Q.
**Topics**
+ [Kurangi ukuran proyek](#reduce-project-size)
+ [Konfigurasikan pengaturan proxy di IDE Anda](#configure-proxy)
+ [Izinkan akses ke Amazon S3](#allowlist-s3-bucket)
### Kurangi ukuran proyek
Untuk mengubah kode Anda, Amazon Q menghasilkan artefak proyek, yang mencakup kode sumber, dependensi proyek, dan log build. Ukuran artefak proyek maksimum untuk pekerjaan transformasi adalah 2 GB. Jika Anda mendapatkan kesalahan terkait dengan ukuran artefak proyek, Anda harus mengurangi ukuran proyek Anda atau mencoba mengubah proyek yang lebih kecil. Anda dapat melihat ukuran file artefak proyek Anda di log transformasi kode. Untuk informasi selengkapnya, lihat [Bagaimana cara mengakses log transformasi kode?](#logs)
### Konfigurasikan pengaturan proxy di IDE Anda
Untuk mengubah kode Anda, Amazon Q mengunggah artefak proyek Anda ke bucket Amazon S3 milik layanan. Bagian dari proses upload melibatkan penggunaan sertifikat SSL atau TLS untuk menjalin komunikasi antara Amazon S3 dan IDE Anda. Jika Anda menggunakan server proxy, sertifikat SSL atau TLS yang digunakan oleh server proxy Anda harus dipercaya, jika tidak Amazon Q tidak dapat mengunggah proyek Anda.
Jika Anda menerima kesalahan terkait proxy atau sertifikat, Anda mungkin perlu mengonfigurasi IDE atau sistem operasi untuk mempercayai sertifikat atau memperbarui pengaturan proxy lainnya.
**catatan**
Anda mungkin juga mengalami masalah yang tidak terkait dengan sertifikat jika Anda berada di belakang server proxy atau firewall organisasi Anda. Jika Anda menyelesaikan prosedur berikut untuk mengonfigurasi sertifikat dan masih mengalami masalah, hubungi administrator jaringan untuk memastikan Anda diizinkan berkomunikasi dengan Amazon S3 dari IDE Anda. Untuk informasi selengkapnya, lihat [Izinkan akses ke Amazon S3](#allowlist-s3-bucket).
#### Konfigurasikan sertifikat di JetBrains
Untuk mengonfigurasi JetBrains IDE Java Runtime Environment (JRE) agar mempercayai sertifikat SSL atau TLS yang digunakan oleh server proxy Anda, Anda harus mengimpor sertifikat SSL atau TLS ke file di JRE. `cacerts` `cacerts`File ini adalah file yang berisi sertifikat root tepercaya untuk koneksi aman seperti HTTPS dan SSL, dan itu adalah bagian dari pengaturan keamanan JRE. Untuk mengimpor sertifikat, selesaikan prosedur berikut.
**catatan**
Sebaiknya buat cadangan `cacerts` file sebelum memodifikasinya, karena kesalahan apa pun dapat menyebabkan masalah dengan koneksi aman.
1. Tentukan jalur ke `cacerts` file di JRE Anda. Jalur `cacerts` file di JRE internal yang dikirimkan bersama JetBrains IDE Anda bergantung pada sistem operasi dan versi JetBrains IDE yang Anda gunakan.
Berikut ini adalah contoh jalur ke `cacerts` file dalam sistem operasi umum. Pilih sistem operasi Anda untuk melihat contoh.
**catatan**
``mengacu pada direktori tempat JetBrains produk diinstal. Direktori ini biasanya dipilih selama proses instalasi.
`jbr`Folder mewakili JRE yang dibundel JetBrains IDEs, yang merupakan versi spesifik dari JRE yang disesuaikan untuk digunakan. JetBrains IDEs
------
#### [ Windows ]
Jalur `cacerts` file untuk JetBrains IDE yang diinstal pada Windows adalah:
```
\jbr\bin\cacerts
```
Misalnya, jika Anda menginstal JetBrains IDE di Windows di lokasi default, jalurnya mungkin:
```
C:\Program Files\JetBrains\jbr\bin\cacerts
```
------
#### [ macOS ]
Jalur `cacerts` file untuk JetBrains IDE yang diinstal pada macOS adalah:
```
/Applications/JetBrains Toolbox//JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts
```
Misalnya, jika Anda menginstal JetBrains IDE di macOS di lokasi default, jalurnya mungkin:
```
/Applications/JetBrains Toolbox/2022.3.4/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts
```
------
#### [ Linux ]
Jalur `cacerts` file untuk JetBrains IDE yang diinstal di Linux adalah:
```
/opt/jetbrains/jbr/lib/security/cacerts
```
------
1. Tentukan sertifikat yang perlu Anda impor ke `cacerts` file. File sertifikat biasanya memiliki`.cer`,`.crt`, atau ekstensi `.der` file. Jika Anda tidak yakin sertifikat mana yang perlu Anda tambahkan, hubungi administrator jaringan Anda.
1. Impor sertifikat ke `cacerts` keystore. Anda dapat melakukan ini dengan `keytool` perintah Java.
1. Buka prompt perintah dan masukkan perintah berikut:
```
keytool -import -alias -file -keystore
```
1. Untuk``, Anda dapat menambahkan nama untuk sertifikat yang Anda impor untuk merujuknya nanti. Opsi ini opsional.
1. Untuk``, tentukan jalur ke sertifikat yang Anda impor. Ini harus menjadi jalur ke`.cer`,`.crt`, atau `.der` file yang berisi sertifikat.
1. Untuk``, tentukan jalur ke file `cacerts` keystore yang Anda simpan di langkah 1. Ini adalah file tempat Anda mengimpor sertifikat.
Misalnya, jika Anda ingin mengimpor sertifikat bernama `my_certificate.cer` ke `cacerts` keystore JRE yang dibundel IntelliJ IDEA di Windows, dan Anda ingin memberikan alias `myalias` ke sertifikat, perintahnya mungkin:
```
keytool -import -alias myalias -file my_certificate.cer -keystore "C:\Program Files\JetBrains\IntelliJ IDEA 2022.3.2\jbr\bin\cacerts"
```
1. Selama proses impor, Anda akan diminta untuk memasukkan kata sandi keystore. Kata sandi default untuk `cacerts` keystore adalah`changeit`.
1. Setelah menjalankan perintah, Anda akan diminta untuk mempercayai sertifikat. Untuk mengonfirmasi sertifikat dipercaya dan menyelesaikan impor, masukkan`yes`.
1. Anda mungkin juga perlu menambahkan sertifikat ke IDE itu sendiri, selain JRE. Untuk informasi selengkapnya, lihat [Sertifikat Server](https://www.jetbrains.com/help/idea/settings-tools-server-certificates.html) dalam JetBrains dokumentasi.
#### Konfigurasikan sertifikat di Visual Studio Code
Visual Studio CodeUntuk mengonfigurasi agar mempercayai sertifikat SSL atau TLS yang digunakan oleh server proxy Anda, pastikan Anda telah mengonfigurasi pengaturan proxy berikut untuk sistem operasi Anda.
##### Konfigurasikan sertifikat Visual Studio Code di macOS
Konfigurasikan pengaturan proxy berikut untuk Visual Studio Code di macOS.
##### Tambahkan sertifikat ke gantungan kunci macOS Anda
Jika Anda belum melakukannya, Anda harus menambahkan sertifikat yang digunakan oleh server proxy Anda ke macOS gantungan kunci Anda. Untuk informasi tentang menambahkan sertifikat ke gantungan kunci Anda, lihat [Menambahkan sertifikat ke gantungan kunci menggunakan Akses Rantai Kunci di Mac di Panduan Pengguna Akses](https://support.apple.com/guide/keychain-access/add-certificates-to-a-keychain-kyca2431/mac) Rantai Kunci.
##### Instal VSCode ekstensi Mac CA
[ VSCode Ekstensi Mac CA](https://marketplace.visualstudio.com/items?itemName=linhmtran168.mac-ca-vscode) memungkinkan Amazon Q mengakses sertifikat yang Anda tambahkan ke Keychain Access di Mac Anda.
Untuk menginstal ekstensi:
1. Cari `mac-ca-vscode` di panel VS Code ekstensi, dan pilih **Instal**.
1. Mulai ulang VS Code.
##### Perbarui pengaturan proxy VS Code di macOS
Perbarui pengaturan berikut untuk memastikan VS Code dikonfigurasi dengan benar untuk proxy Anda.
1. Buka pengaturan diVS Code.
1. Masukkan `proxy` ke bilah pencarian.
1. Di bidang **Http: Proxy**, tambahkan URL proxy Anda.
1. Batalkan pilihan **Http: Proxy SSL Ketat**.
1. **Dalam daftar dropdown **Http: Proxy Support**, pilih.**
1. Di bilah pencarian pengaturan, masukkan`http.experimental.systemCertificatesV2`. Pilih **Http › Eksperimental: Sertifikat Sistem V2**.
##### Konfigurasikan sertifikat Visual Studio Code di Windows
Konfigurasikan pengaturan proxy berikut untuk Visual Studio Code di Windows.
##### Tambahkan sertifikat sebagai sertifikat root tepercaya di Windows
Jika Anda belum melakukannya, Anda harus menambahkan sertifikat yang digunakan oleh server proxy Anda ke toko Otoritas Sertifikasi Root Tepercaya Anda di Windows. Untuk menambahkan sertifikat, selesaikan prosedur berikut:
1. Buka alat pencarian atau jendela perintah Jalankan.
1. Masukkan yang berikut ini untuk membuka alat Certificate Manager:
```
certmgr.msc
```
1. Pilih toko **Otoritas Sertifikasi Root Tepercaya**.
1. Klik kanan **Sertifikat**, pilih **Semua Tugas**, lalu pilih **Impor**... .
1. Ikuti petunjuk yang diberikan untuk mengimpor sertifikat proxy Anda.
1. Setelah Anda mengimpor sertifikat, konfirmasikan sertifikat telah ditambahkan.
Di toko **Otoritas Sertifikasi Root Tepercaya**, klik dua kali **Sertifikat**. Klik kanan sertifikat yang Anda tambahkan dan pilih **Properties**. Di bawah **tujuan Sertifikat**, opsi **Aktifkan semua tujuan untuk sertifikat ini** harus dipilih.
##### Instal ekstensi Win-CA VSCode
[ VSCode Ekstensi Win-CA memungkinkan](https://marketplace.visualstudio.com/items?itemName=ukoloff.win-ca) Amazon Q untuk mengakses sertifikat yang Anda tambahkan ke Sertifikat Root Tepercaya di Windows.
Untuk menginstal ekstensi:
1. Cari `win-ca ` di panel VS Code pengaturan.
1. **Dalam daftar dropdown **Inject**, pilih append.**
##### Perbarui pengaturan proxy VS Code di Windows
Perbarui pengaturan berikut untuk memastikan VS Code dikonfigurasi dengan benar untuk proxy Anda.
1. Buka pengaturan diVS Code.
1. Masukkan `proxy` ke bilah pencarian.
1. Di bidang **Http: Proxy**, tambahkan URL proxy Anda.
1. Batalkan pilihan **Http: Proxy SSL Ketat**.
1. **Dalam daftar dropdown **Http: Proxy Support**, pilih.**
1. Di bilah pencarian pengaturan, masukkan`http.experimental.systemCertificatesV2`. Pilih **Http › Eksperimental: Sertifikat Sistem V2**.
1. Mulai ulang VS Code.
### Izinkan akses ke Amazon S3
Selama transformasi, Amazon Q mengunggah kode Anda ke bucket Amazon S3 milik layanan. Jika jaringan atau organisasi Anda belum mengonfigurasi akses ke Amazon S3, Amazon Q tidak dapat mengunggah proyek Anda.
Untuk memastikan Amazon Q dapat mengunggah proyek Anda, pastikan konfigurasi proxy dan komponen jaringan lainnya, seperti kebijakan Pencegahan Hilang Data (DLP), dikonfigurasi untuk mengizinkan akses ke Amazon S3. Anda mungkin juga perlu mengizinkan daftar bucket Amazon S3 tempat Amazon Q mengunggah proyek Anda. Untuk informasi selengkapnya, lihat [Bucket Amazon S3 URLs dan ARNs daftar yang diizinkan](firewall.md#data-perimeters).
Jika Anda mengubah proyek besar, kebijakan DLP atau komponen jaringan lainnya dapat menyebabkan penundaan dan mencegah unggahan berhasil jika tidak dikonfigurasi untuk mengizinkan bucket Amazon S3. Jika Anda memilih untuk tidak mengizinkan daftar bucket, Anda mungkin perlu mengubah proyek yang lebih kecil sehingga Amazon Q dapat mengunggahnya.
## Mengapa Maven perintah saya gagal?
Berikut ini adalah masalah Maven konfigurasi yang mungkin Anda lihat di JetBrains dan Visual Studio Code IDEs. Jika Anda mengatasi masalah dan masih melihat Maven kesalahan, mungkin ada masalah dengan proyek Anda. Gunakan informasi di log kesalahan untuk mengatasi masalah apa pun dengan proyek Anda, lalu coba ubah proyek Anda lagi.
### Perbarui Maven konfigurasi di JetBrains
Jika transformasi gagal JetBrains karena masalah Maven perintah, log kesalahan muncul di tab **Jalankan**. Gunakan informasi di log untuk mengatasi masalah ini. Berikut adalah beberapa masalah yang mungkin perlu Anda atasi:
+ Pastikan jalur Maven rumah Anda diatur ke **Bundled**. Buka **Pengaturan**, lalu perluas bagian **Build, Execution, Deployment**. Perluas bagian **Build Tools** dan kemudian perluas **Maven**. **Dalam daftar dropdown **jalur rumah Maven**, pilih Dibundel.**
+ Pastikan bahwa lingkungan Java runtime (JRE) menggunakan JDK proyek Anda. Buka **Pengaturan**, lalu perluas bagian **Build, Execution, Deployment**. Perluas **Maven**dan pilih **Runner**. Dalam daftar dropdown **JRE**, pilih **Use** Project JDK.
+ Pastikan itu Maven diaktifkan. Buka **Pengaturan** dan pilih **Plugin**. Cari Maven dan pilih Maven plugin. Jika Anda melihat tombol **Aktifkan**, pilih tombol untuk mengaktifkanMaven.
### Perbarui Maven konfigurasi di Visual Studio Code
Jika transformasi gagal VS Code karena masalah Maven perintah, file teks yang berisi log kesalahan terbuka di tab baru. Gunakan informasi di log untuk mengatasi masalah ini.
Pastikan Anda telah mengonfigurasi salah satu dari opsi berikut:
+ Proyek Anda berisi Maven pembungkus di folder root proyek
+ Versi yang Maven didukung oleh Amazon Q tersedia di Anda `PATH`
Untuk informasi selengkapnya, lihat [Bagaimana cara menambahkan Maven ke saya? `PATH`](#add-maven-to-path)
## Bagaimana cara menambahkan Maven ke saya? `PATH`
Untuk mengubah kode Anda VS Code tanpa menggunakan Maven pembungkus, Anda harus menginstal Maven dan menambahkannya ke `PATH` variabel Anda.
Untuk memeriksa apakah Anda telah Maven menginstal dengan benar, jalankan `mvn -v` di terminal OS baru di luarVisual Studio Code. Anda akan melihat output dengan Maven versi Anda.
Jika Anda mendapatkan output di Visual Studio Code terminal Anda tetapi tidak di terminal OS Anda, atau jika perintah tidak ditemukan, Anda perlu menambahkan Maven ke terminal Anda`PATH`.
Untuk menambahkan Maven ke Anda`PATH`, ikuti instruksi untuk mesin Anda.
------
#### [ macOS ]
Untuk menambahkan Maven ke macOS Anda`PATH`, selesaikan langkah-langkah berikut.
1. Temukan direktori Maven instalasi Anda, atau folder tempat Anda menginstalMaven, dan simpan jalur ke folder itu.
1. Buka file konfigurasi untuk shell Anda di editor pilihan Anda. Untuk versi macOS terbaru, shell default adalah `zsh` dan file konfigurasi default terletak di. `~/.zshrc`
Tambahkan baris berikut ke bagian bawah file konfigurasi. Tetapkan nilai `M2_HOME` ke jalur yang Anda simpan di langkah 1:
```
export M2_HOME="your Maven installation directory"
export PATH="${M2_HOME}/bin:${PATH}"
```
Perintah ini membuat `mvn` perintah tersedia di semua terminal.
1. Tutup semua jendela terminal OS dan keluar dari semua Visual Studio Code instance.
1. Untuk memverifikasi bahwa Maven telah ditambahkan ke Anda`PATH`, buka terminal OS baru dan jalankan perintah berikut:
```
mvn -v
```
Anda akan melihat output dengan Maven versi Anda.
1. Setelah melihat Maven output Anda, restartVisual Studio Code. Anda mungkin juga perlu me-restart mesin Anda. Buka Visual Studio Code terminal baru dan jalankan perintah berikut:
```
mvn -v
```
Output harus identik dengan output pada langkah 4. Jika Visual Studio Code outputnya berbeda, coba yang berikut ini untuk memastikan pengaturan Anda benar:
+ Periksa `PATH` variabel Anda diVisual Studio Code. Ekstensi IDE mungkin mengubah `PATH` sedemikian rupa sehingga berbeda dari `PATH` variabel lokal Anda. Copot pemasangan ekstensi untuk menghapusnya dari ekstensi Anda`PATH`.
+ Periksa shell default Anda diVisual Studio Code. Jika disetel ke sesuatu selain`zsh`, ulangi langkah-langkah ini untuk shell Anda.
------
#### [ Windows ]
MavenUntuk menambah Anda Windows`PATH`, selesaikan langkah-langkah berikut:
1. Temukan direktori Maven instalasi Anda, atau folder tempat Anda menginstalMaven, dan simpan jalur ke folder itu.
1. Buka jendela Variabel Lingkungan:
1. Pilih Windows tombol untuk membuka bilah pencarian.
1. Masuk `Edit environment variables for your account` dan pilih.
1. Di jendela **Variabel Lingkungan**, cari variabel Path. Jika Anda sudah memiliki variabel Path, pilih **Edit...** untuk memperbaruinya. Jika Anda tidak melihat variabel Path, pilih **New...** untuk menambahkan satu.
1. Di jendela **Edit variabel lingkungan** yang muncul, klik dua kali jalur yang ada untuk mengeditnya, atau pilih **Baru** untuk menambahkan entri jalur baru.
Ganti entri Maven jalur yang ada dengan jalur yang Anda simpan di langkah 1, atau tambahkan jalur sebagai entri baru. Di akhir jalur, tambahkan `\bin` sebagai sufiks, seperti pada contoh berikut:
```
C:\Users\yourusername\Downloads\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin
```
1. Pilih **OK** untuk menyimpan entri jalur, lalu pilih **OK** lagi di jendela **Variabel Lingkungan**.
1. Buka Command Prompt baru dan jalankan perintah berikut:
```
mvn -v
```
Anda akan melihat output dengan Maven versi Anda.
------
## Mengapa Amazon Q tidak dapat membangun kode saya?
Jika transformasi gagal saat Amazon Q membuat kode Anda, proyek Anda mungkin tidak dikonfigurasi dengan benar untuk lingkungan tempat Amazon Q membuat kode Anda. Anda mungkin perlu memperbarui konfigurasi build atau implementasi kode.
Tinjau keluaran log build yang disediakan Amazon Q untuk menentukan apakah ada perubahan yang dapat Anda lakukan pada proyek Anda. Berikut ini adalah beberapa masalah umum yang mungkin mencegah Amazon Q membuat kode Anda.
### Hapus jalur absolut di pom.xml
Jika Anda memiliki jalur absolut dalam file pom.xml, Amazon Q tidak akan dapat menemukan file yang relevan, dan akibatnya mungkin tidak dapat membuat kode Anda.
Berikut ini adalah contoh jalur absolut yang dapat Anda miliki di `pom.xml` file Anda:
```
/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar
```
Alih-alih menggunakan jalur absolut, Anda dapat membuat jalur relatif menggunakan pointer. Berikut ini adalah contoh bagaimana Anda dapat mengganti jalur absolut sebelumnya dengan jalur relatif:
```
${java.home}/../lib/tools.jar
```
### Hapus database lokal atau eksternal dalam pengujian unit
Amazon Q menjalankan pengujian unit apa pun dalam proyek Anda saat membuat kode Anda. Jika pengujian unit memanggil database lokal atau eksternal, Amazon Q tidak akan memiliki akses ke database, menyebabkan build gagal. Untuk mencegah build gagal, Anda harus menghapus panggilan database dari pengujian unit atau menghapus pengujian unit sebelum mengirimkan transformasi.
## Mengapa transformasi saya gagal setelah 55 menit?
Jika pekerjaan transformasi kode Anda gagal setelah 55 menit, waktu pembuatan kode Anda kemungkinan melebihi batas waktu pembuatan. Saat ini ada batas waktu 55 menit untuk membuat kode Anda.
Jika waktu pembuatan lokal Anda membutuhkan waktu 55 menit atau lebih, kurangi waktu pembuatan proyek Anda untuk mengubah kode Anda. Jika build lokal Anda lebih cepat daripada build dengan Code Transformation, periksa proyek Anda untuk tugas yang mungkin gagal atau memakan waktu lebih lama di lingkungan yang berbeda. Pertimbangkan untuk menonaktifkan kasus uji yang berjalan lama. Juga pertimbangkan untuk menggunakan batas waktu untuk upaya mengakses sumber daya yang mungkin tidak tersedia dari lingkungan IDE yang aman atau internet.
## Mengapa saya tidak dapat mengunduh kode saya yang diubah?
Jika Anda tidak dapat mengunduh kode Anda setelah transformasi Anda selesai, kemungkinan karena salah satu masalah berikut. Lihat topik yang sesuai dengan kesalahan yang Anda lihat dari Amazon Q.
**Topics**
+ [Kurangi ukuran proyek](#reduce-project-size-output)
+ [Unduh kode diff dalam waktu 30 hari](#download-30-hrs)
+ [Konfigurasikan pengaturan proxy di IDE Anda](#configure-proxy-download)
+ [Hapus karakter wildcard dalam pengaturan JetBrains proxy](#remove-wildcard)
### Kurangi ukuran proyek
Setelah transformasi selesai, Amazon Q menghasilkan artefak keluaran yang berisi perbedaan dengan kode yang ditingkatkan dan ringkasan transformasi dengan informasi tentang perubahan yang dibuatnya. Artefak keluaran harus 1 GB atau kurang agar IDE dapat mengunduhnya.
Jika artefak keluaran melebihi batas, Anda tidak akan dapat mengunduh kode yang ditingkatkan atau ringkasan transformasi. Cobalah mengubah proyek yang lebih kecil untuk mencegah artefak keluaran besar. Jika masalah berlanjut, hubungi Dukungan. Untuk informasi tentang Dukungan menghubungi Amazon Q, lihat[Menggunakan Pengembang Amazon Q untuk mengobrol Dukungan](support-chat.md).
### Unduh kode diff dalam waktu 30 hari
File diff kode dengan kode upgrade Anda hanya tersedia selama 30 hari setelah transformasi selesai. Jika sudah lebih dari 30 hari sejak transformasi selesai, mulai ulang transformasi untuk mengunduh file diff.
### Konfigurasikan pengaturan proxy di IDE Anda
Amazon Q mengunduh kode upgrade Anda dari bucket Amazon S3 milik layanan. Bagian dari proses pengunduhan melibatkan penggunaan sertifikat SSL atau TLS untuk menjalin komunikasi antara Amazon S3 dan IDE Anda. Jika Anda menggunakan server proxy, sertifikat SSL atau TLS yang digunakan oleh server proxy Anda harus dipercaya, jika tidak Amazon Q tidak dapat mengunggah proyek Anda.
Untuk mengunduh kode, Anda mungkin perlu mengonfigurasi IDE untuk mempercayai sertifikat atau memperbarui setelan proxy lainnya. Untuk informasi selengkapnya tentang memperbarui setelan proxy Anda, lihat[Konfigurasikan pengaturan proxy di IDE Anda](#configure-proxy).
### Hapus karakter wildcard dalam pengaturan JetBrains proxy
Jika Anda telah mengonfigurasi pengaturan proxy di JetBrains IDE Anda, Anda mungkin melihat kesalahan berikut saat mengunduh kode yang ditingkatkan:
```
software.amazon.awssdk.core.exception.SdkClientException:
Unable to execute HTTP request: Dangling meta character '*' near index 0
```
Hal ini kemungkinan disebabkan oleh adanya karakter wildcard (\$1) di bidang **Tidak ada proxy untuk** pengaturan proxy IDE Anda. Java SDK yang digunakan oleh Amazon Q tidak mendukung entri wildcard di bidang ini.
Untuk mengunduh kode Anda, hapus wildcard apa pun dari bidang **No proxy for**, lalu restart IDE Anda. Jika Anda perlu menentukan host yang harus melewati proxy, gunakan ekspresi reguler alih-alih wildcard. Untuk memperbarui setelan proxy di JetBrains IDE Anda, lihat [Proxy HTTP](https://www.jetbrains.com/help/idea/settings-http-proxy.html) di JetBrains dokumentasi.
## Bagaimana cara mengakses log transformasi kode?
### Akses log di JetBrains
Untuk informasi tentang cara mengakses file JetBrains log, lihat [Menemukan file log IDE](https://intellij-support.jetbrains.com/hc/en-us/articles/207241085-Locating-IDE-log-files) dalam JetBrains dokumentasi.
Untuk menemukan log yang dipancarkan oleh Amazon Q diJetBrains, cari log IDE untuk string berikut:
```
software.aws.toolkits.jetbrains.services.codemodernizer
```
Log transformasi kode dimulai dengan string sebelumnya. Log Maven yang dihasilkan oleh ditampilkan pada tab **Run** dan memiliki string sebelumnya sebelum dan sesudah entri log.
### Akses log di Visual Studio Code
Untuk menemukan log yang dipancarkan oleh Amazon Q diVS Code, selesaikan langkah-langkah berikut:
1. Pilih **Lihat** di bilah navigasi atas, lalu pilih **Command Palette**.
1. Cari `Amazon Q: View Logs` di palet perintah yang muncul.
1. Log terbuka di IDE. Untuk mencari file log untuk`CodeTransformation`, gunakan `CMD + F` atau`Control + F`.
Log transformasi kode VS Code diawali dengan`CodeTransformation:`. Berikut ini adalah contoh log yang dihasilkan VS Code untuk kesalahan dependensi Maven salinan:
```
2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found
```
## Bagaimana cara menemukan ID pekerjaan transformasi saya?
### Temukan ID pekerjaan Anda di JetBrains
Untuk menemukan ID pekerjaan transformasiJetBrains, buka tab **Detail Transformasi** di **Hub Transformasi** dan pilih ikon **Tampilkan Status Pekerjaan** (jam).
### Temukan ID pekerjaan Anda di Visual Studio Code
Untuk menemukan ID pekerjaan transformasi di VS Code, buka **Transformation Hub** dan pilih ikon **Show Job Status** (clock).
# Mengubah aplikasi.NET dengan Pengembang Amazon Q
Amazon Q Developer dapat mem-port aplikasi.NET berbasis Windows Anda ke aplikasi .NET lintas platform yang kompatibel dengan Linux melalui alur kerja refactoring bertenaga AI generatif. Amazon Q juga membantu Anda meningkatkan versi lama aplikasi .NET lintas platform ke versi yang lebih baru.
Untuk mengubah solusi atau proyek .NET, Amazon Q menganalisis basis kode Anda, menentukan pembaruan yang diperlukan untuk mem-port aplikasi Anda, dan membuat rencana transformasi sebelum transformasi dimulai. Selama analisis ini, Amazon Q membagi solusi atau proyek .NET Anda menjadi grup kode yang dapat Anda lihat dalam rencana transformasi. *Grup kode* adalah proyek dan semua dependensinya yang bersama-sama menghasilkan unit kode yang dapat dibangun seperti pustaka tautan dinamis (DLL) atau yang dapat dieksekusi.
Selama transformasi, Amazon Q menyediakan step-by-step pembaruan di Hub Transformasi tempat Anda dapat memantau kemajuan. Setelah mengubah aplikasi Anda, Amazon Q menghasilkan ringkasan dengan perubahan yang diusulkan dalam tampilan diff agar Anda dapat memverifikasi perubahan secara opsional sebelum Anda menerimanya. Saat Anda menerima perubahan, Amazon Q membuat pembaruan di tempat untuk solusi atau proyek .NET Anda.
Amazon Q melakukan empat tugas kunci untuk mem-port aplikasi.NET ke Linux:
+ **Upgrade versi bahasa - Menggantikan versi** kode C \$1 yang sudah ketinggalan zaman dengan versi C \$1 yang kompatibel dengan Linux.
+ **Bermigrasi dari .NET Framework ke lintas platform .NET** - Migrasi proyek dan paket dari .NET Framework yang bergantung pada Windows ke lintas platform .NET yang kompatibel dengan Linux.
+ **Menulis ulang kode untuk kompatibilitas Linux** — Memfaktorkan ulang dan menulis ulang komponen kode yang tidak digunakan lagi dan tidak efisien.
+ **Menghasilkan laporan kesiapan kompatibilitas Linux** — Untuk tugas terbuka di mana intervensi pengguna diperlukan untuk membuat kode dibangun dan dijalankan di Linux, Amazon Q menyediakan laporan terperinci tentang tindakan yang diperlukan untuk mengonfigurasi aplikasi Anda setelah transformasi.
Untuk informasi selengkapnya tentang cara Amazon Q melakukan transformasi.NET, lihat [Cara kerjanya](how-dotnet-transformation-works.md).
**Topics**
+ [Kuota](#quotas-dotnet-transformation)
+ [Mem-porting aplikasi.NET dengan Pengembang Amazon Q di Visual Studio](port-dotnet-application.md)
+ [Bagaimana Pengembang Amazon Q mengubah aplikasi.NET](how-dotnet-transformation-works.md)
+ [Memecahkan masalah dengan transformasi.NET di IDE](troubleshooting-dotnet-transformation-IDE.md)
## Kuota
.NET transformasi dengan Amazon Q di IDE mempertahankan kuota berikut:
+ **Baris kode per pekerjaan** — Jumlah maksimum baris kode yang dapat diubah Amazon Q dalam pekerjaan transformasi tertentu. Ini juga merupakan batas total bulanan untuk transformasi.NET.
+ **Pekerjaan Bersamaan** — Jumlah maksimum pekerjaan transformasi yang dapat Anda jalankan pada saat yang bersamaan. Kuota ini berlaku untuk semua transformasi dalam IDE, termasuk transformasi [Java](transform-java.md).
| Sumber daya | Kuota |
| --- | --- |
| Baris kode per pekerjaan | 100.000 baris kode |
| Tugas bersamaan | 1 pekerjaan per pengguna 2 lowongan per AWS akun |
# Mem-porting aplikasi.NET dengan Pengembang Amazon Q di Visual Studio
Selesaikan langkah-langkah ini untuk mem-port aplikasi.NET berbasis Windows ke aplikasi .NET lintas platform yang kompatibel dengan Linux dengan Pengembang Amazon Q di Visual Studio.
## Langkah 1: Prasyarat
Sebelum melanjutkan, pastikan Anda telah menyelesaikan langkah-langkah dalam [Mengatur Amazon Q di IDE Anda](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE.html).
Pastikan bahwa prasyarat berikut untuk aplikasi Anda terpenuhi sebelum Anda memulai pekerjaan transformasi.NET:
+ Aplikasi Anda hanya berisi proyek.NET yang ditulis dalam C \$1.
+ Aplikasi Anda hanya memiliki dependensi paket yang ditulis Microsoft NuGet
+ Aplikasi Anda hanya menggunakan karakter UTF-8. Jika aplikasi Anda menggunakan karakter non-UTF-8, Amazon Q masih akan mencoba mengubah kode Anda.
+ Jika aplikasi Anda bergantung pada Layanan Informasi Internet (IIS), hanya konfigurasi IIS default yang digunakan
+ Amazon Q akan mengevaluasi jenis proyek yang Anda pilih dan dependensinya untuk membuat grup kode. Grup kode Anda hanya dapat memiliki jenis proyek berikut:
+ Aplikasi konsol
+ Perpustakaan kelas
+ API Web
+ Layanan WCF
+ Lapisan logika bisnis Model View Controller (MVC) dan Aplikasi Halaman Tunggal (SPA)
+ Proyek uji
**catatan**
Amazon Q tidak mendukung transformasi komponen lapisan UI seperti Razor tampilan atau file WebForms ASPX. Jika Amazon Q mendeteksi komponen lapisan UI dalam solusi atau proyek Anda, Amazon Q akan melakukan transformasi sebagian dengan mengecualikan komponen lapisan UI, dan Anda mungkin perlu melakukan refactor lebih lanjut untuk membuat kode Anda dapat dibangun pada versi.NET target.
## Langkah 2: Ubah aplikasi Anda
Untuk mengubah solusi atau proyek .NET Anda, selesaikan prosedur berikut:
1. Buka solusi atau proyek berbasis C \$1 apa pun di Visual Studio yang ingin Anda ubah.
1. Buka file kode C \$1 apa pun di editor.
1. Pilih **Solution Explorer**.
1. Dari Solution Explorer, klik kanan solusi atau proyek yang ingin diubah, lalu pilih **Port dengan Amazon Q Developer**.
1. Jendela **Port dengan Pengembang Amazon Q** muncul.
Solusi atau proyek yang Anda pilih akan dipilih di menu tarik-turun **Pilih solusi atau proyek untuk mengubah**. Anda dapat memperluas menu untuk memilih solusi atau proyek yang berbeda untuk diubah.
Di menu tarik-turun **Pilih target.NET**, pilih versi.NET yang ingin Anda tingkatkan.
1. Pilih **Konfirmasi** untuk memulai transformasi.
1. Amazon Q mulai mengubah kode Anda. Anda dapat melihat rencana transformasi yang dihasilkannya untuk detail tentang bagaimana hal itu akan mengubah aplikasi Anda.
**Hub Transformasi** terbuka di mana Anda dapat memantau kemajuan selama durasi transformasi. Setelah Amazon Q menyelesaikan langkah **startup Menunggu transformasi pekerjaan**, Anda dapat menavigasi jauh dari proyek atau solusi selama durasi transformasi.
1. Setelah transformasi selesai, navigasikan ke **Transformation Hub** dan pilih **View diffs** untuk meninjau perubahan yang diusulkan dari Amazon Q dalam tampilan diff.
1. Pilih **Lihat ringkasan transformasi kode** untuk detail tentang perubahan yang dibuat Amazon Q. Anda juga dapat mengunduh ringkasan transformasi dengan memilih **Unduh ringkasan sebagai.md.**
Jika salah satu item dalam tabel **Grup Kode** memerlukan input di bawah status porting Linux, Anda harus memperbarui beberapa file secara manual untuk menjalankan aplikasi Anda di Linux.
1. Dari menu tarik-turun **Tindakan**, pilih **Unduh laporan kesiapan Linux**.
1. File.csv terbuka dengan perubahan apa pun pada proyek atau solusi Anda yang harus Anda selesaikan sebelum aplikasi Anda kompatibel dengan Linux. Ini termasuk proyek dan file yang perlu diperbarui, deskripsi item yang akan diperbarui, dan penjelasan tentang masalah tersebut. Gunakan kolom **Rekomendasi** untuk ide tentang cara mengatasi masalah kesiapan Linux.
1. Untuk memperbarui file Anda di tempat, pilih **Terima perubahan** dari menu tarik-turun **Tindakan**.
# Bagaimana Pengembang Amazon Q mengubah aplikasi.NET
Tinjau bagian berikut untuk detail tentang cara kerja transformasi.NET dengan Amazon Q Developer.
## Menganalisis aplikasi Anda dan menghasilkan rencana transformasi
Sebelum transformasi dimulai, Amazon Q membuat kode Anda secara lokal untuk memastikannya dapat dibangun dan dikonfigurasi dengan benar untuk transformasi. Amazon Q kemudian mengunggah kode Anda ke lingkungan build yang aman dan terenkripsi AWS, menganalisis basis kode Anda, dan menentukan pembaruan yang diperlukan untuk mem-port aplikasi Anda.
Selama analisis ini, Amazon Q membagi solusi atau proyek .NET Anda ke dalam kelompok kode. Grup kode adalah proyek dan semua dependensinya yang bersama-sama menghasilkan unit kode yang dapat dibangun seperti pustaka tautan dinamis (DLL) atau yang dapat dieksekusi. Bahkan jika Anda tidak memilih semua dependensi proyek untuk diubah, Amazon Q menentukan dependensi yang diperlukan untuk membangun proyek yang Anda pilih dan mengubahnya juga, sehingga aplikasi Anda yang diubah akan dapat dibangun dan siap digunakan.
Setelah menganalisis kode Anda, Amazon Q menghasilkan rencana transformasi yang menguraikan perubahan yang diusulkan yang akan dibuatnya, termasuk daftar grup kode dan dependensi mereka yang akan diubah.
## Mengubah aplikasi Anda
Untuk memulai transformasi, Amazon Q membuat kode Anda lagi di lingkungan build yang aman untuk memastikannya dapat dibangun dari jarak jauh. Amazon Q kemudian mulai mem-porting aplikasi Anda. Ini bekerja dari bawah ke atas, dimulai dengan ketergantungan tingkat terendah. Jika Amazon Q mengalami masalah dengan porting dependensi, Amazon Q menghentikan transformasi dan memberikan informasi tentang apa yang menyebabkan kesalahan.
Transformasi mencakup pembaruan berikut untuk aplikasi Anda:
+ Mengganti versi kode C \$1 yang sudah ketinggalan zaman dengan versi C\$1 yang kompatibel dengan Linux
+ Meningkatkan .NET Framework ke .NET lintas platform, termasuk:
+ Mengidentifikasi dan mengganti paket, pustaka, dan secara berulang APIs
+ Upgrade dan penggantian NuGet paket dan APIs
+ Transisi ke runtime lintas platform
+ Menyiapkan middleware dan memperbarui konfigurasi runtime
+ Mengganti paket pribadi atau pihak ketiga
+ Menangani komponen IIS dan WCF
+ Kesalahan pembuatan debug
+ Menulis ulang kode untuk kompatibilitas Linux, termasuk refactoring dan penulisan ulang kode usang dan tidak efisien untuk mem-port kode yang ada
## Meninjau ringkasan transformasi dan menerima perubahan
Setelah transformasi selesai, Amazon Q memberikan ringkasan transformasi dengan informasi tentang pembaruan yang diusulkan yang dibuat untuk aplikasi Anda, termasuk jumlah file yang diubah, paket diperbarui, dan APIs diubah. Ini menandai transformasi yang gagal, termasuk file atau bagian file yang terpengaruh dan kesalahan yang ditemui selama percobaan build. Anda juga dapat melihat ringkasan build dengan log build untuk mempelajari lebih lanjut tentang perubahan yang dibuat.
Ringkasan transformasi juga menyediakan status porting Linux, yang menunjukkan apakah input pengguna tambahan diperlukan atau tidak untuk membuat aplikasi Linux kompatibel. Jika salah satu item dalam grup kode memerlukan masukan dari Anda, Anda mengunduh laporan kesiapan Linux yang berisi pertimbangan khusus Windows yang tidak dapat ditangani Amazon Q pada waktu pembuatan. Jika input diperlukan untuk grup kode atau file apa pun, tinjau laporan untuk detail tentang jenis perubahan apa yang masih perlu dilakukan dan, jika berlaku, untuk rekomendasi tentang cara memperbarui kode Anda. Perubahan ini harus dilakukan secara manual sebelum aplikasi Anda dapat dijalankan di Linux.
Anda dapat meninjau perubahan yang diusulkan Amazon Q yang dibuat dalam tampilan diff sebelum menerimanya sebagai pembaruan di tempat untuk file Anda. Setelah memperbarui file Anda dan menangani item apa pun dalam laporan kesiapan Linux, aplikasi Anda siap dijalankan di .NET lintas platform.
# Memecahkan masalah dengan transformasi.NET di IDE
Gunakan bagian berikut untuk memecahkan masalah umum dengan transformasi.NET di IDE dengan Amazon Q Developer.
## Bagaimana saya tahu jika pekerjaan sedang berkembang?
Jika Amazon Q tampaknya menghabiskan waktu lama untuk melangkah di Hub Transformasi, Anda dapat memeriksa apakah pekerjaan tersebut masih aktif di log keluaran. Jika pesan diagnostik sedang dibuat, pekerjaan masih aktif.
Untuk memeriksa output, pilih tab **Output** di Visual Studio. Di menu **Tampilkan output dari:**, pilih **Amazon Q Language Client**.
Tangkapan layar berikut menunjukkan contoh output yang dihasilkan Amazon Q selama transformasi.
![\[Screenshot dari Amazon Q Developer Code Transformation Hub, menampilkan output dari Amazon Q Language Client.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/code-transform-troubleshoot4.png)
## Mengapa beberapa proyek tidak dipilih untuk transformasi?
Amazon Q hanya dapat mengubah jenis proyek yang didukung dalam bahasa C\$1. Saat ini, Amazon Q tidak mendukung porting komponen lapisan UI atau proyek yang ditulis dalam bahasa VB.NET atau F \$1. Untuk daftar jenis proyek yang didukung dan prasyarat lain untuk mengubah proyek .NET Anda, lihat. [Langkah 1: Prasyarat](port-dotnet-application.md#transform-dotnet-prerequisites)
## Bagaimana saya bisa mendapatkan dukungan jika proyek atau solusi saya tidak berubah?
Jika Anda tidak dapat memecahkan masalah sendiri, Anda dapat menghubungi Dukungan atau Akun AWS tim Anda untuk mengirimkan kasus dukungan.
Untuk mendapatkan dukungan, berikan ID pekerjaan transformasi sehingga AWS dapat menyelidiki pekerjaan yang gagal. Untuk menemukan ID pekerjaan transformasi, pilih tab **Output** di Visual Studio. Di menu **Tampilkan output dari:**, pilih **Amazon Q Language Client**.
## Bagaimana saya bisa mencegah firewall saya mengganggu pekerjaan transformasi?
Jika organisasi Anda menggunakan firewall, itu mungkin mengganggu transformasi di Visual Studio. Anda dapat menonaktifkan sementara pemeriksaan keamanan di Node.js untuk memecahkan masalah atau menguji apa yang mencegah transformasi berjalan.
Variabel lingkungan `NODE_TLS_REJECT_UNAUTHORIZED` mengontrol pemeriksaan keamanan penting. Pengaturan `NODE_TLS_REJECT_UNAUTHORIZED` ke “0" menonaktifkan penolakan Node.js terhadap sertifikat yang tidak TLS/SSL sah. Ini berarti:
+ Sertifikat yang ditandatangani sendiri akan diterima
+ Sertifikat kedaluwarsa akan diizinkan
+ Sertifikat dengan nama host yang tidak cocok akan diizinkan
+ Kesalahan validasi sertifikat lainnya akan diabaikan
Jika proxy Anda menggunakan sertifikat mandiri, Anda dapat mengatur variabel lingkungan berikut alih-alih `NODE_TLS_REJECT_UNAUTHORIZED` menonaktifkan:
```
NODE_OPTIONS = —use-openssl-ca
NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs
```
Jika tidak, Anda harus menentukan sertifikat CA yang digunakan oleh proxy untuk menonaktifkan`NODE_TLS_REJECT_UNAUTHORIZED`.
**Untuk menonaktifkan NODE\$1TLS\$1REJECT\$1UNAUTHORIZED pada Windows:**
1. Buka menu Start dan cari **Variabel Lingkungan**.
1. Pilih **Edit variabel lingkungan sistem**.
1. Di jendela **System Properties**, pilih **Environment Variables**.
1. Di bawah **Variabel sistem**, pilih **Baru**.
1. **Setel **nama Variabel** ke NODE\$1TLS\$1REJECT\$1UNAUTHORIZED dan nilai Variabel ke 0.**
1. Pilih **OK** untuk menyimpan perubahan.
1. Mulai ulang Visual Studio.
# Menjelaskan dan memperbarui kode dengan Pengembang Amazon Q
Amazon Q Developer dapat menjelaskan dan memperbarui baris kode tertentu di lingkungan pengembangan terintegrasi (IDE) Anda. Untuk memperbarui kode Anda, minta Amazon Q untuk membuat perubahan pada baris atau blok kode tertentu, dan itu akan menghasilkan kode baru yang mencerminkan perubahan yang Anda minta untuk dibuat. Kemudian, Anda dapat memasukkan kode yang diperbarui langsung ke file tempat kode tersebut berasal.
Anda dapat memilih dari opsi berikut:
+ **Jelaskan** — Dapatkan kode Anda dijelaskan dalam bahasa alami.
+ **Refactor** — Meningkatkan keterbacaan atau efisiensi kode, di antara peningkatan lainnya.
+ **Perbaiki** - kode Debug.
+ **Menghasilkan tes** - Buat tes unit untuk file saat ini atau kode yang dipilih.
+ **Optimalkan** - Tingkatkan kinerja kode.
+ **Kirim ke prompt** - Kirim kode yang disorot ke panel obrolan Amazon Q, dan ajukan pertanyaan yang Anda miliki tentang kode tersebut.
## Kirim kode ke Amazon Q
Untuk mendapatkan kode Anda dijelaskan atau diperbarui oleh Amazon Q, selesaikan langkah-langkah berikut.
1. Sorot bagian dari file kode di IDE Anda.
1. Klik kanan kode yang disorot untuk membuka jendela konteks. Pilih **Amazon Q**, lalu pilih **Jelaskan**, **Refactor**, **Perbaiki**, **Hasilkan pengujian**, **Optimalkan**, atau **Kirim untuk meminta**.
Jika Anda memilih **Kirim ke prompt**, Amazon Q menyalin kode yang disorot ke panel obrolan, di mana Anda dapat memasukkan pertanyaan yang Anda miliki tentang kode tersebut.
1. Untuk mengganti kode yang disorot dengan kode yang baru dibuat, Anda dapat menyalin kode atau memasukkannya langsung ke file Anda dengan memilih **Sisipkan kode**. Amazon Q menggantikan kode asli dengan kode yang diperbarui.
# Mengobrol sebaris dengan Pengembang Amazon Q
Fitur *obrolan inline* memungkinkan Anda mengobrol dengan Amazon Q dari jendela pengkodean utama IDE Anda. Untuk menggunakan fitur obrolan inline, Anda menyorot kode yang Anda inginkan saran, dan memberikan instruksi di layar input kecil. Amazon Q melanjutkan untuk menghasilkan kode untuk Anda, yang disajikan dalam perbedaan dalam jendela pengkodean utama. Anda kemudian dapat memilih untuk menerima atau menolak perubahan.
Keuntungan dari obrolan inline adalah menghilangkan peralihan konteks yang terjadi saat berpindah antara jendela obrolan dan jendela pengkodean utama.
Anda biasanya akan menggunakan fitur obrolan sebaris saat meninjau kode, menulis tes unit, atau melakukan tugas lain yang memerlukan jawaban berbasis kode. Untuk situasi di mana Anda menginginkan jawaban berbasis teks (misalnya, jawaban untuk “Jelaskan kode ini”) maka menggunakan [jendela obrolan]() adalah pilihan yang lebih baik.
Amazon Q mempertimbangkan kode dalam file saat ini saat membuat rekomendasi kode melalui obrolan sebaris. Itu tidak akan melihat kode di file atau proyek lain.
## Obrolan sebaris Amazon Q sedang beraksi
Sesi obrolan inline terungkap sebagai berikut.
1. Anda menyorot kode yang Anda inginkan saran, dan kemudian memilih dari opsi berikut berdasarkan IDE Anda:
+ Di Visual Studio Code danJetBrains, tekan `⌘+I` (Mac) atau `Ctrl+I` (Windows)
+ DiEclipse, tekan `⌘+Shift+I` (Mac) atau `Ctrl+Shift+I` (Windows)
+ Atau, Anda dapat mengklik kanan pilihan dan memilih **Amazon Q** dan kemudian obrolan **sebaris**
Ini meluncurkan layar input kecil di bagian atas jendela pengkodean utama tempat Anda dapat memasukkan prompt, seperti**Fix this code**.
![\[Layar input obrolan sebaris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/inline-chat-input-screen.png)
1. Amazon Q menghasilkan kode dan menyajikannya dalam perbedaan.
![\[Perbedaan obrolan sebaris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/inline-chat-diff.png)
1. Anda menerima atau menolak perubahan dengan memilih **Terima** atau **Tolak**, atau dengan menekan keyboard yang setara (atau). `Enter` `Esc`
![\[Tombol terima dan tolak obrolan sebaris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/inline-chat-accept.png)
## Contoh topik dan pertanyaan
Obrolan sebaris selalu mengembalikan kode sebagai jawabannya, sehingga Anda dapat memasukkan petunjuk seperti:
+ Dokumentasikan kode ini
+ Refactor kode ini
+ Tulis tes unit untuk fungsi ini
## Format berbeda
Obrolan sebaris menampilkan perbedaan dalam beberapa blok, dengan kode yang ada di bagian atas, dan kode yang disarankan di bagian bawah. side-by-sidePerbedaan tidak didukung.
# Menambahkan konteks ke obrolan Pengembang Amazon Q di IDE
Saat Anda mengobrol dengan Amazon Q di lingkungan pengembangan terintegrasi (IDE), Anda dapat memberikan Amazon Q *konteks* tambahan, seperti file dan folder, yang dapat digunakan Amazon Q untuk menyesuaikan dan meningkatkan jawabannya.
Ada dua cara untuk memberikan konteks ke Amazon Q:
+ **Secara eksplisit** — Untuk memberikan konteks secara eksplisit, Anda masuk **@** di jendela obrolan. **@**Meluncurkan pop-up pemilih konteks dari mana Anda memilih item untuk disertakan sebagai konteks. Atau, Anda dapat mengetik **@** dan mulai mengetik nama file, folder, atau jenis konteks lainnya agar pelengkapan otomatis. Untuk informasi selengkapnya, lihat [Jenis konteks eksplisit](#context-explicit).
+ **Secara otomatis** — Untuk menyediakan konteks secara otomatis, Anda mengatur konteks secara terpisah, di luar obrolan. Amazon Q secara otomatis mereferensikan konteks setiap kali pengembang yang mengerjakan proyek mengetik pertanyaan ke jendela obrolan. Untuk informasi selengkapnya, lihat [Jenis konteks otomatis](#context-automatic).
Setelah Amazon Q menghasilkan jawaban, itu menunjukkan kepada Anda file yang digunakan sebagai konteks dalam daftar drop-down **Konteks**, yang muncul tepat di atas awal jawaban.
## Jenis konteks eksplisit
Saat Anda mengetik **@** obrolan, Anda dapat memilih dari jenis konteks berikut:
+ **@workspace** - Amazon Q menggunakan ruang kerja proyek Anda sebagai konteks untuk jawabannya. Opsi **@workspace** membutuhkan konfigurasi. Untuk informasi selengkapnya, lihat [Menambahkan konteks ruang kerja ke obrolan Amazon Q Developer di IDE](workspace-context.md).
+ **Folder** — Amazon Q menunjukkan daftar folder dalam proyek saat ini, dan menggunakan folder yang Anda pilih sebagai konteks untuk jawabannya.
+ **File** — Amazon Q menunjukkan kepada Anda daftar file dalam proyek saat ini, dan menggunakan file yang Anda pilih sebagai konteks untuk jawabannya.
+ **Kode** - Amazon Q menunjukkan kepada Anda daftar kelas, fungsi, variabel global dalam proyek saat ini, dan menggunakan pilihan Anda sebagai konteks untuk jawabannya.
+ **Gambar** - Amazon Q memungkinkan Anda menambahkan gambar sebagai konteks untuk permintaan Anda, berguna untuk skenario seperti menghasilkan kode dari maket UI atau diagram urutan. Gambar harus dalam format JPEG, PNG, GIF, atau WebP, dengan ukuran maksimum 3,75 MB dan dimensi tidak melebihi 8.000 x 8.000 piksel. Anda dapat menyertakan hingga 20 gambar dalam satu pesan, termasuk gambar apa pun yang disematkan ke konteks.
+ **Prompts** — Amazon Q menunjukkan kepada Anda daftar prompt yang telah Anda simpan, dan menggunakan prompt yang Anda pilih sebagai konteks untuk jawabannya. Opsi **Prompts** memerlukan beberapa konfigurasi. Untuk informasi selengkapnya, lihat [Menyimpan petunjuk ke pustaka untuk digunakan dengan obrolan Pengembang Amazon Q](context-prompt-library.md).
## Jenis konteks otomatis
Jenis konteks berikut akan digunakan secara otomatis oleh Amazon Q, jika Anda telah mengaturnya:
+ **Aturan proyek** - Amazon Q akan secara otomatis menggunakan seperangkat aturan proyek yang Anda tetapkan sebagai konteks. Untuk informasi selengkapnya, lihat [Membuat aturan proyek untuk digunakan dengan obrolan Pengembang Amazon Q](context-project-rules.md).
+ **Kustomisasi** - Amazon Q akan secara otomatis menggunakan repositori kode sumber sebagai konteks.
# Menambahkan konteks ruang kerja ke obrolan Amazon Q Developer di IDE
Saat mengobrol dengan Amazon Q di lingkungan pengembangan terintegrasi (IDE), Anda dapat menambahkan pertanyaan Anda **@workspace** untuk secara otomatis menyertakan potongan kode ruang kerja yang paling relevan sebagai konteks. Amazon Q Developer menentukan relevansi berdasarkan indeks yang diperbarui secara berkala.
Dengan konteks ruang kerja, Amazon Q memiliki kemampuan yang ditingkatkan, termasuk menemukan file, memahami cara kode digunakan di seluruh file, dan membuat kode yang memanfaatkan banyak file, termasuk file yang tidak dibuka.
**Topics**
+ [Pengaturan](#setup)
+ [Ajukan pertanyaan dengan konteks ruang kerja](#ask-questions-workspace-context)
## Pengaturan
Sebelum Anda melanjutkan, pastikan Anda memiliki versi terbaru dari IDE Anda diinstal. Anda kemudian dapat menyelesaikan langkah-langkah pengaturan berikut.
### Aktifkan pengindeksan
Untuk menggunakan ruang kerja Anda sebagai konteks, Amazon Q membuat indeks lokal repositori ruang kerja Anda, termasuk file kode, file konfigurasi, dan struktur proyek. Selama pengindeksan, file yang tidak penting seperti binari atau yang ditentukan dalam `.gitignore` file disaring.
Diperlukan waktu 5 hingga 20 menit untuk mengindeks ruang kerja baru. Selama waktu ini, Anda dapat mengharapkan peningkatan penggunaan CPU di IDE Anda. Setelah pengindeksan awal, indeks diperbarui secara bertahap saat Anda membuat perubahan pada ruang kerja Anda.
Pertama kali Anda menambahkan konteks ruang kerja, Anda harus mengaktifkan pengindeksan di IDE Anda. Selesaikan langkah-langkah berikut untuk mengaktifkan pengindeksan:
1. Tambahkan **@workspace** ke pertanyaan Anda di panel obrolan Amazon Q.
1. Amazon Q meminta Anda untuk mengaktifkan pengindeksan. Pilih **Pengaturan** untuk diarahkan ke pengaturan Amazon Q di IDE Anda.
Jika Anda tidak diminta, Anda dapat pergi ke pengaturan dengan memilih **Amazon Q** di bagian bawah IDE Anda. Kemudian, pilih **Buka Pengaturan** dari bilah tugas Amazon Q yang terbuka.
1. Pilih kotak di sebelah **Indeks Ruang Kerja**.
### Konfigurasikan pengindeksan (opsional)
Tidak ada konfigurasi yang diperlukan untuk proses pengindeksan, namun Anda dapat memilih untuk menentukan jumlah utas yang didedikasikan untuk pengindeksan. Jika Anda meningkatkan jumlah thread yang digunakan, pengindeksan akan selesai lebih cepat, dan itu akan menggunakan lebih banyak CPU Anda. Untuk memperbarui konfigurasi pengindeksan, tentukan jumlah utas untuk setelan **Workspace Index Worker Threads**. Anda juga dapat mengatur ukuran maksimum file yang dapat diindeks untuk konteks ruang kerja, dan mengaktifkan penggunaan unit pemrosesan grafis (GPU) Anda untuk pengindeksan.
## Ajukan pertanyaan dengan konteks ruang kerja
Untuk menambahkan ruang kerja Anda sebagai konteks ke percakapan Anda dengan Amazon Q, buka ruang kerja yang ingin Anda tanyakan, lalu tambahkan **@workspace** pertanyaan Anda di panel obrolan. Anda harus menambahkan @workspace ke pertanyaan apa pun yang ingin Anda tambahkan konteks ruang kerja.
Jika Anda ingin mulai mengobrol tentang ruang kerja yang berbeda, buka ruang kerja, lalu buka tab obrolan baru. Sertakan **@workspace** dalam pertanyaan Anda untuk menambahkan ruang kerja baru sebagai konteks.
Anda dapat menanyakan Amazon Q tentang file apa pun di ruang kerja Anda, termasuk file yang belum dibuka. Amazon Q dapat menjelaskan file, menemukan kode, dan menghasilkan kode di seluruh file, selain kemampuan pengkodean percakapan yang ada.
Berikut adalah contoh pertanyaan yang dapat Anda tanyakan kepada Amazon Q yang memanfaatkan konteks ruang kerja dalam obrolan:
+ @workspace di mana kode yang menangani otorisasi?
+ @workspace apa kelas kunci dengan logika aplikasi dalam proyek ini?
+ @workspace jelaskan main.py
+ @workspace tambahkan autentikasi ke proyek ini
+ @workspace pustaka atau paket pihak ketiga apa yang digunakan dalam proyek ini, dan untuk tujuan apa?
+ @workspace tambahkan tes unit untuk fungsi **
# Menyimpan petunjuk ke pustaka untuk digunakan dengan obrolan Pengembang Amazon Q
Anda dapat membuat pustaka petunjuk umum yang dapat Anda gunakan saat mengobrol dengan Amazon Q di IDE. Dengan menyimpan petunjuk ini di perpustakaan Anda, Anda dapat dengan mudah memasukkannya ke dalam obrolan tanpa harus mengetik ulang prompt setiap kali. Anda dapat menggunakan petunjuk yang disimpan di beberapa percakapan dan proyek.
Prompt disimpan di `~/.aws/amazonq/prompts` folder.
**Untuk menyimpan prompt ke pustaka prompt**
1. Di IDE Anda, buka jendela obrolan Amazon Q.
1. Ketik**@**, dan pilih **Prompts.**
1. Pilih **Buat prompt baru**. (Anda mungkin harus menggulir ke bawah untuk menemukannya.)
1. Dalam **nama Prompt**, masukkan nama prompt seperti **Create\$1sequence\$1diagram** dan tekan Enter. Perhatikan bahwa nama prompt tidak dapat menyertakan spasi.
Amazon Q membuat file prompt yang disebut `Create_sequence_diagram.md` di `~/.aws/amazonq/prompts` folder, dan membuka file di IDE Anda.
1. Dalam file prompt, tambahkan prompt terperinci. Contoh:
`Create a sequence diagram using Mermaid that shows the sequence of calls between resources. Ignore supporting resources like IAM policies and security group rules.`
1. Simpan file prompt.
**Untuk menggunakan prompt tersimpan**
1. Di IDE Anda, buka jendela obrolan Amazon Q.
1. Ketik**@**, dan pilih **Prompts.**
1. Pilih prompt yang disimpan, misalnya, **create\$1sequence\$1diagram**.
1. (Opsional) Di jendela input obrolan, tambahkan detail, sesuai kebutuhan. Anda dapat mengetik lebih banyak teks dan menambahkan lebih banyak jenis konteks. Contoh prompt mungkin terlihat seperti ini...
`@Create_sequence_diagram using the files in the @lib folder`
1. Kirimkan prompt dan tunggu Amazon Q menghasilkan jawaban.
# Menyematkan item konteks
**catatan**
Penyematan konteks saat ini hanya tersedia di VS Code IDE.
Penyematan konteks memungkinkan Anda menentukan item konteks yang ditambahkan ke semua pesan dalam sesi obrolan Anda. Saat Anda menyematkan item konteks, item tersebut secara otomatis disertakan dalam setiap pesan dalam percakapan Anda saat ini, sehingga tidak perlu mengetik perintah berulang kali seperti**@workspace**,**@file**, atau**@folder**.
Item yang disematkan dapat berasal dari dua sumber: Anda dapat menyematkan item yang sering Anda referensikan secara manual, atau Amazon Q dapat secara otomatis menambahkan konteks, (seperti file aktif Anda saat ini,) untuk meningkatkan kualitas respons. Item konteks yang disematkan muncul di bagian atas kotak input teks panel obrolan Anda, dan Anda memiliki kontrol untuk menghapus konteks apa pun yang tidak ingin Anda sertakan.
Untuk membantu mempertahankan batas konteks yang jelas, item yang disematkan hanya berlaku untuk tab obrolan Anda saat ini. Saat Anda membuka tab baru, Anda akan mulai segar hanya dengan konteks default yang disematkan, seperti file aktif.
## Menggunakan konteks yang disematkan
**Untuk menambahkan item konteks yang disematkan**
1. Di IDE Anda, buka panel obrolan Amazon Q.
1. Setelah menggunakan perintah konteks seperti**@workspace**,, **@file****@folder**, atau **@prompt** dalam obrolan, klik konteks yang diinginkan untuk menyematkannya.
Atau, Anda dapat mengklik tombol “@ Pin Context” untuk melihat opsi yang tersedia dan memilih konteks yang akan disematkan.
1. Konteks yang disematkan akan muncul di area konteks yang disematkan di bagian atas panel obrolan Anda.
### Metode untuk menyematkan item konteks
Ada tiga cara untuk menyematkan item konteks:
1. Menggunakan menu Konteks @Pin:
+ Klik tombol "@Pin Context” di panel obrolan Anda.
+ Pilih item konteks yang diinginkan dari opsi yang tersedia.
1. Menggunakan menu konteks dan pintasan keyboard:
+ Ketik “@” di input obrolan untuk membuka menu konteks.
+ Arahkan ke item yang diinginkan.
+ Tekan Option/Alt \$1 Enter untuk menyematkan item yang dipilih.
1. Menyematkan dari prompt input:
+ Jika Anda sudah mengetik perintah konteks (seperti**@workspace**,, **@file****@folder**, atau**@prompt**) di input Anda, arahkan kursor ke item konteks di input Anda.
+ Klik pada item untuk menyematkannya.
Setelah menyematkan, item konteks akan muncul di area konteks yang disematkan di bagian atas kotak input teks obrolan Anda.
**Untuk menghapus item konteks yang disematkan**
+ Untuk menghapus item konteks yang disematkan, klik X di sisi kiri pil. Ini berfungsi untuk item konteks yang disematkan pengguna dan yang ditambahkan sistem.
# Membuat aturan proyek untuk digunakan dengan obrolan Pengembang Amazon Q
Anda dapat membuat pustaka aturan proyek yang dapat Anda gunakan saat mengobrol dengan Amazon Q di IDE. Aturan ini menjelaskan standar pengkodean dan praktik terbaik di seluruh tim Anda. Misalnya, Anda dapat memiliki aturan yang menyatakan bahwa semua kode Python harus menggunakan petunjuk tipe, atau bahwa semua kode Java harus menggunakan komentar Javadoc. Dengan menyimpan aturan ini dalam proyek Anda, Anda dapat memastikan konsistensi di seluruh pengembang, terlepas dari tingkat pengalaman mereka.
Aturan proyek didefinisikan dalam file Markdown di `project-root/.amazonq/rules` folder proyek.
Setelah Anda membuat aturan proyek, Amazon Q akan secara otomatis menggunakannya sebagai konteks setiap kali pengembang mengobrol dengan Amazon Q dalam proyek Anda, dan akan memastikan untuk mematuhinya saat menghasilkan jawaban. Untuk informasi selengkapnya tentang menambahkan konteks ke obrolan, lihat[Menambahkan konteks ke obrolan Pengembang Amazon Q di IDE](ide-chat-context.md).
Anda dapat membuat aturan proyek baik secara langsung di sistem file atau melalui antarmuka obrolan Amazon Q.
**Untuk membuat aturan proyek menggunakan antarmuka obrolan Amazon Q**
1. Di IDE Anda, buka panel obrolan Amazon Q.
1. Di kotak input obrolan, klik tombol **Aturan**.
1. Pilih **Buat aturan baru**.
1. Dalam dialog yang muncul, masukkan nama untuk aturan Anda.
Ini akan membuat file Markdown dengan nama itu di `project-root/.amazonq/rules` folder proyek Anda.
1. Tambahkan konten aturan Anda di editor.
1. Simpan file tersebut.
**Untuk membuat aturan proyek menggunakan sistem file**
1. Di IDE Anda, buka folder root proyek.
1. Di folder root proyek, buat folder berikut:
`project-root/.amazonq/rules`
Folder ini menyimpan semua aturan proyek Anda.
1. Di`project-root/.amazonq/rules`, buat file aturan proyek. Itu harus berupa file Markdown. Contoh:
`cdk-rules.md`
1. Buka file Markdown aturan proyek Anda.
1. Tambahkan prompt terperinci ke file. Contoh:
```
All Amazon S3 buckets must have encryption enabled, enforce SSL, and block public access.
All Amazon DynamoDB Streams tables must have encryption enabled.
All Amazon SNS topics must have encryption enabled and enforce SSL.
All Amazon SNS queues must enforce SSL.
```
1. Simpan file tersebut.
1. (Opsional) Tambahkan lebih banyak file Markdown aturan proyek.
Anda sekarang telah membuat satu atau lebih aturan proyek. Amazon Q akan menggunakan aturan ini sebagai konteks secara otomatis setiap kali pengembang mengobrol dengan Amazon Q dalam proyek Anda.
**Untuk mengelola aturan di antarmuka obrolan Amazon Q**
1. Di IDE Anda, buka panel obrolan Amazon Q.
1. Di kotak input obrolan, klik tombol **Aturan** untuk melihat semua aturan yang tersedia.
1. Klik aturan untuk mengaktifkan atau menonaktifkannya untuk sesi obrolan saat ini:
+ Aturan dengan tanda centang aktif dan akan diterapkan pada percakapan Anda.
+ Aturan tanpa tanda centang tidak aktif untuk sesi saat ini.
# Menghasilkan bank memori untuk obrolan Amazon Q
Amazon Q dapat secara otomatis menghasilkan file bank memori yang menyediakan indeks cepat struktur proyek Anda, tumpukan teknologi, dan informasi produk. Fitur ini menganalisis file kunci dalam proyek Anda untuk membuat file ringkasan yang membantu Amazon Q memahami basis kode Anda tanpa harus menganalisis seluruh proyek setiap kali Anda mengajukan pertanyaan.
Saat Anda membuat file bank memori, Amazon Q membuat `memory-bank` subfolder di bawahnya `.amazonq/rules` yang berisi file yang dibuat secara otomatis berikut:
+ `product.md`— Ikhtisar proyek Anda dan kemampuannya.
+ `structure.md`— Arsitektur proyek Anda, organisasi folder, dan komponen utama.
+ `tech.md`— Tumpukan teknologi, kerangka kerja, dependensi, dan standar pengkodean Anda.
+ `guidelines.md`— Standar dan pola pengembangan untuk proyek Anda.
File-file ini secara otomatis digunakan sebagai konteks saat Anda mengobrol dengan Amazon Q, memberikannya informasi latar belakang tentang proyek Anda.
## Hasilkan bank memori untuk proyek Anda
Untuk menghasilkan bank memori, selesaikan prosedur berikut.
1. Di IDE Anda, buka panel obrolan Amazon Q.
1. Di kotak input obrolan, pilih tombol **Aturan**.
1. Pilih **Hasilkan Bank Memori**.
1. Tab obrolan baru terbuka di mana Amazon Q mulai menganalisis proyek Anda untuk membuat file bank memori.
1. Setelah selesai, Anda dapat melihat file dengan memilih tombol **Aturan**.
Anda dapat memilih dan membatalkan pilihan file individual yang akan digunakan sebagai konteks saat Anda mengajukan pertanyaan.
1. Jika proyek Anda berubah, Anda dapat meminta Amazon Q menghasilkan file bank memori baru untuk memperbarui konteksnya. Untuk melakukannya, pilih tombol **Aturan** dan kemudian pilih **Regenerate Memory Bank**.
## Sesuaikan generasi bank memori
Anda dapat menyesuaikan bagaimana file bank memori dihasilkan dengan membuat aturan proyek khusus. Misalnya, Anda dapat membuat aturan yang menentukan bahasa atau format untuk file yang dihasilkan:
```
When generating the memory bank files like product.md, structure.md, and tech.md,
always generate content in Spanish and include detailed code examples.
```
Simpan aturan bank memori Anda dalam file di `project-root/.amazonq/rules` folder proyek Anda.
Untuk informasi selengkapnya tentang membuat aturan proyek kustom, lihat[Membuat aturan proyek untuk digunakan dengan obrolan Pengembang Amazon Q](context-project-rules.md).
# Pemadatan riwayat obrolan di Pengembang Amazon Q
Saat Anda berinteraksi dengan Amazon Q Developer di IDE Anda, percakapan Anda terakumulasi dalam riwayat obrolan. Riwayat ini memberikan konteks penting yang membantu Amazon Q memahami proyek Anda dan memberikan tanggapan yang lebih relevan. Namun, ada batasan berapa banyak riwayat percakapan yang dapat dimasukkan dalam setiap permintaan ke model yang mendasarinya.
## Memahami batas jendela konteks
Jendela konteks mewakili jumlah maksimum informasi yang dapat diproses dalam satu interaksi dengan Amazon Q. Ini termasuk:
+ Pertanyaan atau permintaan Anda saat ini
+ Pesan sebelumnya dalam percakapan Anda
+ Cuplikan kode dan file yang telah Anda bagikan
+ Informasi sistem tentang proyek Anda
Ketika jendela konteks ini mendekati batas kapasitasnya, kemampuan Amazon Q untuk mereferensikan bagian percakapan Anda sebelumnya mungkin terpengaruh.
## Cara kerja pemadatan riwayat obrolan
Pemadatan riwayat obrolan memungkinkan Anda menyimpan informasi penting dari percakapan Anda sekaligus mengurangi jumlah konteks yang digunakan. Ketika pemadatan terjadi:
1. Amazon Q menganalisis riwayat percakapan Anda
1. Ini menciptakan ringkasan singkat dari poin-poin kunci, pertanyaan, dan keputusan
1. Ringkasan ini menggantikan riwayat percakapan terperinci di jendela konteks
1. Percakapan lengkap Anda tetap terlihat di antarmuka obrolan
Compaction membantu Anda melanjutkan percakapan tanpa kehilangan konteks penting, sambil menghindari kebutuhan untuk memulai obrolan yang benar-benar baru ketika Anda mencapai batas jendela konteks.
## Menggunakan pemadatan riwayat obrolan
Anda dapat menggunakan pemadatan dengan dua cara:
### Pemadatan manual
Untuk memadatkan riwayat obrolan Anda secara manual:
1. Masukkan **/compact** di bidang input obrolan
1. Amazon Q akan memproses permintaan Anda dan menampilkan pesan konfirmasi dengan ringkasan percakapan yang dipadatkan
Gunakan pemadatan manual saat Anda ingin melanjutkan percakapan saat ini tetapi perhatikan waktu respons yang lebih lambat atau jawaban yang kurang relevan.
### Dorongan pemadatan otomatis
Ketika jendela konteks Anda mencapai sekitar 80% dari kapasitasnya, Amazon Q akan menampilkan pemberitahuan yang menyarankan pemadatan. Pemberitahuan ini meliputi:
+ Penjelasan mengapa pemadatan direkomendasikan
+ Tombol untuk segera memicu pemadatan
## Setelah pemadatan
Setelah pemadatan terjadi:
+ Riwayat percakapan lengkap Anda tetap terlihat di antarmuka obrolan hingga akhir sesi saat ini
+ Amazon Q menggunakan ringkasan yang dipadatkan (bukan riwayat lengkap) untuk menghasilkan respons
+ Ringkasan yang dipadatkan disertakan dalam jendela konteks alih-alih riwayat terperinci
+ Riwayat obrolan terperinci akan diatur ulang saat Anda memulai ulang IDE Anda
## Perintah-perintah terkait
### Menghapus riwayat obrolan
Sebagai alternatif untuk pemadatan, Anda dapat sepenuhnya menghapus riwayat obrolan Anda menggunakan **/clear** perintah:
1. Masukkan **/clear** di bidang input obrolan
1. Amazon Q akan menghapus semua riwayat percakapan sebelumnya dari tampilan dan jendela konteks
### Kapan memilih pemadatan vs. riwayat kliring
Pilih pemadatan saat:
+ Anda ingin melanjutkan topik percakapan Anda saat ini
+ Konteks sebelumnya masih relevan dengan tugas Anda saat ini
+ Anda ingin mempertahankan arahan dan pengetahuan umum dari percakapan Anda
Pilih untuk menghapus riwayat saat:
+ Anda memulai tugas atau topik yang sama sekali baru
+ Percakapan sebelumnya tidak lagi relevan
+ Anda ingin memastikan tidak ada konteks sebelumnya yang memengaruhi tanggapan baru
+ Anda ingin menghapus informasi yang berpotensi sensitif dari percakapan
# Melihat, menghapus, dan mengekspor riwayat percakapan Pengembang Amazon Q
Saat Anda mengobrol dengan Amazon Q di lingkungan pengembangan terintegrasi (IDE), Amazon Q menyimpan setiap tab obrolan Anda sebagai percakapan terpisah. Anda dapat melihat, mencari, dan menghapus percakapan ini. Anda juga dapat mengekspornya ke file format Markdown atau HTML.
Amazon Q menyimpan percakapan Anda di komputer lokal Anda, di direktori home Anda.
Amazon Q menyimpan percakapan untuk setiap ruang kerja secara terpisah, jadi jika Anda tidak melihat riwayat percakapan Anda, itu mungkin karena Anda berada di ruang kerja yang salah. Amazon Q hanya menampilkan riwayat percakapan untuk ruang kerja saat ini.
Gunakan petunjuk berikut untuk melihat, mencari, menghapus, dan mengekspor percakapan Anda.
**Untuk melihat dan mencari percakapan sebelumnya**
1. Di IDE Anda, masuk ke Amazon Q.
1. Buka tab obrolan Amazon Q.
1. Buka riwayat obrolan dengan melakukan salah satu hal berikut:
+ Di kanan atas panel obrolan, pilih tombol **Lihat riwayat obrolan**.
+ Tekan `ctrl+F` (Windows dan Linux) atau `⌘ F` (Mac).
1. Lakukan salah satu tindakan berikut:
+ Pilih percakapan yang ingin Anda lihat. Percakapan diatur berdasarkan tanggal.
+ Gunakan bilah pencarian di dekat bagian atas riwayat obrolan untuk menemukan percakapan. Amazon Q menemukan percakapan yang sama persis dengan teks yang Anda masukkan.
**Untuk menghapus satu percakapan**
1. Di IDE Anda, masuk ke Amazon Q.
1. Lakukan salah satu tindakan berikut:
+ Di tab obrolan sesi obrolan terbuka, masukkan **/clear** untuk menghapus konten tab obrolan.
+ Buka tab obrolan Amazon Q, lalu buka riwayat obrolan dengan melakukan salah satu hal berikut:
+ Di kanan atas panel obrolan, pilih tombol **Lihat riwayat obrolan**.
+ Tekan `ctrl+F` (Windows dan Linux) atau `⌘ F` (Mac).
**Dalam percakapan yang ingin Anda hapus, pilih elipsis vertikal () dan pilih Hapus.**
**Untuk mengekspor percakapan ke Markdown atau HTML**
1. Di IDE Anda, masuk ke Amazon Q.
1. Lakukan salah satu tindakan berikut:
+ Dengan sesi obrolan sudah dimulai, di kanan atas panel obrolan, pilih tombol **Ekspor** untuk mengekspor percakapan yang ditampilkan di tab.
+ Buka tab obrolan Amazon Q, lalu buka riwayat obrolan dengan melakukan salah satu hal berikut:
+ Di kanan atas panel obrolan, pilih tombol **Lihat riwayat obrolan**.
+ Tekan `ctrl+F` (Windows dan Linux) atau `⌘ F` (Mac).
Dalam percakapan yang ingin Anda ekspor, pilih elipsis vertikal () dan pilih **Ekspor untuk mengekspor** percakapan ke file format Markdown atau HTML.
Secara default, Amazon Q memberi nama file `q-dev-chat-yyyy-mm-dd.md|html` dan menyimpannya di root proyek Anda.
# Menggunakan tombol pintas dalam obrolan dengan Pengembang Amazon Q
Amazon Q menyediakan pintasan keyboard untuk membantu Anda berinteraksi dengan antarmuka obrolan agen secara efisien. Menggunakan pintasan keyboard dapat membantu Anda mempertahankan alur kerja tanpa beralih antara keyboard dan mouse.
**catatan**
Pintasan keyboard saat ini hanya tersedia di Visual Studio Code IDE.
## Pintasan keyboard
**Pintasan keyboard untuk obrolan Amazon Q**
| Tindakan | Visual Studio CodeJalan pintas |
| --- | --- |
| Jalankan perintah | Shift\$1Cmd \$1 Masukkan (Mac) Shift\$1Ctrl\$1Masukkan (Windows) Shift\$1Meta \$1 Masukkan (Linux) |
| Tolak perintah | Pergeser\$1Cmd \$1 R (Mac) Pergeser\$1Ctrl\$1R (Windows) Pergeser\$1Meta\$1R (Linux) |
| Hentikan generasi | Pergeser\$1Cmd \$1Ruang Belakang (Mac) Pergeser\$1Ctrl\$1Ruang Belakang (Windows) Shift\$1Meta \$1 Ruang Belakang (Linux) |
## Menyesuaikan pintasan keyboard
Pintasan dapat dimodifikasi melalui antarmuka kustomisasi pintasan keyboard standar di IDE Anda. Amazon Q menggunakan sistem pintasan asli masing-masing IDE, sehingga setiap perubahan yang Anda buat akan tercermin di antarmuka Amazon Q. Pintasan yang ditampilkan dalam tooltips dan elemen UI akan diperbarui secara otomatis agar sesuai dengan pemetaan kunci khusus Anda.
## Kemampuan untuk menemukan jalan pintas
Amazon Q menyediakan beberapa cara untuk menemukan pintasan keyboard:
+ **Tooltips**: Arahkan kursor ke tombol perintah Jalankan, tombol Tolak perintah, atau tombol Stop untuk melihat pintasan keyboard saat ini
+ **Pengaturan**: Lihat semua pintasan di antarmuka kustomisasi pintasan keyboard IDE Anda
## Perilaku pintasan
+ Pintasan keyboard untuk obrolan agen hanya aktif saat fokus Anda berada di panel obrolan Amazon Q
+ Ini mencegah konflik dengan keybinding IDE yang ada
+ Jika Anda memodifikasi pintasan, Anda mungkin perlu me-refresh IDE agar perubahan tersebut tercermin dalam tooltips
# Memilih model untuk obrolan Amazon Q di IDEs
Anda dapat memilih model yang ingin digunakan Amazon Q saat mengobrol di IDE. Model yang Anda pilih tetap ada di semua sesi chat future.
Tabel berikut menjelaskan model yang tersedia untuk obrolan Amazon Q di IDE dan jendela konteksnya.
****
| Model | Jendela konteks |
| --- | --- |
| Claude Soneta 3.7 | 200k |
| Claude Soneta 4 (default) | 200k |
## Pilih model yang digunakan untuk mengobrol di IDE
Untuk memilih model yang digunakan Amazon Q saat Anda mengobrol di IDE Anda:
1. Buka panel obrolan Amazon Q di IDE Anda.
1. Di bagian bawah kotak teks, pilih dropdown menu model. Pilih model yang ingin Anda gunakan dari opsi yang tersedia.
Model yang Anda pilih tetap ada sampai Anda mengubahnya.
## Jendela konteks
Jendela konteks adalah jumlah konteks, termasuk riwayat percakapan Anda dan konteks eksplisit atau otomatis apa pun, yang dapat digunakan Amazon Q untuk memproses dan menanggapi permintaan Anda. Konteks diukur dalam token, yang mencakup teks dan kode.
Untuk informasi selengkapnya tentang konteks, lihat[Menambahkan konteks ke obrolan](ide-chat-context.md).
# Menghasilkan saran sebaris dengan Pengembang Amazon Q
Amazon Q dapat memberi Anda rekomendasi kode secara real time. Saat Anda menulis kode, Amazon Q secara otomatis menghasilkan saran berdasarkan kode dan komentar yang ada. Rekomendasi Anda yang dipersonalisasi dapat bervariasi dalam ukuran dan ruang lingkup, mulai dari komentar satu baris hingga fungsi yang sepenuhnya terbentuk.
Saat Anda mulai mengetik satu baris kode atau komentar, Amazon Q membuat saran berdasarkan masukan Anda saat ini dan sebelumnya. Nama file juga dipertimbangkan.
Saran sebaris diaktifkan secara otomatis saat Anda mengunduh ekstensi Amazon Q. Untuk memulai, mulailah menulis kode, dan Amazon Q akan mulai menghasilkan saran kode.
Anda juga dapat menyesuaikan saran yang dihasilkan Amazon Q ke pustaka internal tim pengembangan perangkat lunak Anda, teknik algoritmik berpemilik, dan gaya kode perusahaan.
**Topics**
+ [Menjeda saran dengan Amazon Q](#toggling-suggestions)
+ [Penyelesaian kode Q Amazon sedang beraksi](#what-is-walkthrough)
+ [Menghasilkan saran sebaris di lingkungan AWS pengkodean](setting-up-AWS-coding-env.md)
+ [Menggunakan tombol pintas](actions-and-shortcuts.md)
+ [Menggunakan referensi kode](code-reference.md)
+ [Contoh kode](inline-suggestions-code-examples.md)
## Menjeda saran dengan Amazon Q
Pilih IDE Anda untuk melihat langkah-langkah untuk menjeda dan melanjutkan saran kode sebaris di Amazon Q.
------
#### [ Kode Studio Visual ]
1. DiVS Code, pilih **Amazon Q** dari baki komponen di bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka di bagian atas jendela IDE.
1. Pilih **Jeda Saran Otomatis atau **Lanjutkan** Saran Otomatis**.
Gambar berikut menunjukkan bilah tugas Amazon Q diVS Code.
![\[Bilah tugas Amazon Q diVS Code.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/VSC-taskbar.png)
------
#### [ JetBrains ]
1. Di JetBrains IDE Anda, pilih **Amazon Q** dari bilah status di bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka di atas bilah status.
1. Pilih **Jeda Saran Otomatis atau **Lanjutkan** Saran Otomatis**.
Gambar berikut menunjukkan task bar Amazon Q di JetBrains IDE.
![\[Bilah tugas Amazon Q di JetBrains IDE.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/JB-taskbar.png)
------
#### [ Gerhana ]
1. Di Eclipse IDE Anda, pilih ikon **Amazon Q** di sudut kanan atas IDE.
1. Dengan tab obrolan Amazon Q terbuka, pilih ikon elipsis di sudut kanan atas tab. Bilah tugas Amazon Q terbuka.
Gambar berikut menunjukkan task bar Amazon Q di Eclipse IDE.
![\[Bilah tugas Amazon Q di Eclipse IDE.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/eclipse-taskbar.png)
1. Pilih **Jeda Saran Otomatis atau **Lanjutkan** Saran Otomatis**.
------
#### [ Visual Studio ]
1. Dari tepi jendela, pilih ikon Amazon Q.
1. **Pilih **Jeda Auto-Suggesions** atau Lanjutkan Saran Otomatis**
Gambar berikut menunjukkan task bar Amazon Q di Visual Studio.
![\[Menu Alat Pengembang di Visual Studio.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/vstudio-toggle-suggestions.png)
------
#### [ AWS Cloud9 ]
Amazon Q tidak mendukung mengaktifkan dan menonaktifkan saran. AWS Cloud9
Untuk berhenti menerima saran Amazon Q AWS Cloud9, hapus kebijakan IAM yang memberi Amazon Q akses AWS Cloud9 dari peran atau pengguna yang Anda gunakan untuk mengakses AWS Cloud9.
------
#### [ AWS Lambda ]
Untuk menonaktifkan atau mengaktifkan kembali saran kode Q Amazon di Lambda:
1. Di konsol Lambda, buka layar untuk fungsi Lambda tertentu.
1. Di bagian **Sumber kode**, dari bilah alat, pilih **Alat**.
1. Dari menu tarik-turun, pilih Saran **Kode Q Amazon**.
------
#### [ Amazon SageMaker AI Studio ]
1. Di konsol SageMaker AI Studio, pilih Amazon Q dari bagian bawah jendela.
Panel Amazon Q akan terbuka.
1. Pilih **Jeda Saran Otomatis atau **Lanjutkan** Saran Otomatis**.
------
#### [ JupyterLab ]
1. Di JupyterLab konsol, pilih Amazon Q dari bagian bawah jendela.
Panel Amazon Q akan terbuka.
1. Pilih **Jeda Saran Otomatis atau **Lanjutkan** Saran Otomatis**.
------
#### [ AWS Glue Studio Notebook ]
1. Di konsol AWS Glue Studio Notebook, pilih Amazon Q dari bagian bawah jendela.
Panel Amazon Q akan terbuka.
1. Pilih **Jeda Saran Otomatis atau **Lanjutkan** Saran Otomatis**.
------
## Penyelesaian kode Q Amazon sedang beraksi
Bagian ini menunjukkan bagaimana Amazon Q dapat membantu Anda menulis aplikasi lengkap. Aplikasi ini membuat bucket Amazon S3 dan tabel Amazon DynamoDB, ditambah pengujian unit yang memvalidasi kedua tugas.
Di sini, Amazon Q membantu pengembang memilih pustaka mana yang akan diimpor. Menggunakan tombol panah, pengembang beralih melalui beberapa saran.
![\[Contoh fitur penyelesaian blok.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-1.gif)
Di sini, pengembang memasukkan komentar, menjelaskan kode yang ingin mereka tulis di baris berikutnya.
Amazon Q dengan benar mengantisipasi metode yang akan dipanggil. Pengembang dapat menerima saran dengan tombol tab.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-2.png)
Di sini, pengembang bersiap untuk mendefinisikan konstanta.
Amazon Q dengan benar mengantisipasi bahwa konstanta pertama akan `REGION` dan nilainya akan menjadi`us-east-1`, yang merupakan default.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-3.png)
Di sini, pengembang bersiap untuk menulis kode yang akan membuka sesi antara pengguna dan Amazon S3 dan DynamoDB.
Amazon Q, akrab dengan AWS APIs dan SDKs, menyarankan format yang benar.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-4.1.png)
Pengembang hanya menulis nama fungsi yang akan membuat bucket. Tetapi berdasarkan itu (dan konteksnya), Amazon Q menawarkan fungsi penuh, lengkap dengan try/except klausa.
Perhatikan penggunaan `TEST_BUCKET_NAME, which is a constant declared earlier in the same file.`
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-5.png)
Pengembang baru saja mulai mengetik nama fungsi yang akan membuat tabel DynamoDB. Tetapi Amazon Q dapat mengetahui kemana arahnya.
Perhatikan bahwa akun saran untuk sesi DynamoDB yang dibuat sebelumnya, dan bahkan menyebutkannya dalam komentar.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-6.png)
Pengembang telah melakukan sedikit lebih dari sekadar menulis nama kelas pengujian unit, ketika Amazon Q menawarkan untuk menyelesaikannya.
Perhatikan referensi bawaan untuk dua fungsi yang dibuat sebelumnya dalam file yang sama.
Pengembang baru saja mulai mengetik nama fungsi yang akan membuat tabel DynamoDB. Tetapi Amazon Q dapat mengetahui kemana arahnya.
Perhatikan bahwa akun saran untuk sesi DynamoDB yang dibuat sebelumnya, dan bahkan menyebutkannya dalam komentar.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-7.png)
Hanya berdasarkan komentar dan konteksnya, Amazon Q memasok seluruh fungsi utama.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-8.1.png)
Yang tersisa hanyalah penjaga utama, dan Amazon Q tahu itu.
Hanya berdasarkan komentar dan konteksnya, Amazon Q memasok seluruh fungsi utama.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-9.png)
Akhirnya, pengembang menjalankan pengujian unit dari terminal IDE yang sama tempat pengkodean berlangsung.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whatis-demo-10.png)
# Menghasilkan saran sebaris di lingkungan AWS pengkodean
Selain pihak ketiga IDEs, Pengembang Amazon Q dapat menghasilkan saran sebaris dalam AWS layanan yang menyediakan lingkungan pengkodean mereka sendiri.
Bagian berikut menjelaskan cara mengatur saran kode inline Amazon Q dalam AWS layanan terintegrasi.
**catatan**
Jika Anda menggunakan Amazon Q sebagai bagian dari perusahaan, maka Anda menggunakan Amazon Q Developer Pro. Dalam hal ini, administrator di organisasi Anda harus menyelesaikan langkah-langkah tambahan sebelum Anda dapat memulai pengkodean. Lihat informasi yang lebih lengkap di [Memulai dengan Amazon Q Developer](getting-started-q-dev.md).
**Topics**
+ [Menggunakan Pengembang Amazon Q dengan Amazon SageMaker AI Studio](sagemaker-setup.md)
+ [Menggunakan Amazon Q Developer dengan JupyterLab](jupyterlab-setup.md)
+ [Menggunakan Pengembang Amazon Q dengan Amazon EMR Studio](emr-setup.md)
+ [Menggunakan Amazon Q Developer dengan AWS Glue Studio](glue-setup.md)
+ [Menggunakan Amazon Q Developer dengan AWS Lambda](lambda-setup.md)
+ [Menggunakan Amazon Q Developer dengan layanan lain](other-setup.md)
# Menggunakan Pengembang Amazon Q dengan Amazon SageMaker AI Studio
Anda dapat mengobrol dengan Amazon Q di dalam Amazon SageMaker AI Studio. Anda juga dapat membuat rekomendasi kode secara otomatis saat Anda menulis kode Anda.
Untuk menggunakan Amazon Q Developer dengan Amazon SageMaker AI Studio, Anda harus menambahkan izin Amazon Q ke peran eksekusi SageMaker AI Anda. Cara Anda mengonfigurasi izin tergantung pada apakah Anda menggunakan tingkat Amazon Q Developer Free atau Pro tier.
Untuk menyiapkan dan mengaktifkan Amazon Q untuk Amazon SageMaker AI Studio, lihat [Mengatur Pengembang Amazon Q untuk pengguna Anda](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-jl-admin-guide-set-up.html) di *Panduan Pengguna Amazon SageMaker AI*.
# Menggunakan Amazon Q Developer dengan JupyterLab
Halaman ini menjelaskan cara mengatur dan mengaktifkan Pengembang Amazon Q untuk JupyterLab. Setelah diaktifkan, Amazon Q dapat membuat rekomendasi kode secara otomatis saat Anda menulis kode Anda.
**catatan**
Python adalah satu-satunya bahasa pemrograman yang didukung Amazon Q. JupyterLab
## Instalasi JupyterLab
Instal [JupyterLab](https://pypi.org/project/jupyterlab)di komputer Anda atau jika Anda sudah JupyterLab menginstal, periksa versinya dengan menjalankan perintah berikut.
```
pip show jupyterlab
```
Perhatikan versi dalam respons, dan ikuti petunjuk yang sesuai di salah satu bagian berikut.
## Instalasi menggunakan pip untuk versi Jupyter Lab >= 4.0
Anda dapat menginstal dan mengaktifkan ekstensi Amazon Q untuk JupyterLab 4 dengan perintah berikut.
```
# JupyterLab 4
pip install amazon-q-developer-jupyterlab-ext
```
## Instalasi menggunakan pip untuk versi Jupyter Lab >= 3.6 dan < 4.0
Anda dapat menginstal dan mengaktifkan ekstensi Amazon Q untuk JupyterLab 3 dengan perintah berikut.
```
# JupyterLab 3
pip install amazon-q-developer-jupyterlab-ext~=3.0
jupyter server extension enable amazon-q-developer-jupyterlab-ext
```
## Autentikasi dengan ID AWS Builder
Dalam prosedur berikut, Anda akan mengatur Builder ID, yang akan Anda gunakan untuk mengautentikasi saat Anda mengaktifkan Amazon Q.
1. Segarkan tab browser yang Anda gunakan JupyterLab.
1. Dari panel Amazon Q di bagian bawah jendela, pilih **Memulai**.
1. Dari jendela pop-up, pilih **Salin Kode dan Lanjutkan**.
1. Pada halaman **Memulai**, masuk atau mendaftar untuk Builder ID menggunakan alamat email atau akun Google Anda. Untuk informasi selengkapnya, lihat [Memulai dengan akun pribadi (Builder ID)](getting-started-builderid.md).
Jika Anda sudah memiliki Builder ID, lewati ke langkah tentang halaman **permintaan Otorisasi**.
1. Setelah Anda menerima kode verifikasi email, masukkan kode tersebut di kolom kosong dan pilih **Verifikasi**.
1. Pada layar berikutnya, pilih dan konfirmasikan kata sandi, lalu pilih **Buat ID AWS Builder**
1. Pada halaman berikutnya pilih **Izinkan** untuk mengizinkan Amazon Q mengakses data Anda.
Sekarang Anda harus masuk ke Amazon Q in JupyterLab dengan Builder ID.
Untuk memulai pengkodean, lihat[Menggunakan tombol pintas](actions-and-shortcuts.md).
![\[Contoh Amazon Q yang digunakan dengan JupyterLab.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/qdev-demo-example.png)
# Menggunakan Pengembang Amazon Q dengan Amazon EMR Studio
Halaman ini menjelaskan cara mengatur dan mengaktifkan Pengembang Amazon Q untuk Amazon EMR Studio. Setelah diaktifkan, Amazon Q dapat membuat rekomendasi kode secara otomatis saat Anda menulis kode ETL Anda.
**catatan**
Amazon Q mendukung Python, yang dapat digunakan untuk kode skrip ETL untuk pekerjaan Spark di Amazon EMR Studio.
Gunakan prosedur berikut untuk mengatur Amazon EMR Studio agar bekerja dengan Amazon Q.
1. Siapkan [Notebook Amazon EMR Studio](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-managed-notebooks-create.html).
1. Lampirkan kebijakan berikut ke peran pengguna IAM untuk Amazon EMR Studio Notebook.
**catatan**
`codewhisperer`Awalan adalah nama lama dari layanan yang digabungkan dengan Amazon Q Developer. Untuk informasi selengkapnya, lihat [Ganti nama Pengembang Amazon Q - Ringkasan perubahan](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Buka [konsol Amazon EMR](https://console.aws.amazon.com/emr).
1. Di Amazon EMR Studio, pilih **Ruang Kerja (**Notebook).
1. Pilih Ruang Kerja yang Anda inginkan dan pilih **Peluncuran cepat**.
# Menggunakan Amazon Q Developer dengan AWS Glue Studio
Halaman ini menjelaskan cara mengatur dan mengaktifkan Amazon Q Developer for [AWS Glue Studio Notebook](https://docs.aws.amazon.com/glue/latest/ug/notebooks-chapter.html). Setelah diaktifkan, Amazon Q dapat membuat rekomendasi kode secara otomatis saat Anda menulis kode ETL Anda.
**catatan**
Amazon Q mendukung Python dan Scala, dua bahasa yang digunakan untuk pengkodean skrip ETL untuk pekerjaan Spark di Studio. AWS Glue
Dalam prosedur berikut, Anda akan mengatur AWS Glue untuk bekerja dengan Amazon Q.
1. [Siapkan Notebook AWS Glue Studio](https://docs.aws.amazon.com/glue/latest/ug/notebook-getting-started.html).
1. Lampirkan kebijakan berikut ke peran IAM Anda untuk notebook Glue Studio
**catatan**
`codewhisperer`Awalan adalah nama lama dari layanan yang digabungkan dengan Amazon Q Developer. Untuk informasi selengkapnya, lihat [Ganti nama Pengembang Amazon Q - Ringkasan perubahan](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Buka [konsol Glue](https://console.aws.amazon.com/glue)
1. Di bawah **pekerjaan ETL**, pilih **Notebook**.
1. Verifikasi bahwa **Notebook Jupyter dipilih**. Pilih **Buat**.
1. Masukkan **nama Job**.
1. Untuk peran IAM, pilih peran yang Anda konfigurasikan untuk berinteraksi dengan Amazon Q
1. Pilih **Mulai buku catatan**.
# Menggunakan Amazon Q Developer dengan AWS Lambda
Dokumen ini menjelaskan cara mengatur dan mengaktifkan Amazon Q Developer untuk konsol Lambda. Setelah diaktifkan, Amazon Q dapat membuat rekomendasi kode sesuai permintaan di editor kode Lambda saat Anda mengembangkan fungsi Anda.
**catatan**
Di konsol Lambda, Amazon Q hanya mendukung fungsi menggunakan runtime Python dan Node.js.
## AWS Identity and Access Management izin untuk Lambda
Agar Amazon Q dapat memberikan rekomendasi di konsol Lambda, Anda harus mengaktifkan izin IAM yang benar untuk pengguna atau peran IAM Anda. Anda harus menambahkan `codewhisperer:GenerateRecommendations` izin, sebagaimana diuraikan dalam contoh kebijakan IAM di bawah ini:
**catatan**
`codewhisperer`Awalan adalah nama lama dari layanan yang digabungkan dengan Amazon Q Developer. Untuk informasi selengkapnya, lihat [Ganti nama Pengembang Amazon Q - Ringkasan perubahan](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": ["codewhisperer:GenerateRecommendations"],
"Resource": "*"
}
]
}
```
------
Praktik terbaik adalah menggunakan kebijakan IAM untuk memberikan izin terbatas kepada prinsipal IAM. Untuk detail tentang bekerja dengan IAM AWS Lambda, lihat [Identitas dan manajemen akses AWS Lambda di](https://docs.aws.amazon.com/lambda/latest/dg/security-iam.html) *Panduan AWS Lambda Pengembang*.
## Mengaktifkan Pengembang Amazon Q dengan Lambda
Untuk mengaktifkan Amazon Q di editor kode konsol Lambda, selesaikan langkah-langkah ini.
1. Buka [halaman Fungsi](https://console.aws.amazon.com/lambda/home#/functions) konsol Lambda, dan pilih fungsi yang ingin Anda edit.
1. Saat Anda mengetik editor kode, saran kode otomatis dari Amazon Q diaktifkan secara default. Untuk menjeda saran, pilih **Amazon Q** di sudut kiri bawah panel **sumber Kode**. Palet perintah terbuka di bagian atas panel sumber Kode. Dari sana, pilih **Jeda saran otomatis**.
Untuk tombol pintas, lihat[Menggunakan tombol pintas](actions-and-shortcuts.md).
# Menggunakan Amazon Q Developer dengan layanan lain
## AWS Identity and Access Management izin untuk layanan lain
Agar Amazon Q dapat memberikan rekomendasi dalam konteks layanan lain, Anda harus mengaktifkan izin IAM yang benar untuk pengguna atau peran IAM Anda. Anda harus menambahkan `codewhisperer:GenerateRecommendations` izin, sebagaimana diuraikan dalam contoh kebijakan IAM di bawah ini:
**catatan**
`codewhisperer`Awalan adalah nama lama dari layanan yang digabungkan dengan Amazon Q Developer. Untuk informasi selengkapnya, lihat [Ganti nama Pengembang Amazon Q - Ringkasan perubahan](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": ["codewhisperer:GenerateRecommendations"],
"Resource": "*"
}
]
}
```
------
Ini adalah praktik terbaik untuk menggunakan kebijakan IAM untuk memberikan izin terbatas kepada prinsipal IAM. Untuk detail tentang bekerja dengan IAM, lihat [Praktik terbaik keamanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) di panduan *pengguna IAM*.
# Menggunakan tombol pintas
Saat mendapatkan saran sebaris dari Amazon Q, Anda dapat menggunakan pintasan keyboard untuk tindakan umum yang Anda lakukan, seperti memulai Amazon Q atau menerima rekomendasi.
Pilih lingkungan pengembangan terintegrasi (IDE) tempat Anda mengembangkan kode untuk melihat pintasan keyboard untuk IDE Anda.
------
#### [ Kode Studio Visual ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya | Panah kanan |
| Rekomendasi sebelumnya | Panah kiri |
| Tolak rekomendasi | ESC, backspace, atau terus mengetik dan rekomendasi akan hilang segera setelah ada ketidakcocokan karakter. |
| Terima kata berikutnya | Cmd \$1 panah kanan |
Untuk mengubah ikatan kunci di VS Code, lihat [Pengikatan Kunci untuk Kode Visual Studio di situs web VS Code](https://code.visualstudio.com/docs/getstarted/keybindings).
**catatan**
Bilah alat saran sebaris di VS Code dinonaktifkan secara default. Untuk informasi selengkapnya, lihat [Bilah alat saran sebaris yang dirancang ulang di situs](https://code.visualstudio.com/updates/v1_75#_redesigned-inline-suggestions-toolbar) web VS Code.
------
#### [ JetBrains ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya | Panah kanan |
| Rekomendasi sebelumnya | Panah kiri |
| Tolak rekomendasi | ESC, backspace, atau terus mengetik dan rekomendasi akan hilang segera setelah ada ketidakcocokan karakter. |
[Untuk mengubah ikatan kunci di IntelliJ, lihat pintasan keyboard IntelliJ IDEA di situs web.](https://www.jetbrains.com/help/idea/mastering-keyboard-shortcuts.html) JetBrains
------
#### [ Gerhana ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya | macOS: Opsi \$1] Windows: Alt \$1] |
| Rekomendasi sebelumnya | macOS: Opsi \$1 [ Windows: Alt \$1 [ |
| Tolak rekomendasi | ESC, backspace, atau terus mengetik dan rekomendasi akan hilang segera setelah ada ketidakcocokan karakter. |
Untuk mengubah ikatan kunciEclipse, lihat [Mengubah binding kunci dalam](https://help.eclipse.org/latest/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftkeybindings.htm) dokumentasi. Eclipse
------
#### [ Toolkit for Visual Studio ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual `AWSToolkit.CodeWhisperer.GetSuggestion`di keybindings | Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya `Edit.NextSuggestion`di keybindings | Windows: Alt \$1. |
| Rekomendasi sebelumnya `Edit.PreviousSuggestion`di keybindings | Windows: Alt \$1, |
| Tolak rekomendasi | ESC, backspace, atau terus mengetik dan rekomendasi akan hilang segera setelah ada ketidakcocokan karakter. |
Lihat juga [pintasan keyboard default Visual Studio](https://visualstudio.microsoft.com/keyboard-shortcuts.pdf) Microsoft.
Untuk mengubah keybinding di Visual Studio, gunakan Tools -> Options -> Keyboard.
------
#### [ Amazon SageMaker AI ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya | Panah bawah |
| Rekomendasi sebelumnya | Panah atas |
| Tolak rekomendasi | ESC |
------
#### [ JupyterLab ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya | Panah bawah |
| Rekomendasi sebelumnya | Panah atas |
| Tolak rekomendasi | ESC |
------
#### [ AWS Glue Studio Notebook ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Memulai Amazon Q secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima rekomendasi | Tab |
| Rekomendasi berikutnya | Panah bawah |
| Rekomendasi sebelumnya | Panah atas |
| Tolak rekomendasi | ESC |
------
#### [ AWS Lambda ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Ambil saran kode secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima saran | Tab |
| Tolak saran | ESC, Backspace, gulir ke segala arah, atau terus mengetik dan rekomendasi secara otomatis menghilang. |
Untuk mengubah binding kunci, gunakan prosedur berikut.
1. Saat melihat fungsi tertentu, pilih ikon roda gigi untuk membuka tab **Preferensi**.
1. Pada tab **Preferensi**, pilih **Keybindings**.
1. Di kotak pencarian keybinding, masukkan Amazon Q.
![\[Keybindings settings in AWS Cloud9 IDE with Amazon CodeWhisperer option highlighted.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/CWSPR-Lambda-keybinding-settings.png)
------
#### [ AWS Cloud9 ]
| Tindakan | Pintasan keyboard |
| --- | --- |
| Ambil saran kode secara manual | macOS: Opsi\$1C Windows: Alt\$1C |
| Terima saran | Tab |
| Tolak saran | ESC, Backspace, gulir ke segala arah, atau terus mengetik dan rekomendasi secara otomatis menghilang. |
1. Saat melihat lingkungan tertentu, pilih ikon roda gigi untuk membuka tab **Preferensi**.
1. Pada tab **Preferensi**, pilih **Keybindings**.
1. Di kotak pencarian keybinding, masukkan Amazon Q.
1. Di kolom Keystroke, klik dua kali spasi yang sesuai dengan fungsi yang Anda minati.
1. Masukkan tombol yang ingin Anda ikat fungsinya.
![\[AWS Cloud9 interface showing Keybindings settings with options for keyboard mode and custom keybindings.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/CWSPR-C9-keybinding-settings.png)
------
# Menggunakan referensi kode
Amazon Q belajar, sebagian, dari proyek sumber terbuka. Terkadang, saran yang diberikan kepada Anda mungkin mirip dengan kode yang tersedia untuk umum. Referensi kode mencakup informasi tentang sumber Amazon Q yang digunakan untuk menghasilkan rekomendasi.
**Topics**
+ [Lihat dan perbarui referensi kode](#show-code-reference)
+ [Matikan dan aktifkan referensi kode](#toggle-code-reference)
+ [Menyisih dari kode dengan referensi](#opt-out-code-reference)
## Lihat dan perbarui referensi kode
Dengan log referensi, Anda dapat melihat referensi ke rekomendasi kode yang mirip dengan kode yang tersedia untuk umum. Anda juga dapat memperbarui dan mengedit rekomendasi kode yang disarankan oleh Amazon Q.
Pilih IDE Anda untuk melihat langkah-langkah cara melihat dan memperbarui referensi kode.
------
#### [ Kode Studio Visual ]
Untuk menampilkan log masuk referensi Amazon QVS Code, gunakan prosedur berikut.
1. Pastikan Anda menggunakan versi terbaru dari keduanya VS Code dan ekstensi Amazon Q.
1. DiVS Code, pilih **Amazon Q** dari baki komponen di bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka di bagian atas jendela IDE.
1. Pilih **Buka Log Referensi Kode**.
Tab log referensi kode terbuka. Referensi apa pun untuk rekomendasi kode terdaftar.
Gambar berikut menunjukkan bilah tugas Amazon Q terbuka dan tab log referensi kode.
![\[Referensi kode Q Amazon masukVisual Studio Code.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/VSC-coderef.png)
------
#### [ JetBrains ]
Untuk menampilkan log masuk referensi Amazon Q JetBrains IDEs, gunakan prosedur berikut.
1. Pastikan Anda menggunakan versi terbaru dari JetBrains IDE Anda dan plugin Amazon Q.
1. DiJetBrains, pilih **Amazon Q** dari bilah status di bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka di atas bilah status.
1. Pilih **Buka Log Referensi Kode**.
Tab log referensi kode terbuka. Referensi apa pun untuk rekomendasi kode terdaftar.
Gambar berikut menunjukkan bilah tugas Amazon Q terbuka dan tab log referensi kode.
![\[Referensi kode Q Amazon masukJetBrains.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/JB-coderef.png)
------
#### [ Gerhana ]
Untuk menampilkan log masuk referensi Amazon Q Eclipse IDEs, gunakan prosedur berikut.
1. Pastikan Anda menggunakan versi terbaru dari Eclipse IDE dan plugin Amazon Q.
1. Di Eclipse IDE Anda, pilih ikon **Amazon Q** di sudut kanan atas IDE.
1. Dengan tab obrolan Amazon Q terbuka, pilih ikon elipsis di sudut kanan atas tab. Bilah tugas Amazon Q terbuka.
Gambar berikut menunjukkan task bar Amazon Q di Eclipse IDE.
![\[Bilah tugas Amazon Q di Eclipse IDE.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/eclipse-taskbar.png)
1. Pilih **Buka Log Referensi Kode**.
Tab log referensi kode terbuka. Referensi apa pun untuk rekomendasi kode terdaftar.
------
#### [ Toolkit for Visual Studio ]
Saat Amazon Q menyarankan kode yang berisi referensi di Toolkit for Visual Studio, jenis referensi akan muncul di deskripsi saran.
![\[Code snippet showing a function to create a DynamoDB table with 'Products' as the table name.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/visual-studio-view-code-suggestions.png)
Semua saran yang diterima yang berisi referensi ditangkap dalam log referensi.
Untuk mengakses log referensi, pilih AWS ikon, lalu pilih **Buka Log Referensi Kode**.
Daftar saran yang diterima yang berisi referensi akan muncul. Daftar ini meliputi:
+ Lokasi di mana saran itu diterima. Klik dua kali pada ini akan membawa Anda ke lokasi itu dalam kode Anda.
+ Lisensi terkait
+ Kode sumber yang direferensikan
+ Fragmen kode yang dikaitkan dengan referensi
![\[CodeWhisperer Reference Log output showing accepted recommendation with MIT license.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/vstudio-reference-log2.png)
------
#### [ AWS Cloud 9 ]
Saat Anda menggunakan Amazon Q dengan AWS Cloud 9, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Di konsol AWS Cloud 9, di sudut kiri atas, pilih logo AWS Cloud 9.
1. **Dari menu tarik-turun, pilih Preferensi.**
Di sisi kanan konsol, tab **Preferensi** akan terbuka.
1. Pada tab **Preferensi**, di bawah **Pengaturan Proyek**, di bawah **Ekstensi**, pilih **AWS Toolkit**.
1. Pilih atau batal pilihan **Amazon Q: Sertakan Saran Dengan Referensi Kode**.
------
#### [ Lambda ]
Amazon Q di Lambda tidak mendukung referensi kode. Saat Anda menggunakan Amazon Q dengan Lambda, saran kode apa pun dengan referensi dihilangkan.
------
#### [ SageMaker AI Studio ]
Untuk menampilkan log referensi Amazon Q di SageMaker AI Studio, gunakan prosedur berikut.
1. Di bagian bawah jendela SageMaker AI Studio, buka panel Amazon Q.
1. Pilih **Buka Log Referensi Kode**.
------
#### [ JupyterLab ]
Untuk menampilkan log masuk referensi Amazon Q JupyterLab, gunakan prosedur berikut.
1. Di bagian bawah JupyterLab jendela, buka panel Amazon Q.
1. Pilih **Buka Log Referensi Kode**.
------
#### [ AWS Glue Studio Notebook ]
Untuk menampilkan log referensi Amazon Q di AWS Glue Studio Notebook, gunakan prosedur berikut.
1. Di bagian bawah jendela AWS Glue Studio Notebook, buka panel Amazon Q.
1. Pilih **Buka Log Referensi Kode**.
------
## Matikan dan aktifkan referensi kode
Di sebagian besar IDEs, referensi kode aktif secara default. Pilih IDE Anda untuk melihat langkah-langkah cara menonaktifkan atau mengaktifkan referensi kode.
------
#### [ Kode Studio Visual ]
Saat Anda menggunakan Amazon Q denganVS Code, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Pastikan Anda menggunakan versi terbaru dari keduanya VS Code dan ekstensi Amazon Q.
1. DiVS Code, pilih **Amazon Q** dari baki komponen di bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka di bagian atas jendela IDE.
1. Pilih **Buka Pengaturan**. Tab pengaturan terbuka dengan opsi yang terkait dengan Amazon Q ditampilkan.
1. Pilih atau batal pilihan kotak di samping **Tampilkan Kode Dengan Referensi**.
------
#### [ JetBrains ]
Saat Anda menggunakan Amazon Q dengan JetBrains IDE Anda, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Pastikan Anda menggunakan versi terbaru dari JetBrains IDE Anda dan plugin Amazon Q.
1. DiJetBrains, pilih **Amazon Q** dari bilah status di bagian bawah jendela IDE.
Bilah tugas Amazon Q terbuka di atas bilah status.
1. Pilih **Buka Pengaturan**. Jendela pengaturan terbuka dengan opsi yang terkait dengan Amazon Q ditampilkan.
1. Pilih atau batal pilihan kotak di samping **Tampilkan Kode Dengan Referensi**.
------
#### [ Gerhana ]
Saat Anda menggunakan Amazon Q denganEclipse, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Pastikan Anda menggunakan versi terbaru dari Eclipse IDE dan plugin Amazon Q.
1. Buka **Pengaturan** di Eclipse IDE Anda.
1. Pilih **Amazon Q** dari bilah navigasi kiri.
1. Pilih atau batal pilihan kotak di samping **Tampilkan Kode Dengan Referensi**.
1. Pilih **Terapkan** untuk menyimpan perubahan Anda.
------
#### [ Toolkit for Visual Studio ]
Saat Anda menggunakan Amazon Q di Toolkit for Visual Studio, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Pastikan Anda menggunakan Toolkit for Visual Studio versi terbaru.
1. Buka **Opsi** di Visual Studio.
1. Pilih **AWS Toolkit** dari bilah navigasi kiri, lalu pilih **Amazon Q**.
1. Dari dropdown di samping **Sertakan Saran Dengan Referensi**, pilih Benar atau Salah.
1. Pilih **OK** untuk menyimpan perubahan Anda.
------
#### [ AWS Cloud 9 ]
Saat Anda menggunakan Amazon Q dengan AWS Cloud 9, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Di konsol AWS Cloud 9, di sudut kiri atas, pilih logo AWS Cloud 9.
1. **Dari menu tarik-turun, pilih Preferensi.**
Di sisi kanan konsol, tab **Preferensi** akan terbuka.
1. Pada tab **Preferensi**, di bawah **Pengaturan Proyek**, di bawah **Ekstensi**, pilih **AWS Toolkit**.
1. Pilih atau batal pilihan **Amazon Q: Sertakan Saran Dengan Referensi Kode**.
------
#### [ Lambda ]
Amazon Q di Lambda tidak mendukung referensi kode. Saat Anda menggunakan Amazon Q dengan Lambda, saran kode apa pun dengan referensi dihilangkan.
------
#### [ SageMaker AI Studio ]
Saat Anda menggunakan Amazon Q dengan SageMaker AI Studio, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Dari bagian atas jendela SageMaker AI Studio pilih **Pengaturan**.
1. Dari menu tarik-turun **Pengaturan**, pilih Editor **Pengaturan Lanjut**.
1. Di dropdown Amazon Q, pilih atau batal pilihan kotak di sebelah **Aktifkan saran dengan** referensi kode.
------
#### [ JupyterLab ]
Saat Anda menggunakan Amazon Q dengan JupyterLab, referensi kode aktif secara default.
Untuk mematikannya, atau menyalakannya kembali nanti, gunakan prosedur berikut.
1. Dari bagian atas JupyterLab jendela pilih **Pengaturan**.
1. Dari menu tarik-turun **Pengaturan**, pilih Editor **Pengaturan Lanjut**.
1. Di dropdown Amazon Q, pilih atau batal pilihan kotak di sebelah **Aktifkan saran dengan** referensi kode.
------
#### [ AWS Glue Studio Notebook ]
1. Dari bagian bawah jendela AWS Glue Studio Notebook pilih **Amazon Q**.
1. Dari menu pop-up, alihkan sakelar di sebelah **Kode** dengan referensi.
**catatan**
Menjeda referensi kode hanya akan berlaku selama durasi Notebook AWS Glue Studio saat ini.
------
## Menyisih dari kode dengan referensi
Di beberapa IDEs, Anda dapat memilih untuk tidak menerima saran dengan referensi di tingkat administrator.
Pilih IDE Anda untuk melihat langkah-langkah untuk memilih keluar sebagai administrator.
------
#### [ Kode Studio Visual ]
Jika Anda seorang administrator perusahaan, Anda dapat memilih keluar dari saran dengan referensi kode untuk seluruh organisasi Anda. Jika Anda melakukan ini, pengembang individu di organisasi Anda tidak akan dapat memilih kembali melalui IDE. Pengembang tersebut akan dapat memilih dan membatalkan pilihan kotak yang dibahas di bagian sebelumnya, tetapi itu tidak akan berpengaruh jika Anda memilih keluar di tingkat perusahaan.
Untuk memilih keluar dari saran dengan referensi di tingkat perusahaan, gunakan prosedur berikut.
1. Di konsol Pengembang Amazon Q, pilih **Pengaturan**.
1. Di panel **detail akun Pengembang Amazon Q**, pilih **Edit**.
1. Pada halaman Edit detail, di panel **Pengaturan lanjutan**, batalkan pilihan **Sertakan saran dengan referensi kode**.
1. Pilih **Simpan perubahan**.
------
#### [ JetBrains ]
Jika Anda seorang administrator perusahaan, Anda dapat memilih keluar dari saran dengan referensi kode untuk seluruh organisasi Anda. Jika Anda melakukan ini, pengembang individu di organisasi Anda tidak akan dapat memilih kembali melalui IDE. Pengembang tersebut akan dapat memilih dan membatalkan pilihan kotak yang dibahas di bagian sebelumnya, tetapi itu tidak akan berpengaruh jika Anda memilih keluar di tingkat perusahaan.
Untuk memilih keluar dari saran dengan referensi di tingkat perusahaan, gunakan prosedur berikut.
1. Di konsol Pengembang Amazon Q, pilih **Pengaturan**.
1. Di panel **detail akun Pengembang Amazon Q**, pilih **Edit**.
1. Pada halaman Edit detail, di panel **Pengaturan lanjutan**, batalkan pilihan **Sertakan saran dengan referensi kode**.
1. Pilih **Simpan perubahan**.
------
#### [ Gerhana ]
Jika Anda seorang administrator perusahaan, Anda dapat memilih keluar dari saran dengan referensi kode untuk seluruh organisasi Anda. Jika Anda melakukan ini, pengembang individu di organisasi Anda tidak akan dapat memilih kembali melalui IDE. Pengembang tersebut akan dapat memilih dan membatalkan pilihan kotak yang dibahas di bagian sebelumnya, tetapi itu tidak akan berpengaruh jika Anda memilih keluar di tingkat perusahaan.
Untuk memilih keluar dari saran dengan referensi di tingkat perusahaan, gunakan prosedur berikut.
1. Di konsol Pengembang Amazon Q, pilih **Pengaturan**.
1. Di panel **detail akun Pengembang Amazon Q**, pilih **Edit**.
1. Pada halaman Edit detail, di panel **Pengaturan lanjutan**, batalkan pilihan **Sertakan saran dengan referensi kode**.
1. Pilih **Simpan perubahan**.
------
#### [ Toolkit for Visual Studio ]
Untuk memilih keluar dari saran dengan referensi di tingkat perusahaan, gunakan prosedur berikut.
1. Anda bisa mendapatkan pengaturan referensi kode dengan salah satu dari dua cara:
1. Pilih ikon Amazon Q di tepi jendela, lalu pilih **Opsi...**
1. Buka **Alat** -> **AWS Toolkit** -> **Amazon Q**
1. Ubah sakelar ke **True** atau **False**, tergantung apakah Anda ingin menyertakan saran dengan referensi.
------
#### [ AWS Cloud 9 ]
Amazon Q di AWS Cloud 9 tidak mendukung memilih keluar dari saran kode dengan referensi di tingkat perusahaan.
Untuk memilih keluar di tingkat pengembang individu, lihat Mengubah referensi kode.
------
#### [ Lambda ]
Amazon Q di Lambda tidak mendukung referensi kode. Saat Anda menggunakan Amazon Q dengan Lambda, saran kode apa pun dengan referensi dihilangkan.
------
#### [ SageMaker AI Studio ]
Amazon Q tidak mendukung memilih keluar dari saran kode dengan referensi di tingkat perusahaan di SageMaker AI Studio.
------
#### [ JupyterLab ]
Amazon Q tidak mendukung memilih keluar dari saran kode dengan referensi di tingkat perusahaan di JupyterLab.
------
#### [ AWS Glue Studio Notebook ]
Amazon Q tidak mendukung memilih keluar dari saran kode dengan referensi di AWS Glue Studio Notebook.
------
# Contoh kode
Amazon Q dapat menyarankan kode dalam skenario yang berbeda. Untuk memahami bagaimana hal itu dapat membantu Anda saat Anda menulis kode dalam bahasa pemrograman pilihan Anda, lihat contoh kode berikut.
**Topics**
+ [Menggunakan Amazon Q Developer untuk penyelesaian kode satu baris](single-line-completion.md)
+ [Menggunakan Amazon Q Developer untuk pembuatan fungsi penuh](full-function-generation.md)
+ [Menggunakan Amazon Q Developer untuk penyelesaian blok](code-block.md)
+ [Menggunakan Amazon Q Developer untuk Docstring, JSDoc, dan penyelesaian Javadoc](docstring-javadoc.md)
+ [Menggunakan Pengembang Amazon Q untuk line-by-line rekomendasi](line-by-line-1.md)
# Menggunakan Amazon Q Developer untuk penyelesaian kode satu baris
Saat Anda mulai mengetik satu baris kode, Amazon Q membuat saran berdasarkan input Anda saat ini dan sebelumnya.
------
#### [ C\$1\$1 ]
![\[Contoh fitur penyelesaian satu baris menggunakan C ++.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/single-line-completion-c-plus.gif)
------
#### [ JavaScript ]
Dalam contoh ini, Amazon Q melengkapi baris kode yang dimulai pengembang.
![\[Contoh fitur penyelesaian satu baris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/javascript_vscode_SingleLine.gif)
------
#### [ TypeScript ]
Dalam contoh ini, pengguna memasukkan komentar lengkap, dan kemudian Amazon Q memasok kode yang menyertainya.
![\[Contoh fitur penyelesaian satu baris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/typescript_vscode_single-line.gif)
------
#### [ C\$1 ]
Dalam contoh ini, Amazon Q memberikan rekomendasi satu baris berdasarkan komentar.
![\[Contoh fitur penyelesaian baris tunggal.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/c-sharp-single-line.gif)
------
#### [ Shell ]
Pada gambar di bawah ini, Amazon Q menawarkan rekomendasi tentang cara menyelesaikan satu baris kode.
![\[Contoh fitur penyelesaian satu baris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/jb-single-line-shell.gif)
------
#### [ Java ]
Saat Anda mulai mengetik satu baris kode, Amazon Q membuat saran berdasarkan input Anda saat ini dan sebelumnya.
Pada contoh di bawah ini, di Java, pengguna memasukkan string `public` ke dalam kelas yang ada.
Berdasarkan masukan, Amazon Q menghasilkan saran untuk tanda tangan metode utama.
![\[Contoh fitur penyelesaian satu baris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-c9-single-line-completion.gif)
------
#### [ Python ]
Dalam contoh ini, Amazon Q merekomendasikan satu baris kode, berdasarkan komentar pengembang.
![\[Contoh fitur penyelesaian satu baris.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_singleline.gif)
------
# Menggunakan Amazon Q Developer untuk pembuatan fungsi penuh
Amazon Q dapat menghasilkan seluruh fungsi berdasarkan komentar yang telah Anda tulis. Saat Anda menyelesaikan komentar Anda, Amazon Q akan menyarankan tanda tangan fungsi. Jika Anda menerima saran tersebut, Amazon Q secara otomatis memajukan kursor Anda ke bagian berikutnya dari fungsi dan membuat saran. Bahkan jika Anda memasukkan komentar tambahan atau baris kode di antara saran, Amazon Q akan melakukan refactor berdasarkan masukan Anda.
------
#### [ C ]
![\[Contoh fitur penyelesaian fungsi penuh menggunakan C.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ C\$1\$1 ]
![\[Contoh fitur penyelesaian fungsi penuh menggunakan C ++.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ JavaScript ]
Dalam contoh berikut, pengguna menghasilkan, dan kemudian mengedit, fungsi penuh berdasarkan serangkaian komentar.
![\[Contoh fitur generasi fungsi penuh.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/javascript_lambda_FullFunctionGeneration.gif)
Pada gambar berikut, pengguna telah menulis tanda tangan fungsi untuk membaca file dari Amazon S3. Amazon Q kemudian menyarankan implementasi penuh dari `read_from_s3` metode ini.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-function-read-from-s3.png)
**catatan**
Terkadang, seperti pada contoh sebelumnya, Amazon Q menyertakan `import` pernyataan sebagai bagian dari sarannya. Sebagai praktik terbaik, pindahkan `import` pernyataan ini secara manual ke bagian atas file Anda.
Sebagai contoh lain, pada gambar berikut, pengguna telah menulis tanda tangan fungsi. Amazon Q kemudian menyarankan implementasi penuh dari `quicksort` metode ini.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-function-quicksort.png)
Amazon Q mempertimbangkan cuplikan kode sebelumnya saat membuat saran. Pada gambar berikut, pengguna dalam contoh sebelumnya telah menerima implementasi yang disarankan untuk `quicksort` di atas. Pengguna kemudian menulis tanda tangan fungsi lain untuk `sort` metode generik. Amazon Q kemudian menyarankan implementasi berdasarkan apa yang telah ditulis.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-function-from-context-sort.png)
Pada gambar berikut, pengguna telah menulis komentar. Berdasarkan komentar ini, Amazon Q kemudian menyarankan tanda tangan fungsi.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-comment-binary-search.png)
Pada gambar berikut, pengguna dalam contoh sebelumnya telah menerima tanda tangan fungsi yang disarankan. Amazon Q kemudian dapat menyarankan implementasi `binary_search` fungsi yang lengkap.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-function-binary-search.png)
------
#### [ Java ]
Daftar berikut berisi contoh bagaimana Amazon Q membuat saran dan memajukan Anda melalui seluruh proses pembuatan fungsi.
1. Dalam contoh berikut, pengguna memasukkan komentar. Amazon Q menyarankan tanda tangan fungsi.
Setelah pengguna menerima saran itu, Amazon Q menyarankan badan fungsi.
![\[Contoh fungsi yang dihasilkan dari komentar.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment.gif)
1. Pada gambar di bawah, pengguna memasukkan komentar di badan fungsi sebelum menerima saran dari Amazon Q. Pada baris berikut, Amazon Q menghasilkan saran berdasarkan komentar.
![\[Contoh fungsi yang dihasilkan dari komentar di dalam blok kode yang ada.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment-within-block.gif)
------
#### [ C\$1 ]
Dalam contoh berikut, Amazon Q merekomendasikan fungsi penuh.
![\[Function declaration for ListTables with AmazonDynamoDBClient parameter in code editor.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/c-sharp-full-function.gif)
------
#### [ TypeScript ]
Dalam contoh berikut, Amazon Q menghasilkan fungsi berdasarkan docstring pengguna.
![\[Contoh fitur penyelesaian fungsi penuh.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/typescript_vscode_function.gif)
------
#### [ Python ]
Amazon Q dapat menghasilkan seluruh fungsi berdasarkan komentar yang telah Anda tulis. Saat Anda menyelesaikan komentar Anda, Amazon Q akan menyarankan tanda tangan fungsi. Jika Anda menerima saran tersebut, Amazon Q secara otomatis memajukan kursor Anda ke bagian berikutnya dari fungsi dan membuat saran. Bahkan jika Anda memasukkan komentar tambahan atau baris kode di antara saran, Amazon Q akan melakukan refactor berdasarkan masukan Anda.
Dalam contoh berikut, Amazon Q menghasilkan fungsi penuh dan pengujian unit yang sesuai.
![\[Contoh fitur penyelesaian fungsi penuh.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/python_pycharm_fullfunction_unittests.GIF)
Daftar berikut berisi contoh bagaimana Amazon Q membuat saran dan memajukan Anda melalui seluruh proses pembuatan fungsi.
1. Pada gambar di bawah ini, pengguna memiliki masukan komentar. Tanda tangan fungsi, yang terletak di bawah komentar, adalah saran dari Amazon Q.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-jb-comment-062022.png)
1. Pada gambar di bawah ini, pengguna telah menerima saran Amazon Q untuk tanda tangan fungsi. Menerima saran secara otomatis memajukan kursor dan Amazon Q telah membuat saran baru untuk badan fungsi.
![\[alt_text\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunctionadvance-062022.png)
1. Pada gambar di bawah ini, pengguna memasukkan komentar di badan fungsi sebelum menerima saran dari Amazon Q. Pada baris berikut, Amazon Q telah menghasilkan saran baru berdasarkan konten komentar.
![\[menghasilkan saran baru berdasarkan konten komentar\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunction-062022.png)
Dalam contoh ini, Amazon Q merekomendasikan fungsi penuh setelah pengguna mengetik bagian dari tanda tangan.
![\[Contoh fitur fungsi penuh.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_fullfunction.gif)
------
# Menggunakan Amazon Q Developer untuk penyelesaian blok
Penyelesaian blok digunakan untuk menyelesaikan blok `if/for/while/try` kode Anda.
------
#### [ C ]
![\[Contoh fitur penyelesaian blok menggunakan C\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/block-completion-c.gif)
------
#### [ C\$1\$1 ]
![\[Contoh fitur penyelesaian blok menggunakan C ++.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/block-completion-c-plus.gif)
------
#### [ Java ]
Dalam contoh di bawah ini, pengguna memasukkan tanda tangan `if` pernyataan. Isi pernyataan tersebut adalah saran dari Amazon Q.
![\[Contoh fitur penyelesaian blok.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-c9-block-completion.gif)
------
#### [ C\$1 ]
Pada gambar di bawah ini, Amazon Q merekomendasikan cara untuk menyelesaikan fungsi.
![\[Contoh fitur penyelesaian blok.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/c-sharp-block.gif)
------
#### [ TypeScript ]
Pada gambar di bawah ini, Amazon Q merekomendasikan cara untuk menyelesaikan fungsi.
![\[Contoh fitur penyelesaian blok.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/typescript_vscode_block-completion.gif)
------
#### [ Python ]
Dalam contoh ini, Amazon Q merekomendasikan blok kode, berdasarkan konteksnya.
![\[Contoh fitur blok kode.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_codeblock.gif)
------
# Menggunakan Amazon Q Developer untuk Docstring, JSDoc, dan penyelesaian Javadoc
Amazon Q dapat membantu Anda menghasilkan atau melengkapi dokumentasi di dalam kode Anda.
------
#### [ C\$1\$1 ]
![\[Contoh fitur penyelesaian docstring menggunakan C ++.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/docstring-completion-c-plus.gif)
------
#### [ Javascript ]
Dalam contoh ini, Amazon Q mengisi JSDoc parameter berdasarkan konstanta yang ada.
![\[Contoh fitur JSDoc penyelesaian.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/javascript_vscode_JSDocCompletion.gif)
------
#### [ C\$1 ]
Dalam contoh ini, Amazon Q mengisi JSDoc parameter berdasarkan konstanta yang ada.
![\[Contoh C3 dengan DocString penyelesaian.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/c-sharp-docstring.gif)
------
#### [ Java ]
Contoh berikut diadaptasi dari [contoh di situs web Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
Pada gambar di bawah ini, pengguna telah mulai memasukkan docstring. Amazon Q telah menyarankan kata-kata untuk ditambahkan ke docstring.
![\[menyarankan fungsi untuk menyelesaikan docstring\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/jb-docstring-java.png)
Contoh berikut diadaptasi dari [contoh di situs web Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
Pada contoh di bawah ini, di Java, pengguna memasukkan docstring. Amazon Q menyarankan fungsi untuk memproses docstring.
![\[Contoh penyelesaian kode berdasarkan Javadoc.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/cw-c9-javadoc.gif)
------
#### [ Python ]
Dalam contoh ini, Amazon Q merekomendasikan Docstring, berdasarkan konteks sekitarnya.
![\[Contoh fitur Docstring.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_commentblock.gif)
------
# Menggunakan Pengembang Amazon Q untuk line-by-line rekomendasi
Bergantung pada kasus penggunaan Anda, Amazon Q mungkin tidak dapat menghasilkan seluruh blok fungsi dalam satu rekomendasi. Namun, Amazon Q masih dapat memberikan line-by-line rekomendasi.
------
#### [ Go and GoLand ]
Dalam contoh ini, Amazon Q memberikan line-by-line rekomendasi.
![\[Contoh fitur line-by-line penyelesaian.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-go.gif)
Berikut adalah contoh line-by-line rekomendasi lainnya, kali ini dengan tes unit.
![\[Contoh fitur line-by-line penyelesaian.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-unit-test-go.gif)
------
#### [ C\$1\$1 and CLion ]
Dalam contoh ini, Amazon Q memberikan line-by-line rekomendasi.
![\[Contoh fitur line-by-line penyelesaian.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-cpp.gif)
------
#### [ Python ]
Pada gambar berikut, pelanggan telah menulis komentar awal yang menunjukkan bahwa mereka ingin mempublikasikan pesan ke grup Amazon CloudWatch Logs. Mengingat konteks ini, Amazon Q hanya dapat menyarankan kode inisialisasi klien dalam rekomendasi pertamanya, seperti yang ditunjukkan pada gambar berikut.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-1.png)
Namun, jika pengguna terus meminta line-by-line rekomendasi, Amazon Q juga terus menyarankan baris kode berdasarkan apa yang sudah ditulis.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-2.png)
**catatan**
Dalam contoh di atas, `VPCFlowLogs` mungkin bukan nilai konstanta yang benar. Saat Amazon Q memberikan saran, ingatlah untuk mengganti nama konstanta apa pun sesuai kebutuhan.
Amazon Q akhirnya dapat menyelesaikan seluruh blok kode seperti yang ditunjukkan pada gambar berikut.
![\[\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-3.png)
Dalam contoh ini, Amazon Q memberikan rekomendasi, satu baris pada waktu.
![\[Contoh fitur line-by-line penyelesaian.\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_linebyline.gif)
------
# Bahasa yang didukung untuk Pengembang Amazon Q di IDE
Anda dapat menggunakan fitur Amazon Q Developer berikut di IDE dengan bahasa pemrograman apa pun:
+ [Obrolan](q-in-IDE-chat.md)
+ [Obrolan sebaris](q-in-IDE-inline-chat.md)
Kualitas output saat menggunakan fitur-fitur ini bervariasi berdasarkan popularitas bahasa.
Untuk fitur Amazon Q yang tersisa di IDE, bahasa yang didukung tercantum di bagian berikut.
## Dukungan bahasa untuk saran sebaris
Amazon Q mendukung [saran kode inline](inline-suggestions.md) untuk beberapa bahasa pemrograman. Keakuratan dan kualitas pembuatan kode untuk bahasa pemrograman tergantung pada ukuran dan kualitas data pelatihan.
Dalam hal kualitas data pelatihan, bahasa pemrograman dengan dukungan paling banyak adalah:
+ C
+ C\$1\$1
+ C\$1
+ Dart
+ Go
+ Java
+ JavaScript
+ Kotlin
+ Lua
+ PHP
+ PowerShell
+ Python
+ R
+ Ruby
+ Karat
+ Skala
+ Cangkang
+ SQL
+ Cepat
+ SystemVerilog
+ TypeScript
Bahasa Infrastructure as Code (IAc) dengan dukungan terbanyak adalah:
+ CDK (TypeScript, Python)
+ HCL (Terraform)
+ JSON
+ YAML
## Dukungan bahasa untuk transformasi
Bahasa yang didukung untuk transformasi bergantung pada lingkungan tempat Anda mengubah kode.
Di JetBrains IDEs danVisual Studio Code, Amazon Q dapat mengubah kode dalam bahasa berikut:
+ [Java](code-transformation.md)
+ [Konversi SQL tertanam untuk migrasi database Oracle ke PostgreSQL](transform-sql.md)
Di Visual Studio, Amazon Q dapat mengubah kode dalam bahasa berikut:
+ [C \$1 dalam aplikasi.NET](transform-dotnet-IDE.md)
Untuk informasi selengkapnya tentang bahasa yang didukung dan prasyarat lain untuk transformasi, lihat topik untuk jenis transformasi yang Anda lakukan.
## Dukungan bahasa untuk ulasan kode
Amazon Q dapat membuat [ulasan kode](code-reviews.md) dan memberikan perbaikan kode otomatis untuk file dan proyek yang ditulis dalam bahasa berikut:
+ Java - Java 17 dan sebelumnya
+ JavaScript - ECMAScript 2021 dan sebelumnya
+ Python - Python 3.11 dan sebelumnya, dalam seri Python 3
+ C\$1 ‐ Semua versi (.NET 6.0 dan yang lebih baru direkomendasikan)
+ TypeScript - Semua versi
+ Ruby - Ruby 2.7 dan 3.2
+ Pergi - Pergi 1.18
+ C - C11 dan sebelumnya
+ C \$1\$1 - C\$1\$117 dan sebelumnya
+ PHP - PHP 8.2 dan sebelumnya
+ Kotlin - Kotlin 2.0.0 dan sebelumnya
+ Scala - Scala 3.2.2 dan sebelumnya
+ JSX - React 17 dan sebelumnya
+ Infrastruktur sebagai bahasa Kode (IAc)
+ CloudFormation ‐ 2010-09-09
+ Terraform - 1.6.2 dan sebelumnya
+ AWS CDK - TypeScript dan Python
## Dukungan bahasa untuk kustomisasi
Amazon Q mendukung bahasa berikut, dan menggunakan jenis file yang tercantum untuk membuat penyesuaian:
+ Bash/Shell (.sh, .zsh, .bash)
+ C (.c, .h)
+ C \$1 (.cs)
+ C\$1\$1 (.cpp, .hpp, .h)
+ Anak panah (.dart)
+ Pergi (.go)
+ HCL (.hcl)
+ HTML (.html, .htm)
+ Jawa (.java)
+ JavaScript (.js, .jsx)
+ JSON (.json)
+ Kotlin (.kt, .kts)
+ Penurunan harga (.md, .mdx)
+ PHP (.php)
+ Powershell (.ps1, .psm1, .psd1)
+ Python (.py)
+ reStructuredText (.rst)
+ Ruby (.rb)
+ Karat (.rs)
+ Scala (.scala)
+ Terraform (.tf, .tfvars)
+ Teks (.txt)
+ TypeScript (.ts, .tsx)
+ YAMM (.yaml, .yml)