In questa pagina viene descritto come ottenere previsioni online (singole e a bassa latenza) da tabelle AutoML.
Introduzione
Dopo aver creato (addestrato) un modello, puoi eseguirne il deployment e richiedere previsioni online (in tempo reale). Le previsioni online accettano una riga di dati e forniscono un risultato previsto basato sul modello per tali dati. Utilizzi le previsioni online quando hai bisogno di una previsione come input per il flusso della logica di business.
Per poter richiedere una previsione online, devi eseguire il deployment del modello. I modelli di cui è stato eseguito il deployment sono addebitati. Quando hai finito di fare previsioni online, puoi annullare il deployment del modello per evitare ulteriori addebiti. Scopri di più.
I modelli devono essere riaddestrati periodicamente in modo che possano continuare a fornire previsioni. Per le previsioni senza importanza della caratteristica, un modello deve essere riaddestrato ogni due anni. Per le previsioni con importanza della caratteristica, un modello deve essere addestrato ogni sei mesi.
Richiedere una previsione online
Console
In genere, utilizzi le previsioni online per ottenere previsioni dalle tue applicazioni aziendali. Tuttavia, puoi utilizzare AutoML Tables in Cloud Console per testare il tuo formato dati o il tuo modello con un set di input specifico.
Visita la pagina AutoML Tables in Google Cloud Console.
Seleziona Modelli e scegli il modello che vuoi utilizzare.
Seleziona la scheda Test & Use (Prova e utilizzo) e fai clic su Online previsione (Previsione online).
Se non è ancora stato eseguito il deployment del modello, eseguine il deployment facendo clic su Esegui il deployment del modello.
Per utilizzare le previsioni online, devi eseguire il deployment del modello. Il deployment del modello comporta costi. Per ulteriori informazioni, consulta la pagina sui prezzi.
Specifica i valori di input nelle caselle di testo fornite.
In alternativa, puoi selezionare Vista codice JSON per fornire i valori di input in formato JSON.
Se vuoi vedere in che modo ogni funzionalità ha influito sulla previsione, seleziona Genera importanza delle caratteristiche.
Google Cloud Console tronca i valori di importanza delle funzionalità locali per favorire la leggibilità. Se hai bisogno di un valore esatto, utilizza l'API Cloud AutoML per effettuare la richiesta di previsione.
Per informazioni sull'importanza delle funzionalità, consulta importanza delle funzionalità locali.
Fai clic su Previsione per ottenere la previsione.
Per informazioni sull'interpretazione dei risultati della previsione, consulta la sezione Interpretare i risultati delle previsioni. Per informazioni sull'importanza delle funzionalità locali, consulta la sezione Importanza delle funzionalità locali.
(Facoltativo) Se non prevedi di richiedere ulteriori previsioni online, puoi annullare il deployment del modello facendo clic su Annulla deployment modello.
Curling
Per richiedere una previsione per un insieme di valori, crea un oggetto JSON con i valori delle tue funzionalità e poi utilizza il metodo model.predict
per ottenere la previsione.
I valori devono contenere le colonne esatte incluse nell'addestramento e devono seguire lo stesso ordine indicato nella scheda Valutazione facendo clic sul link delle colonne incluse.
Se vuoi riordinare i valori, puoi includere una serie di ID delle colonne nell'ordine in cui sono specificati. Puoi ottenere gli ID delle specifiche della colonna dall'oggetto del modello, che si trovano nel campo TablesModelMetadata.inputFeatureColumnSpecs.
Il tipo di dati di ogni valore (feature) nell'oggetto Row dipende dal tipo di dati Tabs di AutoML per la funzionalità. Per un elenco dei tipi di dati accettati per tipo di dati AutoML Tables, consulta Formato oggetto riga.
Se non hai ancora eseguito il deployment del modello, eseguilo ora. Scopri di più.
Richiedi la previsione.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
-
endpoint:
automl.googleapis.com
per la località globale eeu-automl.googleapis.com
per l'area geografica dell'UE. - project-id: il tuo ID progetto Google Cloud.
- location: la località della risorsa:
us-central1
per il mondo globale oeu
per l'Unione europea. - model-id: l'ID del modello. Ad esempio,
TBL543
. - valueN: i valori per ciascuna colonna, nell'ordine corretto.
Metodo HTTP e URL:
POST https://endpoint/v1beta1/projects/project-id/locations/location/models/model-id:predict
Corpo JSON richiesta:
{ "payload": { "row": { "values": [ value1, value2,... ] } } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Salva il corpo della richiesta in un file denominato
request.json
ed esegui il seguente comando:curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://endpoint/v1beta1/projects/project-id/locations/location/models/model-id:predict"PowerShell
Salva il corpo della richiesta in un file denominato
request.json
ed esegui il seguente comando:$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://endpoint/v1beta1/projects/project-id/locations/location/models/model-id:predict" | Select-Object -Expand Contentfeature_importance
. Per saperne di più sull'importanza delle funzionalità locali, consulta Importanza della funzionalità locale.-
endpoint:
Visualizzare i risultati.
Per un modello di classificazione, dovresti vedere un output simile all'esempio riportato di seguito. Tieni presente che vengono restituiti due risultati, ognuno con una stima dell'affidabilità (
score
). La stima dell'affidabilità è compresa tra 0 e 1 e mostra la probabilità che il modello rappresenti il valore corretto della previsione. Per scoprire di più su come utilizzare la stima di affidabilità, consulta Interpretare i risultati delle previsioni.{ "payload": [ { "tables": { "score": 0.11210235, "value": "1" } }, { "tables": { "score": 0.8878976, "value": "2" } } ] }
Per un modello di regressione, i risultati includono un valore di previsione e un intervallo di previsione. L'intervallo di previsione fornisce un intervallo che include il vero valore del 95% delle volte (in base ai dati su cui è stato addestrato il modello). Tieni presente che il valore previsto potrebbe non essere centrato nell'intervallo (potrebbe persino non rientrare nell'intervallo), perché l'intervallo di previsione è centrato intorno alla mediana, mentre il valore previsto è il valore previsto (o medio).
{ "payload": [ { "tables": { "value": 207.18209838867188, "predictionInterval": { "start": 29.712770462036133, "end": 937.42041015625 } } } ] }
Per informazioni sull'importanza delle funzionalità locali, consulta Importanza dell'importanza delle funzionalità locali.
(Facoltativo) Se hai completato la richiesta di previsioni online, puoi annullare il deployment del modello per evitare addebiti. Scopri di più.
Java
Se le risorse si trovano nell'area geografica UE, devi impostare esplicitamente l'endpoint. Scopri di più.
Node.js
Se le risorse si trovano nell'area geografica UE, devi impostare esplicitamente l'endpoint. Scopri di più.
Python
La libreria client per AutoML Tables include metodi Python aggiuntivi che semplificano l'utilizzo dell'API AutoML Tables. Questi metodi si riferiscono a set di dati e modelli in base al nome anziché all'ID. I nomi del set di dati e del modello devono essere univoci. Per ulteriori informazioni, consulta la sezione Riferimento client.
Se le risorse si trovano nell'area geografica UE, devi impostare esplicitamente l'endpoint. Scopri di più.
Passaggi successivi
- Scopri come interpretare i risultati delle previsioni.
- Scopri l'importanza delle funzionalità locali.