

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

# Membuat versi solusi secara manual
<a name="creating-a-solution-version"></a>

Setelah selesai[Mengonfigurasi solusi khusus di Amazon Personalize](customizing-solution-config.md), Anda siap untuk memulai pelatihan:
+  Jika solusi Anda menggunakan pelatihan otomatis, solusi akan membuat versi solusi untuk Anda pada frekuensi pelatihan yang Anda tentukan. Secara default, semua solusi baru menggunakan pelatihan otomatis untuk membuat versi solusi baru setiap 7 hari. Anda masih dapat membuat versi solusi secara manual. Untuk informasi selengkapnya, lihat [Mengkonfigurasi pelatihan otomatis](solution-config-auto-training.md).
+ Jika Anda mematikan pelatihan otomatis untuk solusi Anda atau Anda ingin melatih secara manual, Anda dapat membuat versi solusi secara manual. *Versi solusi* mengacu pada model pembelajaran mesin yang terlatih. Anda dapat membuat versi solusi menggunakan konsol, AWS Command Line Interface (AWS CLI), atau AWS SDKs. Jika versi solusi Anda memiliki status CREATE\_PENDING atau CREATE\_IN\_PROGRESS, Anda dapat menggunakan [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) operasi untuk menghentikan proses pembuatan versi solusi. Lihat [Menghentikan pembuatan versi solusi](stop-solution-version.md). 

Jika pelatihan tidak selesai karena kesalahan, Anda tidak dikenakan biaya untuk pelatihan. Jika versi solusi Anda memiliki status CREATE\_PENDING atau CREATE\_IN\_PROGRESS, Anda dapat menghentikan proses pembuatan versi solusi. Untuk menghentikan pembuatan versi solusi, navigasikan ke halaman detail versi solusi dan pilih **Berhenti**. Untuk informasi selengkapnya, lihat [Menghentikan pembuatan versi solusi](stop-solution-version.md).

**Topics**
+ [Membuat versi solusi (konsol)](#create-solution-version-console)
+ [Membuat versi solusi (AWS CLI)](#create-solution-version-cli)
+ [Membuat versi solusi (AWS SDKs)](#create-solution-version-sdk)

## Membuat versi solusi (konsol)
<a name="create-solution-version-console"></a>

Untuk membuat versi solusi baru secara manual dengan konsol Amazon Personalize, Anda memulai pelatihan dari halaman detail solusi Anda.

**Untuk membuat versi solusi baru**

1. Buka konsol Amazon Personalize di [https://console.aws.amazon.com/personalize/rumah](https://console.aws.amazon.com/personalize/home) dan masuk ke akun Anda.

1. Arahkan ke halaman grup kumpulan data dan pilih grup kumpulan data dengan solusi baru Anda.

1. Di panel navigasi, di bawah **Sumber daya khusus**, pilih **Solusi dan resep**. 

1. Pada halaman **Solusi dan resep**, pilih solusi yang ingin Anda buat versi solusinya.

1. Pada halaman ikhtisar solusi, pilih **Buat versi solusi** untuk mulai melatih model baru.

Pada halaman detail solusi, Anda dapat melacak kemajuan pelatihan di bagian **Versi solusi**. Saat pelatihan selesai, statusnya **Aktif**, Anda dapat mengevaluasinya menggunakan metrik yang disediakan oleh Amazon Personalize. Untuk informasi selengkapnya, lihat [Mengevaluasi versi solusi Amazon Personalize dengan metrik](working-with-training-metrics.md).

 Ketika versi solusi AKTIF, Anda siap menggunakannya untuk mendapatkan rekomendasi. Bagaimana Anda menggunakan versi solusi aktif tergantung pada bagaimana Anda mendapatkan rekomendasi:
+  Untuk rekomendasi real-time, Anda menerapkan versi solusi AKTIF dengan kampanye Amazon Personalize. Anda menggunakan kampanye untuk mendapatkan rekomendasi bagi pengguna Anda. Lihat [Menerapkan versi solusi Amazon Personalize dengan kampanyeMembuat kampanye](campaigns.md).
+ Untuk rekomendasi batch, Anda menentukan versi solusi AKTIF saat membuat pekerjaan inferensi batch atau pekerjaan segmen batch. Lihat [Mendapatkan rekomendasi item batch](getting-batch-recommendations.md) atau [Mendapatkan segmen pengguna batch](getting-user-segments.md).

## Membuat versi solusi (AWS CLI)
<a name="create-solution-version-cli"></a>

Ketika solusi Anda AKTIF, latih model dengan menjalankan perintah berikut. Ganti `solution arn` dengan solusi Amazon Resource Name (ARN) dari. [Mengonfigurasi solusi khusus di Amazon Personalize](customizing-solution-config.md)

```
aws personalize create-solution-version \
  --solution-arn {{solution arn}}
```

Versi solusi ARN ditampilkan, misalnya:

```
{
  "solutionVersionArn": "arn:aws:personalize:us-west-2:acct-id:solution/SolutionName/<version-id>"
}
```

Periksa status pelatihan versi solusi dengan menggunakan `describe-solution-version` perintah. Berikan solusi versi ARN yang dikembalikan pada langkah sebelumnya. Untuk informasi selengkapnya tentang API, lihat [DescribeSolutionVersion](API_DescribeSolutionVersion.md).

```
aws personalize describe-solution-version \
  --solution-version-arn {{solution version arn}}
```

Properti versi solusi dan pelatihan `status` ditampilkan. Awalnya, status ditampilkan sebagai CREATE PENDING, misalnya:

```
{
  "solutionVersion": {
      "solutionVersionArn": "arn:aws:personalize:us-west-2:acct-id:solution/solutionName/<version-id>",
      ...,
      "status": "CREATE PENDING"
  }
}
```

Pelatihan selesai saat `status` selesai `ACTIVE` dan Anda dapat mengevaluasinya menggunakan metrik yang disediakan oleh Amazon Personalize. Untuk informasi selengkapnya, lihat [Mengevaluasi versi solusi Amazon Personalize dengan metrik](working-with-training-metrics.md). Jika pelatihan tidak selesai karena kesalahan, Anda tidak dikenakan biaya untuk pelatihan. 

Jika versi solusi Anda memiliki status CREATE\_PENDING atau CREATE\_IN\_PROGRESS, Anda dapat menggunakan [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) operasi untuk menghentikan proses pembuatan versi solusi. Lihat [Menghentikan pembuatan versi solusi](stop-solution-version.md).

 Ketika versi solusi AKTIF, Anda siap menggunakannya untuk mendapatkan rekomendasi. Bagaimana Anda menggunakan versi solusi aktif tergantung pada bagaimana Anda mendapatkan rekomendasi:
+  Untuk rekomendasi real-time, Anda menerapkan versi solusi AKTIF dengan kampanye Amazon Personalize. Anda menggunakan kampanye untuk mendapatkan rekomendasi bagi pengguna Anda. Lihat [Menerapkan versi solusi Amazon Personalize dengan kampanyeMembuat kampanye](campaigns.md).
+ Untuk rekomendasi batch, Anda menentukan versi solusi AKTIF saat membuat pekerjaan inferensi batch atau pekerjaan segmen batch. Lihat [Mendapatkan rekomendasi item batch](getting-batch-recommendations.md) atau [Mendapatkan segmen pengguna batch](getting-user-segments.md).

## Membuat versi solusi (AWS SDKs)
<a name="create-solution-version-sdk"></a>

Ketika solusi Anda AKTIF, gunakan kode berikut untuk membuat versi solusi. Tentukan Nama Sumber Daya Amazon (ARN) dari. [Mengonfigurasi solusi khusus di Amazon Personalize](customizing-solution-config.md) Gunakan [DescribeSolutionVersion](API_DescribeSolutionVersion.md) operasi untuk mengambil status versi solusi.

------
#### [ SDK for Python (Boto3) ]

```
import boto3

personalize = boto3.client('personalize')
# Store the solution ARN
solution_arn = '{{solution arn}}'
        
# Use the solution ARN to get the solution status.
solution_description = personalize.describe_solution(solutionArn = 'solution_arn')['solution']
print('Solution status: ' + solution_description['status'])

# Use the solution ARN to create a solution version.
print ('Creating solution version')
response = personalize.create_solution_version(solutionArn = solution_arn)
solution_version_arn = response['solutionVersionArn']
print('Solution version ARN: ' + solution_version_arn)

# Use the solution version ARN to get the solution version status.
solution_version_description = personalize.describe_solution_version(
    solutionVersionArn = solution_version_arn)['solutionVersion']
print('Solution version status: ' + solution_version_description['status'])
```

------
#### [ SDK for Java 2.x ]

```
public static String createPersonalizeSolutionVersion(PersonalizeClient personalizeClient, String solutionArn) {
        long maxTime = 0;
        long waitInMilliseconds = 30 * 1000; // 30 seconds
        String solutionStatus = "";
        String solutionVersionStatus = "";
        String solutionVersionArn = "";

        try {
            DescribeSolutionRequest describeSolutionRequest = DescribeSolutionRequest.builder()
                .solutionArn(solutionArn)
                .build();
            
            maxTime = Instant.now().getEpochSecond() + 3 * 60 * 60;

            // Wait until solution is active. 
            while (Instant.now().getEpochSecond() < maxTime) {

                solutionStatus = personalizeClient.describeSolution(describeSolutionRequest).solution().status();
                System.out.println("Solution status: " + solutionStatus);

                if (solutionStatus.equals("ACTIVE") || solutionStatus.equals("CREATE FAILED")) {
                    break;
                }
                try {
                    Thread.sleep(waitInMilliseconds);
                } catch (InterruptedException e) {
                    System.out.println(e.getMessage());
                }
            }
            
            // Once the solution is active, start creating a solution version.
            
            if (solutionStatus.equals("ACTIVE")) {

                CreateSolutionVersionRequest createSolutionVersionRequest = CreateSolutionVersionRequest.builder()
                    .solutionArn(solutionArn)
                    .build();
                
                CreateSolutionVersionResponse createSolutionVersionResponse = personalizeClient.createSolutionVersion(createSolutionVersionRequest);
                solutionVersionArn = createSolutionVersionResponse.solutionVersionArn();

                System.out.println("Solution version ARN: " + solutionVersionArn);

                DescribeSolutionVersionRequest describeSolutionVersionRequest = DescribeSolutionVersionRequest.builder() 
                    .solutionVersionArn(solutionVersionArn)
                    .build();
                
                maxTime = Instant.now().getEpochSecond() + 3 * 60 * 60;
                
                while (Instant.now().getEpochSecond() < maxTime) {

                    // Use the solution version ARN to get the solution version status.
                    solutionVersionStatus = personalizeClient.describeSolutionVersion(describeSolutionVersionRequest).solutionVersion().status();
                    System.out.println("Solution version status: " + solutionVersionStatus);
    
                    if (solutionVersionStatus.equals("ACTIVE") || solutionVersionStatus.equals("CREATE FAILED")) {
                        break;
                    }
                    try {
                        Thread.sleep(waitInMilliseconds);
                    } catch (InterruptedException e) {
                        System.out.println(e.getMessage());
                    }
                }
                return solutionVersionArn;
            }
        } catch(PersonalizeException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
        return "";
    }
```

------
#### [ SDK for JavaScript v3 ]

```
// Get service clients module and commands using ES6 syntax.
import { CreateSolutionVersionCommand } from "@aws-sdk/client-personalize";
import { personalizeClient } from "./libs/personalizeClients.js";
// Or, create the client here.
// const personalizeClient = new PersonalizeClient({ region: "REGION"});

// Set the solution version parameters.
export const solutionVersionParam = {
  solutionArn: "SOLUTION_ARN" /* required */,
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new CreateSolutionVersionCommand(solutionVersionParam),
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();
```

------



Untuk memeriksa status versi solusi saat ini, panggil [DescribeSolutionVersion](API_DescribeSolutionVersion.md) operasi dan lewati ARN dari versi solusi yang dikembalikan dari operasi. `CreateSolutionVersion` Pelatihan selesai saat `status` selesai `ACTIVE` dan Anda dapat mengevaluasinya menggunakan metrik yang disediakan oleh Amazon Personalize. Untuk informasi selengkapnya, lihat [Mengevaluasi versi solusi Amazon Personalize dengan metrik](working-with-training-metrics.md). Jika pelatihan tidak selesai karena kesalahan, Anda tidak dikenakan biaya untuk pelatihan. 

Jika versi solusi Anda memiliki status CREATE\_PENDING atau CREATE\_IN\_PROGRESS, Anda dapat menggunakan [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) operasi untuk menghentikan proses pembuatan versi solusi. Lihat [Menghentikan pembuatan versi solusi](stop-solution-version.md).

 Ketika versi solusi AKTIF, Anda siap menggunakannya untuk mendapatkan rekomendasi. Bagaimana Anda menggunakan versi solusi aktif tergantung pada bagaimana Anda mendapatkan rekomendasi:
+  Untuk rekomendasi real-time, Anda menerapkan versi solusi AKTIF dengan kampanye Amazon Personalize. Anda menggunakan kampanye untuk mendapatkan rekomendasi bagi pengguna Anda. Lihat [Menerapkan versi solusi Amazon Personalize dengan kampanyeMembuat kampanye](campaigns.md).
+ Untuk rekomendasi batch, Anda menentukan versi solusi AKTIF saat membuat pekerjaan inferensi batch atau pekerjaan segmen batch. Lihat [Mendapatkan rekomendasi item batch](getting-batch-recommendations.md) atau [Mendapatkan segmen pengguna batch](getting-user-segments.md).