CreateSolution - Amazon Personalize
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

CreateSolution

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

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

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

注意

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

状态

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

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

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

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

请求语法

{ "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 的更多信息,请参阅以下内容: