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

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

CreateSolution

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

创建解决方案版本后，您可以通过调用来检查其准确性获取解决方案指标. 若您满意所创建的版本，请使用CreateCampaign. 该活动通过GetRecommendationsAPI。

要训练模型，Amazon Personalize 化需要培训数据和食谱。训练数据来自您在请求中提供的数据集组。配方指定了训练算法和特征转换。您可以指定 Amazon Personalize 化提供的预定义食谱之一。或者，您也可以指定performAutoML而且 Amazon Personalize 化将分析您的数据并为您选择最佳的 USER_PEROIZATION 配方。

注意

Amazon Personalize 化不支持配置hpoObjective对于目前的解决方案超参数优化。

状态

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

  • 创建待处理 > 创建进度 > 活动-或-创建失败

  • 删除待处理 > 删除正在进行

要获取解决方案的状态，请调用描述解决方案. 在调用之前，请等待，直到状态显示为 ACCreateSolutionVersion.

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

请求参数

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

datasetGroupArn

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

类型: 字符串

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

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

：必需 是

eventType

当你有多种事件类型时（使用EVENT_TYPE模式字段），此参数指定用于训练模型的事件类型（例如，“点击” 或 “类似”）。

如果你不提供eventType，Amazon Personalize 化将使用所有互动进行训练，无论类型如何，均具有相同

类型: 字符串

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

：必需 否

name

解决方案的名称。

类型: 字符串

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

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

：必需 是

performAutoML

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

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

类型: Boolean

：必需 否

performHPO

是否对指定或选定的配方执行超参数优化 (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 格式返回的以下数据。

solutionArn

解决方案的 ARN。

类型: 字符串

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

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

错误

InvalidInputException

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

HTTP 状态代码：400

LimitExceededException

已超过每秒的请求数的限制。

HTTP 状态代码：400

ResourceAlreadyExistsException

指定的资源已存在。

HTTP 状态代码：400

ResourceInUseException

正在使用指定的资源。

HTTP 状态代码：400

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码：400

另请参阅

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