CreateSolution - Amazon Personalize
请求语法请求参数响应语法响应元素Errors另请参阅
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CreateSolution

创建用于训练模型的配置。经过训练的模型称为解决方案。创建配置后，您可以通过调用CreateSolutionVersionoperation. 每次你打电话CreateSolutionVersion，则将创建解决方案的新版本。

创建解决方案版本后，您可以通过调用GetSolutionMetrics。当您对版本感到满意时，您可以使用CreateCampaign。该活动通过GetRecommendationsAPI。

要训练模型，Amazon Personalize 需要培训数据和配方。训练数据来自您在请求中提供的数据集组。配方指定训练算法和要素转换。您可以指定 Amazon 个性化提供的某个预定义配方。或者，您也可以指定performAutoML，Amazon Personalize 将分析您的数据并为您选择最佳的用户个性化配方。

注意

Amazon Personalize 不支持配置hpoObjective以获取解决方案超参数优化。

状态

解决方案可以处于以下某种状态：

  • “创建挂起” > “正在创建” > “活动” 或 “创建失败”

  • 删除挂起 > 删除正在进行

要获取解决方案的状态，请调用。DescribeSolution。等待，直到状态显示为 ACTIVECreateSolutionVersion。

相关 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"
         }
      }
   }
}

请求参数

请求接受采用 JSON 格式的以下数据。

DatasetGroupArn

提供训练数据的数据集组的 Amazon 资源名称 (ARN)。

类型: 字符串

长度约束：长度上限为 256。

模式：arn:([a-z\d-]+):personalize:.*:.*:.+

：必需 是

eventType

当你有多个事件类型时（使用EVENT_TYPE架构字段），此参数指定用于训练模型的事件类型（例如，'click' 或 '类似'）。

如果您没有提供eventType，Amazon Personalize 将使用所有交互进行相同重量的训练，无论类型如何。

类型: 字符串

长度约束：长度上限为 256。

：必需 否

name

解决方案的名称。

类型: 字符串

长度约束：最小长度为 1。长度上限为 63。

模式：^[a-zA-Z0-9][a-zA-Z0-9\-_]*

：必需 是

performAutoML

是否执行自动机器学习 (AutoML)。默认为 false。对于此情况，您必须指定recipeArn。

如果设置为true，Amazon Personalize 会分析您的培训数据，并选择最佳的 USER_个性化配方和超参数。在此情况下，您必须省略recipeArn。Amazon Personalize 通过运行具有不同值的超参数测试来确定最佳配方。与选择特定配方相比，AutoML 延长了培训过程。

类型: Boolean

：必需 否

公共卫生保健组织

是否对指定或选定的配方执行超参数优化 (HPO)。默认为 false。

执行 AutoML 时，此参数始终为true，你不应该将它设置为false。

类型: Boolean

：必需 否

recipeArn

用于模型培训的配方的 ARN。仅在performAutoML是 false 的。

类型: 字符串

长度约束：长度上限为 256。

模式：arn:([a-z\d-]+):personalize:.*:.*:.+

：必需 否

solutionConfig

与解决方案一起使用的配置。何时performAutoML设为 true，则 Amazon Personalize 仅评估autoMLConfig部分中的解决方案配置。

注意

Amazon Personalize 不支持配置hpoObjective目前。

类型：SolutionConfig 对象

：必需 否

响应语法

{
   "solutionArn": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

解决方案

解决方案的 ARN。

类型: 字符串

长度约束：长度上限为 256。

模式：arn:([a-z\d-]+):personalize:.*:.*:.+

Errors

InvalidInputException

为字段或参数提供有效值。

HTTP 状态代码：400

LimitExceededException

每秒的限制已超出。

HTTP 状态代码：400

ResourceAlreadyExistsException

已存在指定的资源。

HTTP 状态代码：400

ResourceInUseException

Specify resource is use (指定的资源正在使用

HTTP 状态代码：400

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码：400

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：