Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateSolution
Importante
Per impostazione predefinita, tutte le nuove soluzioni utilizzano la formazione automatica. Con la formazione automatica, si sostengono costi di formazione mentre la soluzione è attiva. Per evitare costi inutili, al termine è possibile aggiornare la soluzione per disattivare la formazione automatica. Per informazioni sui costi di formazione, consulta i prezzi di Amazon Personalize
Crea la configurazione per l'addestramento di un modello (creazione di una versione della soluzione). Questa configurazione include la ricetta da utilizzare per l'addestramento dei modelli e la configurazione di addestramento opzionale, ad esempio le colonne da utilizzare nell'addestramento e i parametri di trasformazione delle funzionalità. Per ulteriori informazioni sulla configurazione di una soluzione, vedere Creazione e configurazione di una soluzione.
Per impostazione predefinita, le nuove soluzioni utilizzano la formazione automatica per creare versioni della soluzione ogni 7 giorni. È possibile modificare la frequenza dell'allenamento. La creazione automatica della versione della soluzione inizia entro un'ora dall'attivazione della soluzione. Se crei manualmente una versione della soluzione entro un'ora, la soluzione salta il primo addestramento automatico. Per ulteriori informazioni, vedere Configurazione della formazione automatica.
Per disattivare l'allenamento automatico, imposta su performAutoTraining false. Se si disattiva la formazione automatica, è necessario creare manualmente una versione della soluzione richiamando l'CreateSolutionVersionoperazione.
Dopo l'inizio della formazione, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con il funzionamento dell'ListSolutionVersionsAPI. Per conoscerne lo stato, usa il DescribeSolutionVersion.
Al termine della formazione, è possibile valutare la precisione del modello GetSolutionMetricschiamando. Quando sei soddisfatto della versione della soluzione, la distribuisci utilizzando. CreateCampaign La campagna fornisce consigli a un cliente tramite l'GetRecommendationsAPI.
Nota
Al momento Amazon Personalize non supporta la configurazione dell'ottimizzazione hpoObjective degli iperparametri della soluzione.
Stato
Una soluzione può trovarsi in uno dei seguenti stati:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oppure- CREATE FAILED
-
DELETE PENDING > DELETE IN_PROGRESS
Per conoscere lo stato della soluzione, chiamate DescribeSolution. Se si utilizza la formazione manuale, lo stato deve essere ATTIVO prima della chiamataCreateSolutionVersion.
Sintassi della richiesta
{
"datasetGroupArn": "string",
"eventType": "string",
"name": "string",
"performAutoML": boolean,
"performAutoTraining": boolean,
"performHPO": boolean,
"recipeArn": "string",
"solutionConfig": {
"algorithmHyperParameters": {
"string" : "string"
},
"autoMLConfig": {
"metricName": "string",
"recipeList": [ "string" ]
},
"autoTrainingConfig": {
"schedulingExpression": "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"
},
"trainingDataConfig": {
"excludedDatasetColumns": {
"string" : [ "string" ]
}
}
},
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- datasetGroupArn
-
Il nome della risorsa Amazon (ARN) del gruppo di set di dati che fornisce i dati di addestramento.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Campo obbligatorio: sì
- eventType
-
Quando si utilizzano più tipi di eventi (utilizzando un campo
EVENT_TYPEdello schema), questo parametro specifica quale tipo di evento (ad esempio, «click» o «mi piace») viene utilizzato per addestrare il modello.Se non ne fornisci uno
eventType, Amazon Personalize utilizzerà tutte le interazioni per allenarti con lo stesso peso indipendentemente dal tipo.Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Campo obbligatorio: no
- name
-
Il nome della soluzione.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Campo obbligatorio: sì
- performAutoML
-
Importante
Si sconsiglia l’abilitazione del machine learning automatizzato. Abbina, invece, il tuo caso d'uso alle ricette Amazon Personalize disponibili. Per ulteriori informazioni, vedere Scelta di una ricetta.
Se eseguire l'apprendimento automatico (AutoML). Il valore predefinito è
false. In questo caso, è necessario specificarerecipeArn.Se impostato su
true, Amazon Personalize analizza i dati di allenamento e seleziona la ricetta e gli iperparametri USER_PERSONALIZATION ottimali. In questo caso, devi omettere.recipeArnAmazon Personalize determina la ricetta ottimale eseguendo test con valori diversi per gli iperparametri. AutoML allunga il processo di formazione rispetto alla selezione di una ricetta specifica.Tipo: Booleano
Campo obbligatorio: no
- performAutoTraining
-
Se la soluzione utilizza la formazione automatica per creare nuove versioni della soluzione (modelli addestrati). L'impostazione predefinita è
Truee la soluzione crea automaticamente nuove versioni della soluzione ogni 7 giorni. È possibile modificare la frequenza di allenamento specificando unschedulingExpressionnella casellaAutoTrainingConfigcome parte della configurazione della soluzione. Per ulteriori informazioni sulla formazione automatica, vedere Configurazione dell'allenamento automatico.La creazione automatica della versione della soluzione inizia entro un'ora dall'attivazione della soluzione. Se crei manualmente una versione della soluzione entro un'ora, la soluzione salta il primo addestramento automatico.
Dopo l'inizio della formazione, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con il funzionamento dell'ListSolutionVersionsAPI. Per conoscerne lo stato, usa il DescribeSolutionVersion.
Tipo: Booleano
Campo obbligatorio: no
- performHPO
-
Se eseguire l'ottimizzazione degli iperparametri (HPO) sulla ricetta specificata o selezionata. Il valore predefinito è
false.Quando si esegue AutoML, questo parametro è sempre
truee non è necessario impostarlo su.falseTipo: Booleano
Campo obbligatorio: no
- recipeArn
-
L'Amazon Resource Name (ARN) della ricetta da utilizzare per la formazione dei modelli. È richiesto quando
performAutoMLè falso. Per informazioni sulle diverse ricette di Amazon Personalize e relative ARNs, consulta Scelta di una ricetta.Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Campo obbligatorio: no
- solutionConfig
-
Le proprietà di configurazione della soluzione. Quando
performAutoMLè impostato su true, Amazon Personalize valuta solo laautoMLConfigsezione della configurazione della soluzione.Nota
Attualmente, Amazon Personalize non supporta la configurazione di
hpoObjective.Tipo: oggetto SolutionConfig
Campo obbligatorio: no
-
Un elenco di tag da applicare alla soluzione.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
Sintassi della risposta
{
"solutionArn": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- solutionArn
-
L'ARN della soluzione.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errori
- InvalidInputException
-
Fornire un valore valido per il campo o il parametro.
Codice di stato HTTP: 400
- LimitExceededException
-
Il limite del numero di richieste al secondo è stato superato.
Codice di stato HTTP: 400
- ResourceAlreadyExistsException
-
La risorsa specificata esiste già.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Impossibile trovare la risorsa specificata.
Codice di stato HTTP: 400
- TooManyTagsException
-
Hai superato il numero massimo di tag che puoi applicare a questa risorsa.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
