Menyiapkan Amazon Q Developer untuk pengguna Anda - Amazon SageMaker AI
Kustomisasi Amazon Q di Amazon SageMaker AI

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.

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.

Untuk informasi tentang berlangganan Amazon Q Developer Pro, lihat Berlangganan Amazon Q Developer Pro.

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": "*"
		}
	]
}

  2. Arahkan ke Amazon SageMaker Studio.

  3. Buka ruang JupyterLab atau Editor Kode Anda.

  4. Arahkan ke Launcher dan pilih Terminal.

  5. Di JupyterLab, lakukan hal berikut:

    1. Tentukan restart-jupyter-server.

    2. Mulai ulang browser Anda dan navigasikan kembali ke Amazon SageMaker Studio.

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 AWS Management Console atau AWS Command Line Interface untuk memperbarui domain.

Anda harus menggunakan ARN profil Pengembang Amazon Q Anda. Anda dapat menemukan ARN Profil Q di halaman Pengaturan Pengembang Q.

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 AWS Management Console.

  1. Arahkan ke konsol Amazon SageMaker AI.

  2. Pilih domain.

  3. Pilih Konfigurasi Aplikasi.

  4. Untuk Pengembang Amazon Q untuk Aplikasi SageMaker AI, pilih Edit.

  5. Pilih Aktifkan Pengembang Amazon Q di domain ini.

  6. Berikan Profil Q ARN.

  7. Pilih Kirim.

Anda harus menggunakan ARN profil Pengembang Amazon Q Anda. Anda dapat menemukan ARN Profil Q di halaman detail akun Amazon Q di konsol Pengembang Amazon Q.

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, lihatGunakan pengaturan khusus untuk Amazon SageMaker AI.

Saat menyiapkan Amazon Q Developer di domain baru, Anda dapat menggunakan perintah AWS Management Console 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.

Jika Anda perlu membuat koneksi antara Amazon Q Developer dan VPC Anda, lihat Membuat antarmuka VPC endpoint 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 dan Asisten Pengkodean AI - Pengembang Amazon Q FAQs.

  • 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.

  • 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 dan di atasnya. Pada Code Editor, Amazon Q bekerja dalam SageMaker AI Distribution Images versi 2.2.1 ke atas.

  • 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 Pengembang Amazon Q.