Kunden registrieren

Auf dieser Seite werden Sie durch die folgenden Schritte zum Registrieren und Deregistrieren von Parteien geführt, um Vorhersageergebnisse zu erstellen:

1. Sie sind bereit, Parteien zu registrieren
2. Tabellen für die Parteiregistrierung vorbereiten
3. Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um Teilnehmer zu registrieren oder abzumelden.
4. Methode – Antwort validieren
5. Optional: Tabelle mit registrierten Parteien exportieren

Hinweise

Bevor Sie beginnen, benötigen Sie eine AML AI-Instanz.

Damit ein Modell Risikobewertungen erstellen kann, müssen Sie zuerst Parteien registrieren. Wir empfehlen, Parteien zu registrieren, wenn Sie bereits Folgendes haben:

• Ein oder mehrere Datasets
• Ein abgestimmtes, trainiertes und zurückgeprüftes Modell

Wann müssen Parteien registriert werden?

Bevor Sie in einem Ihrer Datasets Vorhersagen für eine Partei erstellen können, müssen Sie die Partei registrieren. Für die Schulung, Optimierung oder das Backtesting ist keine Registrierung erforderlich.

Die Vorhersageergebnisse werden bei der Prüfung von Kunden auf Geldwäsche entweder in der Produktions- oder in der Testphase (parallel) verwendet. Sie können auch eigene Governance- und Modellanalyseprozesse anhand der Ergebnisse erstellen, die Sie aus den Vorhersagen erhalten.

Die Registrierung von Parteien verursacht zusätzliche monatliche Kosten pro registrierter Partei. Weitere Informationen finden Sie auf der Preisseite.

Tabellen für die Registrierung von Parteien vorbereiten

Informationen zur Registrierung von Gruppen finden Sie auf der Preisseite.

Erstellen Sie eine Tabelle für die Branche, für die Sie Teilnehmer registrieren möchten. Wenn Sie bereits einige Parteien registriert haben, kann diese Tabelle zur Registrierung von Parteien eine Teilmenge der Parteien aus der Tabelle Party enthalten, die Sie für Prognoseergebnisse verwenden möchten.

Schema für Einzelhandelspartner

Schema für kommerzielle Parteien

Parteien registrieren

Parteien werden für jede AML-KI-Instanz separat registriert. Wichtige Hinweise:

• Einzelhändler und kommerzielle Parteien müssen separat registriert werden. Verwenden Sie separate API-Aufrufe und separate Tabellen für die Registrierung von Parteien. Wenn eine Partei in beiden Listen aufgeführt ist, wird sie als separate Registrierung betrachtet.
• Für Vorhersagen müssen alle Parteien in der Branche registriert sein, die mit der verwendeten Engine-Version verknüpft ist. Sie können keine Prognoseergebnisse erstellen, wenn ein Datensatz verwendet wird, der Rechtssubjekte enthält, die nicht in derselben Branche registriert sind.
• Die bereitgestellte Tabelle mit der Registrierung von Parteien wird verwendet, um entweder die vorhandene Liste der registrierten Parteien in der Instanz anzuhängen oder alle registrierten Parteien für die angegebene Branche in der Instanz zu ersetzen.
• Nach der Registrierung kann eine Partei für einige Zeit nicht wieder abgemeldet werden (siehe Preisseite). Aus diesem Grund können Sie das Feld validateOnly auf TRUE setzen. In diesem Feld sehen Sie den Nettoeffekt und die Reaktion der Methode, ohne die registrierten Teilnehmer zu ändern. Nach der Validierung können Sie den Vorgang noch einmal ausführen und den Parameter validateOnly auf FALSE setzen.
• Prüfe immer die Antwort einer Registrierungsanfrage, um sicherzustellen, dass alle Parteien erfolgreich registriert wurden, auch wenn eine vorherige validateOnly-Anfrage erfolgreich war.
• Bei kommerziellen Parteiregistrierungen löst ein Wert in Feld party_size in der Tabelle „Parteiregistrierung“ mit Ausnahme von SMALL oder LARGE einen Fehler (Invalid party_size present in table) aus. Registrierte Parteien werden nicht aktualisiert.
• Bei Registrierungen von Einzelhandelsparteien wird das Feld party_size ignoriert und alle Parteien in der bereitgestellten Tabelle für die Parteiregistrierung werden registriert.

Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um registrierte Parteien zu importieren.

Die folgenden Informationen finden Sie auch unter Instanzen erstellen und verwalten.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
• LOCATION: Der Standort der Instanz. Verwenden Sie eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
  • australia-southeast1
• INSTANCE_ID: die benutzerdefinierte Kennung für die Instanz
• BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: ein BigQuery-Dataset mit einer Tabelle, die die registrierten Parteien beschreibt
• PARTY_REGISTRATION_TABLE: Tabelle mit den registrierten Parteien
• UPDATE_MODE: Mit REPLACE können Sie Parteien, die in der Tabelle „Registered parties“ (Registrierte Parteien) entfernt werden können, durch neue Parteien ersetzen. Mit APPEND können Sie der Tabelle „Registered parties“ neue Parteien hinzufügen.
• LINE_OF_BUSINESS: Dieses Feld muss mit dem lineOfBusiness-Wert in der Engine-Version übereinstimmen, die von der Engine-Konfiguration verwendet wird. Verwenden Sie COMMERCIAL für Kunden des kommerziellen Bankgewerbes (Rechtssubjekte und natürliche Personen) oder RETAIL für Kunden des Privatkundengeschäfts.

JSON-Text der Anfrage:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Informationen zum Abrufen des Ergebnisses des lang andauernden Vorgangs finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Antwort auf die Registrierung

Wenn der LRO abgeschlossen ist, gibt die Antwort die Anzahl der Parteien an, die durch den Vorgang hinzugefügt, entfernt oder aktualisiert wurden.

Parteien abmelden

Parteien werden pro AML-KI-Instanz mit derselben projects.locations.instances.importRegisteredParties-Methode abgemeldet und die vorhandene Liste der Parteien wird ersetzt. Setzen Sie das Feld mode auf REPLACE. Mit dieser Einstellung werden alle derzeit registrierten Parteien (für die angegebene Branche) abgemeldet, die nicht Teil der angegebenen Tabelle für die Registrierung von Parteien sind.

Antworten auf die Abmeldung

Prüfen Sie nach Abschluss des Vorgangs in der API-Antwort, ob der Vorgang zum gewünschten Ergebnis geführt hat, was die Anzahl der hinzugefügten oder entfernten Parteien und die Gesamtzahl der registrierten Parteien angeht.

Die API-Antwort gibt auch die Anzahl der Parteien zurück, die aufgrund von Einschränkungen nicht entfernt werden konnten. Beispielsweise kann ein Kunde erst nach Ablauf einer bestimmten Mindestanzahl von Tagen abgemeldet werden.

Registrierte Parteien exportieren

Verwenden Sie zum Exportieren registrierter Parteien die Methode projects.locations.instances.exportRegisteredParties.

Die folgenden Informationen finden Sie auch unter Instanzen erstellen und verwalten.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
• LOCATION: Der Standort der Instanz. Verwenden Sie eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
  • australia-southeast1
• INSTANCE_ID: die benutzerdefinierte Kennung für die Instanz
• BQ_OUTPUT_DATASET_NAME: ein BigQuery-Dataset, in das eine Tabelle mit den registrierten Parteien exportiert werden soll
• PARTY_REGISTRATION_TABLE: die Tabelle, in die die registrierten Parteien geschrieben werden sollen
• WRITE_DISPOSITION: Die Aktion, die ausgeführt wird, wenn die Zieltabelle bereits vorhanden ist. Verwenden Sie einen der folgenden Werte:
  • WRITE_EMPTY: Nur Daten exportieren, wenn die Zieltabelle leer ist.
  • WRITE_TRUNCATE: Alle vorhandenen Daten in der BigQuery-Tabelle werden gelöscht, bevor Daten in die Tabelle geschrieben werden.
• LINE_OF_BUSINESS: Verwenden Sie COMMERCIAL für Kunden des Firmenkundengeschäfts (Rechtssubjekte und natürliche Personen) oder RETAIL für Privatkunden.

JSON-Text der Anfrage:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Informationen zum Abrufen des Ergebnisses des lang andauernden Vorgangs finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Mit dieser Methode wird eine BigQuery-Tabelle mit dem folgenden Schema ausgegeben: