CreateSolution - Amazon Personalize
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateSolution

penting

Secara default, semua solusi baru menggunakan pelatihan otomatis. Dengan pelatihan otomatis, Anda dikenakan biaya pelatihan saat solusi Anda aktif. Untuk menghindari biaya yang tidak perlu, ketika Anda selesai Anda dapat memperbarui solusi untuk mematikan pelatihan otomatis. Untuk informasi tentang biaya pelatihan, lihat harga Amazon Personalisasi.

Membuat konfigurasi untuk melatih model (membuat versi solusi). Konfigurasi ini mencakup resep yang akan digunakan untuk pelatihan model dan konfigurasi pelatihan opsional, seperti kolom yang akan digunakan dalam pelatihan dan parameter transformasi fitur. Untuk informasi selengkapnya tentang mengonfigurasi solusi, lihat Membuat dan mengonfigurasi solusi.

Secara default, solusi baru menggunakan pelatihan otomatis untuk membuat versi solusi setiap 7 hari. Anda dapat mengubah frekuensi pelatihan. Pembuatan versi solusi otomatis dimulai dalam waktu satu jam setelah solusinyaACTIVE. Jika Anda secara manual membuat versi solusi dalam satu jam, solusi melewatkan pelatihan otomatis pertama. Untuk informasi selengkapnya, lihat Mengonfigurasi pelatihan otomatis.

Untuk mematikan pelatihan otomatis, atur performAutoTraining ke false. Jika Anda mematikan pelatihan otomatis, Anda harus membuat versi solusi secara manual dengan memanggil CreateSolutionVersionoperasi.

Setelah pelatihan dimulai, Anda bisa mendapatkan Amazon Resource Name (ARN) versi solusi dengan ListSolutionVersionsAPIoperasi. Untuk mendapatkan statusnya, gunakan DescribeSolutionVersion.

Setelah pelatihan selesai, Anda dapat mengevaluasi akurasi model dengan menelepon GetSolutionMetrics. Ketika Anda puas dengan versi solusi, Anda menerapkannya menggunakan CreateCampaign. Kampanye ini memberikan rekomendasi kepada klien melalui GetRecommendationsAPI.

catatan

Amazon Personalize tidak mendukung konfigurasi optimasi hyperparameter hpoObjective for solution saat ini.

Status

Solusi dapat berada di salah satu negara berikut:

  • CREATEPENDING> CREATE IN_ PROGRESS > ACTIVE -atau- CREATE FAILED

  • DELETEPENDING> DELETE DI_ PROGRESS

Untuk mendapatkan status solusinya, hubungi DescribeSolution. Jika Anda menggunakan pelatihan manual, statusnya harus ACTIVE sebelum Anda meneleponCreateSolutionVersion.

Terkait APIs

Sintaksis Permintaan

{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performAutoTraining": boolean,
   "performHPO": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventValueThreshold": "string",
      "featureTransformationParameters": { 
         "string" : "string" 
      },
      "hpoConfig": { 
         "algorithmHyperParameterRanges": { 
            "categoricalHyperParameterRanges": [ 
               { 
                  "name": "string",
                  "values": [ "string" ]
               }
            ],
            "continuousHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ],
            "integerHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ]
         },
         "hpoObjective": { 
            "metricName": "string",
            "metricRegex": "string",
            "type": "string"
         },
         "hpoResourceConfig": { 
            "maxNumberOfTrainingJobs": "string",
            "maxParallelTrainingJobs": "string"
         }
      },
      "optimizationObjective": { 
         "itemAttribute": "string",
         "objectiveSensitivity": "string"
      },
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Parameter Permintaan

Permintaan menerima data berikut dalam JSON format.

datasetGroupArn

Amazon Resource Name (ARN) dari grup dataset yang menyediakan data pelatihan.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Ya

eventType

Ketika Anda memiliki beberapa jenis acara (menggunakan bidang EVENT_TYPE skema), parameter ini menentukan jenis acara (misalnya, 'klik' atau 'suka') yang digunakan untuk melatih model.

Jika Anda tidak memberikaneventType, Amazon Personalize akan menggunakan semua interaksi untuk pelatihan dengan bobot yang sama terlepas dari jenisnya.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Wajib: Tidak

name

Nama untuk solusinya.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

Pola: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Wajib: Ya

performAutoML
penting

Kami tidak menyarankan untuk mengaktifkan pembelajaran mesin otomatis. Sebagai gantinya, cocokkan kasus penggunaan Anda dengan resep Amazon Personalize yang tersedia. Untuk informasi selengkapnya, lihat Memilih resep.

Apakah akan melakukan pembelajaran mesin otomatis (AutoML). Default-nya adalah false. Untuk kasus ini, Anda harus menentukanrecipeArn.

Saat disetel ketrue, Amazon Personalize menganalisis data pelatihan Anda dan memilih resep USER _ PERSONALIZATION dan hyperparameter yang optimal. Dalam hal ini, Anda harus menghilangkannyarecipeArn. Amazon Personalize menentukan resep optimal dengan menjalankan pengujian dengan nilai berbeda untuk hyperparameters. AutoML memperpanjang proses pelatihan dibandingkan dengan memilih resep tertentu.

Tipe: Boolean

Wajib: Tidak

performAutoTraining

Apakah solusi menggunakan pelatihan otomatis untuk membuat versi solusi baru (model terlatih). Defaultnya adalah True dan solusinya secara otomatis membuat versi solusi baru setiap 7 hari. Anda dapat mengubah frekuensi pelatihan dengan menentukan a schedulingExpression dalam AutoTrainingConfig sebagai bagian dari konfigurasi solusi. Untuk informasi selengkapnya tentang pelatihan otomatis, lihat Mengonfigurasi pelatihan otomatis.

Pembuatan versi solusi otomatis dimulai dalam waktu satu jam setelah solusinyaACTIVE. Jika Anda secara manual membuat versi solusi dalam satu jam, solusi melewatkan pelatihan otomatis pertama.

Setelah pelatihan dimulai, Anda bisa mendapatkan Amazon Resource Name (ARN) versi solusi dengan ListSolutionVersionsAPIoperasi. Untuk mendapatkan statusnya, gunakan DescribeSolutionVersion.

Tipe: Boolean

Wajib: Tidak

performHPO

Apakah akan melakukan optimasi hyperparameter (HPO) pada resep yang ditentukan atau dipilih. Default-nya adalah false.

Saat melakukan AutoML, parameter ini selalu true dan Anda tidak harus mengaturnya. false

Tipe: Boolean

Wajib: Tidak

recipeArn

Nama Sumber Daya Amazon (ARN) dari resep yang akan digunakan untuk pelatihan model. Ini diperlukan ketika performAutoML salah. Untuk informasi tentang berbagai resep Amazon Personalisasi dan resep lainnyaARNs, lihat Memilih resep.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Tidak

solutionConfig

Properti konfigurasi untuk solusi. Bila performAutoML disetel ke true, Amazon Personalize hanya mengevaluasi autoMLConfig bagian konfigurasi solusi.

catatan

Amazon Personalize tidak mendukung konfigurasi hpoObjective saat ini.

Tipe: Objek SolutionConfig

Wajib: Tidak

tags

Daftar tag untuk diterapkan pada solusi.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Wajib: Tidak

Sintaksis Respons

{
   "solutionArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

solutionArn

ARNSolusinya.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Kesalahan

InvalidInputException

Berikan nilai yang valid untuk bidang atau parameter.

HTTPKode Status: 400

LimitExceededException

Batas jumlah permintaan per detik telah terlampaui.

HTTPKode Status: 400

ResourceAlreadyExistsException

Sumber daya yang ditentukan sudah ada.

HTTPKode Status: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

HTTPKode Status: 400

ResourceNotFoundException

Tidak dapat menemukan sumber daya yang ditentukan.

HTTPKode Status: 400

TooManyTagsException

Anda telah melampaui jumlah maksimum tag yang dapat Anda terapkan ke sumber daya ini.

HTTPKode Status: 400

Lihat Juga

Untuk informasi lebih lanjut tentang menggunakan ini API di salah satu bahasa khusus AWS SDKs, lihat yang berikut ini: