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](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) per disattivare la formazione automatica. Per informazioni sui costi di formazione, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/). 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](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html) 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](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). Per disattivare l'allenamento automatico, imposta su `performAutoTraining` false. Se si disattiva la formazione automatica, è necessario creare manualmente una versione della soluzione richiamando l'[CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)operazione. Dopo l'inizio della formazione, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con il funzionamento dell'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Per conoscerne lo stato, usa il [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Al termine della formazione, è possibile valutare la precisione del modello [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html)chiamando. Quando sei soddisfatto della versione della soluzione, la distribuisci utilizzando. [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) La campagna fornisce consigli a un cliente tramite l'[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API. **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\$1PROGRESS > ACTIVE -oppure- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Per conoscere lo stato della soluzione, chiamate [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Se si utilizza la formazione manuale, lo stato deve essere ATTIVO prima della chiamata`CreateSolutionVersion`. **Correlati APIs** + [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) + [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) + [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) + [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) + [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) + [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) + [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) ## 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](#API_CreateSolution_RequestSyntax) ** Il nome della risorsa Amazon (ARN) del gruppo di set di dati che fornisce i dati di addestramento. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obbligatorio: sì ** [eventType](#API_CreateSolution_RequestSyntax) ** Quando si utilizzano 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 uno`eventType`, Amazon Personalize utilizzerà tutte le interazioni per allenarti con lo stesso peso indipendentemente dal tipo. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Obbligatorio: no ** [name](#API_CreateSolution_RequestSyntax) ** Il nome della soluzione. Tipo: String 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](#API_CreateSolution_RequestSyntax) ** 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](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html). Se eseguire l'apprendimento automatico (AutoML). Il valore predefinito è `false`. In questo caso, è necessario specificare`recipeArn`. Se impostato su`true`, Amazon Personalize analizza i dati di allenamento e seleziona la ricetta e gli iperparametri USER\$1PERSONALIZATION 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](#API_CreateSolution_RequestSyntax) ** 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](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). 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'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Per conoscerne lo stato, usa il [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Tipo: Booleano Obbligatorio: no ** [performHPO](#API_CreateSolution_RequestSyntax) ** 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](#API_CreateSolution_RequestSyntax) ** Se eseguire aggiornamenti incrementali della formazione sul modello. Se abilitato, ciò consente al modello di apprendere più frequentemente dai nuovi dati 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](#API_CreateSolution_RequestSyntax) ** 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](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html) ricetta. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obbligatorio: no ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** Le proprietà di configurazione della soluzione. Quando `performAutoML` è impostato su true, Amazon Personalize valuta solo la `autoMLConfig` sezione della configurazione della soluzione. Attualmente, Amazon Personalize non supporta la configurazione di `hpoObjective`. Tipo: oggetto [SolutionConfig](API_SolutionConfig.md) Obbligatorio: no ** [tags](#API_CreateSolution_RequestSyntax) ** Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare alla soluzione. Tipo: matrice di oggetti [Tag](API_Tag.md) 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](#API_CreateSolution_ResponseSyntax) ** L'ARN della soluzione. Tipo: String 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: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolution) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution)