本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateSolution
创建用于训练模型的配置。经过训练的模型称为解决方案。创建配置后,您可以通过调用创建解决方案版本operation. 每次打电话CreateSolutionVersion
,将创建解决方案的新版本。
创建解决方案版本后,您可以通过调用来检查其准确性获取解决方案指标. 若您满意所创建的版本,请使用CreateCampaign. 该活动通过GetRecommendationsAPI。
要训练模型,Amazon Personalize 化需要培训数据和食谱。训练数据来自您在请求中提供的数据集组。配方指定了训练算法和特征转换。您可以指定 Amazon Personalize 化提供的预定义食谱之一。或者,您也可以指定performAutoML
而且 Amazon Personalize 化将分析您的数据并为您选择最佳的 USER_PEROIZATION 配方。
Amazon Personalize 化不支持配置hpoObjective
对于目前的解决方案超参数优化。
状态
解决方案可以处于以下某种状态:
-
创建待处理 > 创建进度 > 活动-或-创建失败
-
删除待处理 > 删除正在进行
要获取解决方案的状态,请调用描述解决方案. 在调用之前,请等待,直到状态显示为 ACCreateSolutionVersion
.
请求语法
{
"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 的更多信息,请参阅以下内容: