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

Dopo aver creato una soluzione, non è possibile modificarne la configurazione. Per impostazione predefinita, tutte le nuove soluzioni utilizzano la formazione automatica. Con la formazione automatica, si sostengono costi di formazione mentre la soluzione è attiva. Non è possibile interrompere la formazione automatica per trovare una soluzione. Per evitare costi inutili, assicurati di eliminare la soluzione quando hai finito. 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 un'ora dopo che la soluzione è ATTIVA. 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.

API correlate

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 hanno 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 ricetta e gli iperparametri USER_PERSONALIZATION 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 un'ora dopo che la soluzione è ATTIVA. 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 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. È richiesto quando performAutoML è falso. Per informazioni sulle diverse ricette di Amazon Personalize e sui relativi ARN, consulta Scelta di una ricetta.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Campo obbligatorio: no

solutionConfig

La configurazione da utilizzare con la 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'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 uno degli AWS SDK specifici della lingua, consulta quanto segue: