Questa pagina mostra come creare e gestire i risultati delle previsioni di AML AI. I risultati della previsione vengono salvati nelle tabelle BigQuery.
A questo punto, devi solo creare i risultati della previsione. Gli altri metodi per i risultati di previsione sono forniti per comodità.
Prima di iniziare
-
Per ottenere le autorizzazioni necessarie per creare e gestire i risultati delle previsioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore di Financial Services (
financialservices.admin
) sul tuo progetto. Per saperne di più sulla concessione dei ruoli, vedi Gestire l'accesso.Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.
- Crea un'istanza
- Creare un modello
- Crea un set di dati
Crea risultati della previsione
Alcuni metodi API restituiscono un'operazione a lunga esecuzione (LRO). Questi metodi sono asincroni. L'operazione potrebbe non essere completata quando il metodo restituisce una risposta. Per questi metodi, invia la richiesta e poi controlla il risultato.
Invia la richiesta
Per creare i risultati della previsione, utilizza il metodo projects.locations.instances.predictionResults.create
.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
INSTANCE_ID
: un identificatore definito dall'utente per l'istanzaPREDICTION_RESULTS_ID
: un identificatore definito dall'utente per i risultati della previsione.MODEL_ID
: un identificatore del modello definito dall'utente.DATASET_ID
: l'identificatore definito dall'utente per il set di dati utilizzato per le previsioni; le tabelle non devono avere le colonne delle etichette di addestramentoPREDICTION_END_DATE
: l'ora più recente a partire dalla quale i dati vengono utilizzati per generare funzionalità per le previsioni. Questa data deve essere uguale o precedente all'ora di fine dei set di dati. Utilizza il formato "Zulu" UTC RFC3339 (ad esempio2014-10-02T15:01:23Z
).PREDICTION_PERIODS
: il numero di mesi consecutivi per i quali generare previsioni, che termina con l'ultimo mese completo precedente la data di fine della previsione in base al fuso orario del set di dati.BQ_OUTPUT_DATASET_NAME
: il nome del set di dati BigQuery di output utilizzato per la previsioneBQ_OUTPUT_PREDICTION_TABLE
: l'identificatore definito dall'utente per la tabella BigQuery di output utilizzato per le previsioniBQ_OUTPUT_PREDICTION_EXPLAINABILITY_TABLE
: l'identificatore definito dall'utente per la tabella BigQuery della spiegabilità di output utilizzata per la previsione; rimuovi l'oggettoexplainabilityDestination
facoltativo dal JSON della richiesta se non vuoi esportare in una tabella BigQueryWRITE_DISPOSITION
: l'azione che si verifica se la tabella di destinazione esiste già; utilizza uno dei seguenti valori:-
WRITE_EMPTY
: esporta i dati solo se la tabella BigQuery è vuota. -
WRITE_TRUNCATE
: cancella tutti i dati esistenti nella tabella BigQuery prima di scrivere nella tabella.
-
Corpo JSON della richiesta:
{ "model": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/models/MODEL_ID", "dataset": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/datasets/DATASET_ID", "endTime": "PREDICTION_END_DATE", "predictionPeriods": "PREDICTION_PERIODS", "outputs": { "predictionDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.BQ_OUTPUT_PREDICTION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "explainabilityDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.BQ_OUTPUT_PREDICTION_EXPLAINABILITY_TABLE", "writeDisposition": "WRITE_DISPOSITION" } } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Verifica il risultato
Utilizza il metodo projects.locations.operations.get
per verificare se i risultati della previsione sono stati creati. Se la risposta contiene "done": false
, ripeti il comando finché la risposta non contiene "done": true
.
Il completamento di queste operazioni può richiedere da pochi minuti a diverse ore.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
OPERATION_ID
: l'identificatore dell'operazione
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": true, "response": { "@type": "type.googleapis.com/dataresidency.monitoring.DataResidencyAugmentedView", "tpIds": [ "i608e8cf4abb2a7d9-tp" ] } }
Ottieni i risultati delle previsioni
Per ottenere i risultati della previsione, utilizza il metodo projects.locations.instances.predictionResults.get
.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
INSTANCE_ID
: l'identificatore definito dall'utente per l'istanzaPREDICTION_RESULTS_ID
: l'identificatore definito dall'utente per i risultati della previsione
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "state": "ACTIVE", "model": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/models/MODEL_ID", "dataset": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/datasets/DATASET_ID", "endTime": "PREDICTION_END_DATE", "predictionPeriods": PREDICTION_PERIODS, "outputs": { "predictionDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.BQ_OUTPUT_PREDICTION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "explainabilityDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.BQ_OUTPUT_PREDICTION_EXPLAINABILITY_TABLE", "writeDisposition": "WRITE_DISPOSITION" } }, "lineOfBusiness": "RETAIL" }
Aggiorna i risultati delle previsioni
Per aggiornare i risultati della previsione, utilizza il metodo projects.locations.instances.predictionResults.patch
.
Non tutti i campi nei risultati della previsione possono essere aggiornati. L'esempio seguente aggiorna la coppia chiave-valore etichette utente associate ai risultati della previsione.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
INSTANCE_ID
: l'identificatore definito dall'utente per l'istanzaPREDICTION_RESULTS_ID
: l'identificatore definito dall'utente per i risultati della previsioneKEY
: la chiave in una coppia chiave-valore utilizzata per organizzare i risultati della previsione. Per ulteriori informazioni, visitalabels
.VALUE
: il valore in una coppia chiave-valore utilizzato per organizzare i risultati della previsione. Per ulteriori informazioni, visitalabels
.
Corpo JSON della richiesta:
{ "labels": { "KEY": "VALUE" } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Per saperne di più su come ottenere il risultato dell'operazione a lunga esecuzione (LRO), consulta Verificare il risultato.
Elenca i risultati della previsione
Per elencare i risultati della previsione per una determinata istanza, utilizza il metodo projects.locations.instances.predictionResults.list
.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
INSTANCE_ID
: l'identificatore definito dall'utente per l'istanza
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "predictionResults": [ { "name": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "state": "ACTIVE", "model": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/models/MODEL_ID", "dataset": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/datasets/DATASET_ID", "endTime": "PREDICTION_END_DATE", "predictionPeriods": PREDICTION_PERIODS, "outputs": { "predictionDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.BQ_OUTPUT_PREDICTION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "explainabilityDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.BQ_OUTPUT_PREDICTION_EXPLAINABILITY_TABLE", "writeDisposition": "WRITE_DISPOSITION" } }, "lineOfBusiness": "RETAIL" } ] }
Esporta metadati
Per esportare i metadati dai risultati della previsione, utilizza il metodo projects.locations.instances.predictionResults.exportMetadata
.
Per ulteriori informazioni, consulta la sezione Metadati esportati nel modello dei dati di output AML.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
INSTANCE_ID
: l'identificatore definito dall'utente per l'istanzaPREDICTION_RESULTS_ID
: l'identificatore definito dall'utente per i risultati della previsioneBQ_OUTPUT_DATASET_NAME
: un set di dati BigQuery in cui esportare una tabella che descrive i metadati strutturati dei risultati della previsioneSTRUCTURED_METADATA_TABLE
: la tabella in cui scrivere i metadati strutturatiWRITE_DISPOSITION
: l'azione che si verifica se la tabella di destinazione esiste già; utilizza uno dei seguenti valori:-
WRITE_EMPTY
: esporta i dati solo se la tabella BigQuery è vuota. -
WRITE_TRUNCATE
: cancella tutti i dati esistenti nella tabella BigQuery prima di scrivere nella tabella.
-
Corpo JSON della richiesta:
{ "structuredMetadataDestination": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.STRUCTURED_METADATA_TABLE", "writeDisposition": "WRITE_DISPOSITION" } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "verb": "exportMetadata", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Per saperne di più su come ottenere il risultato dell'operazione a lunga esecuzione (LRO), consulta Verificare il risultato.
Elimina risultati della previsione
Per eliminare i risultati della previsione, utilizza il metodo projects.locations.instances.predictionResults.delete
.
Prima di utilizzare qualsiasi dato della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato nelle impostazioni IAMLOCATION
: la località dell'istanza; utilizza una delle regioni supportate:us-central1
us-east1
europe-west1
europe-west2
europe-west4
southamerica-east1
INSTANCE_ID
: l'identificatore definito dall'utente per l'istanzaPREDICTION_RESULTS_ID
: l'identificatore definito dall'utente per i risultati della previsione
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/predictionResults/PREDICTION_RESULTS_ID", "verb": "delete", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Per saperne di più su come ottenere il risultato dell'operazione a lunga esecuzione (LRO), consulta Verificare il risultato.