AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.
[ aws . personalize ]
Creates the configuration for training a model (creating a solution version). This configuration includes the recipe to use for model training and optional training configuration, such as columns to use in training and feature transformation parameters. For more information about configuring a solution, see Creating and configuring a solution .
By default, new solutions use automatic training to create solution versions every 7 days. You can change the training frequency. Automatic solution version creation starts within one hour after the solution is ACTIVE. If you manually create a solution version within the hour, the solution skips the first automatic training. For more information, see Configuring automatic training .
To turn off automatic training, set performAutoTraining
to false. If you turn off automatic training, you must manually create a solution version by calling the CreateSolutionVersion operation.
After training starts, you can get the solution version's Amazon Resource Name (ARN) with the ListSolutionVersions API operation. To get its status, use the DescribeSolutionVersion .
After training completes you can evaluate model accuracy by calling GetSolutionMetrics . When you are satisfied with the solution version, you deploy it using CreateCampaign . The campaign provides recommendations to a client through the GetRecommendations API.
Amazon Personalize doesn't support configuring thehpoObjective
for solution hyperparameter optimization at this time.
Status
A solution can be in one of the following states:
To get the status of the solution, call DescribeSolution . If you use manual training, the status must be ACTIVE before you call CreateSolutionVersion
.
Related APIs
See also: AWS API Documentation
create-solution
--name <value>
[--perform-hpo | --no-perform-hpo]
[--perform-auto-ml | --no-perform-auto-ml]
[--perform-auto-training | --no-perform-auto-training]
[--recipe-arn <value>]
--dataset-group-arn <value>
[--event-type <value>]
[--solution-config <value>]
[--tags <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
--name
(string)
The name for the solution.
--perform-hpo
| --no-perform-hpo
(boolean)
Whether to perform hyperparameter optimization (HPO) on the specified or selected recipe. The default is
false
.When performing AutoML, this parameter is always
true
and you should not set it tofalse
.
--perform-auto-ml
| --no-perform-auto-ml
(boolean)
Warning
We don't recommend enabling automated machine learning. Instead, match your use case to the available Amazon Personalize recipes. For more information, see Choosing a recipe .Whether to perform automated machine learning (AutoML). The default is
false
. For this case, you must specifyrecipeArn
.When set to
true
, Amazon Personalize analyzes your training data and selects the optimal USER_PERSONALIZATION recipe and hyperparameters. In this case, you must omitrecipeArn
. Amazon Personalize determines the optimal recipe by running tests with different values for the hyperparameters. AutoML lengthens the training process as compared to selecting a specific recipe.
--perform-auto-training
| --no-perform-auto-training
(boolean)
Whether the solution uses automatic training to create new solution versions (trained models). The default is
True
and the solution automatically creates new solution versions every 7 days. You can change the training frequency by specifying aschedulingExpression
in theAutoTrainingConfig
as part of solution configuration. For more information about automatic training, see Configuring automatic training .Automatic solution version creation starts within one hour after the solution is ACTIVE. If you manually create a solution version within the hour, the solution skips the first automatic training.
After training starts, you can get the solution version's Amazon Resource Name (ARN) with the ListSolutionVersions API operation. To get its status, use the DescribeSolutionVersion .
--recipe-arn
(string)
The Amazon Resource Name (ARN) of the recipe to use for model training. This is required whenperformAutoML
is false. For information about different Amazon Personalize recipes and their ARNs, see Choosing a recipe .
--dataset-group-arn
(string)
The Amazon Resource Name (ARN) of the dataset group that provides the training data.
--event-type
(string)
When your have multiple event types (using an
EVENT_TYPE
schema field), this parameter specifies which event type (for example, 'click' or 'like') is used for training the model.If you do not provide an
eventType
, Amazon Personalize will use all interactions for training with equal weight regardless of type.
--solution-config
(structure)
The configuration properties for the solution. When
performAutoML
is set to true, Amazon Personalize only evaluates theautoMLConfig
section of the solution configuration.Note
Amazon Personalize doesn't support configuring thehpoObjective
at this time.eventValueThreshold -> (string)
Only events with a value greater than or equal to this threshold are used for training a model.hpoConfig -> (structure)
Describes the properties for hyperparameter optimization (HPO).
hpoObjective -> (structure)
The metric to optimize during HPO.
Note
Amazon Personalize doesn't support configuring thehpoObjective
at this time.type -> (string)
The type of the metric. Valid values areMaximize
andMinimize
.metricName -> (string)
The name of the metric.metricRegex -> (string)
A regular expression for finding the metric in the training job logs.hpoResourceConfig -> (structure)
Describes the resource configuration for HPO.
maxNumberOfTrainingJobs -> (string)
The maximum number of training jobs when you create a solution version. The maximum value formaxNumberOfTrainingJobs
is40
.maxParallelTrainingJobs -> (string)
The maximum number of parallel training jobs when you create a solution version. The maximum value formaxParallelTrainingJobs
is10
.algorithmHyperParameterRanges -> (structure)
The hyperparameters and their allowable ranges.
integerHyperParameterRanges -> (list)
The integer-valued hyperparameters and their ranges.
(structure)
Provides the name and range of an integer-valued hyperparameter.
name -> (string)
The name of the hyperparameter.minValue -> (integer)
The minimum allowable value for the hyperparameter.maxValue -> (integer)
The maximum allowable value for the hyperparameter.continuousHyperParameterRanges -> (list)
The continuous hyperparameters and their ranges.
(structure)
Provides the name and range of a continuous hyperparameter.
name -> (string)
The name of the hyperparameter.minValue -> (double)
The minimum allowable value for the hyperparameter.maxValue -> (double)
The maximum allowable value for the hyperparameter.categoricalHyperParameterRanges -> (list)
The categorical hyperparameters and their ranges.
(structure)
Provides the name and range of a categorical hyperparameter.
name -> (string)
The name of the hyperparameter.values -> (list)
A list of the categories for the hyperparameter.
(string)
algorithmHyperParameters -> (map)
Lists the algorithm hyperparameters and their values.
key -> (string)
value -> (string)
featureTransformationParameters -> (map)
Lists the feature transformation parameters.
key -> (string)
value -> (string)
autoMLConfig -> (structure)
The AutoMLConfig object containing a list of recipes to search when AutoML is performed.
metricName -> (string)
The metric to optimize.recipeList -> (list)
The list of candidate recipes.
(string)
optimizationObjective -> (structure)
Describes the additional objective for the solution, such as maximizing streaming minutes or increasing revenue. For more information see Optimizing a solution .
itemAttribute -> (string)
The numerical metadata column in an Items dataset related to the optimization objective. For example, VIDEO_LENGTH (to maximize streaming minutes), or PRICE (to maximize revenue).objectiveSensitivity -> (string)
Specifies how Amazon Personalize balances the importance of your optimization objective versus relevance.trainingDataConfig -> (structure)
Specifies the training data configuration to use when creating a custom solution version (trained model).
excludedDatasetColumns -> (map)
Specifies the columns to exclude from training. Each key is a dataset type, and each value is a list of columns. Exclude columns to control what data Amazon Personalize uses to generate recommendations.
For example, you might have a column that you want to use only to filter recommendations. You can exclude this column from training and Amazon Personalize considers it only when filtering.
key -> (string)
value -> (list)
(string)autoTrainingConfig -> (structure)
Specifies the automatic training configuration to use.
schedulingExpression -> (string)
Specifies how often to automatically train new solution versions. Specify a rate expression in rate(value unit ) format. For value, specify a number between 1 and 30. For unit, specify
day
ordays
. For example, to automatically create a new solution version every 5 days, specifyrate(5 days)
. The default is every 7 days.For more information about auto training, see Creating and configuring a solution .
JSON Syntax:
{
"eventValueThreshold": "string",
"hpoConfig": {
"hpoObjective": {
"type": "string",
"metricName": "string",
"metricRegex": "string"
},
"hpoResourceConfig": {
"maxNumberOfTrainingJobs": "string",
"maxParallelTrainingJobs": "string"
},
"algorithmHyperParameterRanges": {
"integerHyperParameterRanges": [
{
"name": "string",
"minValue": integer,
"maxValue": integer
}
...
],
"continuousHyperParameterRanges": [
{
"name": "string",
"minValue": double,
"maxValue": double
}
...
],
"categoricalHyperParameterRanges": [
{
"name": "string",
"values": ["string", ...]
}
...
]
}
},
"algorithmHyperParameters": {"string": "string"
...},
"featureTransformationParameters": {"string": "string"
...},
"autoMLConfig": {
"metricName": "string",
"recipeList": ["string", ...]
},
"optimizationObjective": {
"itemAttribute": "string",
"objectiveSensitivity": "LOW"|"MEDIUM"|"HIGH"|"OFF"
},
"trainingDataConfig": {
"excludedDatasetColumns": {"string": ["string", ...]
...}
},
"autoTrainingConfig": {
"schedulingExpression": "string"
}
}
--tags
(list)
A list of tags to apply to the solution.
(structure)
The optional metadata that you apply to resources to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. For more information see Tagging Amazon Personalize resources .
tagKey -> (string)
One part of a key-value pair that makes up a tag. A key is a general label that acts like a category for more specific tag values.tagValue -> (string)
The optional part of a key-value pair that makes up a tag. A value acts as a descriptor within a tag category (key).
Shorthand Syntax:
tagKey=string,tagValue=string ...
JSON Syntax:
[
{
"tagKey": "string",
"tagValue": "string"
}
...
]
--cli-input-json
(string)
Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton
. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.
--generate-cli-skeleton
(string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input
, prints a sample input JSON that can be used as an argument for --cli-input-json
. If provided with the value output
, it validates the command inputs and returns a sample output JSON for that command.
--debug
(boolean)
Turn on debug logging.
--endpoint-url
(string)
Override command's default URL with the given URL.
--no-verify-ssl
(boolean)
By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.
--no-paginate
(boolean)
Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.
--output
(string)
The formatting style for command output.
--query
(string)
A JMESPath query to use in filtering the response data.
--profile
(string)
Use a specific profile from your credential file.
--region
(string)
The region to use. Overrides config/env settings.
--version
(string)
Display the version of this tool.
--color
(string)
Turn on/off color output.
--no-sign-request
(boolean)
Do not sign requests. Credentials will not be loaded if this argument is provided.
--ca-bundle
(string)
The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.
--cli-read-timeout
(int)
The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.
--cli-connect-timeout
(int)
The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.