Cette page a été traduite par l'API Cloud Translation.

Enregistrez vos clients

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 le 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 : en phase de production ou de test (parallèle). Vous pouvez également créer votre processus de gouvernance et d'analyse de modèles autour des résultats obtenus des prédictions.

L'enregistrement de parties entraîne des coûts mensuels supplémentaires par partie enregistrée (pour en savoir plus, consultez la page des tarifs).

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

Taille du groupe demandée. Le niveau est basé sur le nombre moyen de transactions mensuelles de la partie au cours des 365 derniers jours :

SMALL pour les petites sociétés commerciales enregistrant moins de 500 transactions mensuelles en moyenne
LARGE pour les grandes parties commerciales enregistrant en moyenne 500 transactions mensuelles en moyenne

Toutes les valeurs sont sensibles à la casse.

Comment enregistrer 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.
Pour effectuer des prédictions, toutes les parties doivent être enregistrées auprès de la branche d'activité associée à 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 sur TRUE. Ce champ vous permet de voir l'effet net et la réponse de la méthode sans modifier les parties enregistrées. Une fois la validation effectuée, vous pouvez réexécutez l'opération et définissez le paramètre validateOnly sur FALSE.
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.
Pour les enregistrements de parties commerciales, une valeur autre que SMALL ou LARGE dans le champ party_size de la table d'enregistrement des parties déclenche une erreur (Invalid party_size present in table). Les parties enregistrées ne sont pas mises à jour.
Pour les enregistrements de parties commerciales, le champ party_size est ignoré et toutes les parties de la table d'enregistrement de parties fournie 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)

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes:

Autorisations

financialservices.v1instances.importRegisteredParties

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
Afficher les lieux
- us-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'instance
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: a Ensemble de données BigQuery contenant une table décrivant les parties enregistrées
PARTY_REGISTRATION_TABLE: table qui répertorie les parties enregistrées
Remarque: Vous pouvez fournir plusieurs tableaux répertoriant les parties enregistrées. Utilisez le format "bq://{project}.{bqDatasetID}.{bqTableID}" pour chaque table dans partyTables tableau.
UPDATE_MODE : utilisez REPLACE pour remplacer les parties pouvant être supprimées dans la table des parties enregistrées par de nouvelles parties, ou APPEND pour ajouter de nouvelles parties à la table des parties enregistrées.
LINE_OF_BUSINESS: ce champ doit correspondre au Valeur lineOfBusiness dans version du moteur utilisé par le engine config; utilisez COMMERCIAL pour les clients de banques commerciales (entités juridiques et naturelles) ou utilisez RETAIL 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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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 une fois l'opération de mise à jour terminée
`partiesUptiered`	`integer`	Nombre total de parties commerciales qui sont passées de la catégorie "petite" à la catégorie "grande"
`partiesDowntiered`	`integer`	Nombre total de parties commerciales qui sont rétrogradées de grandes à petites
`partiesFailedToDowntier`	`integer`	Nombre total de parties commerciales qui n'ont pas pu passer de la catégorie "grande entreprise" à la catégorie "petite entreprise"
`partiesFailedToRemove`	`integer`	Nombre de parties qui n'ont pas été 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 à la demande de résiliation

Une fois l'opération terminée, vérifiez la réponse de l'API pour voir si l'opération a abouti au résultat souhaité en termes de nombre de parties ajoutées ou supprimées, et du 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, l'enregistrement d'un client ne peut être annulé tant qu'un nombre minimum de jours s'est écoulé.

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)

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes:

Autorisations

financialservices.v1instances.exportRegisteredParties

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
Afficher les emplacements
- us-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'instance
BQ_OUTPUT_DATASET_NAME: a Ensemble de données BigQuery dans lequel exporter une table décrivant les parties enregistrées
PARTY_REGISTRATION_TABLE: table à écrire aux parties enregistrées
WRITE_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: utilisez COMMERCIAL pour Clients d'une banque commerciale (entités juridiques et naturelles) ou utilisent RETAIL 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

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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`	Indique le niveau pour les clients commerciaux (grandes entreprises ou petites entreprises). Ce champ ne s'applique pas aux clients marchands. `NULL` pour tous les clients du secteur du commerce `SMALL` pour les petites sociétés commerciales enregistrant moins de 500 transactions mensuelles en moyenne `LARGE` pour les grandes parties commerciales enregistrant en moyenne 500 transactions mensuelles en moyenne Toutes les valeurs sont sensibles à la casse.
`earliest_remove_time`	`STRING`	Date et heure les plus anciennes auxquelles la partie peut être supprimée
`party_with_prediction_intent`	`STRING`	Indicateur suggérant si une fête a été prédite depuis l'enregistrement
`registration_or_uptier_time`	`STRING`	La date et l'heure auxquelles le parti a été enregistré ou mis à jour