기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

캠페인과 함께 Amazon Personalize 솔루션 버전 배포하기

사용자 지정 리소스가 포함된 실시간 추천의 경우, 솔루션 버전 생성을 완료하고 나면 캠페인과 함께 솔루션 버전을 배포할 준비가 된 것입니다.

캠페인에서는 프로비저닝 트랜잭션 용량이 포함된 솔루션 버전(학습된 모델)을 배포하여 실시간 추천을 생성합니다. 캠페인을 생성한 후 GetRecommendations또는 GetPersonalizedRankingAPI 작업을 사용하여 추천을 얻을 수 있습니다. 일괄 항목 추천 또는 사용자 세그먼트를 받는 경우에는 캠페인을 만들 필요가 없습니다. 자세한 내용은 배치 항목 추천 받기 또는 일괄 사용자 세그먼트 가져오기을 참조하세요.

캠페인을 생성할 때 다음을 구성할 수 있습니다.

Amazon Personalize 콘솔, AWS Command Line Interface (AWS CLI) 또는 AWS SDK를 사용하여 캠페인을 생성할 수 있습니다. 권장 사항에서 메타데이터를 활성화하는 등 기존 캠페인의 설정을 변경하려면 캠페인을 업데이트해야 합니다. 자세한 정보는 Amazon Personalize 캠페인의 구성 업데이트을 참조하세요.

캠페인이 활성화된 동안에는 캠페인 비용이 발생합니다. 불필요한 비용이 발생하지 않도록 하려면 완료 후 캠페인을 삭제하세요. 캠페인 비용에 대한 자세한 내용은 Amazon Personalize 가격을 참조하십시오.

자동 캠페인 업데이트 활성화

캠페인을 생성할 때 자동 캠페인 업데이트를 활성화할 수 있습니다. 자동 업데이트를 사용하면 캠페인이 자동으로 업데이트되어 솔루션의 최신 자동 또는 수동 교육 솔루션 버전을 배포할 수 있습니다. 이렇게 하면 캠페인을 최신 상태로 유지하기가 더 쉬워집니다.

예를 들어 솔루션에서 자동 교육을 사용하여 7일마다 새 솔루션 버전을 만들면 매주 교육마다 최신 솔루션 버전을 사용하도록 캠페인이 자동으로 업데이트됩니다. 자동 캠페인 업데이트를 사용하지 않는 경우 캠페인을 수동으로 업데이트하여 학습된 최신 모델을 배포해야 합니다.

초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링

Amazon Personalize 캠페인을 생성할 때 캠페인에 대한 초당 최소 프로비저닝 트랜잭션 수(minProvisionedTPS)를 지정할 수 있습니다. 이는 Amazon Personalize에서 프로비저닝한 캠페인의 기준 트랜잭션 처리량입니다. 캠페인이 활성 상태일 때의 최소 청구 요금을 설정합니다. 트랜잭션은 단일 GetRecommendations 또는 GetPersonalizedRanking 요청으로 이루어집니다. 기본 minProvisionedTPS 값은 1입니다.

TPS가 minProvisionedTPS 이상으로 증가할 경우 Amazon Personalize는 프로비저닝 용량을 자동으로 확장 및 축소하지만, minProvisionedTPS 이하로는 확장 및 축소하지 않습니다. 용량이 증가 중에 잠시 동안의 지연으로 거래 손실이 발생할 수 있습니다. 트래픽이 감소하면 용량은 minProvisionedTPS로 돌아옵니다.

프로비저닝된 최소 TPS 또는 요청이 실제 TPS를 초과하는 경우 요금이 부과됩니다. minProvisionedTPS 실제 TPS는 추천을 요청한 총 건수입니다. 낮은 minProvisionedTPS 수치부터 시작하여 Amazon CloudWatch 측정치를 사용하여 사용량을 추적한 다음 minProvisionedTPS 필요에 따라 늘리는 것이 좋습니다.

캠페인 비용에 대한 자세한 내용은 Amazon Personalize 요금을 참조하세요.

권장 사항의 항목 메타데이터

추천을 받으면 Amazon Personalize가 추천 결과에 항목 메타데이터를 포함하도록 할 수 있습니다. 요청 시 항목 데이터세트에서 포함할 열을 선택할 수 있습니다. Amazon Personalize는 추천 응답의 각 항목에 대해 이 데이터를 반환합니다.

메타데이터를 통해 사용자 인터페이스에서 추천을 강화할 수 있습니다(예: 캐러셀에 영화 장르 추가). 또는 이를 사용하여 추천 품질을 시각적으로 평가할 수도 있습니다. 앱에서 생성형 AI를 사용하는 경우 메타데이터를 AI 프롬프트에 연결하여 관련성이 더 높은 콘텐츠를 생성할 수 있습니다. Amazon Personalize를 생성형 AI와 함께 사용하는 방법에 대한 자세한 내용은 Amazon Personalize 및 생성형 AI 섹션을 참조하세요.

메타데이터 활성화

추천에 메타데이터를 추가하려면 메타데이터 열이 포함된 항목 데이터 세트가 있어야 합니다. 교육 시 메타데이터를 사용할 필요는 없습니다. 데이터 세트 생성에 대한 내용은 데이터세트 및 스키마 생성 섹션을 참조하세요. 데이터 관리 및 업데이트에 대한 내용은 데이터셋의 훈련 데이터 관리 섹션을 참조하세요.

사용자 맞춤 설정-v2 또는 맞춤형 순위-v2 레시피를 사용하는 경우 캠페인에는 추천 결과에 항목 메타데이터를 포함할 수 있는 옵션이 자동으로 제공됩니다. 캠페인의 메타데이터를 수동으로 활성화할 필요는 없습니다. 다른 모든 레시피와 도메인 사용 사례의 경우 메타데이터 옵션을 활성화해야 합니다.

캠페인 생성(콘솔)

솔루션 버전 상태가 활성이면 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"}"

캠페인 상태가 활성이면 캠페인 준비가 완료된 것입니다. 현재 상태를 확인하려면 DescribeCampaign을 호출하고 status필드가 ACTIVE인지 확인합니다.

솔루션 버전을 재교육했는데 캠페인이 최신 솔루션 버전을 사용하도록 자동으로 업데이트되지 않거나 캠페인 설정을 변경하려는 경우 캠페인을 업데이트해야 합니다. 자세한 정보는 Amazon Personalize 캠페인의 구성 업데이트을 참조하세요.

Amazon Personalize는 생성한 캠페인을 ListCampaigns 나열하는 것과 같은 캠페인 관리 작업을 제공합니다. 캠페인은 DeleteCampaign을 호출하여 삭제할 수 있습니다. 캠페인을 삭제하더라도 캠페인의 일부인 솔루션 버전은 삭제되지 않습니다.

캠페인을 생성한 후 이를 사용하여 추천할 수 있습니다. 자세한 정보는 4단계: 추천 받기을 참조하세요.

캠페인 (AWS SDK) 만들기

솔루션 버전이 활성 상태가 되면 Amazon Personalize 캠페인을 통해 배포할 준비가 된 것입니다. AWS SDK로 캠페인을 생성하려면 CreateCampaign API 작업을 사용합니다.

다음 코드 샘플은 캠페인을 만드는 방법을 보여줍니다. 이 코드는 사용자-개인화 레시피를 사용하는 솔루션의 최신 솔루션 버전을 배포합니다. 만든 캠페인은 향후 솔루션 버전을 사용할 수 있도록 자동으로 업데이트됩니다. 코드는 다음 구성을 사용합니다.

모든 파라미터의 전체 목록은 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();

캠페인 상태가 활성이면 캠페인 준비가 완료된 것입니다. 현재 상태를 확인하려면 전화를 걸어 DescribeCampaign status 필드가 맞는지 확인하십시오ACTIVE.

솔루션 버전을 수동으로 재교육하거나 캠페인 설정을 변경하려면 캠페인을 업데이트해야 합니다. 자세한 정보는 Amazon Personalize 캠페인의 구성 업데이트을 참조하세요.

Amazon Personalize는 생성한 캠페인을 ListCampaigns 나열하는 것과 같은 캠페인 관리 작업을 제공합니다. 캠페인은 DeleteCampaign을 호출하여 삭제할 수 있습니다. 캠페인을 삭제하더라도 캠페인의 일부인 솔루션 버전은 삭제되지 않습니다.

캠페인을 생성한 후에 캠페인을 사용하여 추천을 생성합니다. 자세한 내용은 4단계: 추천 받기단원을 참조하세요.