Skip to main content

Tutorial Interativo

Em breve: Vídeo interativo com Clueso estará disponível aqui. Por enquanto, siga o guia passo a passo abaixo.

Visão Geral

O motor de regras do gu1 permite criar avaliações automáticas de risco e compliance para entidades (pessoas, empresas, transações). Você pode:
  • Criar regras sem código usando o constructor visual
  • Escrever lógica personalizada em JavaScript
  • Usar análise de IA para avaliações complexas
  • Combinar múltiplas condições com operadores lógicos
  • Definir ações automáticas (criar alertas, enviar webhooks, etc.)
Recomendação: Comece com o constructor visual para regras simples e evolua para código quando precisar de lógica mais sofisticada.

Passos Resumidos

1

Acesse o Gerenciador de Regras

Navegue até Rules no menu lateral esquerdo do dashboard gu1.
2

Clique em 'Create Rule'

No topo direito, clique no botão + Create Rule (azul).
3

Configure Informações Básicas

  • Nome: Escolha um nome descritivo (ex: “PEP Screening - Alto Risco”)
  • Descrição: Explique o que a regra faz
  • Tipo de entidade: Selecione Person, Company ou Transaction
  • Categoria: Escolha AML, KYC, Fraud, Credit, etc.
4

Defina Condições

Use o constructor visual ou escreva código JavaScript para definir quando a regra deve ser executada.
5

Configure Ações

Defina o que acontece quando a regra é ativada:
  • Criar alerta
  • Atualizar score de risco
  • Enviar webhook
  • Executar integração externa
6

Teste a Regra

Use o Rule Tester para validar com entidades de exemplo antes de publicar.
7

Publique

Quando estiver satisfeito, clique em Publish para ativar a regra.

Constructor Visual vs. Código

Quando Usar

  • Regras simples baseadas em propriedades da entidade
  • Comparações diretas (igual, maior que, contém, etc.)
  • Múltiplas condições com AND/OR
  • Não requer conhecimento de programação

Exemplo: PEP Screening

SE
  person.isPEP = true
  E
  person.pep.level EM ["National", "International"]
  E
  person.country EM ["Venezuela", "Syria", "Iran"]
ENTÃO
  Criar alerta de ALTA prioridade

Como Funciona

  1. Clique em + Add Condition
  2. Selecione o campo (ex: person.isPEP)
  3. Escolha o operador (ex: equals, greaterThan, in)
  4. Defina o valor de comparação
  5. Adicione mais condições se necessário
  6. Configure o operador lógico entre condições (AND/OR)

Tipos de Condições

Propriedades

Campos da entidade
  • person.age >= 18
  • company.revenue < 1000000
  • transaction.amount > 10000
  • person.country in ["BR", "AR", "UY"]

Documentos

Validação de docs
  • Documento ausente
  • Documento expirado
  • Documento rejeitado
  • Tipo de documento específico

Relacionamentos

Grafos de entidades
  • Pessoa é sócio de empresa
  • Empresa tem relação com PEP
  • Transação entre entidades relacionadas
  • Profundidade de relacionamento

Histórico

Eventos passados
  • Alertas prévios
  • Investigações fechadas
  • Mudanças de dados
  • Padrões temporais

Listas Externas

Screening
  • Sanctions lists (OFAC, UN, EU)
  • PEP databases
  • Watchlists personalizadas
  • Listas de bloqueio internas

Integrações

APIs externas
  • ComplyAdvantage
  • Bureau de crédito
  • Validadores de documentos
  • Provedores de dados

Ações Disponíveis

Quando uma regra é ativada, você pode executar múltiplas ações:
Configuração:
  • Prioridade: Low, Medium, High, Critical
  • Tipo: AML, Fraud, Compliance, Credit
  • Mensagem: Texto descritivo ou template
  • Atribuir a: Time ou usuário específico
  • Tags: Para categorização adicional
Exemplo:
{
  "type": "create_alert",
  "config": {
    "priority": "high",
    "alertType": "aml",
    "message": "PEP de alto risco detectado: {{person.name}}",
    "assignTo": "compliance-team",
    "tags": ["pep", "high-risk", "latam"]
  }
}
Configuração:
  • Score: Valor numérico (0-100)
  • Categoria: AML, Credit, Fraud, etc.
  • Justificativa: Explicação para auditoria
Exemplo:
{
  "type": "update_risk_score",
  "config": {
    "score": 85,
    "category": "aml",
    "reason": "Múltiplos fatores de risco identificados"
  }
}
Configuração:
  • URL: Endpoint HTTP do seu sistema
  • Método: POST, PUT, PATCH
  • Headers: Autenticação e metadata
  • Payload: Dados da entidade e resultado da regra
Exemplo:
{
  "type": "webhook",
  "config": {
    "url": "https://yourapi.com/webhooks/gueno",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer {{api_key}}",
      "Content-Type": "application/json"
    },
    "payload": {
      "entityId": "{{entity.id}}",
      "ruleId": "{{rule.id}}",
      "result": "{{result}}"
    }
  }
}
Integrações disponíveis:
  • ComplyAdvantage: Screening adicional
  • Validadores de documento: OCR e verificação
  • Bureau de crédito: Consulta de score
  • BACEN/Receita Federal: Dados públicos
Exemplo:
{
  "type": "integration",
  "config": {
    "provider": "complyadvantage",
    "action": "screening",
    "params": {
      "entityType": "person",
      "searchDepth": "deep"
    }
  }
}
Configuração:
  • Canal: Email, Slack, Teams, SMS
  • Destinatários: Times ou usuários específicos
  • Template: Mensagem personalizada
Exemplo:
{
  "type": "notification",
  "config": {
    "channel": "slack",
    "recipients": ["#compliance-alerts"],
    "template": "pep-alert",
    "data": {
      "entityName": "{{person.name}}",
      "riskScore": "{{result.riskScore}}"
    }
  }
}
Configuração:
  • Prioridade: Low, Medium, High, Critical
  • Tipo: Due Diligence, Enhanced DD, Adverse Media
  • Atribuir a: Analista ou time
  • Consolidar alertas: Agrupar alertas relacionados
Exemplo:
{
  "type": "create_investigation",
  "config": {
    "priority": "high",
    "investigationType": "enhanced_dd",
    "assignTo": "senior-analyst-team",
    "consolidateAlerts": true
  }
}

Testando Regras

Importante: Sempre teste regras antes de publicar para evitar falsos positivos e impacto em produção.

Rule Tester

O Rule Tester permite validar regras com entidades reais:
1

Abra o Tester

Na página da regra, clique em Test Rule no canto superior direito.
2

Selecione Entidades

Escolha entidades existentes ou crie dados de teste (mock).
3

Execute

Clique em Run Test para ver os resultados.
4

Analise Output

Verifique:
  • Regra foi ativada corretamente?
  • Ações foram executadas?
  • Metadata está correto?
  • Logs estão claros?

Dados de Teste (Mock)

Crie entidades sintéticas para testar casos extremos:
{
  "type": "person",
  "data": {
    "name": "João Silva",
    "age": 42,
    "country": "BR",
    "isPEP": true,
    "pep": {
      "level": "National",
      "position": "Senador Federal"
    },
    "income": 15000,
    "documents": [
      { "type": "cpf", "number": "123.456.789-00", "status": "valid" },
      { "type": "proof_of_address", "status": "pending" }
    ]
  }
}

Boas Práticas

Nomeação Clara

Use nomes descritivos que expliquem o propósito da regra:
  • ✅ “PEP Nacional - Criar Alerta Alto Risco”
  • ❌ “Regra 123”

Documentação

Sempre preencha a descrição explicando:
  • Por que a regra existe
  • Quando ela é ativada
  • O que ela faz

Versionamento

Ao editar regras em produção:
  • Crie uma nova versão
  • Teste em staging primeiro
  • Documente mudanças

Monitoramento

Acompanhe métricas:
  • Taxa de ativação
  • Falsos positivos
  • Tempo de execução
  • Custo (para regras com IA)

Próximos Passos

Precisa de Ajuda?


Última atualização: Janeiro 2025