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

캠페인을 사용하여 Amazon Personalize 솔루션 버전 배포

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

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

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

Personalize 콘솔 AWS Command Line Interface (AWS CLI) 또는 를 사용하여 캠페인을 생성할 수 있습니다 AWS SDKs. 추천에서 메타데이터 활성화와 같은 기존 캠페인의 설정을 변경하려면 캠페인을 업데이트해야 합니다. 자세한 내용은 Personalize 캠페인의 구성 업데이트 단원을 참조하십시오.

캠페인이 활성화되어 있는 동안 캠페인 비용이 발생합니다. 불필요한 비용을 방지하려면 완료 시 캠페인을 삭제해야 합니다. 캠페인 비용에 대한 자세한 내용은 Personalize 요금 섹션을 참조하세요.

자동 캠페인 업데이트

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

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

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

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

를 초과하여 가 TPS 증가하면 minProvisionedTPSPersonalize는 프로비저닝된 용량을 상하로 자동 조정하지만 에는 절대 미치지 않습니다minProvisionedTPS. 용량이 증가 중에 잠시 동안의 지연으로 거래 손실이 발생할 수 있습니다. 트래픽이 감소하면 용량은 minProvisionedTPS로 돌아옵니다.

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

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

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

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

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

메타데이터 활성화

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

User-Personalization-v2 또는 Personalized-Ranking-v2 레시피를 사용하는 경우 새 캠페인에는 추천 결과와 함께 항목 메타데이터를 포함할 수 있는 옵션이 자동으로 있습니다. 캠페인에 대한 메타데이터를 수동으로 활성화하지 않았습니다. 다른 모든 레시피 및 도메인 사용 사례의 경우 메타데이터 옵션을 활성화해야 합니다.

캠페인 생성(콘솔)

솔루션 버전 상태가 활성이면 Personalize 캠페인을 통해 솔루션을 배포할 준비가 된 것입니다.

캠페인 생성(AWS CLI)

솔루션 버전이 활성 상태가 되면 Personalize 캠페인으로 배포할 준비가 된 것입니다. 를 사용하여 캠페인을 생성하려면 create-campaign 명령을 AWS CLI사용합니다.

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

모든 파라미터의 전체 목록은 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인지 확인합니다.

솔루션 버전을 재훈련했는데 캠페인이 최신 솔루션 버전을 사용하도록 자동으로 업데이트되지 않거나 캠페인 설정을 변경하려면 캠페인을 업데이트해야 합니다. 자세한 내용은 Personalize 캠페인의 구성 업데이트 단원을 참조하십시오.

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

캠페인을 생성한 후에는 캠페인을 사용하여 추천을 할 수 있습니다. 자세한 내용은 Personalize에서 추천 받기 단원을 참조하십시오.

캠페인 생성(AWS SDKs)

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

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

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

솔루션 버전을 수동으로 재훈련하거나 캠페인 설정을 변경하려면 캠페인을 업데이트해야 합니다. 자세한 내용은 Personalize 캠페인의 구성 업데이트 단원을 참조하십시오.

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

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