View a markdown version of this page

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, i costi di formazione vengono sostenuti 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 (creando una versione della soluzione). Questa configurazione include la ricetta da utilizzare per l'addestramento del modello 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 degli allenamenti. La creazione automatica della versione della soluzione inizia entro un'ora dall'attivazione della soluzione. Se si crea manualmente una versione della soluzione entro un'ora, la soluzione salta il primo training automatico. Per ulteriori informazioni, vedere Configurazione del training automatico.

Per disattivare l'allenamento automatico, imposta performAutoTraining su false. Se si disattiva l'addestramento automatico, è necessario creare manualmente una versione della soluzione richiamando l'CreateSolutionVersionoperazione.

Dopo l'inizio del training, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con l'operazione ListSolutionVersions API. Per conoscerne lo stato, usa il DescribeSolutionVersion.

Al termine dell'addestramento, è possibile valutare la precisione del modello GetSolutionMetrics chiamando. Quando sei soddisfatto della versione della soluzione, la distribuisci utilizzando. CreateCampaign La campagna fornisce consigli a un cliente tramite l'GetRecommendationsAPI.

Nota

Amazon Personalize non supporta la configurazione dell'ottimizzazione degli iperparametri hpoObjective per la soluzione in questo momento.

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, chiama DescribeSolution. Se si utilizza la formazione manuale, lo stato deve essere ATTIVO prima di chiamareCreateSolutionVersion.

API correlate

Sintassi della richiesta

{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performAutoTraining": boolean,
   "performHPO": boolean,
   "performIncrementalUpdate": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventsConfig": { 
         "eventParametersList": [ 
            { 
               "eventType": "string",
               "eventValueThreshold": number,
               "weight": number
            }
         ]
      },
      "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" ]
         },
         "includedDatasetColumns": { 
            "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:.*:.*:.+

Obbligatorio: sì

eventType

Quando sono presenti più tipi di eventi (utilizzando un campo EVENT_TYPE schema), questo parametro specifica quale tipo di evento (ad esempio, 'click' o 'like') viene utilizzato per addestrare il modello.

Se non ne fornisci unoeventType, Amazon Personalize utilizzerà tutte le interazioni per l'allenamento con lo stesso peso indipendentemente dal tipo.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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\-_]*

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, consulta 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

Obbligatorio: no

performAutoTraining

Se la soluzione utilizza l'addestramento automatico 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 formazione specificando schedulingExpression a AutoTrainingConfig come parte della configurazione della soluzione. Per ulteriori informazioni sull'addestramento automatico, vedere Configurazione dell'addestramento automatico.

La creazione automatica della versione della soluzione inizia entro un'ora dall'attivazione della soluzione. Se si crea manualmente una versione della soluzione entro un'ora, la soluzione salta il primo training automatico.

Dopo l'inizio del training, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione utilizzando l'ListSolutionVersionsAPI. Per conoscerne lo stato, usa il DescribeSolutionVersion.

Tipo: Booleano

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

Obbligatorio: no

performIncrementalUpdate

Se eseguire aggiornamenti incrementali di addestramento sul modello. Se abilitato, ciò consente al modello di apprendere dai nuovi dati con maggiore frequenza senza richiedere una riqualificazione completa, il che consente una personalizzazione quasi in tempo reale. Questo parametro è supportato solo per le soluzioni che utilizzano la ricetta della somiglianza semantica.

Tipo: Booleano

Obbligatorio: no

recipeArn

L'Amazon Resource Name (ARN) della ricetta da utilizzare per l'addestramento 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:.*:.*:.+

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

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.

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

Fornisci 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

È stato superato il numero massimo di tag che è possibile 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: