Esta página mostra as etapas para registrar e cancelar o registro partes para criar resultados de previsão:
- Confira se você está pronto para registrar as partes
- Preparar as tabelas de registro de partidos
- Use o
projects.locations.instances.importRegisteredParties
para registrar ou cancelar o registro festas - Validar a resposta do método
- (Opcional) Exportar uma tabela de partes registradas
Antes de começar
Antes de começar, você precisa Instância da IA antilavagem de dinheiro.
Para permitir que um modelo crie previsões de pontuação de risco, primeiro é necessário registrar partes. Recomendamos que você registre as partes quando já tiver o seguintes:
- Um ou mais conjuntos de dados
- Um modelo ajustado, treinado e retestado
Quando registrar partes
Antes de criar previsões para uma parte em um dos seus conjuntos de dados, é necessário registrar a parte. Não é preciso se inscrever para o treinamento, ajustes ou backtesting.
Os resultados da Prediction são usados na investigação de clientes para lavagem de dinheiro em uma fase de produção ou teste (paralela). Também é possível criar seus próprios processos de governança e análise de modelos com base nos resultados das previsões.
O registro de partes gera custos mensais adicionais por parte registrada. Consulte a página de preços para mais informações.
Como preparar tabelas de registro de festa
Leia a página de preços para saber como registrar partes.
Prepare uma tabela para a linha de negócios em que você quer registrar partes. Se você já tem algumas partes registradas, esta tabela de registro de parte pode conter um subconjunto das partes da tabela Party que você quer usar para resultados de previsão.
Esquema das partes varejistas
Coluna | Tipo | Descrição |
---|---|---|
party_id | STRING | Identificador exclusivo da parte nos conjuntos de dados da instância |
party_size | STRING | NULL: o conteúdo é ignorado para registros de terceiros de varejo |
Esquema de partes comerciais
Coluna | Tipo | Descrição |
---|---|---|
party_id | STRING | Identificador exclusivo da parte nos conjuntos de dados da instância |
party_size | STRING |
Tamanho do grupo solicitado. O nível é baseado no número médio de transações mensais
a parte nos últimos 365 dias:
Todos os valores diferenciam maiúsculas de minúsculas. |
Como registrar partes
As partes são registradas separadamente para cada instância da IA antilavagem de dinheiro. Observações:
- As partes comerciais e de varejo precisam ser registradas separadamente. Usar anúncios Chamadas de API e tabelas de registro de partes separadas. Se uma das partes estiver em ambos listas, elas são consideradas registros separados.
- As previsões exigem que todas as partes estejam registradas na linha de negócios associada à versão do mecanismo usada. Não é possível gera resultados de previsão se um conjunto de dados que contém qualquer parte não for usado registradas na mesma linha de negócios.
- A tabela de registro de parte fornecida é usada para anexar ao lista de partes registradas na instância ou substituir todas partes registradas para a linha de negócios informada na instância.
- Após o registro, não será possível cancelar o registro de uma parte por algum tempo (consulte a seção
página de preços). Por isso, defina o
validateOnly
comoTRUE
. Este campo permite que você veja o efeito líquido e a resposta de o método sem alterar as partes registradas. Após a validação, é possível Execute novamente a operação e defina o parâmetrovalidateOnly
comoFALSE
. - Sempre verifique a resposta de uma solicitação de registro para garantir que todas as partes
foram registrados com sucesso, mesmo que uma solicitação
validateOnly
anterior bem-sucedido. - Para registros de parte comercial, um valor diferente de
SMALL
ouLARGE
em o campoparty_size
na tabela de registro da parte aciona um erro. (Invalid party_size present in table
). As partes registradas não são atualizado. - Para registros de terceiros, o campo
party_size
é ignorado, e todos as partes na tabela de registro de parte fornecida sejam registradas.
Para importar partes registradas, use o método
projects.locations.instances.importRegisteredParties
.
(As informações a seguir também estão disponíveis em Criar e gerenciar instâncias.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do projeto do Google Cloud listado nas Configurações do IAMLOCATION
: o local da instância. use uma das as regiões com suporteMostrar locaisus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: o identificador definido pelo usuário para a instância.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME
: um conjunto de dados do BigQuery que contém uma tabela que descreve as partes registradasPARTY_REGISTRATION_TABLE
: a tabela que lista as partes registradasUPDATE_MODE
: useREPLACE
para substituir as partes que são removíveis na tabela de partes registradas com novas partes ou useAPPEND
para adicionar novas partes à tabela de partes registradasLINE_OF_BUSINESS
: este campo precisa corresponder à O valorlineOfBusiness
na versão do mecanismo usadas pela configuração do mecanismo useCOMMERCIAL
para clientes de bancos comerciais (pessoas jurídicas e físicas) ou useRETAIL
para clientes de bancos de varejo
Corpo JSON da solicitação:
{ "partyTables": [ "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE" ], "mode": "UPDATE_MODE", "lineOfBusiness": "LINE_OF_BUSINESS" }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo chamado request.json
.
Execute o comando a seguir no terminal para criar ou substituir
esse arquivo no diretório atual:
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
Depois execute o comando a seguir para enviar a solicitação 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
Salve o corpo da solicitação em um arquivo chamado request.json
.
Execute o comando a seguir no terminal para criar ou substituir
esse arquivo no diretório atual:
@' { "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
Depois execute o comando a seguir para enviar a solicitação 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
Você receberá uma resposta JSON semelhante a esta:
{ "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 informações sobre como obter o resultado da operação de longa duração (LRO, na sigla em inglês), consulte Gerencie operações de longa duração.
Resposta de registro
Quando a LRO é concluída, a resposta indica o número de partes que foram adicionadas, removidas ou atualizadas pela operação.
Campo de resposta | Tipo | Descrição |
---|---|---|
partiesAdded | integer |
Número de partes adicionadas por essa operação |
partiesRemoved | integer |
Número de partes removidas por esta operação |
partiesTotal | integer |
Número total de partes registradas nesta instância, após a operação de atualização ter sido concluído |
partiesUptiered | integer |
Número total de partes comerciais de pequeno a grande porte |
partiesDowntiered | integer |
Número total de partes comerciais que são rebaixadas de grandes para pequenas |
partiesFailedToDowntier | integer |
Número total de partes comerciais que não reduziram o número de partes comerciais, de grande para pequeno |
partiesFailedToRemove | integer |
Número de partes que não foram removidas por esta operação |
Como cancelar o registro de partes
As partes são canceladas por instância de IA antilavagem de dinheiro usando a mesma
projects.locations.instances.importRegisteredParties
e substituindo a lista atual de partes. Defina o campo mode
como
REPLACE
. Esta configuração cancela o registro das partes atualmente registradas (por
a linha de negócios fornecida) que não fazem parte da parte fornecida
na tabela de registro.
Respostas de cancelamento de registro
Após a conclusão da operação, verifique a resposta da API para verificar se a operação gerou o resultado pretendido em termos de números de partes adicionadas ou removidas e o número total de partes registradas.
A resposta da API também retorna o número de partes que não puderam ser removidas devido a restrições. por exemplo, o registro de um cliente só pode ser cancelado o número mínimo de dias já passou.
Exportar partes registradas
Para exportar partes registradas, use o
projects.locations.instances.exportRegisteredParties
.
(As informações a seguir também estão disponíveis em Criar e gerenciar instâncias.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do projeto do Google Cloud listado nas Configurações do IAMLOCATION
: o local da instância. use uma das as regiões com suporteMostrar locaisus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: o identificador definido pelo usuário para a instância.BQ_OUTPUT_DATASET_NAME
: um Conjunto de dados do BigQuery para exportar uma tabela com a descrição das partes registradasPARTY_REGISTRATION_TABLE
: a tabela para gravar as partes registradasWRITE_DISPOSITION
: a ação que ocorre. se a tabela de destino já existir; use um dos seguintes valores:-
WRITE_EMPTY
: só exporta dados se a tabela do BigQuery estiver vazia. -
WRITE_TRUNCATE
: apagar todos os dados atuais na tabela do BigQuery antes de gravar na tabela.
-
LINE_OF_BUSINESS
: useCOMMERCIAL
para clientes de bancos comerciais (pessoas jurídicas e físicas) ou usam oRETAIL
para serviços bancários de varejo clientes
Corpo JSON da solicitação:
{ "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo chamado request.json
.
Execute o comando a seguir no terminal para criar ou substituir
esse arquivo no diretório atual:
cat > request.json << 'EOF' { "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" } EOF
Depois execute o comando a seguir para enviar a solicitação 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
Salve o corpo da solicitação em um arquivo chamado request.json
.
Execute o comando a seguir no terminal para criar ou substituir
esse arquivo no diretório atual:
@' { "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
Depois execute o comando a seguir para enviar a solicitação 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
Você receberá uma resposta JSON semelhante a esta:
{ "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 informações sobre como obter o resultado da operação de longa duração (LRO, na sigla em inglês), consulte Gerencie operações de longa duração.
Esse método gera uma tabela do BigQuery com o seguinte esquema:
Coluna | Tipo | Descrição |
---|---|---|
party_id | STRING | Identificador exclusivo da parte nos conjuntos de dados da instância |
party_size | STRING |
Especifica o nível para clientes comerciais (grande versus pequeno). Este campo não se aplica
para clientes de varejo.
Todos os valores diferenciam maiúsculas de minúsculas. |
earliest_remove_time | STRING | A primeira data e hora em que a parte pode ser removida |
party_with_prediction_intent | STRING | O indicador que sugere se uma festa foi prevista desde o registro |
registration_or_uptier_time | STRING | O momento em que a parte foi registrada ou atualizada |