CreateSolution - Amazon Personalize
요청 구문요청 파라미터응답 구문응답 요소오류참고 항목

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

CreateSolution

모델을 교육하기 위한 구성을 생성합니다. 교육된 모델을 솔루션이라고 하고, 구성이 생성된 후 다음을 호출하여 모델을 훈련시킵니다 (솔루션 생성).만들기솔루션 버전작업. 전화를 걸 때마다CreateSolutionVersion의 새 솔루션 버전이 생성됩니다.

솔루션 버전을 만든 후 다음을 호출하여 정확성을 확인합니다.GetSolution메트릭. 버전에 어떤 문제가 없으면 를 사용하여 버전을 배포할 수 있습니다.CreateCampaign. 캠페인은 다음을 통해 고객에게 권장 사항을 제공합니다.GetRecommendationsAPI.

모델을 훈련시키기 위해 Amazon Personalize Personalize에는 교육 데이터와 레시피가 필요합니다. 교육 데이터는 요청에 제공한 데이터세트 그룹에서 가져옵니다. 레시피는 훈련 알고리즘과 피쳐 변환을 지정합니다. Amazon Personalize에서 제공하는 사전 정의된 레시피 중 한 가지를 지정할 수 있습니다. 또는 를 지정할 수 있습니다.performAutoMLAmazon Personalize Personalize는 데이터를 분석하고 최적의 USER_개인 설정 방법을 선택합니다.

참고

Amazon Personalize 다음을 구성하는 것을 지원하지 않습니다.hpoObjective현재 솔루션 하이퍼파라미터 최적화를 위한 것입니다.

상태

솔루션은 다음 상태 중 하나일 수 있습니다.

  • 작성 보류 중 > 생성 진행 중 > 활성 또는 생성 실패

  • 보류 중 삭제 > 진행 중 삭제

솔루션의 상태를 확인하려면 을 호출합니다.설명솔루션. 호출하기 전에 상태가 ACTIVE로 나타날 때까지 기다립니다.CreateSolutionVersion.

관련 API

요청 구문

{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performHPO": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "eventValueThreshold": "string",
      "featureTransformationParameters": { 
         "string" : "string" 
      },
      "hpoConfig": { 
         "algorithmHyperParameterRanges": { 
            "categoricalHyperParameterRanges": [ 
               { 
                  "name": "string",
                  "values": [ "string" ]
               }
            ],
            "continuousHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ],
            "integerHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ]
         },
         "hpoObjective": { 
            "metricName": "string",
            "metricRegex": "string",
            "type": "string"
         },
         "hpoResourceConfig": { 
            "maxNumberOfTrainingJobs": "string",
            "maxParallelTrainingJobs": "string"
         }
      },
      "optimizationObjective": { 
         "itemAttribute": "string",
         "objectiveSensitivity": "string"
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

요청 파라미터

요청은 JSON 형식의 다음 데이터를 받습니다.

datasetGroupArn

교육 데이터를 제공하는 데이터 세트 그룹의 Amazon 리소스 이름 (ARN) 입니다.

Type: String

길이 제약 조건: 최대 길이 256.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

필요 사항: 예

eventType

이벤트 유형이 여러 개인 경우 (EVENT_TYPE스키마 필드) 를 사용하면 모델을 훈련하는 데 사용되는 이벤트 유형 (예: 'click' 또는 'like') 을 지정합니다.

제공하지 않는 경우eventTypeAmazon Personalize 유형에 관계없이 동일한 가중치를 가진 교육에 모든 상호 작용을 사용합니다.

Type: String

길이 제약 조건: 최대 길이 256.

필요 사항: 아니요

name

솔루션의 이름.

Type: String

길이 제약 조건: 최소 길이는 1이고, 최대 길이 63.

패턴: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

필요 사항: 예

performAutoML

자동 기계 학습 (AutoML) 을 수행할지 여부입니다. 기본값은 false입니다. 이 경우 를 지정해야 합니다.recipeArn.

로 설정된 경우trueAmazon Personalize Personalize는 교육 데이터를 분석하고 최적의 USER_개인화 레시피 및 하이퍼파라미터를 선택합니다. 이 경우 생략해야 합니다.recipeArn. Amazon Personalize Personalize는 하이퍼파라미터에 대해 서로 다른 값으로 테스트를 실행하여 최적의 레시피를 결정합니다. AutoML은 특정 레시피를 선택하는 것과 비교하여 훈련 프로세스를 길게합니다.

Type: Boolean

필요 사항: 아니요

performHPO

지정된 레시피나 선택된 레시피에 대해 하이퍼파라미터 최적화 (HPO) 를 수행할지 여부입니다. 기본값은 false입니다.

AutoML을 수행할 때 이 매개 변수는 항상true로 설정해서는 안 됩니다.false.

Type: Boolean

필요 사항: 아니요

recipeArn

모델 교육에 사용할 레시피의 ARN입니다. 다음에만 지정됨performAutoML가 false입니다.

Type: String

길이 제약 조건: 최대 길이 256.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

필요 사항: 아니요

solutionConfig

솔루션과 함께 사용할 구성입니다. 일시performAutoML가 true로 설정되면 Amazon Personalize Personalize가autoMLConfig솔루션 구성의 섹션입니다.

참고

Amazon Personalize 다음을 구성하는 것을 지원하지 않습니다.hpoObjective현재는 가능합니다.

유형: SolutionConfig 객체

필요 사항: 아니요

tags

목록태그솔루션에 적용할 수 있습니다.

Type: 배열Tag사물

배열 멤버: 최소 항목 수 0개. 최대 항목 수는 200개입니다.

필요 사항: 아니요

응답 구문

{
   "solutionArn": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

solutionArn

솔루션의 ARN입니다.

Type: String

길이 제약 조건: 최대 길이 256.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

오류

InvalidInputException

필드 또는 파라미터에 유효한 값을 제공합니다.

HTTP 상태 코드: 400

LimitExceededException

초당 요청 수 제한이 초과되었습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

지정한 리소스가 이미 존재합니다.

HTTP 상태 코드: 400

ResourceInUseException

지정한 리소스가 이미 사용 중입니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 리소스를 찾을 수 없습니다.

HTTP 상태 코드: 400

TooManyTagsException

이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.