Registra tus fiestas

En esta página, se te guiará por los siguientes pasos para registrar y anular el registro de las partes con el fin de crear resultados de predicción:

Asegúrate de tener todo listo para registrar fiestas
Prepara las tablas de registro de la fiesta
Usa el método projects.locations.instances.importRegisteredParties para registrar o anular el registro de las partes.
Valida la respuesta del método
(Opcional) Exporta una tabla de las partes registradas

Antes de comenzar

Antes de comenzar, necesitas una instancia de AML AI.

Para permitir que un modelo cree predicciones de puntuación de riesgo, primero debes registrar a las partes. Te recomendamos que registres a las partes cuando ya tengas lo siguiente:

Uno o más conjuntos de datos
Un modelo ajustado, entrenado y sometido a pruebas retrospectivas

Cuándo registrar a las partes

Antes de crear predicciones para una parte en uno de tus conjuntos de datos, debes registrarla. No es necesario registrarse para el entrenamiento, la optimización ni las pruebas retrospectivas.

Los resultados de la predicción se usan para investigar a los clientes por lavado de dinero en una fase de producción o de prueba (paralela). También puedes crear tus propios procesos de análisis de modelos y gobernanza en torno a los resultados que obtienes de las predicciones.

Las partes registradas generan costos mensuales adicionales por cada parte registrada (consulta la página Precios para obtener más información).

Cómo preparar tablas de registro de partidos

Lee la página de precios para obtener información sobre el registro de las partes.

Prepara una tabla para la línea de negocio para la que deseas registrar a las partes. 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 deseas usar para los resultados de la predicción.

Esquema de entidades 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`	NULL; el contenido se ignora para los registros de terceros 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

Tamaño de grupo solicitado. El nivel se basa en la cantidad promedio de transacciones mensuales de la parte durante los 365 días anteriores:

SMALL para comercios pequeños con menos de 500 transacciones mensuales promedio
LARGE para grandes comercios con un promedio de 500 o más transacciones mensuales

Todos los valores distinguen mayúsculas de minúsculas.

Cómo registrar partidos

Las partes se registran por separado para cada instancia de la IA de la AML. Ten en cuenta lo siguiente:

Los comercios y las partes comerciales deben registrarse por separado. Usa llamadas a la API y tablas de registro de terceros independientes. Si una parte se encuentra en ambas listas, se considera que son registros separados.
Las predicciones requieren que todas las partes estén registradas en la 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 a cualquier entidad no registrada en la misma línea de negocio.
La tabla de registro de terceros proporcionada se usa para agregar a la lista existente de terceros registrados en la instancia o reemplazar todos los terceros registrados para la línea de negocio proporcionada en la instancia.
Una vez que se registra, una fiesta no se puede dar de baja durante un tiempo (consulta la página de precios). Por este motivo, puedes configurar el campo validateOnly como TRUE. Este campo te permite ver el efecto neto y la respuesta del método sin cambiar las partes registradas. Una vez validado, puedes volver a ejecutar la operación y establecer el parámetro validateOnly en FALSE.
Siempre verifica la respuesta de una solicitud de registro para asegurarte de que todas las partes se hayan registrado correctamente, incluso si una solicitud validateOnly anterior se realizó con éxito.
En el caso de los registros de partes comerciales, un valor distinto de SMALL o LARGE en el campo party_size de la tabla de registro de partes activa un error (Invalid party_size present in table). No se actualizan las partes registradas.
En el caso de los registros de socios minoristas, se ignora el campo party_size y se registran todos los socios de la tabla de registro de socios proporcionada.

Para importar las partes registradas, usa el método projects.locations.instances.importRegisteredParties.

(La siguiente información también está disponible en Crea y administra instancias).

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.importRegisteredParties

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID de tu proyecto de Google Cloud que aparece en la Configuración de IAM.
LOCATION: Es la ubicación de la instancia. Usa una de las regiones compatibles.
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
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 registradas
PARTY_REGISTRATION_TABLE: Es la tabla que enumera las partes registradas.
Nota: Puedes proporcionar varias tablas que enumeren las partes registradas. Usa el formato "bq://{project}.{bqDatasetID}.{bqTableID}" para cada tabla del array partyTables.
UPDATE_MODE: Usa REPLACE para reemplazar a las partes que se pueden quitar en la tabla de partes registradas por partes nuevas o usa APPEND para agregar partes nuevas a la tabla de partes registradas.
LINE_OF_BUSINESS: Este campo debe coincidir con el valor de lineOfBusiness en la versión del motor que usa la configuración del motor. Usa COMMERCIAL para los clientes de banca comercial (entidades legales y naturales) o RETAIL para los 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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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 se agregaron, quitaron o actualizaron con la operación.

Campo de respuesta	Tipo	Descripción
`partiesAdded`	`integer`	Cantidad de partes agregadas por esta operación
`partiesRemoved`	`integer`	Cantidad de partes quitadas por esta operación
`partiesTotal`	`integer`	Cantidad total de partes registradas en esta instancia después de que se completó la operación de actualización
`partiesUptiered`	`integer`	Cantidad total de socios comerciales que se actualizaron de pequeños a grandes
`partiesDowntiered`	`integer`	Cantidad total de partes comerciales que se redujeron de grandes a pequeñas
`partiesFailedToDowntier`	`integer`	Cantidad total de entidades comerciales que no pudieron reducir su nivel de grande a pequeña
`partiesFailedToRemove`	`integer`	Cantidad de partes que no se pudieron quitar con esta operación

Cómo anular el registro de las partes

Las partes se dan de baja por instancia de IA de la AML con el mismo método projects.locations.instances.importRegisteredParties y se reemplaza la lista existente de partes. Configura el campo mode como REPLACE. Este parámetro de configuración anula el registro de las partes registradas (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 produjo el resultado esperado en términos de cantidades de partes agregadas o quitadas, y la cantidad total de partes registradas.

La respuesta de la API también devuelve la cantidad de partes que no se pudieron quitar debido a restricciones. Por ejemplo, no se puede anular el registro de un cliente hasta que haya transcurrido una cantidad mínima de días.

Exportar las partes registradas

Para exportar las partes registradas, usa el método projects.locations.instances.exportRegisteredParties.

(La siguiente información también está disponible en Crea y administra instancias).

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.exportRegisteredParties

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID de tu proyecto de Google Cloud que aparece en la Configuración de IAM.
LOCATION: Es la ubicación de la instancia. Usa una de las regiones compatibles.
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: Es el identificador definido por el usuario para la instancia.
BQ_OUTPUT_DATASET_NAME: Es un conjunto de datos de BigQuery en el que se exportará una tabla que describe a las partes registradas.
PARTY_REGISTRATION_TABLE: Es la tabla en la que se escribirán las partes registradas.
WRITE_DISPOSITION: Es la acción que ocurre si ya existe la tabla de destino. 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: Usa COMMERCIAL para los clientes de banca comercial (entidades legales y físicas) o RETAIL para los clientes de banca minorista.

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 se aplica a los clientes minoristas. `NULL` para todos los clientes minoristas `SMALL` para comercios pequeños con menos de 500 transacciones mensuales promedio `LARGE` para grandes comercios con un promedio de 500 o más transacciones mensuales Todos los valores distinguen mayúsculas de minúsculas.
`earliest_remove_time`	`STRING`	Es la fecha y hora más tempranas en las que se puede quitar a la parte.
`party_with_prediction_intent`	`STRING`	Es el indicador que sugiere si se predijo un partido desde el registro.
`registration_or_uptier_time`	`STRING`	Fecha y hora en que se registró o se actualizó el nivel de la parte

Registra tus fiestas Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Cuándo registrar a las partes

Cómo preparar tablas de registro de partidos

Esquema de entidades de venta minorista

Esquema de partes comerciales

Cómo registrar partidos

Permisos necesarios para esta tarea

curl

PowerShell

Respuesta de registro

Cómo anular el registro de las partes

Respuestas de anulación del registro

Exportar las partes registradas

Permisos necesarios para esta tarea

curl

PowerShell

Registra tus fiestas