Registra i tuoi clienti

Questa pagina illustra i seguenti passaggi per registrare e annullare la registrazione delle parti al fine di creare risultati di previsione:

1. Assicurati di essere pronto a registrare le parti
2. Prepara le tabelle di registrazione dei partiti
3. Utilizza il metodo projects.locations.instances.importRegisteredParties per registrare o annullare la registrazione delle parti
4. Convalida la risposta del metodo
5. (Facoltativo) Esporta una tabella delle parti registrate

Prima di iniziare

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

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

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

Quando registrare le parti

Prima di poter creare previsioni per un partito in uno dei tuoi set di dati, devi registrare il partito. La registrazione non è obbligatoria per l'addestramento, la messa a punto o il backtesting.

I risultati di previsione vengono utilizzati per verificare la presenza di attività di riciclaggio di denaro da parte dei clienti in una fase di produzione o di test (parallela). Ti consigliamo inoltre di creare le tue procedure di governance e analisi dei modelli in base ai risultati ottenuti dalle previsioni.

La registrazione delle 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

Leggi la pagina dei prezzi per informazioni su come registrare le parti.

Prepara una tabella per la settore di attività per cui vuoi registrare le parti. Se hai già registrato alcuni partiti, questa tabella di registrazione dei partiti potrebbe contenere un sottoinsieme dei partiti della tabella Partito che vuoi utilizzare per i risultati di previsione.

Schema delle parti di vendita al dettaglio

Schema delle parti commerciali

Come registrare le parti

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

• I rivenditori e le parti commerciali devono essere registrati separatamente. Utilizza chiamate API e tabelle di registrazione dei partiti separate. Se un partito è presente in entrambi gli elenchi, vengono considerate registrazioni distinte.
• Le previsioni richiedono che tutte le parti siano registrate alla linea di business associata alla versione del motore utilizzata. Non puoi creare risultati di previsione se viene utilizzato un set di dati che contiene parti non registrate con la stessa attività commerciale.
• La tabella di registrazione dei partiti fornita viene utilizzata per aggiungere elementi all'elenco esistente di partiti registrati nell'istanza o per sostituire tutti i partiti registrati per la sfera di attività fornita nell'istanza.
• Una volta registrata, una festa non può essere annullata per un po' di tempo (consulta la pagina Prezzi). Per questo motivo, puoi impostare il campo validateOnly su TRUE. Questo campo ti consente di vedere l'effetto netto e la risposta del metodo senza modificare le parti registrate. Una volta convalidata, puoi eseguire nuovamente l'operazione e impostare il parametro validateOnly su FALSE.
• Controlla sempre la risposta di 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 attiva un errore (Invalid party_size present in table). Le parti registrate non vengono aggiornate.
• Per le registrazioni dei partiti di vendita al dettaglio, il campo party_size viene ignorato e tutti i partiti nella tabella di registrazione dei partiti fornita vengono registrati.

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

Le seguenti informazioni sono disponibili anche in Creare e gestire istanze.

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud elencato nelle Impostazioni IAM
• LOCATION: la posizione dell'istanza. Utilizza una delle regioni supportate.
  Mostra sedi
  • 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 contenente una tabella che descrive le parti registrate
• PARTY_REGISTRATION_TABLE: la tabella che elenca le parti registrate
• UPDATE_MODE: utilizza REPLACE per sostituire i partiti rimovibili nella tabella dei partiti registrati con nuovi partiti oppure utilizza APPEND per aggiungere nuovi partiti alla tabella dei partiti registrati
• 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 di credito al consumo

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 delle seguenti opzioni:

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

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"

@'
{
  "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

$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 LRO, la risposta indica il numero di parti aggiunte, rimosse o aggiornate dall'operazione.

Come annullare la registrazione delle parti

Le parti vengono registrate per istanza di IA AML 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 attualmente registrate (per la linea di business indicata) che non fanno parte della tabella di registrazione delle parti indicata.

Risposte alla disattivazione

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 del 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, non è possibile annullare la registrazione di un cliente fino a quando 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 Creare e gestire istanze.

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud elencato nelle Impostazioni IAM
• LOCATION: la posizione dell'istanza. Utilizza una delle regioni supportate.
  Mostra sedi
  • 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 banche commerciali (persone giuridiche e fisiche) o RETAIL per i clienti di banche di retail

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 delle seguenti opzioni:

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

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"

@'
{
  "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

$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 genera una tabella BigQuery con il seguente schema: