Registrare i partiti

Questa pagina ti guida attraverso i seguenti passaggi per registrare e annullare la registrazione dei partiti al fine di creare i risultati della previsione:

Assicurati di essere pronto a registrare le parti
Prepara le tabelle di registrazione del partito
Utilizza il metodo projects.locations.instances.importRegisteredParties per registrare o annullare la registrazione delle parti
Convalidare la risposta del metodo
(Facoltativo) Esportare una tabella delle parti registrate

Prima di iniziare

Prima di iniziare, devi disporre di un'istanza AML AI.

Per consentire a un modello di creare previsioni del punteggio di rischio, devi prima registrare le parti. Ti consigliamo di registrare le parti quando disponi già di quanto segue:

Uno o più set di dati
Un modello ottimizzato, addestrato e sottoposto a backtest

Quando registrare i partiti

Prima di poter creare previsioni per una festa in uno dei tuoi set di dati, devi registrare la festa. La registrazione non è necessaria per l'addestramento, la messa a punto o il backtest.

I risultati della previsione vengono utilizzati per indagare sui clienti per riciclaggio di denaro in una fase di produzione o di test (parallela). Potresti anche voler creare processi di governance e analisi dei modelli personalizzati in base ai risultati ottenuti dalle previsioni.

La registrazione di parti comporta costi mensili aggiuntivi per ogni parte registrata (per ulteriori informazioni, consulta la pagina relativa ai prezzi).

Come preparare le tabelle di registrazione dei partiti

Consulta la pagina dei prezzi per informazioni sulle parti registrate.

Prepara una tabella per la linea di business per cui vuoi registrare le parti. Se hai già registrato alcune parti, questa tabella di registrazione delle parti potrebbe contenere un sottoinsieme delle parti della tabella Parte che vuoi utilizzare per i risultati della previsione.

Schema delle parti retail

Colonna	Tipo	Descrizione
`party_id`	`STRING`	Identificatore univoco della parte nei set di dati dell'istanza
`party_size`	`STRING`	NULL; i contenuti vengono ignorati per le registrazioni di parti al dettaglio

Schema delle parti commerciali

Colonna Tipo Descrizione

party_id STRING Identificatore univoco della parte nei set di dati dell'istanza

party_size

STRING

Dimensioni del gruppo richieste. Il livello si basa sul numero medio di transazioni mensili per la parte nei 365 giorni precedenti:

SMALL per piccole attività commerciali con meno di 500 transazioni mensili medie
LARGE per grandi parti commerciali con una media di transazioni mensili pari o superiore a 500

Tutti i valori sono sensibili alle maiuscole.

Come registrare i partiti

Le parti vengono registrate separatamente per ogni istanza di AML AI. Nota quanto segue:

Le parti commerciali e di vendita al dettaglio devono essere registrate separatamente. Utilizza chiamate API separate e tabelle di registrazione delle parti separate. Se un partito è presente in entrambe le liste, viene considerato come due registrazioni separate.
Le previsioni richiedono che tutte le parti siano registrate nella linea di business associata alla versione del motore utilizzata. Non puoi creare risultati di previsione se viene utilizzato un set di dati che contiene una parte non registrata con la stessa linea di business.
La tabella di registrazione delle parti fornita viene utilizzata per aggiungere all'elenco esistente di parti registrate nell'istanza o per sostituire tutte le parti registrate per la linea di business fornita nell'istanza.
Una volta registrata, una parte non può essere deregistrata per un certo periodo di tempo (vedi la pagina dei prezzi). Per questo motivo, puoi impostare il campo validateOnly su TRUE. Questo campo ti consente di visualizzare l'effetto netto e la risposta del metodo senza modificare le parti registrate. Una volta convalidata, puoi eseguire di nuovo l'operazione e impostare il parametro validateOnly su FALSE.
Controlla sempre la risposta a una richiesta di registrazione per assicurarti che tutte le parti siano state registrate correttamente, anche se una richiesta validateOnly precedente è andata a buon fine.
Per le registrazioni di parti commerciali, un valore diverso da SMALL o LARGE nel campo party_size della tabella di registrazione delle parti genera un errore (Invalid party_size present in table). Le parti registrate non vengono aggiornate.
Per le registrazioni di parti al dettaglio, il campo party_size viene ignorato e tutte le parti nella tabella di registrazione delle parti fornita vengono registrate.

Per importare le parti registrate, utilizza il metodo projects.locations.instances.importRegisteredParties.

Le seguenti informazioni sono disponibili anche in Crea e gestisci istanze.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

Autorizzazioni

financialservices.v1instances.importRegisteredParties

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM
LOCATION: la posizione dell'istanza; utilizza una delle regioni supportate
Mostra località
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: l'identificatore definito dall'utente per l'istanza
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: un set di dati BigQuery che contiene una tabella che descrive le parti registrate
PARTY_REGISTRATION_TABLE: la tabella che elenca le parti registrate
Nota: puoi fornire più tabelle che elencano le parti registrate. Utilizza il formato "bq://{project}.{bqDatasetID}.{bqTableID}" per ogni tabella nell'array partyTables.
UPDATE_MODE: utilizza REPLACE per sostituire le parti rimovibili nella tabella delle parti registrate con nuove parti oppure utilizza APPEND per aggiungere nuove parti alla tabella delle parti registrate.
LINE_OF_BUSINESS: questo campo deve corrispondere al valore lineOfBusiness nella versione del motore utilizzata dalla configurazione del motore; utilizza COMMERCIAL per i clienti di banche commerciali (persone giuridiche e fisiche) o RETAIL per i clienti di banche al dettaglio

Corpo JSON della richiesta:

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

cat > request.json << 'EOF'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

Quindi esegui questo comando per inviare la richiesta REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

@'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi esegui questo comando per inviare la richiesta REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties" | Select-Object -Expand Content

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": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Per informazioni su come ottenere il risultato dell'operazione a lunga esecuzione (LRO), consulta Gestire le operazioni a lunga esecuzione.

Risposta alla registrazione

Al termine dell'operazione a lunga esecuzione, la risposta indica il numero di parti che sono state aggiunte, rimosse o aggiornate dall'operazione.

Campo di risposta	Tipo	Descrizione
`partiesAdded`	`integer`	Numero di parti aggiunte da questa operazione
`partiesRemoved`	`integer`	Numero di parti rimosse da questa operazione
`partiesTotal`	`integer`	Numero totale di parti registrate in questa istanza, dopo il completamento dell'operazione di aggiornamento
`partiesUptiered`	`integer`	Numero totale di parti commerciali che vengono promosse da piccole a grandi
`partiesDowntiered`	`integer`	Numero totale di parti commerciali che vengono declassate da grandi a piccole
`partiesFailedToDowntier`	`integer`	Numero totale di parti commerciali per cui non è stato possibile eseguire il downgrade da grande a piccola
`partiesFailedToRemove`	`integer`	Numero di parti che non sono state rimosse da questa operazione

Come annullare la registrazione delle parti

Le parti vengono annullate per istanza AML AI utilizzando lo stesso metodo projects.locations.instances.importRegisteredParties e sostituendo l'elenco esistente di parti. Imposta il campo mode su REPLACE. Questa impostazione annulla la registrazione di tutte le parti registrate (per il ramo di attività fornito) che non fanno parte della tabella di registrazione delle parti fornita.

Risposte alla cancellazione della registrazione

Al termine dell'operazione, controlla la risposta dell'API per verificare se l'operazione ha prodotto il risultato previsto in termini di numero di parti aggiunte o rimosse e il numero totale di parti registrate.

La risposta dell'API restituisce anche il numero di parti che non è stato possibile rimuovere a causa di vincoli; ad esempio, un cliente non può essere deregistrato finché non è trascorso un numero minimo di giorni.

Esportare le parti registrate

Per esportare le parti registrate, utilizza il metodo projects.locations.instances.exportRegisteredParties.

Le seguenti informazioni sono disponibili anche in Crea e gestisci istanze.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

Autorizzazioni

financialservices.v1instances.exportRegisteredParties

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM
LOCATION: la posizione dell'istanza; utilizza una delle regioni supportate
Mostra località
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: l'identificatore definito dall'utente per l'istanza
BQ_OUTPUT_DATASET_NAME: un set di dati BigQuery in cui esportare una tabella che descrive le parti registrate
PARTY_REGISTRATION_TABLE: la tabella in cui scrivere le parti registrate
WRITE_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.
LINE_OF_BUSINESS: utilizza COMMERCIAL per i clienti di commercial banking (persone giuridiche e fisiche) o RETAIL per i clienti di retail banking

Corpo JSON della richiesta:

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

cat > request.json << 'EOF'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

Quindi esegui questo comando per inviare la richiesta REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties"

PowerShell

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

@'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi esegui questo comando per inviare la richiesta REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties" | Select-Object -Expand Content

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": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Per informazioni su come ottenere il risultato dell'operazione a lunga esecuzione (LRO), consulta Gestire le operazioni a lunga esecuzione.

Questo metodo restituisce una tabella BigQuery con lo schema seguente:

Colonna	Tipo	Descrizione
`party_id`	`STRING`	Identificatore univoco della parte nei set di dati dell'istanza
`party_size`	`STRING`	Specifica il livello per i clienti commerciali (grandi o piccoli). Questo campo non si applica ai clienti al dettaglio. `NULL` per tutti i clienti al dettaglio `SMALL` per piccole attività commerciali con meno di 500 transazioni mensili medie `LARGE` per grandi parti commerciali con una media di transazioni mensili pari o superiore a 500 Tutti i valori sono sensibili alle maiuscole.
`earliest_remove_time`	`STRING`	L'ora più vicina in cui la parte può essere rimossa
`party_with_prediction_intent`	`STRING`	L'indicatore che suggerisce se un partito è stato previsto dalla registrazione
`registration_or_uptier_time`	`STRING`	L'ora in cui la parte è stata registrata o è stato eseguito l'upgrade

Registrare i partiti Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Quando registrare i partiti

Come preparare le tabelle di registrazione dei partiti

Schema delle parti retail

Schema delle parti commerciali

Come registrare i partiti

Autorizzazioni richieste per questa attività

curl

PowerShell

Risposta alla registrazione

Come annullare la registrazione delle parti

Risposte alla cancellazione della registrazione

Esportare le parti registrate

Autorizzazioni richieste per questa attività

curl

PowerShell

Registrare i partiti