翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

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

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

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)

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

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

すべてのパラメータの詳細なリストについては、「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)

ソリューションバージョンがアクティブになったら、Amazon Personalize キャンペーンでデプロイする準備が整います。でキャンペーンを作成するには AWS SDKs、 CreateCampaignAPIオペレーションを使用します。

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

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

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();

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

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

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

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