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.)
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
- Constructor Visual
- Código JavaScript
- Análise de IA
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
Como Funciona
- Clique em + Add Condition
- Selecione o campo (ex:
person.isPEP) - Escolha o operador (ex:
equals,greaterThan,in) - Defina o valor de comparação
- Adicione mais condições se necessário
- Configure o operador lógico entre condições (AND/OR)
Tipos de Condições
Propriedades
Campos da entidade
person.age >= 18company.revenue < 1000000transaction.amount > 10000person.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:Criar Alerta
Criar Alerta
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
Atualizar Score de Risco
Atualizar Score de Risco
Configuração:
- Score: Valor numérico (0-100)
- Categoria: AML, Credit, Fraud, etc.
- Justificativa: Explicação para auditoria
Enviar Webhook
Enviar Webhook
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
Executar Integração
Executar Integração
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
Notificar Time
Notificar Time
Configuração:
- Canal: Email, Slack, Teams, SMS
- Destinatários: Times ou usuários específicos
- Template: Mensagem personalizada
Criar Investigação
Criar Investigação
Configuração:
- Prioridade: Low, Medium, High, Critical
- Tipo: Due Diligence, Enhanced DD, Adverse Media
- Atribuir a: Analista ou time
- Consolidar alertas: Agrupar alertas relacionados
Testando Regras
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: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
Gerenciar Alertas
Aprenda a revisar e resolver alertas gerados pelas regras
Configurar Webhooks
Integre alertas com seus sistemas existentes
Referência de API
Crie e gerencie regras via API
Casos de Uso KYB
Exemplos de regras para análise de empresas
Precisa de Ajuda?
- Documentação: Navegue por nossas guias completas
- Email: [email protected]
- Dashboard: Acesse sua conta em app.gu1.ai
Última atualização: Janeiro 2025