Parteien registrieren

Auf dieser Seite werden Sie durch die folgenden Schritte geführt, um Parteien zu registrieren und die Registrierung aufzuheben, damit Vorhersageergebnisse erstellt werden können:

Vorbereitung auf die Registrierung von Parteien
Tabellen für die Parteiregistrierung vorbereiten
Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um Parteien zu registrieren oder die Registrierung aufzuheben.
Methodenantwort validieren
Optional: Tabelle der registrierten Parteien exportieren

Hinweise

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

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

Mindestens ein Dataset
Ein abgestimmtes, trainiertes und backgetestetes Modell

Wann müssen Parteien registriert werden?

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

Vorhersageergebnisse werden in der Produktions- oder Testphase (parallel) verwendet, um Kunden auf Geldwäsche zu untersuchen. Möglicherweise möchten Sie auch eigene Prozesse für Governance und Modellanalyse auf Grundlage der Ergebnisse erstellen, die Sie aus Vorhersagen erhalten.

Für die Registrierung von Parteien fallen zusätzliche monatliche Kosten pro registrierter Partei an. Weitere Informationen finden Sie auf der Preisseite.

Tabellen für die Registrierung von politischen Parteien vorbereiten

Informationen zur Registrierung von Parteien finden Sie auf der Preisseite.

Erstellen Sie eine Tabelle für den Geschäftsbereich, für den Sie Parteien registrieren möchten. Wenn Sie bereits einige Parteien registriert haben, kann diese Tabelle mit der Registrierung von Parteien eine Teilmenge der Parteien aus der Tabelle Party (Partei) enthalten, die Sie für Vorhersageergebnisse verwenden möchten.

Schema für Einzelhandelspartner

Spalte	Typ	Beschreibung
`party_id`	`STRING`	Eindeutige Kennung der Partei in den Datasets der Instanz
`party_size`	`STRING`	NULL; Inhalt wird für die Registrierung von Einzelhandelspartnern ignoriert

Schema für kommerzielle Rechtssubjekte

Spalte Typ Beschreibung

party_id STRING Eindeutige Kennung der Partei in den Datasets der Instanz

party_size

STRING

Angeforderte Gruppengröße. Die Stufe basiert auf der durchschnittlichen Anzahl der monatlichen Transaktionen für die Partei in den letzten 365 Tagen:

SMALL für kleine gewerbliche Rechtssubjekte mit durchschnittlich weniger als 500 Transaktionen pro Monat
LARGE für große gewerbliche Parteien mit mindestens 500 Transaktionen pro Monat im Durchschnitt

Bei allen Werten wird die Groß-/Kleinschreibung beachtet.

Parteien registrieren

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

Einzelhändler und gewerbliche 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, gelten die Einträge als separate Registrierungen.
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 Vorhersageergebnisse erstellen, wenn ein Datensatz verwendet wird, der eine Partei enthält, die nicht in derselben Branche registriert ist.
Die bereitgestellte Tabelle zur Registrierung von Rechtssubjekten wird verwendet, um die vorhandene Liste der registrierten Rechtssubjekte in der Instanz zu ergänzen oder alle registrierten Rechtssubjekte für die angegebene Branche in der Instanz zu ersetzen.
Nach der Registrierung kann eine Partei für einige Zeit nicht mehr abgemeldet werden (siehe Preisseite). Aus diesem Grund können Sie das Feld validateOnly auf TRUE festlegen. In diesem Feld sehen Sie die Nettoauswirkung und Reaktion der Methode, ohne die registrierten Parteien zu ändern. Nach der Validierung können Sie den Vorgang noch einmal ausführen und den Parameter validateOnly auf FALSE festlegen.
Prüfen Sie immer die Antwort einer Registrierungsanfrage, um sicherzustellen, dass alle Parteien erfolgreich registriert wurden, auch wenn eine vorherige validateOnly-Anfrage erfolgreich war.
Bei Registrierungen von kommerziellen Rechtssubjekten wird ein Fehler (Invalid party_size present in table) ausgelöst, wenn im Feld party_size in der Tabelle zur Registrierung von Rechtssubjekten ein anderer Wert als SMALL oder LARGE angegeben ist. Registrierte Rechtssubjekte werden nicht aktualisiert.
Bei Registrierungen von Einzelhändlern wird das Feld party_size ignoriert und alle Parteien in der bereitgestellten Tabelle für die Registrierung von Parteien werden registriert.

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

Die folgenden Informationen sind auch unter Instanzen erstellen und verwalten verfügbar.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

Berechtigungen

financialservices.v1instances.importRegisteredParties

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, das eine Tabelle mit den registrierten Rechtssubjekten enthält
PARTY_REGISTRATION_TABLE: die Tabelle, in der die registrierten Parteien aufgeführt sind
Hinweis: Sie können mehrere Tabellen angeben, in denen die registrierten Parteien aufgeführt sind. Verwenden Sie das Format "bq://{project}.{bqDatasetID}.{bqTableID}" für jede Tabelle im Array partyTables.
UPDATE_MODE: Verwenden Sie REPLACE, um entfernungsfähige Parteien in der Tabelle der registrierten Parteien durch neue Parteien zu ersetzen, oder verwenden Sie APPEND, um der Tabelle der registrierten Parteien neue Parteien hinzuzufügen.
LINE_OF_BUSINESS: Dieses Feld muss mit dem Wert lineOfBusiness in der Engine-Version übereinstimmen, die von der Engine-Konfiguration verwendet wird. Verwenden Sie COMMERCIAL für Kunden im kommerziellen Bankgeschäft (juristische und natürliche Personen) oder RETAIL für Privatkunden.

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:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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 eine JSON-Antwort ähnlich wie diese 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 Vorgangs mit langer Ausführungszeit (Long-Running Operation, LRO) finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Registrierungsantwort

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

Antwortfeld	Typ	Beschreibung
`partiesAdded`	`integer`	Anzahl der durch diesen Vorgang hinzugefügten Parteien
`partiesRemoved`	`integer`	Anzahl der durch diesen Vorgang entfernten Parteien
`partiesTotal`	`integer`	Die Gesamtzahl der Parteien, die in dieser Instanz registriert sind, nachdem der Aktualisierungsvorgang abgeschlossen wurde.
`partiesUptiered`	`integer`	Gesamtzahl der kommerziellen Parteien, die von klein auf groß hochgestuft werden
`partiesDowntiered`	`integer`	Gesamtzahl der kommerziellen Parteien, die von groß auf klein herabgestuft wurden
`partiesFailedToDowntier`	`integer`	Gesamtzahl der kommerziellen Rechtssubjekte, die nicht von „groß“ auf „klein“ herabgestuft wurden
`partiesFailedToRemove`	`integer`	Anzahl der Parteien, die durch diesen Vorgang nicht entfernt werden konnten

Parteien abmelden

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

Antworten auf die Registrierungsaufhebung

Prüfen Sie nach Abschluss des Vorgangs die API-Antwort, um festzustellen, ob der Vorgang das beabsichtigte Ergebnis in Bezug auf die Anzahl der hinzugefügten oder entfernten Parteien und die Gesamtzahl der registrierten Parteien erzielt hat.

Die API-Antwort gibt auch die Anzahl der Parteien zurück, die aufgrund von Einschränkungen nicht entfernt werden konnten. Ein Kunde kann beispielsweise erst abgemeldet werden, wenn eine Mindestanzahl von Tagen vergangen ist.

Registrierte Rechtssubjekte exportieren

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

Die folgenden Informationen sind auch unter Instanzen erstellen und verwalten verfügbar.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

Berechtigungen

financialservices.v1instances.exportRegisteredParties

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 Rechtssubjekten 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 im Commercial Banking (juristische und natürliche Personen) oder RETAIL für Kunden im Retail Banking.

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:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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 eine JSON-Antwort ähnlich wie diese 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 Vorgangs mit langer Ausführungszeit (Long-Running Operation, LRO) finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

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

Spalte	Typ	Beschreibung
`party_id`	`STRING`	Eindeutige Kennung der Partei in den Datasets der Instanz
`party_size`	`STRING`	Gibt die Stufe für gewerbliche Kunden an (groß oder klein). Dieses Feld gilt nicht für Einzelhandelskunden. `NULL` für alle Einzelhandelskunden `SMALL` für kleine gewerbliche Rechtssubjekte mit durchschnittlich weniger als 500 Transaktionen pro Monat `LARGE` für große gewerbliche Parteien mit mindestens 500 Transaktionen pro Monat im Durchschnitt Bei allen Werten wird die Groß-/Kleinschreibung beachtet.
`earliest_remove_time`	`STRING`	Der früheste Zeitpunkt, zu dem die Partei entfernt werden kann
`party_with_prediction_intent`	`STRING`	Gibt an, ob eine Partei seit der Registrierung vorhergesagt wurde.
`registration_or_uptier_time`	`STRING`	Der Zeitpunkt, zu dem die Partei registriert oder hochgestuft wurde

Parteien registrieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweise

Wann müssen Parteien registriert werden?

Tabellen für die Registrierung von politischen Parteien vorbereiten

Schema für Einzelhandelspartner

Schema für kommerzielle Rechtssubjekte

Parteien registrieren

Erforderliche Berechtigungen für diese Aufgabe

curl

PowerShell

Registrierungsantwort

Parteien abmelden

Antworten auf die Registrierungsaufhebung

Registrierte Rechtssubjekte exportieren

Erforderliche Berechtigungen für diese Aufgabe

curl

PowerShell

Parteien registrieren