Cette page vous guide à travers les étapes suivantes pour enregistrer et annuler l'enregistrement parties afin de créer des résultats de prédiction:
- Assurez-vous d'être prêt à enregistrer des parties
- Préparer les tableaux d'inscription des partis
- Utilisez les
projects.locations.instances.importRegisteredParties
pour enregistrer ou annuler l'enregistrement parties - Valider la réponse de la méthode
- (Facultatif) Exporter un tableau des partis enregistrés
Avant de commencer
Avant de commencer, vous avez besoin Instance AML AI.
Pour permettre à un modèle de créer des prédictions de score de risque, vous devez d'abord enregistrer les parties prenantes. Nous vous recommandons d'enregistrer les parties lorsque vous avez déjà suivantes:
- Une ou plusieurs ensembles de données
- A modèle réglé, entraîné et rétrotesté
Quand enregistrer les parties
Avant de pouvoir créer des prédictions pour une partie dans l'un de vos ensembles de données vous devez enregistrer la partie. L'inscription n'est pas requise pour la formation, le réglage ou les tests rétrospectifs.
Les résultats des prédictions permettent d'enquêter sur le blanchiment d'argent des clients dans le pays suivant : soit en production, soit en phase de test/parallèle.
L'enregistrement des parties entraîne des frais mensuels supplémentaires par partie enregistrée (voir consultez la page des tarifs pour en savoir plus).
Préparer les tableaux d'inscription des partis
Consultez la page des tarifs pour en savoir plus sur l'enregistrement de parties.
Préparez une table correspondant au secteur d'activité pour lequel vous souhaitez enregistrer les parties. Si vous avez déjà enregistré des partis, ce tableau d'enregistrement pourrait contiennent un sous-ensemble des parties de la table Party que vous à utiliser pour les résultats de prédiction.
Schéma des parties commerciales
Colonne | Type | Description |
---|---|---|
party_id | STRING | Identifiant unique de la partie dans les ensembles de données de l'instance |
party_size | STRING | NULL; le contenu est ignoré pour les enregistrements d'une partie commerciale |
Schéma des parties commerciales
Colonne | Type | Description |
---|---|---|
party_id | STRING | Identifiant unique de la partie dans les ensembles de données de l'instance |
party_size | STRING |
Nombre de personnes demandé. Ce niveau est basé sur le nombre moyen de transactions mensuelles
au cours des 365 jours précédents:
<ph type="x-smartling-placeholder">
Toutes les valeurs sont sensibles à la casse. |
Inscrire des parties
Les parties sont enregistrées séparément pour chaque instance d'AML basée sur l'IA. Veuillez noter les points suivants :
- Les parties commerciales et les parties commerciales doivent être enregistrées séparément. Utiliser des colonnes distinctes Appels d'API et tables distinctes d'enregistrement des parties. Si une partie est à la fois des enregistrements distincts, ils sont considérés comme des enregistrements distincts.
- Les prédictions exigent que toutes les parties soient enregistrées auprès du secteur d'activité associé à la version du moteur utilisée. Vous ne pouvez pas créer des résultats de prédiction si un ensemble de données utilisé contient une partie qui n'est pas enregistrés dans le même secteur d'activité.
- Le tableau d'enregistrement des parties fourni est utilisé pour ajouter des liste existante des parties enregistrées dans l'instance ou remplacer tous les les parties enregistrées pour le secteur d'activité indiqué dans l'instance.
- Une fois l'enregistrement effectué, l'enregistrement d'une partie ne peut pas être annulé pendant un certain temps (voir les
page des tarifs). Pour cette raison, vous pouvez définir le
validateOnly
surTRUE
. Ce champ vous permet de voir l'effet net et la réponse la méthode sans modifier les parties enregistrées. Une fois la validation terminée, vous pouvez réexécutez l'opération et définissez le paramètrevalidateOnly
surFALSE
. - Vérifiez toujours la réponse à une demande d'inscription pour vous assurer que toutes les parties
ont bien été enregistrées, même si une requête
validateOnly
précédente réussi. - Dans le cas de l'enregistrement d'un parti commercial, une valeur autre que
SMALL
ouLARGE
au Le champparty_size
du tableau d'enregistrement du parti déclenche une erreur. (Invalid party_size present in table
). Les parties enregistrées ne sont pas mis à jour. - Pour les enregistrements d'une partie commerciale, le champ
party_size
est ignoré et tous les les parties figurant dans le tableau d'enregistrement des parties fourni sont enregistrées.
Pour importer des tiers enregistrés, utilisez le
projects.locations.instances.importRegisteredParties
.
(Les informations suivantes sont également disponibles dans Créer et gérer des instances)
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google Cloud répertorié dans les paramètres IAM.LOCATION
: emplacement de l'instance. utilisez l'une des la régions où le service est disponible <ph type="x-smartling-placeholder"></ph> Afficher les lieuxus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: identifiant défini par l'utilisateur pour l'instanceBQ_INPUT_REGISTERED_PARTIES_DATASET_NAME
: a Ensemble de données BigQuery contenant une table décrivant les parties enregistréesPARTY_REGISTRATION_TABLE
: table qui répertorie les parties enregistréesUPDATE_MODE
: utilisezREPLACE
pour remplacer les parties qui peuvent être supprimés du tableau des parties enregistrées avec de nouvelles parties, ou utilisezAPPEND
pour ajouter de nouvelles parties au tableau des partis enregistrésLINE_OF_BUSINESS
: ce champ doit correspondre au ValeurlineOfBusiness
dans version du moteur utilisé par le engine config; utilisezCOMMERCIAL
pour les clients de banques commerciales (entités juridiques et naturelles) ou utilisezRETAIL
pour les clients de la banque de détail
Corps JSON de la requête :
{ "partyTables": [ "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE" ], "mode": "UPDATE_MODE", "lineOfBusiness": "LINE_OF_BUSINESS" }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
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
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "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
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Vous devriez recevoir une réponse JSON de ce type :
{ "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 }
Pour savoir comment obtenir le résultat de l'opération de longue durée, consultez Gérez les opérations de longue durée.
Réponse à l'inscription
Une fois l'opération de longue durée terminée, la réponse indique le nombre de parties ajoutées, supprimées ou mises à jour par l'opération.
Champ de réponse | Type | Description |
---|---|---|
partiesAdded | integer |
Nombre de parties ajoutées par cette opération |
partiesRemoved | integer |
Nombre de parties supprimées par cette opération |
partiesTotal | integer |
Nombre total de parties enregistrées dans cette instance après l'opération de mise à jour terminée |
partiesUptiered | integer |
Nombre total de parties commerciales adaptées de la plus petite à la plus grande |
partiesDowntiered | integer |
Nombre total de parties commerciales déclassées de petite ou grande envergure |
partiesFailedToDowntier | integer |
Nombre total de parties commerciales n'ayant pas réussi à passer de l'une à l'autre |
partiesFailedToRemove | integer |
Nombre de parties qui n'ont pas pu être supprimées par cette opération |
Annuler l'enregistrement de tiers
L'enregistrement des parties est annulé pour chaque instance d'AML d'IA à l'aide de la même
projects.locations.instances.importRegisteredParties
et en remplaçant la liste existante de parties. Définissez le champ mode
sur
REPLACE
Ce paramètre annule l'enregistrement des partis actuellement enregistrés (pour
le secteur d'activité indiqué) qui ne font pas partie de la partie fournie.
tableau d'inscription.
Réponses concernant la désinscription
Une fois l'opération terminée, vérifiez la réponse de l'API. pour vérifier si l'opération a conduit au résultat souhaité en termes de nombre de de parties ajoutées ou supprimées, ainsi que le nombre total de parties enregistrées.
La réponse de l'API indique également le nombre de parties qui n'ont pas pu être supprimées. en raison de contraintes (par exemple, en raison du nombre minimal de jours avant une l'enregistrement de la partie concernée peut être annulé).
Exporter les parties enregistrées
Pour exporter les parties enregistrées, utilisez le
projects.locations.instances.exportRegisteredParties
.
(Les informations suivantes sont également disponibles dans Créer et gérer des instances)
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google Cloud répertorié dans les paramètres IAM.LOCATION
: emplacement de l'instance. utilisez l'une des la régions où le service est disponible <ph type="x-smartling-placeholder"></ph> Afficher les lieuxus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: identifiant défini par l'utilisateur pour l'instanceBQ_OUTPUT_DATASET_NAME
: a Ensemble de données BigQuery dans lequel exporter une table décrivant les parties enregistréesPARTY_REGISTRATION_TABLE
: table à écrire aux parties enregistréesWRITE_DISPOSITION
: action qui se produit si la table de destination existe déjà ; utilisez l'une des valeurs suivantes:-
WRITE_EMPTY
: n'exporter les données que si la table BigQuery est vide -
WRITE_TRUNCATE
: effacer toutes les données existantes dans la table BigQuery avant d'écrire dans la table.
-
LINE_OF_BUSINESS
: utilisezCOMMERCIAL
pour Clients d'une banque commerciale (entités juridiques et naturelles) ou utilisentRETAIL
pour la banque de détail clients
Corps JSON de la requête :
{ "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "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
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Vous devriez recevoir une réponse JSON de ce type :
{ "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 }
Pour savoir comment obtenir le résultat de l'opération de longue durée, consultez Gérez les opérations de longue durée.
Cette méthode génère une table BigQuery présentant le schéma suivant:
Colonne | Type | Description |
---|---|---|
party_id | STRING | Identifiant unique de la partie dans les ensembles de données de l'instance |
party_size | STRING |
Spécifie le niveau pour les clients commerciaux (grand ou petit). Ce champ ne s'applique pas
aux clients du secteur du commerce.
Toutes les valeurs sont sensibles à la casse. |
earliest_remove_time | STRING | Date limite à laquelle la partie peut être exclue |
party_with_prediction_intent | STRING | Indicateur qui suggère si une partie a fait l'objet de prédictions depuis l'enregistrement |
registration_or_uptier_time | STRING | La date et l'heure auxquelles le parti a été enregistré ou mis à jour |