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

# Membuat model terlatih di AWS Clean Rooms MS
<a name="create-trained-model"></a>

Prasyarat: 
+ An Akun AWS dengan akses ke AWS Clean Rooms
+ Kolaborasi yang dibuat di AWS Clean Rooms
+ Algoritma model yang dikonfigurasi terkait dengan kolaborasi
+ Setidaknya satu saluran input ML yang dikonfigurasi
+ Izin yang sesuai untuk membuat dan mengelola model ML dalam kolaborasi

Setelah Anda mengaitkan algoritma model yang dikonfigurasi ke kolaborasi, lalu membuat dan mengonfigurasi saluran input ML, Anda siap untuk membuat model terlatih. *Model terlatih* digunakan oleh anggota kolaborasi untuk bersama-sama menganalisis data mereka.

Anda dapat membuat model terlatih menggunakan prosedur berikut. 

Atau, Anda dapat menggunakan pelatihan tambahan untuk meningkatkan model yang ada dengan data baru, atau pelatihan terdistribusi untuk melatih model di beberapa instance komputasi. 

**Topics**
+ [Menggunakan pelatihan tambahan di AWS Clean Rooms](use-incremental-training.md)
+ [Menggunakan pelatihan terdistribusi di AWS Clean Rooms](use-distributed-training.md)

------
#### [ Console ]

**Untuk membuat model terlatih (konsol)**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Clean Rooms konsol di [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. Di panel navigasi kiri, pilih **Kolaborasi**.

1. Pada halaman **Kolaborasi**, pilih kolaborasi tempat Anda ingin membuat model terlatih.

1. Setelah kolaborasi terbuka, pilih tab **model ML**.

1. Di bawah **model Custom** MS, di bagian **Model terlatih**, pilih **Buat model terlatih**.

1. Pada halaman **Buat model terlatih**, untuk **algoritma model terkait**, tentukan algoritmanya.

1. Untuk **detail model Terlatih**, masukkan yang berikut ini:

   1. Untuk **Nama**, masukkan nama unik untuk model dalam kolaborasi.

   1. (Opsional) Untuk **Deskripsi**, masukkan deskripsi model yang dilatih.

   1. Untuk **mode input data Pelatihan**, pilih salah satu dari berikut ini: 
      + Pilih **File** jika Anda memiliki kumpulan data yang lebih kecil yang dapat muat pada volume penyimpanan ML dan Anda lebih memilih akses sistem file tradisional untuk skrip pelatihan Anda.
      + Pilih **Pipe** untuk kumpulan data besar untuk mengalirkan data langsung dari S3, menghindari kebutuhan untuk mengunduh semuanya ke disk, yang dapat meningkatkan kecepatan pelatihan dan mengurangi persyaratan penyimpanan.
      + Pilih **FastFile**apakah Anda ingin menggabungkan manfaat streaming dari S3 dengan akses sistem file, terutama untuk membaca data secara berurutan atau ketika berhadapan dengan lebih sedikit file untuk waktu startup yang lebih cepat.

1. Untuk **detail saluran masukan ML**, lakukan hal berikut: 

   1. Untuk **saluran input ML**, tentukan saluran input ML yang menyediakan data ke algoritma model. 

      Untuk menambahkan saluran lain, pilih **Tambahkan saluran input ML lainnya**. Anda dapat menambahkan hingga 19 saluran input ML tambahan. 

   1. Untuk **nama Saluran**, masukkan nama saluran input ML.

   1. Untuk **jenis distribusi data Amazon S3**, pilih salah satu dari berikut ini:
      + Pilih **Sepenuhnya direplikasi** untuk memberikan setiap instance pelatihan dengan salinan lengkap kumpulan data Anda. Ini berfungsi paling baik ketika kumpulan data Anda cukup kecil untuk muat dalam memori atau ketika setiap instance membutuhkan akses ke semua data.
      + Pilih **Sharded by S3 kunci** untuk membagi dataset Anda di seluruh instans pelatihan berdasarkan kunci S3. Setiap instance menerima sekitar 1/n dari total objek S3, di mana 'n' adalah jumlah instance. Ini berfungsi paling baik untuk kumpulan data besar yang ingin Anda proses secara paralel.
**catatan**  
Pertimbangkan ukuran set data dan persyaratan pelatihan Anda saat memilih jenis distribusi. **Sepenuhnya direplikasi** menyediakan akses data yang lengkap tetapi membutuhkan lebih banyak penyimpanan, sementara **Sharded by S3 key** memungkinkan pemrosesan terdistribusi kumpulan data besar.

1. Untuk **Durasi pelatihan maksimum**, pilih jumlah waktu maksimum yang Anda inginkan untuk melatih model Anda.

1. Untuk **Hyperparameters**, tentukan parameter spesifik algoritme apa pun dan nilai yang dimaksudkan. Hyperparameter khusus untuk model yang dilatih dan digunakan untuk menyempurnakan pelatihan model.

1. Untuk **variabel Lingkungan**, tentukan variabel spesifik algoritme apa pun dan nilai yang dimaksudkan. Variabel lingkungan diatur dalam wadah Docker.

1. Untuk **Enkripsi**, untuk menggunakan kustom AWS KMS key, pilih kotak **centang Enkripsi rahasia dengan kunci KMS kustom**.

1. Untuk **konfigurasi Sumber Daya EC2**, tentukan informasi tentang sumber daya komputasi yang digunakan untuk pelatihan model. 

   1. Untuk **jenis Instance**, pilih jenis instance yang ingin Anda jalankan. 

   1. Untuk **hitungan Instance**, masukkan jumlah instance.

   1. Untuk **ukuran Volume dalam GB**, masukkan ukuran volume penyimpanan ML.

1. Pilih **Buat model terlatih**. 

------
#### [ API ]

Untuk membuat model terlatih (API)

Anggota dengan kemampuan untuk melatih model memulai pelatihan dengan memilih saluran input ML dan algoritma model.

Jalankan kode berikut dengan parameter spesifik Anda:

```
import boto3 
acr_ml_client= boto3.client('cleanroomsml')

acr_ml_client.create_trained_model(
    membershipIdentifier= '{{membership_id}}',
    configuredModelAlgorithmAssociationArn = 'arn:aws:cleanrooms-ml:{{region}}:{{account}}:{{membership}}/membershipIdentifier/configured-model-algorithm-association/{{identifier}}',
    name='{{trained_model_name}}',
    resourceConfig={
        'instanceType': "ml.m5.xlarge",
        'volumeSizeInGB': 1
    },
    dataChannels=[
        {
            "mlInputChannelArn": channel_arn_1,
            "channelName": "{{channel_name}}"
        },
        {
            "mlInputChannelArn": channel_arn_2,
            "channelName": "{{channel_name}}"
        }
    ]
)
```

------

**catatan**  
Setelah model terlatih dibuat, Anda tidak dapat mengeditnya. Untuk membuat perubahan, hapus model terlatih dan buat yang baru.