CreateSolution - Amazon Personalize
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 dalla creazione della soluzioneACTIVE. 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 l'ListSolutionVersionsAPIoperazione. 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. 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:

  • CREATEPENDING> CREATE IN_ PROGRESS > ACTIVE -oppure- CREATE FAILED

  • DELETEPENDING> IT_ DELETE PROGRESS

Per conoscere lo stato della soluzione, chiamate DescribeSolution. Se si utilizza la formazione manuale, lo stato deve essere ACTIVE precedente alla chiamataCreateSolutionVersion.

Correlati APIs

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 nel JSON formato.

datasetGroupArn

L'Amazon Resource Name (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 hai più tipi di eventi (utilizzando un campo EVENT_TYPE dello schema), questo parametro specifica quale tipo di evento (ad esempio, «click» o «mi piace») viene utilizzato per addestrare il modello.

Se non ne fornisci unoeventType, 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 sutrue, Amazon Personalize analizza i dati di allenamento e seleziona la USER _ PERSONALIZATION ricetta e gli iperparametri ottimali. In questo caso, devi omettere. recipeArn Amazon 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 è True e la soluzione crea automaticamente nuove versioni della soluzione ogni 7 giorni. È possibile modificare la frequenza di allenamento specificando un schedulingExpression nella casella AutoTrainingConfig come 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 dalla creazione della soluzione. ACTIVE 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 l'ListSolutionVersionsAPIoperazione. 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 true e non è necessario impostarlo su. false

Tipo: Booleano

Campo obbligatorio: no

recipeArn

L'Amazon Resource Name (ARN) della ricetta da utilizzare per la formazione dei modelli. È necessario quando performAutoML è falso. Per informazioni sulle diverse ricette di Amazon Personalize e relativeARNs, 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 la autoMLConfig sezione della configurazione della soluzione.

Nota

Attualmente, Amazon Personalize non supporta la configurazione di hpoObjective.

Tipo: oggetto SolutionConfig

Campo obbligatorio: no

tags

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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

solutionArn

ARNLa 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.

HTTPCodice di stato: 400

LimitExceededException

Il limite del numero di richieste al secondo è stato superato.

HTTPCodice di stato: 400

ResourceAlreadyExistsException

La risorsa specificata esiste già.

HTTPCodice di stato: 400

ResourceInUseException

La risorsa specificata è in uso.

HTTPCodice di stato: 400

ResourceNotFoundException

Impossibile trovare la risorsa specificata.

HTTPCodice di stato: 400

TooManyTagsException

Hai superato il numero massimo di tag che puoi applicare a questa risorsa.

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, vedi quanto segue: