Fontes de dados para suas decisões
Você acompanha uma solicitação chegar ao fluxo de decisão e vê o mesmo problema de novo. Um cliente com um longo histórico é tratado como se fosse desconhecido porque a regra não consegue consultar o registro no sistema bancário central. A equipe responsável diz que o dado já está disponível por uma API no gateway. O provedor também oferece um sinal útil, a análise do dispositivo, mas a chave ainda está guardada no gerenciador de senhas da sua equipe. Seu chamado de integração está na fila da plataforma, com uma dúvida sobre quais campos as regras vão consultar. A informação está por perto, mas a decisão tem acesso a muito pouco dela.
O que é uma fonte de dados
Uma fonte de dados é uma chamada a uma API REST ou a um serviço web SOAP disponível na internet pública. Você configura a chamada como uma fonte de dados, e todo o fluxo de decisão pode usar a resposta, seja o endpoint de um provedor ou de um serviço da sua empresa.
| Método | Quando usar |
|---|---|
| GET | Consulta simples, com parâmetros na URL |
| POST | Solicitações maiores, com campos de formulário, JSON ou um modelo de corpo bruto |
| PUT | Para enviar o resultado de uma decisão a outro sistema |
| SOAP | Serviço web mais antigo, com WSDL e nome de método |
Você pode definir parâmetros com valores fixos ou mapeá-los a partir do objeto de dados. Ao selecionar “Flow”, o parâmetro fica disponível na etapa do fluxo de decisão para mapeamento. Um espaço reservado na URL recebe o valor do parâmetro com o mesmo nome. Você também pode enviar cabeçalhos com a solicitação, inclusive chaves de autenticação.
Uma solicitação POST pode enviar campos de formulário, JSON ou um modelo de corpo bruto. Nesse modelo, você escreve o formato esperado pela API e usa espaços reservados para os valores dos parâmetros. A API pode retornar JSON ou XML. O mecanismo converte uma resposta XML em uma estrutura JSON e a adiciona ao objeto de dados.
Você define um tempo limite para cada fonte, de até 15 segundos. Se a API não responder a tempo, o fluxo continua, e suas regras tratam a chamada com falha como qualquer outro valor.
Onde a resposta fica
O mecanismo grava a resposta completa no objeto de dados, em $.output, seguida pelo nome da etapa e pelo nome da fonte de dados. Uma regra, tabela de decisão, scorecard ou função pode consultar qualquer campo retornado pelo caminho correspondente.
Em um exemplo, uma fonte chamada ip_check fica em uma etapa chamada checks e retorna uma resposta do AbuseIPDB. Assim, uma regra consulta $.output.checks.ip_check.abuseConfidenceScore.
O mecanismo também registra detalhes da chamada junto à resposta, como __http_code, __attempts e __cached. Se a chamada falhar, a saída inclui __error e __error_details.
Como a chamada é autenticada
Escolha o método de autenticação exigido pelo endpoint. Na tela da fonte de dados, “HTTP Authentication” recebe um nome de usuário e uma senha. “OAuth2 Authentication” recebe um endpoint de token, um ID de cliente e um segredo. O OAuth2 aceita o fluxo de credenciais do cliente ou o fluxo de senha, com escopo, público ou realm opcionais.
O mecanismo armazena o token OAuth2 em cache e solicita outro quando necessário. Se a API rejeitar o token com uma resposta 401, o mecanismo descarta o token e solicita outro uma vez durante a chamada. Uma chave de API pode ser enviada em um cabeçalho ou parâmetro.
Nos campos de chave, token ou senha, você seleciona uma credencial do cofre. A configuração mantém uma referência, como secret:openai_main. O valor não é incluído em nenhuma exportação nem release.
Conecte serviços da sua empresa
Seu fluxo de decisão pode chamar um serviço da própria empresa, assim como chama um provedor. Estes são alguns exemplos de chamadas que um credor ou uma seguradora pode fazer a partir de uma decisão:
- O cadastro de clientes no sistema central, com produtos ativos, atrasos e meses de relacionamento, para que um cliente de dez anos não pareça desconhecido.
- Um serviço de saldo ou exposição, com os saldos atuais dos produtos que limitam um novo crédito.
- O serviço de preços ou produtos, que mantém a tabela de taxas ou o catálogo de produtos em um só lugar.
- O CRM ou sistema de casos, para verificar se já existe uma solicitação, reclamação ou caso de fraude aberto para essa pessoa.
- Seu próprio serviço de documentos ou KYC, para consultar se os documentos de identidade foram verificados e quando.
- Uma chamada PUT para enviar o resultado da decisão a outro sistema.
O Decisimo chama endereços disponíveis na internet pública. Para conectar seu serviço, disponibilize um endereço pelo gateway de API e proteja o acesso com uma chave ou OAuth2. Endereços de loopback, faixas privadas 10/8, 172.16/12 e 192.168/16, além de endereços link-local, são recusados antes da chamada. Para um endereço recusado, __error_details.type recebe o valor ssrf_blocked. Redirecionamentos não são seguidos, então configure diretamente a URL final.
Sistemas centrais mais antigos costumam usar SOAP. Configure a URL do WSDL e o nome do método, depois mapeie os parâmetros aninhados pelo caminho. A versão SOAP vem do binding do WSDL, e a resposta é convertida para JSON, como em uma resposta REST.
Várias chamadas, falhas e novas tentativas
Uma única etapa pode reunir várias fontes de dados. O motor consulta todas em conjunto, e a etapa espera pela resposta mais lenta. Assim, as verificações de menor custo ficam em uma etapa, e o solicitante aguarda apenas a resposta mais demorada.
Um timeout, uma falha de conexão, um endpoint bloqueado ou um erro HTTP não interrompe todo o fluxo de decisão. A saída registra o erro e seu motivo, e o fluxo continua. Uma regra pode encaminhar a solicitação para uma ramificação alternativa ou para uma fila de análise manual. Veja como criar uma estratégia de decisão que continua funcionando quando um provedor falha.
Use “Retry this call if it fails” somente quando for seguro fazer uma segunda chamada, considerando a cobrança e o registro da solicitação. Para uma fonte configurada para tentar de novo, o mecanismo faz uma segunda tentativa após uma falha de conexão ou uma resposta HTTP 408, 425, 429, 502, 503 ou 504. O intervalo é de 200 milissegundos a 2 segundos. A nova tentativa só ocorre se o tempo disponível na etapa permitir, e __attempts registra a quantidade de tentativas.
Você também pode armazenar em cache a resposta de uma fonte por etapa do fluxo de decisão, em um destino Data cache de um banco PostgreSQL seu. O prazo padrão do cache é de 30 dias. A correspondência pode considerar a solicitação ou um conjunto de parâmetros escolhido por você. As credenciais não fazem parte da correspondência, e erros não são armazenados. __cached indica se a etapa usou uma resposta armazenada.
Configure a fonte com o assistente
O botão “AI Assistant” na tela da fonte de dados abre um chat para você descrever a API e receber uma proposta de configuração. A proposta aparece ao lado das configurações atuais para você revisar. “Apply Configuration” preenche o formulário, e “Save” salva a fonte de dados.
Se a API exigir uma chave, a caixa “Credential needed” permite selecionar uma credencial existente ou adicionar uma ao cofre. O chat inclui o nome da credencial. O assistente do fluxo também pode adicionar uma tarefa de fonte de dados enquanto você monta o fluxo de decisão.
Selecione “Run test” para chamar a fonte e ver a resposta.
Provedores que você pode conectar
Uma resposta do Fingerprint inclui um ID de visitante e indica se o dispositivo parece ser um bot. O MaxMind minFraud retorna uma pontuação de risco e informa se o e-mail é descartável. O Trestle informa se um e-mail é válido e que tipo de linha está associado a um número de telefone.
Para verificar e-mails, o Have I Been Pwned informa em quais violações de dados um endereço aparece, com as datas e os tipos de dados envolvidos. O Email Hippo analisa o próprio endereço. Para consultas de IP e dispositivo, o AbuseIPDB retorna uma pontuação de confiança de abuso de 0 a 100. Os guias do macaddress.io e do WhatIsMyBrowser mostram como conectar outras duas fontes de consulta de dispositivos da mesma forma.
Outros guias explicam como conectar o BINLIST para cartões, o Companies House para informações de empresas e o Google Places para dados geográficos e de endereço. Todos estão na página de integrações, organizados pelo tipo de consulta.
Além das fontes de dados, um fluxo pode chamar um modelo LLM com um modelo de prompt preenchido com dados da decisão e um formato de saída opcional. Também pode usar seu próprio modelo treinado em uma etapa do fluxo. Suas listas de bloqueio, permissão e monitoramento ficam no seu banco de dados, e o fluxo consulta essas listas durante a execução.
Perguntas frequentes
O Decisimo pode chamar um serviço na nossa rede privada?
Disponibilize o serviço por um endereço no gateway de API para que ele possa ser acessado pela internet pública. Endereços de redes privadas são recusados antes da chamada.
O que acontece quando um provedor demora para responder?
Você define o tempo limite, de até 15 segundos. Se o provedor não responder a tempo, o fluxo continua com o erro e o motivo registrados, e suas regras determinam o que acontece em seguida.
Quem mantém o contrato com o provedor?
Você mantém o contrato com o provedor e a chave de acesso. O Decisimo não fornece os dados do provedor.
Uma etapa pode chamar dois provedores?
As fontes são chamadas em paralelo, e a etapa espera a resposta mais lenta.