

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

# Lengkapi prasyarat untuk model pondasi di Canvas SageMaker
<a name="canvas-fm-chat-prereqs"></a>

Bagian berikut menguraikan prasyarat untuk berinteraksi dengan model dasar dan menggunakan fitur kueri dokumen di Canvas. Sisa konten di halaman ini mengasumsikan bahwa Anda telah memenuhi prasyarat untuk model pondasi. Fitur kueri dokumen memerlukan izin tambahan.

## Prasyarat untuk model pondasi
<a name="canvas-fm-chat-prereqs-fm"></a>

Izin yang Anda perlukan untuk berinteraksi dengan model disertakan dalam izin Ready-to-use model Canvas. Untuk menggunakan model generatif yang didukung AI di Canvas, Anda harus mengaktifkan izin **konfigurasi Ready-to-use model Canvas** saat menyiapkan domain Amazon SageMaker AI Anda. Untuk informasi selengkapnya, lihat [Prasyarat untuk menyiapkan Amazon Canvas SageMaker](canvas-getting-started.md#canvas-prerequisites). **Konfigurasi Ready-to-use model Canvas** melampirkan kebijakan [AmazonSageMakerCanvasAIServicesAccess](https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-canvas.html#security-iam-awsmanpol-AmazonSageMakerCanvasAIServicesAccess) ke peran eksekusi pengguna Canvas AWS Identity and Access Management (IAM) Anda. Jika Anda mengalami masalah dengan pemberian izin, lihat topiknya. [Memecahkan masalah dengan pemberian izin melalui konsol AI SageMaker](canvas-limits.md#canvas-troubleshoot-trusted-services)

Jika sudah menyiapkan domain, Anda dapat mengedit pengaturan domain dan mengaktifkan izin. Untuk petunjuk tentang cara mengedit setelan domain Anda, lihat[Edit pengaturan domain](domain-edit.md). Saat mengedit pengaturan untuk domain Anda, buka **pengaturan Canvas** dan aktifkan opsi **Aktifkan Ready-to-use model Canvas**.

Model JumpStart foundation tertentu juga mengharuskan Anda meminta peningkatan kuota instans SageMaker AI. Canvas menghosting model yang saat ini berinteraksi dengan Anda pada instans ini, tetapi kuota default untuk akun Anda mungkin tidak mencukupi. Jika Anda mengalami kesalahan saat menjalankan salah satu model berikut, minta peningkatan kuota untuk jenis instance terkait:
+ Falcon-40B —, `ml.g5.12xlarge` `ml.g5.24xlarge`
+ Falcon-13B —,, `ml.g5.2xlarge` `ml.g5.4xlarge` `ml.g5.8xlarge`
+ MPT-7B-Instruksikan -,, `ml.g5.2xlarge` `ml.g5.4xlarge` `ml.g5.8xlarge`

Untuk jenis instans sebelumnya, minta peningkatan dari 0 menjadi 1 untuk kuota penggunaan titik akhir. Untuk informasi selengkapnya tentang cara meningkatkan kuota instans untuk akun Anda, lihat [Meminta peningkatan kuota di Panduan Pengguna *Service* Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html).

## Prasyarat untuk kueri dokumen
<a name="canvas-fm-chat-prereqs-kendra"></a>

**catatan**  
Kueri dokumen didukung sebagai berikut Wilayah AWS: AS Timur (Virginia N.), AS Timur (Ohio), AS Barat (Oregon), Eropa (Irlandia), Asia Pasifik (Singapura), Asia Pasifik (Sydney), Asia Pasifik (Tokyo), dan Asia Pasifik (Mumbai).

Fitur kueri dokumen mengharuskan Anda sudah memiliki indeks Amazon Kendra yang menyimpan dokumen dan metadata dokumen Anda. Untuk informasi selengkapnya tentang Amazon Kendra, lihat Panduan Pengembang [Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/what-is-kendra.html). *Untuk mempelajari lebih lanjut tentang kuota untuk mengkueri indeks, lihat [Kuota di Panduan Pengembang](https://docs.aws.amazon.com/kendra/latest/dg/quotas.html) Amazon Kendra.*

Anda juga harus memastikan bahwa profil pengguna Canvas Anda memiliki izin yang diperlukan untuk kueri dokumen. [AmazonSageMakerCanvasFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSageMakerCanvasFullAccess.html)Kebijakan harus dilampirkan ke peran eksekusi AWS IAM untuk domain SageMaker AI yang menghosting aplikasi Canvas Anda (kebijakan ini dilampirkan secara default ke semua profil pengguna Canvas baru dan yang sudah ada). Anda juga harus secara khusus memberikan izin kueri dokumen dan menentukan akses ke satu atau beberapa indeks Amazon Kendra.

Jika administrator Canvas Anda menyiapkan domain atau profil pengguna baru, minta mereka menyiapkan domain dengan mengikuti petunjuk di[Prasyarat untuk menyiapkan Amazon Canvas SageMaker](canvas-getting-started.md#canvas-prerequisites). Saat menyiapkan domain, mereka dapat mengaktifkan izin kueri dokumen melalui konfigurasi ** Ready-to-usemodel Canvas**.

Administrator Canvas dapat mengelola izin kueri dokumen di tingkat profil pengguna juga. Misalnya, jika administrator ingin memberikan izin kueri dokumen ke beberapa profil pengguna tetapi menghapus izin untuk orang lain, mereka dapat mengedit izin untuk pengguna tertentu.

Prosedur berikut menunjukkan cara mengaktifkan izin kueri dokumen untuk profil pengguna tertentu:

1. Buka konsol SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).

1. Di panel navigasi kiri, pilih **Konfigurasi admin**.

1. Di bawah **konfigurasi Admin**, pilih **domain**.

1. Dari daftar domain, pilih domain profil pengguna.

1. Pada halaman **detail domain**, pilih **profil Pengguna** yang izinnya ingin Anda edit.

1. Pada halaman **Detail Pengguna**, pilih **Edit**.

1. Di panel navigasi kiri, pilih **Pengaturan kanvas**.

1. Di bagian **konfigurasi Ready-to-use model Canvas**, aktifkan tombol **Aktifkan kueri dokumen menggunakan Amazon Kendra**.

1. Di dropdown, pilih satu atau beberapa indeks Amazon Kendra yang ingin Anda berikan aksesnya.

1. Pilih **Kirim** untuk menyimpan perubahan pada pengaturan domain Anda.

Anda sekarang harus dapat menggunakan model dasar Canvas untuk menanyakan dokumen dalam indeks Amazon Kendra yang ditentukan.