キャンペーンを使用して Amazon Personalize のソリューションバージョンをデプロイする

カスタムリソースを使ったリアルタイムのレコメンデーションについては、ソリューションバージョンの手動作成 を完了すると、ソリューションバージョンをキャンペーンでデプロイする準備が整います。

キャンペーンでは、アプリケーションユーザー向けのリアルタイムレコメンデーションを生成するためのプロビジョンドトランザクション容量を搭載した、ソリューションバージョン (トレーニング済みモデル) がデプロイされます。キャンペーンを作成したら、GetRecommendations または GetPersonalizedRanking の API 操作を使用してレコメンデーションを取得します。バッチアイテムレコメンデーションやユーザーセグメントを取得しようとしている場合は、キャンペーンを作成する必要はありません。詳細については、バッチアイテムのレコメンデーションの取得 または バッチユーザーセグメントの取得 を参照してください。

キャンペーンを作成するとき、以下を設定できます。

Amazon Personalize コンソール、 AWS Command Line Interface （AWS CLI）、または AWS SDKsを使用してキャンペーンを作成できます。レコメンデーションのメタデータを有効にするなど、既存のキャンペーンの設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。

キャンペーンがアクティブな間は、キャンペーンコストが発生します。不要なコストを避けるため、完了したらキャンペーンを削除します。キャンペーンのコストの詳細については、「Amazon Personalize の料金」を参照してください。

キャンペーンの自動更新

キャンペーンを作成するときに、キャンペーンの自動更新を有効にできます。自動更新では、キャンペーンは自動的に更新され、自動または手動でトレーニングされたソリューションの最新のソリューションバージョンがデプロイされます。これにより、キャンペーンを最新の状態に保つことが容易になります。

例えば、ソリューションが自動トレーニングを使用して 7 日ごとに新しいソリューションバージョンを作成する場合、キャンペーンは自動的に更新され、毎週のトレーニングごとに最新のソリューションバージョンが使用されます。自動キャンペーン更新を使用しない場合は、キャンペーンを手動で更新して、最新のトレーニング済みモデルをデプロイする必要があります。

1 秒あたりの最小プロビジョンドトランザクション数とオートスケーリング

Amazon Personalize のキャンペーンを作成する場合、キャンペーンの 1 秒あたりのプロビジョニングされる最小トランザクション数 (minProvisionedTPS) を指定できます。これは Amazon Personalize によってプロビジョニングされたキャンペーンのベースライントランザクションスループットです。キャンペーンがアクティブである間の最低請求額を設定します。トランザクションは単一の GetRecommendations または GetPersonalizedRanking リクエストです。デフォルト minProvisionedTPS は 1 です。

TPS が minProvisionedTPS を超えて増加した場合、Amazon Personalize はプロビジョンド容量を自動スケーリングしますが、minProvisionedTPS を下回ることはありません。容量が引き上げられている間に短時間の遅延が生じます。これにより、トランザクションの損失が生じる可能性があります。トラフィックが減少すると、容量は minProvisionedTPS に戻ります。

プロビジョニングされた最小 TPS、またはリクエストが minProvisionedTPS を超える場合は実際の TPS に対して課金されます。実際の TPS は、行ったレコメンデーションリクエストの総数です。低い minProvisionedTPS から始めて、Amazon CloudWatch メトリクスを使用して使用状況を追跡し、必要に応じて minProvisionedTPS を引き上げることをお勧めします。

キャンペーンのコストの詳細については、「Amazon Personalize の料金」を参照してください。

レコメンデーションのアイテムメタデータ

レコメンデーションを取得すると、Amazon Personalize にレコメンデーション結果にアイテムメタデータを含めることができます。リクエストでは、含めるアイテムデータセットから列を選択できます。Amazon Personalize は、レコメンデーションレスポンス内の各アイテムについてこのデータを返します。

メタデータを使用して、映画のジャンルをカルーセルに追加するなど、ユーザーインターフェイスのレコメンデーションを充実させることができます。あるいは、レコメンデーションの質を視覚的に評価するのにも使えます。アプリで生成 AI を使用している場合は、メタデータを AI プロンプトに組み込んで、より関連性の高いコンテンツを生成できます。Amazon Personalize の生成 AI の使用に関する詳細については、「Amazon Personalize と生成 AI」を参照してください。

メタデータの有効化

レコメンデーションにメタデータを追加するには、メタデータの列を含むアイテムデータセットが必要です。トレーニングではメタデータを使用する必要はありません。データセットの作成については、「スキーマとデータセットの作成」を参照してください。データの更新については、「トレーニング後のデータセット内のデータの更新」を参照してください。

User-Personalization-v2 または Personalized-Ranking-v2 レシピを使用すると、新しいキャンペーンにアイテムメタデータをレコメンデーション結果に含めるオプションが自動的に追加されます。キャンペーンのメタデータを手動で有効にすることはできません。他のすべてのレシピとドメインのユースケースでは、メタデータオプションを有効にする必要があります。

キャンペーンの作成 (コンソール)

ソリューションバージョンのステータスが [Active ] (アクティブ) になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。

キャンペーンの作成 (AWS CLI)

ソリューションバージョンが Active になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。でキャンペーンを作成するには AWS CLI、 create-campaign コマンドを使用します。

次のコードサンプルは、新しいキャンペーンを作成する方法を示しています。User-Personalization レシピを使用するソリューションの最新バージョンをデプロイします。将来のソリューションバージョンを使用するように自動的に更新されるキャンペーン。コードは、次の設定を使用します。

すべてのパラメータの詳細なリストについては、「CreateCampaign」を参照してください。

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

キャンペーンのステータスが ACTIVE になると、キャンペーンの準備が整います。現在のステータスを取得するには、DescribeCampaign を呼び出して、status フィールドが ACTIVE であることを確認します。

ソリューションバージョンを再トレーニングし、キャンペーンが自動的に更新されて最新のソリューションバージョンが使用されない場合、またはキャンペーン設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。

Amazon Personalize には、作成したキャンペーンを一覧表示する ListCampaigns など、キャンペーンを管理するための操作が用意されています。キャンペーンを削除するには、DeleteCampaign を呼び出します。キャンペーンを削除しても、キャンペーンの一部であるソリューションバージョンは削除されません。

キャンペーンを作成したら、これを使用して推奨を行うことができます。詳細については、「Amazon Personalize からのレコメンデーションの取得」を参照してください。

キャンペーンの作成 (AWS SDKs)

ソリューションバージョンが Active になったら、Amazon Personalize のキャンペーンでそのソリューションバージョンをデプロイする準備が整います。 AWS SDK を使用してキャンペーンを作成するには、CreateCampaign API オペレーションを使用します。

次のコードサンプルは、新しいキャンペーンを作成する方法を示しています。このコードは、User-Personalization レシピを使用するソリューションの最新バージョンをデプロイします。将来のソリューションバージョンを使用するように自動的に更新されるキャンペーン。コードは、次の設定を使用します。

すべてのパラメータの詳細なリストについては、「CreateCampaign」を参照してください。

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'])

キャンペーンのステータスが ACTIVE になると、キャンペーンの準備が整います。現在のステータスを取得するには、DescribeCampaign を呼び出して、status フィールドが ACTIVE であることを確認します。

ソリューションバージョンを手動で再トレーニングする場合、またはキャンペーンの設定を変更する場合は、キャンペーンを更新する必要があります。詳細については、「Amazon Personalize キャンペーンの設定の更新」を参照してください。

Amazon Personalize には、作成したキャンペーンを一覧表示する ListCampaigns など、キャンペーンを管理するための操作が用意されています。キャンペーンを削除するには、DeleteCampaign を呼び出します。キャンペーンを削除しても、キャンペーンの一部であるソリューションバージョンは削除されません。

キャンペーンを作成したら、これを使用して推奨を行うことができます。詳細については、「Amazon Personalize からのレコメンデーションの取得」を参照してください。