Menerapkan versi solusi Amazon Personalize dengan kampanye - Amazon Personalize
Pembaruan kampanye otomatisMinimum disediakan TPSMetadata item dalam rekomendasiMembuat kampanye (konsol)Membuat kampanye (AWS CLI)Membuat kampanye (AWS SDKs)

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

Menerapkan versi solusi Amazon Personalize dengan kampanye

Untuk rekomendasi real-time dengan sumber daya khusus, setelah selesaiMembuat versi solusi secara manual, Anda siap untuk menerapkan versi solusi Anda dengan kampanye.

Kampanye menyebarkan versi solusi (model terlatih) dengan kapasitas transaksi yang disediakan untuk menghasilkan rekomendasi waktu nyata. Setelah Anda membuat kampanye, Anda menggunakan GetRecommendations atau GetPersonalizedRanking API operasi untuk mendapatkan rekomendasi. Jika Anda mendapatkan rekomendasi item batch atau segmen pengguna, Anda tidak perlu membuat kampanye. Untuk informasi selengkapnya, lihat Mendapatkan rekomendasi item batch atau Mendapatkan segmen pengguna batch.

Saat membuat kampanye, Anda dapat mengonfigurasi hal berikut:

  • Anda dapat mengonfigurasi kampanye untuk memperbarui secara otomatis untuk menggunakan versi solusi terbaru solusi Anda. Untuk informasi selengkapnya, lihat Pembaruan kampanye otomatis.

  • Anda dapat mengaktifkan metadata item dalam rekomendasi. Untuk informasi selengkapnya, lihat Metadata item dalam rekomendasi.

  • Anda dapat menentukan transaksi minimum yang disediakan per detik untuk kampanye. Ini adalah throughput transaksi dasar untuk kampanye yang disediakan oleh Amazon Personalize. Ini menetapkan biaya penagihan minimum untuk kampanye saat sedang aktif. Untuk informasi selengkapnya, lihat Minimum transaksi yang disediakan per detik dan auto-scaling.

Anda dapat membuat kampanye dengan konsol Amazon Personalize, AWS Command Line Interface (AWS CLI), atau. AWS SDKs Jika ingin mengubah setelan kampanye yang ada, seperti mengaktifkan metadata dalam rekomendasi, Anda harus memperbarui kampanye. Untuk informasi selengkapnya, lihat Memperbarui konfigurasi kampanye Amazon Personalize.

Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat harga Amazon Personalisasi.

Pembaruan kampanye otomatis

Saat membuat kampanye, Anda dapat mengaktifkan pembaruan kampanye otomatis. Dengan pembaruan otomatis, kampanye secara otomatis memperbarui untuk menerapkan versi solusi terbaru yang terlatih secara otomatis atau manual dari solusi Anda. Ini memudahkan Anda untuk menjaga kampanye Anda tetap terkini.

Misalnya, jika solusi Anda menggunakan pelatihan otomatis untuk membuat versi solusi baru setiap tujuh hari, kampanye Anda akan diperbarui secara otomatis untuk menggunakan versi solusi terbaru untuk setiap pelatihan mingguan. Jika Anda tidak menggunakan pembaruan kampanye otomatis, Anda harus memperbarui kampanye secara manual untuk menerapkan model terlatih terbaru.

  • Untuk mengaktifkan pembaruan kampanye otomatis saat Anda membuat kampanye dengan konsol Amazon Personalisasi, pilih Perbarui secara otomatis untuk menggunakan versi solusi terbaru solusi Anda di detail Kampanye. Anda dapat menemukan stempel waktu untuk pembaruan terbaru di halaman detail kampanye.

    Untuk informasi selengkapnya, lihat Membuat kampanye (konsol).

  • Untuk mengaktifkan pembaruan kampanye otomatis saat Anda menggunakan CreateCampaign API operasi, untuk SolutionVersionArn parameter, tentukan Nama Sumber Daya Amazon (ARN) solusi Anda dalam SolutionArn/$LATEST format. DicampaignConfig, atur enableMetadataWithRecommendations ketrue.

    Untuk mendapatkan stempel waktu pembaruan kampanye terbaru, Anda dapat menggunakan DescribeCampaign API operasi dan memeriksa latestCampaignUpdate detail dalam respons.

    Untuk contoh kode yang menunjukkan cara mengaktifkan pembaruan otomatis, lihat Membuat kampanye (AWS CLI) atauMembuat kampanye (AWS SDKs).

Minimum transaksi yang disediakan per detik dan auto-scaling

penting

Tinggi minProvisionedTPS akan meningkatkan biaya Anda. Sebaiknya mulai dengan 1 untuk minProvisionedTPS (default). Lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan tingkatkan minProvisionedTPS seperlunya.

Saat membuat kampanye Amazon Personalize, Anda dapat menentukan transaksi minimum yang disediakan per detik (minProvisionedTPS) untuk kampanye. Ini adalah throughput transaksi dasar untuk kampanye yang disediakan oleh Amazon Personalize. Ini menetapkan biaya penagihan minimum untuk kampanye saat sedang aktif. Transaksi adalah satu GetRecommendations atau GetPersonalizedRanking permintaan. minProvisionedTPSDefaultnya adalah 1.

Jika Anda TPS meningkat lebih dari ituminProvisionedTPS, Amazon Personalize secara otomatis menskalakan kapasitas yang disediakan ke atas dan ke bawah, tetapi tidak pernah di bawah. minProvisionedTPS Ada penundaan waktu singkat sementara kapasitas meningkat yang dapat menyebabkan hilangnya transaksi. Ketika lalu lintas Anda berkurang, kapasitas kembali keminProvisionedTPS.

Anda dikenakan biaya untuk ketentuan minimum TPS atau, jika permintaan Anda melebihiminProvisionedTPS, yang sebenarnya. TPS Yang sebenarnya TPS adalah jumlah permintaan rekomendasi yang Anda buat. Sebaiknya mulai dengan yang rendahminProvisionedTPS, lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, lalu tingkatkan minProvisionedTPS seperlunya.

Untuk informasi selengkapnya tentang biaya kampanye, lihat harga Amazon Personalisasi.

Metadata item dalam rekomendasi

penting

Jika Anda menggunakan resep User-Personalization-v 2 atau Personalized-Ranking-v 2, Anda tidak dikenakan biaya tambahan untuk metadata. Untuk semua resep lain dan semua kasus penggunaan domain, Anda dikenakan biaya tambahan. Untuk informasi selengkapnya, lihat Harga Amazon Personalisasi.

Ketika Anda mendapatkan rekomendasi, Anda dapat meminta Amazon Personalize menyertakan metadata item dalam hasil rekomendasi. Dalam permintaan Anda, Anda dapat memilih kolom dari kumpulan data Item Anda untuk disertakan. Amazon Personalize mengembalikan data ini untuk setiap item dalam respons rekomendasi.

Anda dapat menggunakan metadata untuk memperkaya rekomendasi di antarmuka pengguna, seperti menambahkan genre film ke komidi putar. Atau Anda dapat menggunakannya untuk menilai kualitas rekomendasi secara visual. Jika Anda menggunakan AI generatif di aplikasi, Anda dapat menyambungkan metadata ke prompt AI untuk menghasilkan konten yang lebih relevan. Untuk informasi selengkapnya tentang menggunakan Amazon Personalize dengan AI generatif, lihat. Amazon Personalisasi dan AI generatif

Mengaktifkan metadata

Untuk menambahkan metadata ke rekomendasi, Anda harus memiliki kumpulan data Item dengan kolom metadata. Anda tidak harus menggunakan metadata dalam pelatihan. Untuk informasi tentang membuat kumpulan data, lihatMembuat skema dan dataset. Untuk informasi yang memperbarui data, lihatMemperbarui data dalam kumpulan data setelah pelatihan.

Jika Anda menggunakan resep User-Personalization-v 2 atau Personalized-Ranking-v 2, kampanye baru secara otomatis memiliki opsi untuk menyertakan metadata item dengan hasil rekomendasi. Anda tidak mengaktifkan metadata secara manual untuk kampanye Anda. Untuk semua resep dan kasus penggunaan domain lainnya, Anda harus mengaktifkan opsi metadata:

  • Untuk mengaktifkan metadata dengan konsol Amazon Personalize, saat Anda membuat kampanye, pilih Metadata pengembalian item di hasil rekomendasi di detail Kampanye. Untuk informasi selengkapnya, lihat Membuat kampanye (konsol).

  • Untuk mengaktifkan metadata dengan AWS SDKs atau AWS CLI, gunakan CreateCampaign API operasi dan dalam campaignConfig set enableMetadataWithRecommendations ke. true Untuk informasi selengkapnya, lihat Membuat kampanye (AWS CLI) atau Membuat kampanye (AWS SDKs).

Membuat kampanye (konsol)

penting

Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat harga Amazon Personalisasi.

Setelah status versi solusi Anda Aktif, Anda siap untuk menerapkannya dengan kampanye Amazon Personalize.

Untuk membuat kampanye (konsol)

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

  2. Pilih grup kumpulan data dengan versi solusi yang ingin Anda terapkan.

  3. Di panel navigasi, di bawah Sumber daya khusus, pilih Kampanye.

  4. Pada halaman Kampanye, pilih Buat kampanye.

  5. Pada halaman Buat kampanye baru, untuk detail Kampanye, berikan informasi berikut:

    • Nama kampanye — Masukkan nama kampanye. Teks yang Anda masukkan di sini muncul di dasbor Kampanye dan halaman detail.

    • Solusi — Pilih solusi yang baru saja Anda buat.

    • Perbarui secara otomatis untuk menggunakan versi solusi terbaru solusi Anda — Pilih opsi ini agar kampanye secara otomatis menggunakan versi solusi aktif terbaru. Jika Anda tidak memilih ini, Anda harus memperbarui kampanye secara manual setiap kali Anda ingin menerapkan versi solusi baru. Untuk informasi selengkapnya, lihat Pembaruan kampanye otomatis.

    • ID versi solusi - Jika Anda tidak menggunakan pembaruan kampanye otomatis untuk menggunakan versi solusi terbaru, pilih ID versi solusi yang ingin Anda gunakan.

    • Transaksi minimum yang disediakan per detik (dipanggil minProvisioned TPS masukAPIs) - Tetapkan transaksi minimum yang disediakan per detik yang didukung Amazon Personalize. Nilai tinggi akan meningkatkan biaya Anda. Kami menyarankan Anda memulai dengan 1 (default). Lacak penggunaan Anda dengan menggunakan CloudWatch metrik Amazon, dan tingkatkan minProvisionedTPS seperlunya. Untuk informasi selengkapnya, lihat Minimum transaksi yang disediakan per detik dan auto-scaling.

    • Kembalikan metadata item dalam hasil rekomendasi — Pilih opsi ini jika Anda ingin opsi menyertakan metadata dengan hasil rekomendasi. Jika diaktifkan, Anda dapat menentukan kolom dari kumpulan data Item saat Anda mendapatkan rekomendasi. Untuk informasi selengkapnya, lihat Metadata item dalam rekomendasi.

  6. Jika Anda menggunakan resep Personalisasi Pengguna, dalam konfigurasi Kampanye, Anda dapat secara opsional memasukkan nilai untuk bobot Eksplorasi dan batas usia item Eksplorasi. Untuk informasi selengkapnya, lihat Personalisasi Pengguna.

  7. Untuk Tag, secara opsional tambahkan tag apa pun. Untuk informasi selengkapnya tentang menandai sumber daya Amazon Personalize, lihat. Menandai Amazon Personalisasi sumber daya

  8. Pilih Buat kampanye.

  9. Pada halaman detail kampanye, ketika status kampanye Aktif, Anda dapat menggunakan kampanye untuk mendapatkan rekomendasi dan merekam tayangan. Untuk informasi selengkapnya, lihat Mendapatkan rekomendasi dari Amazon Personalize.

    Kampanye siap ketika statusnyaACTIVE. Jika Anda melatih ulang versi solusi Anda, atau jika Anda ingin mengubah setelan kampanye, Anda harus memperbarui kampanye Anda. Untuk informasi selengkapnya, lihat Memperbarui konfigurasi kampanye Amazon Personalize.

Membuat kampanye (AWS CLI)

penting

Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat harga Amazon Personalisasi.

Setelah versi solusi Anda Aktif, Anda siap untuk menerapkannya dengan kampanye Amazon Personalize. Untuk membuat kampanye dengan AWS CLI, Anda menggunakan create-campaign perintah.

Contoh kode berikut menunjukkan cara membuat kampanye. Ini menyebarkan versi solusi terbaru dari solusi yang menggunakan resep User-Personalization. Kampanye yang dibuatnya secara otomatis diperbarui untuk menggunakan versi solusi masa depan. Kode menggunakan konfigurasi berikut:

  • Ini mengonfigurasi kampanye untuk memperbarui secara otomatis untuk menggunakan versi solusi terbaru untuk solusi Anda: solution-version-arn Ini dalam solution ARN/$LATEST format, dan syncWithLatestSolutionVersion sedangTrue. Untuk menggunakan kode, ganti solution ARN dengan Amazon Resource Name (ARN) solusi Anda.

    Untuk menonaktifkan otomatissyncWithLatestSolutionVersion, tentukan hanya versi solusi ARN (tanpa/$LATEST), dan atur syncWithLatestSolutionVersion keFalse.

  • Ini menetapkan enableMetadataWithRecommendations opsi untukTrue. Ini memungkinkan opsi permintaan rekomendasi untuk menyertakan metadata item dari kumpulan data Item dengan hasil rekomendasi. Untuk menonaktifkan opsi ini, atur keFalse. Untuk informasi selengkapnya, lihat Metadata item dalam rekomendasi.

  • Ini diatur min-provisioned-tps ke 1 (default). Sebaiknya mulai dengan 1 untuk minProvisionedTPS (default). Lacak penggunaan Anda dengan menggunakan CloudWatch metrik Amazon, dan tingkatkan minProvisionedTPS seperlunya. Untuk informasi selengkapnya, lihat Minimum transaksi yang disediakan per detik dan auto-scaling.

Untuk daftar lengkap semua parameter, lihatCreateCampaign.

aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"

Kampanye siap ketika statusnyaACTIVE. Untuk mendapatkan status saat ini, panggil DescribeCampaign dan periksa apakah status bidangnyaACTIVE.

Jika Anda melatih ulang versi solusi dan kampanye Anda tidak diperbarui secara otomatis untuk menggunakan versi solusi terbaru, atau jika ingin mengubah setelan kampanye, Anda harus memperbarui kampanye. Untuk informasi selengkapnya, lihat Memperbarui konfigurasi kampanye Amazon Personalize.

Amazon Personalize memberi Anda operasi untuk mengelola kampanye seperti ListCampaigns mencantumkan kampanye yang telah Anda buat. Anda dapat menghapus kampanye dengan meneleponDeleteCampaign. Jika Anda menghapus kampanye, versi solusi yang merupakan bagian dari kampanye tidak akan dihapus.

Setelah Anda membuat kampanye, Anda dapat menggunakannya untuk membuat rekomendasi. Untuk informasi selengkapnya, lihat Mendapatkan rekomendasi dari Amazon Personalize.

Membuat kampanye (AWS SDKs)

penting

Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat harga Amazon Personalisasi.

Setelah versi solusi Anda Aktif, Anda siap untuk menerapkannya dengan kampanye Amazon Personalize. Untuk membuat kampanye dengan AWS SDKs, Anda menggunakan CreateCampaign API operasi.

Contoh kode berikut menunjukkan cara membuat kampanye. Kode ini menerapkan versi solusi terbaru dari solusi yang menggunakan resep User-Personalization. Kampanye yang dibuatnya secara otomatis diperbarui untuk menggunakan versi solusi masa depan. Kode menggunakan konfigurasi berikut:

  • Ini mengonfigurasi kampanye untuk memperbarui secara otomatis untuk menggunakan versi solusi terbaru untuk solusi Anda: solutionVersionArn Ini dalam solution ARN/$LATEST format, dan syncWithLatestSolutionVersion sedangTrue. Untuk menggunakan kode, ganti solution ARN dengan Amazon Resource Name (ARN) versi solusi Anda.

    Untuk menonaktifkan otomatissyncWithLatestSolutionVersion, tentukan hanya versi solusi ARN (tanpa/$LATEST), dan atur syncWithLatestSolutionVersion keFalse.

  • Ini menetapkan enableMetadataWithRecommendations opsi untukTrue. Ini memungkinkan opsi permintaan rekomendasi untuk menyertakan metadata item dari kumpulan data Item dengan hasil rekomendasi. Untuk menonaktifkan opsi ini, atur keFalse. Untuk informasi selengkapnya, lihat Metadata item dalam rekomendasi.

  • Ini diatur minProvisionedTPS ke 1 (default). Kami menyarankan Anda memulai dengan 1 untuk minProvisionedTPS (default). Lacak penggunaan Anda dengan menggunakan CloudWatch metrik Amazon, dan tingkatkan minProvisionedTPS seperlunya. Untuk informasi selengkapnya, lihat Minimum transaksi yang disediakan per detik dan auto-scaling.

Untuk daftar lengkap semua parameter, lihatCreateCampaign.

SDK for Python (Boto3)
import boto3

personalize = boto3.client('personalize')

response = personalize.create_campaign(
    name = 'campaign name',
    solutionVersionArn = 'solution ARN/$LATEST',
    minProvisionedTPS = 1,
    campaignConfig = {"syncWithLatestSolutionVersion": True, "enableMetadataWithRecommendations": True}
)

arn = response['campaignArn']

description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])
SDK for JavaScript v3
// Get service clients module and commands using ES6 syntax.
import { CreateCampaignCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";

// create personalizeClient
const personalizeClient = new PersonalizeClient({ region: "REGION" });

// set the campaign parameters
export const createCampaignParam = {
  solutionVersionArn: "SOLUTION_ARN/$LATEST" /* required */,
  name: "NAME" /* required */,
  minProvisionedTPS: 1 /* optional */,
  campaignConfig: {   /* optional */
    syncWithLatestSolutionVersion: true,
    enableMetadataWithRecommendations: true,
  },
};

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

Kampanye siap ketika statusnyaACTIVE. Untuk mendapatkan status saat ini, panggilDescribeCampaign, dan periksa apakah status bidangnyaACTIVE.

Jika Anda melatih ulang versi solusi secara manual, atau jika ingin mengubah setelan kampanye, Anda harus memperbarui kampanye. Untuk informasi selengkapnya, lihat Memperbarui konfigurasi kampanye Amazon Personalize.

Amazon Personalize memberi Anda operasi untuk mengelola kampanye seperti ListCampaigns mencantumkan kampanye yang telah Anda buat. Anda dapat menghapus kampanye dengan meneleponDeleteCampaign. Jika Anda menghapus kampanye, versi solusi yang merupakan bagian dari kampanye tidak akan dihapus.

Setelah Anda membuat kampanye, gunakan untuk membuat rekomendasi. Untuk informasi selengkapnya, lihat Mendapatkan rekomendasi dari Amazon Personalize.