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对于目前的解决方案超参数优化。

状态

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

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

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

要获解决方案的状态,请调用描述解决方案. 请等待,直到状态显示为 ACTIVE,然后再CreateSolutionVersion.

请求语法

{ "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)。

类型: 字符串

长度约束:长度上限为 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 延长了训练过程。

类型: 布尔值

:必需 否

performHPO

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

执行 AutoML 时,此参数始终是true而且你不应该将其设置为false.

类型: 布尔值

:必需 否

recipeArn

用于模型训练的配方的 ARN。仅在何时指定performAutoML是假的。

类型: 字符串

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

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

:必需 否

solutionConfig

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

注意

Amazon Personalize 化不支持配置hpoObjective目前。

类型:SolutionConfig 对象

:必需 否

tags

列表标签以应用于解决方案。

类型: 数组Tag对象

数组成员:最少 0 项。最多 200 项。

:必需 否

响应语法

{ "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

TooManyTagsException

您已超出您可以应用于此资源的最大标签数。

HTTP 状态代码:400

另请参阅

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