Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyiapkan Amazon Q Developer untuk pengguna Anda
Amazon Q Developer adalah asisten percakapan AI generatif. Anda dapat mengatur Pengembang Amazon Q dalam domain baru atau domain yang sudah ada. Gunakan informasi berikut untuk menyiapkan Amazon Q Developer.
Dengan Amazon Q Developer, pengguna Anda dapat:
+ Dapatkan step-by-step panduan tentang penggunaan fitur SageMaker AI secara mandiri atau dalam kombinasi dengan AWS layanan lain.
+ Dapatkan kode sampel untuk memulai tugas ML Anda seperti persiapan data, pelatihan, inferensi, dan MLOps.
+ Terima bantuan pemecahan masalah untuk men-debug dan menyelesaikan kesalahan yang dihadapi saat menjalankan kode.
**catatan**
Pengembang Amazon Q di Studio tidak menggunakan konten pengguna untuk meningkatkan layanan, terlepas dari apakah Anda menggunakan langganan Free-tier atau Pro-tier. Untuk berbagi telemetri tingkat IDE, Amazon Q dapat melacak penggunaan pengguna Anda, seperti jumlah pertanyaan yang diajukan dan apakah rekomendasi diterima atau ditolak. Data telemetri ini tidak termasuk informasi yang dapat diidentifikasi secara pribadi seperti alamat IP pengguna. Untuk informasi selengkapnya tentang perlindungan data dan instruksi untuk [memilih keluar, lihat Menyisih dari berbagi data di IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html).
Anda dapat mengatur Pengembang Amazon Q dengan langganan tingkat Pro atau Gratis. Tingkat Pro adalah layanan berlangganan berbayar dengan batas penggunaan yang lebih tinggi dan fitur lainnya. Untuk informasi selengkapnya tentang perbedaan antara tingkatan, lihat [Memahami tingkatan layanan untuk Pengembang Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html).
Untuk informasi tentang berlangganan Amazon Q Developer Pro, lihat [Berlangganan Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html) Pro.
## Siapkan instruksi untuk Tingkat Gratis Pengembang Amazon Q:
Untuk mengatur Tingkat Gratis Pengembang Amazon Q, gunakan prosedur berikut:
**Untuk mengatur Tingkat Gratis Pengembang Amazon Q**
1. Tambahkan kebijakan berikut ke peran IAM yang Anda gunakan untuk membuat ruang JupyterLab atau Editor Kode:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"q:SendMessage"
],
"Resource": [
"*"
]
},
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Arahkan ke Amazon SageMaker Studio.
1. Buka ruang JupyterLab atau Editor Kode Anda.
1. Arahkan ke **Launcher** dan pilih **Terminal**.
1. Di JupyterLab, lakukan hal berikut:
1. Tentukan `restart-jupyter-server`.
1. Mulai ulang browser Anda dan navigasikan kembali ke Amazon SageMaker Studio.
## Siapkan instruksi untuk Amazon Q Developer Pro tier:
**Prasyarat**
Untuk mengatur Amazon Q Pro, Anda harus memiliki:
Domain Amazon SageMaker AI yang disiapkan untuk organisasi Anda dengan Pusat Identitas IAM yang dikonfigurasi sebagai sarana akses.
Langganan Amazon Q Developer Pro.
Jika memperbarui domain yang sudah disiapkan untuk organisasi, Anda perlu memperbaruinya untuk menggunakan Amazon Q Developer. Anda dapat menggunakan salah satu Konsol Manajemen AWS atau AWS Command Line Interface untuk memperbarui domain.
Anda harus menggunakan ARN dari profil Pengembang Amazon Q Anda. Anda dapat menemukan ARN Profil Q di halaman [Pengaturan Pengembang Q](https://console.aws.amazon.com/amazonq/developer/settings).
Anda dapat menggunakan AWS Command Line Interface perintah berikut untuk memperbarui domain Anda:
```
aws --region Wilayah AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"
```
Anda juga dapat menggunakan prosedur berikut untuk memperbarui domain di dalam Konsol Manajemen AWS.
1. Arahkan ke konsol [Amazon SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Pilih domain.
1. Pilih **Konfigurasi Aplikasi**.
1. Untuk **Pengembang Amazon Q untuk Aplikasi SageMaker AI**, pilih **Edit**.
1. Pilih **Aktifkan Pengembang Amazon Q di domain ini**.
1. Berikan Profil Q ARN.
1. Pilih **Kirim**.
Anda harus menggunakan ARN dari profil Pengembang Amazon Q Anda. Anda dapat menemukan ARN Profil Q di halaman **detail akun Amazon Q** di konsol [Pengembang Amazon Q](https://console.aws.amazon.com/amazonq/developer).
**Pengaturan untuk organisasi** adalah penyiapan lanjutan untuk domain Amazon SageMaker AI yang memungkinkan Anda menggunakan Pusat Identitas IAM. Untuk informasi tentang cara mengatur domain dan informasi tentang pengaturan Pusat Identitas IAM, lihat[Gunakan pengaturan khusus untuk Amazon SageMaker AI](onboard-custom.md).
Saat menyiapkan Amazon Q Developer di domain baru, Anda dapat menggunakan perintah Konsol Manajemen AWS atau AWS Command Line Interface perintah berikut dari mesin lokal Anda:
```
aws --region Wilayah AWS sagemaker create-domain --domain-id domain-id --domain-name "example-domain-name" --vpc-id example-vpc-id --subnet-ids example-subnet-ids --auth-mode SSO --default-user-settings "ExecutionRole=arn:aws:iam::111122223333:role/IAM-role",--domain-settings "AmazonQSettings={status=ENABLED,qProfileArn=Q-profile-ARN" --query example-domain-ARN--output text
```
Anda dapat menggunakan AWS CLI perintah berikut untuk menonaktifkan Pengembang Amazon Q:
```
aws --region Wilayah AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"
```
Kami merekomendasikan menggunakan versi terbaru dari AWS Command Line Interface. Untuk informasi tentang memperbarui AWS CLI, lihat [Menginstal atau memperbarui ke versi terbaru AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Jika Anda perlu membuat koneksi antara Amazon Q Developer dan VPC Anda, lihat [Membuat antarmuka VPC endpoint](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create) untuk Amazon Q.
**catatan**
Pengembang Amazon Q memiliki batasan berikut:
Itu tidak mendukung ruang bersama.
Amazon Q Developer mendeteksi apakah saran kode mungkin terlalu mirip dengan kode yang tersedia untuk umum. Pelacak referensi dapat menandai saran dengan repositori URLs dan lisensi, atau memfilternya. Ini memungkinkan Anda untuk meninjau kode yang direferensikan dan penggunaannya sebelum Anda mengadopsinya. Semua referensi dicatat untuk Anda tinjau nanti untuk memastikan bahwa aliran kode Anda tidak terganggu dan Anda dapat terus mengkodekan tanpa gangguan.
Untuk informasi selengkapnya tentang referensi kode, lihat [Menggunakan referensi kode - Pengembang Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html) dan [Asisten Pengkodean AI - Pengembang Amazon Q FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F).
Amazon Q memproses semua data interaksi pengguna di Timur AS (Virginia N.) Wilayah AWS. Untuk informasi selengkapnya tentang cara Amazon Q memproses data dan Wilayah AWS mendukungnya, lihat [Wilayah yang Didukung untuk Pengembang Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html).
Amazon Q hanya berfungsi di Amazon SageMaker Studio. Itu tidak didukung dalam Amazon SageMaker Studio Classic.
Pada JupyterLab, Amazon Q bekerja dalam SageMaker AI Distribution Images versi 2.0 ke atas. Pada Code Editor, Amazon Q bekerja dalam SageMaker AI Distribution Images versi 2.2.1 dan yang lebih baru.
Pengembang Amazon Q JupyterLab bekerja dalam ekstensi Jupyter AI. Anda tidak dapat menggunakan model 3P lainnya dalam ekstensi saat Anda menggunakan Amazon Q.
## Kustomisasi Amazon Q di Amazon SageMaker AI
Jika Anda menggunakan Amazon Q Developer Pro, Anda memiliki opsi untuk membuat *penyesuaian*. Dengan penyesuaian, Amazon Q Developer memberikan saran berdasarkan basis kode perusahaan Anda. Jika Anda membuat kustomisasi di Amazon Q Developer, mereka akan tersedia untuk Anda gunakan JupyterLab dan Editor Kode di Amazon SageMaker Studio. Untuk informasi selengkapnya tentang menyiapkan penyesuaian, lihat [Menyesuaikan saran di Panduan Pengguna](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) *Pengembang Amazon Q*.