En esta página, se indican los pasos que debes seguir para registrarte y anular el registro partes para crear resultados de predicción:
- Asegúrate de tener todo listo para registrar grupos
- Prepara las tablas de registro de partidos
- Usa el método
projects.locations.instances.importRegisteredParties
para registrar o cancelar el registro de las partes. - Valida la respuesta del método
- (Opcional) Exporta una tabla de partes registradas
Antes de comenzar
Antes de comenzar, necesitas Instancia de IA contra el lavado de dinero.
Para permitir que un modelo cree predicciones de puntuación de riesgo, primero debes registrar terceros. Te recomendamos que registres las partes cuando ya tengas lo siguiente:
- Uno o más conjuntos de datos
- R ajustado, entrenado y retroprobado
Cuándo registrar partes
Antes de crear predicciones para un grupo en uno de tus conjuntos de datos debe registrar a la parte. No se requiere registro para la capacitación. el ajuste o la backtesting.
Los resultados de las predicciones se usan para investigar a los clientes por lavado de dinero en una fase de producción o de pruebas (paralela). También te recomendamos que crees tus propios procesos de gobernanza y análisis de modelos en función de los resultados que obtengas de las predicciones.
Las partes registradas incurren en costos mensuales adicionales por cada parte registrada (consulte la página de precios para obtener más información).
Cómo preparar las tablas de registro de las partes
Consulta la página de precios para obtener información sobre el registro de partes.
Prepara una tabla para la línea de negocio en la que deseas registrar grupos. Si ya tienes algunas partes registradas, esta tabla de registro de partes podría contener un subconjunto de las partes de la tabla Parte que usted deseas usar para los resultados de la predicción.
Esquema de las partes de venta minorista
Columna | Tipo | Descripción |
---|---|---|
party_id | STRING | Identificador único de la parte en los conjuntos de datos de la instancia |
party_size | STRING | Es NULL. Se ignora el contenido para los registros de tiendas minoristas. |
Esquema de partes comerciales
Columna | Tipo | Descripción |
---|---|---|
party_id | STRING | Identificador único de la parte en los conjuntos de datos de la instancia |
party_size | STRING |
Cantidad de personas solicitadas. El nivel se basa en la cantidad promedio de transacciones mensuales de
la parte durante los 365 días anteriores:
Todos los valores distinguen mayúsculas de minúsculas. |
Cómo registrar partes
Las partes se registran por separado para cada instancia de IA contra lavado de dinero. Ten en cuenta lo siguiente:
- Las partes minoristas y comerciales deben registrarse por separado. Usar independientes Llamadas a la API y tablas de registro de partes independientes. Si una parte está en ambos se consideran registros independientes.
- Las predicciones requieren que todas las partes estén registradas ante el línea de negocio asociada con la versión del motor que se usa. No puedes crear resultados de predicción si se usa un conjunto de datos que contiene partes que no registrados en la misma línea de negocio.
- La tabla de registro de partes proporcionada se utiliza para adjuntar al lista existente de partes registradas en la instancia o reemplazar todas partes registradas de la línea de negocio indicada en la instancia.
- Una vez que se registra, no se puede anular el registro de una parte durante un tiempo determinado (consulte el
Página de precios). Por este motivo, puedes configurar el
validateOnly
enTRUE
. Este campo te permite ver el efecto neto y la respuesta de el método sin cambiar las partes registradas. Una vez validados, puedes vuelve a ejecutar la operación y establece el parámetrovalidateOnly
enFALSE
. - Verifica siempre la respuesta a una solicitud de registro para asegurarte de que todas las partes
se registraron correctamente, incluso si una solicitud
validateOnly
anterior sin errores. - Para los registros de partes comerciales, un valor distinto de
SMALL
oLARGE
en el campoparty_size
de la tabla de registro de partes activa un error (Invalid party_size present in table
). Las partes registradas no son se actualicen. - Para los registros de ventas minoristas, el campo
party_size
se ignora y todos estén registradas en la tabla de registro de partes proporcionada.
Para importar partes registradas, utilice el
projects.locations.instances.importRegisteredParties
.
(La siguiente información también está disponible en Crear y administrar instancias).
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.LOCATION
: La ubicación de la instancia. usa uno de el regiones admitidasMostrar ubicacionesus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: Es el identificador definido por el usuario para la instancia.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME
: un Conjunto de datos de BigQuery que contiene una tabla que describe a las partes registradasPARTY_REGISTRATION_TABLE
: Es la tabla que enumera las partes registradas.UPDATE_MODE
: usaREPLACE
para reemplazar a los grupos que se pueden eliminar de la tabla de partes registradas con los grupos nuevos, o bien puede utilizarAPPEND
para agregar nuevos grupos al tabla de partes registradasLINE_OF_BUSINESS
: este campo debe coincidir con El valor delineOfBusiness
en versión del motor utilizadas por el configuración del motor; usarCOMMERCIAL
para clientes de banca comercial (entidades legales y naturales) o usarRETAIL
para clientes de banca minorista
Cuerpo JSON de la solicitud:
{ "partyTables": [ "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE" ], "mode": "UPDATE_MODE", "lineOfBusiness": "LINE_OF_BUSINESS" }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
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
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@' { "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
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "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 }
Para obtener información sobre cómo obtener el resultado de la operación de larga duración (LRO), consulta Administra operaciones de larga duración.
Respuesta de registro
Cuando se completa la LRO, la respuesta indica la cantidad de partes que que la operación agrega, quita o actualiza.
Campo de respuesta | Tipo | Descripción |
---|---|---|
partiesAdded | integer |
Cantidad de partes agregadas por esta operación |
partiesRemoved | integer |
Cantidad de partes que se quitaron a través de esta operación |
partiesTotal | integer |
Cantidad total de partes registradas en esta instancia, después de que se completara la operación de actualización completada |
partiesUptiered | integer |
Cantidad total de partes comerciales que se cambian de tamaño pequeño a grande |
partiesDowntiered | integer |
Cantidad total de partes comerciales que se bajan de nivel de grandes a pequeños |
partiesFailedToDowntier | integer |
Cantidad total de empresas comerciales que no lograron reducir el nivel de grande a pequeño |
partiesFailedToRemove | integer |
Cantidad de partes que no se pudieron eliminar con esta operación |
Cómo anular el registro de partes
Las partes se cancelan por instancia de IA contra lavado de dinero con la misma
projects.locations.instances.importRegisteredParties
y reemplaza la lista existente de partes. Establece el campo mode
en
REPLACE
Este parámetro de configuración cancela el registro de las partes registradas actualmente (para la línea de negocio proporcionada) que no forman parte de la tabla de registro de partes proporcionada.
Respuestas de anulación del registro
Una vez completada la operación, verifica la respuesta de la API. para comprobar si la operación llevó al resultado previsto en términos de cantidad de partes agregadas o eliminadas, y el número total de partes registradas.
La respuesta de la API también muestra la cantidad de partes que no se pudieron quitar. debido a las restricciones, Por ejemplo, no se puede anular el registro de un cliente hasta que se una cantidad mínima de días.
Exportar grupos registrados
Para exportar partes registradas, usa el método projects.locations.instances.exportRegisteredParties
.
(La siguiente información también está disponible en Crear y administrar instancias).
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.LOCATION
: La ubicación de la instancia. usa uno de el regiones admitidasMostrar ubicacionesus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: Es el identificador definido por el usuario para la instancia.BQ_OUTPUT_DATASET_NAME
: un Conjunto de datos de BigQuery en el que se exporta una tabla que describe a las partes registradasPARTY_REGISTRATION_TABLE
: Es la tabla que se enviará escribir las partes registradas aWRITE_DISPOSITION
: Es la acción que se produce. si la tabla de destino ya existe; usa uno de los siguientes valores:-
WRITE_EMPTY
: Solo exportar datos si la tabla de destino está vacía. -
WRITE_TRUNCATE
: Borra todos los datos existentes en la tabla de BigQuery antes de escribir en ella.
-
LINE_OF_BUSINESS
: usaCOMMERCIAL
para clientes de banca comercial (entidades legales y naturales) o usarRETAIL
para la banca minorista clientes
Cuerpo JSON de la solicitud:
{ "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF' { "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" } EOF
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@' { "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
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "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 }
Para obtener información sobre cómo obtener el resultado de la operación de larga duración (LRO), consulta Administra operaciones de larga duración.
Este método genera una tabla de BigQuery con el siguiente esquema:
Columna | Tipo | Descripción |
---|---|---|
party_id | STRING | Identificador único de la parte en los conjuntos de datos de la instancia |
party_size | STRING |
Especifica el nivel para los clientes comerciales (grandes o pequeños). Este campo no corresponde
a clientes minoristas.
Todos los valores distinguen mayúsculas de minúsculas. |
earliest_remove_time | STRING | El primer horario en el que se puede retirar la fiesta |
party_with_prediction_intent | STRING | El indicador que sugiere si se predijo una parte desde el registro |
registration_or_uptier_time | STRING | La hora a la que se inscribió la fiesta o en la que se subió el nivel |