Skip to main content

​
Tutorial Interativo

Este vídeo é interativo. Você pode clicar nos elementos para navegar entre diferentes seções e aprender no seu próprio ritmo.

​
Visão Geral

O sistema de ambientes duplos do gu1 permite trabalhar com dois ambientes isolados dentro da mesma organização:
  • Produção: Dados reais, clientes ativos, regras em operação
  • Sandbox: Ambiente de testes seguro, dados isolados, experimentação livre
Vantagem: Teste novas regras, configurações e integrações no Sandbox antes de ativá-las em Produção, sem risco de afetar seus dados reais.

​
Quando Usar Cada Ambiente

Produção

Operação do dia a dia
  • Onboarding de clientes reais
  • Análise de alertas de produção
  • Investigações em andamento
  • Decisões de aprovação/rejeição
  • Integrações ativas
  • Webhooks em tempo real

Sandbox

Testes e experimentação
  • Testar novas regras
  • Validar integrações
  • Treinar novos analistas
  • Simular cenários complexos
  • Ajustar configurações
  • Desenvolver workflows personalizados

​
Passos para Alternar

1

Localize o Seletor de Ambiente

No canto superior direito do dashboard, ao lado do seu nome de usuário, você verá um toggle ou dropdown indicando o ambiente atual:
  • 🟢 Production (verde)
  • 🟡 Sandbox (amarelo/laranja)
2

Clique no Seletor

Clique no toggle ou dropdown para abrir o menu de seleção de ambientes.
3

Escolha o Ambiente

Selecione o ambiente para o qual deseja alternar:
  • Production: Para trabalhar com dados reais
  • Sandbox: Para testes e experimentação
4

Confirme a Mudança

O dashboard será recarregado automaticamente e você verá:
  • Indicador visual do ambiente atual
  • Badge no canto superior (Sandbox terá badge amarelo/laranja)
  • Dados correspondentes ao ambiente selecionado
Importante: Todas as suas ações (criar entidades, regras, alertas) acontecerão no ambiente atualmente selecionado. Sempre verifique o indicador antes de fazer mudanças críticas.

​
Diferenças Entre Ambientes

​
Dados Isolados

Dados reais de clientes
  • Entidades (pessoas, empresas) reais
  • Alertas e investigações ativos
  • Histórico completo de decisões
  • Integrações conectadas a sistemas reais
  • Webhooks enviados para endpoints de produção

​
Regras e Configurações

Cada ambiente tem suas próprias regras, mas você pode:
  1. Criar regra no Sandbox para testar
  2. Validar com dados de teste
  3. Promover para Produção quando estiver pronto
Promoção de regras:
# Via interface
Settings > Rules > [Selecione a regra] > Promote to Production

# Via API
POST /api/rules/{ruleId}/promote
A promoção copia a regra do Sandbox para Produção, mas não ativa automaticamente. Você precisa ativar manualmente após promover.
Configurações de integrações são compartilhadas, mas você pode:
  • Usar credenciais diferentes por ambiente
  • Desabilitar integrações no Sandbox
  • Configurar modo de teste para APIs externas
Exemplo: ComplyAdvantage
  • Produção: Credenciais reais, consultas cobradas
  • Sandbox: Credenciais de teste, consultas gratuitas (se disponível)
Configure em: Settings > Integrations > [Integração] > Environment Settings
Sim, mas você controla o comportamento:Produção:
  • Webhooks sempre ativos
  • Enviados para endpoints de produção
  • Falhas geram alertas críticos
Sandbox:
  • Webhooks podem ser desabilitados globalmente
  • Podem ser redirecionados para endpoints de teste
  • Falhas não geram alertas críticos
Configure em: Settings > Webhooks > Sandbox Behavior
{
  "sandbox": {
    "enabled": true,
    "redirectTo": "https://webhook-test.com/sandbox",
    "muteErrors": true
  }
}
Sim, usuários e times são compartilhados entre ambientes:
  • Mesmos membros da organização
  • Mesmas permissões e perfis
  • Mesmos times configurados
Mas: Cada usuário pode trabalhar independentemente em cada ambiente. Por exemplo:
  • Analista A está em Produção revisando alertas reais
  • Analista B está em Sandbox testando uma nova regra
Ambos podem trabalhar simultaneamente sem conflito.
Sim, você pode copiar dados de Produção para Sandbox para testes realistas:Via Interface:
  1. Vá para a entidade em Produção
  2. Clique em Actions > Copy to Sandbox
  3. A entidade (e opcionalmente seus relacionamentos) será copiada
Via API:
POST /api/entities/{entityId}/copy-to-sandbox
{
  "includeRelationships": true,
  "includeDocuments": false,
  "anonymize": true
}
Privacidade: Ao copiar para Sandbox, considere anonimizar dados sensíveis (CPF, emails, etc.) para proteger a privacidade dos clientes.
Não é possível copiar de Sandbox para Produção diretamente (por segurança). Você precisa recriar entidades manualmente ou via API.

​
Indicadores Visuais

Para evitar confusão, o gu1 oferece múltiplos indicadores visuais:

​
No Dashboard

Badge de Ambiente

Canto superior direito
  • 🟢 PRODUCTION (verde)
  • 🟡 SANDBOX (amarelo/laranja)

Cor de Fundo

Sutil mudança de cor
  • Produção: fundo padrão
  • Sandbox: leve tom amarelado/laranja no header

Favicon

Ícone da aba do navegador
  • Produção: logo padrão
  • Sandbox: logo com ponto laranja

​
No Código (Para Desenvolvedores)

Se você está desenvolvendo integrações customizadas, pode detectar o ambiente: 
// Via API
const response = await fetch('https://api.gu1.ai/me', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});
const { currentEnvironment } = await response.json();
console.log(currentEnvironment); // "production" ou "sandbox"

// Via SDK
import { GueoClient } from '@gueno/sdk';
const client = new GueoClient({ apiKey });
const environment = client.getCurrentEnvironment();

​
Casos de Uso Comuns

​
1. Testar Nova Regra

1

Alterne para Sandbox

Clique no seletor e escolha Sandbox.
2

Crie a Regra

Vá em Rules > Create Rule e configure a nova regra.
3

Teste com Dados

  • Use dados de teste existentes no Sandbox
  • Ou copie entidades reais de Produção (anonimizadas)
4

Valide os Resultados

Verifique se a regra gera os alertas esperados e não tem falsos positivos.
5

Promova para Produção

Quando estiver satisfeito: Rules > [Sua regra] > Promote to Production.
6

Ative em Produção

Alterne para Production e ative a regra promovida.

​
2. Treinar Novo Analista

1

Crie Dados de Teste

No Sandbox, crie entidades fictícias representando diferentes cenários (PEP, fraude, etc.).
2

Configure Regras de Treinamento

Ative regras que gerem alertas para os cenários criados.
3

Convide o Analista

Adicione o novo membro com perfil Viewer inicialmente.
4

Oriente a Alternar para Sandbox

Mostre como alternar para Sandbox e explique que é um ambiente seguro.
5

Acompanhe o Progresso

Deixe o analista praticar revisão de alertas, criação de investigações, etc.
6

Promova para Produção

Quando estiver pronto, mude o perfil para Analyst e oriente a trabalhar em Produção.

​
3. Validar Integração

1

Configure no Sandbox

Vá em Settings > Integrations e configure a nova integração com credenciais de teste.
2

Execute Testes

Crie entidades de teste e execute a integração manualmente.
3

Verifique Logs

Revise os logs em Settings > Integrations > [Integração] > Logs.
4

Ajuste Configurações

Corrija erros e refine parâmetros até funcionar perfeitamente.
5

Atualize Credenciais em Produção

Alterne para Production e atualize com credenciais reais.
6

Ative em Produção

Habilite a integração e monitore os primeiros usos.

​
Boas Práticas

Sempre Teste Primeiro

Sandbox → ProduçãoNunca crie ou modifique regras diretamente em Produção. Sempre teste no Sandbox primeiro para evitar impactos negativos.

Verifique o Ambiente

Antes de cada ação importanteSempre confira o badge no canto superior direito antes de:
  • Criar regras
  • Executar integrações
  • Aprovar/rejeitar entidades
  • Exportar dados

Use Dados Realistas

Copie de ProduçãoPara testes mais precisos, copie entidades reais de Produção para Sandbox (anonimizadas). Isso garante que suas regras funcionem com dados reais.

Documente Testes

Histórico de validaçõesMantenha um registro de:
  • Quais regras foram testadas
  • Quais cenários foram validados
  • Resultados obtidos
  • Ajustes realizados
Isso ajuda em auditorias e onboarding de novos membros.

​
Limites e Quotas

Sandbox tem limites diferentes de Produção para proteger recursos:
RecursoProduçãoSandbox
EntidadesIlimitado (plano)1.000
Alertas/mêsIlimitado (plano)500
Análises de IA/mêsConforme plano50
Integrações/diaIlimitado (plano)100
Webhooks/diaIlimitado200
Exportações/dia103
Para aumentar limites do Sandbox, entre em contato com support@gueno.com

​
Atalhos de Teclado

Produtividade: Use atalhos para alternar rapidamente entre ambientes:
  • g + e - Abrir seletor de ambiente
  • p - Alternar para Production (quando seletor aberto)
  • s - Alternar para Sandbox (quando seletor aberto)
  • ? - Ver todos os atalhos disponíveis

​
Perguntas Frequentes

Sim! Você pode limpar o Sandbox completamente sem afetar Produção:Settings > Sandbox > Reset SandboxIsso remove:
  • Todas as entidades de teste
  • Todos os alertas e investigações
  • Histórico de ações
Não remove:
  • Regras (você pode escolher manter ou deletar)
  • Configurações de integrações
  • Usuários e times
Incluído no seu plano, sem custo adicional!
  • Todos os planos (Starter, Professional, Enterprise) incluem Sandbox
  • Limites de quota são menores (ver tabela acima)
  • Análises de IA no Sandbox consomem do seu quota total
Não atualmente. Cada organização tem:
  • 1 ambiente de Produção
  • 1 ambiente de Sandbox
Se você precisa de múltiplos ambientes de teste, considere:
  • Criar uma organização separada
  • Usar branches de desenvolvimento (para integrações via API)
  • Contactar nosso time de Enterprise para soluções customizadas
Não há problema! Dados criados no Sandbox ficam isolados lá.Se você acidentalmente:
  • Criar entidades no Sandbox: não afeta Produção
  • Criar regras no Sandbox: não afeta Produção (até você promovê-las)
  • Executar integrações: usam credenciais de teste
Dica: Configure notificações de ambiente em Settings > Notifications para receber um lembrete ao alternar.

​
Próximos Passos

Criar Regras

Aprenda a criar e testar regras no Sandbox

Configurar Integrações

Configure integrações com credenciais de teste

API de Ambientes

Gerencie ambientes programaticamente

Promoção de Regras

Guia completo sobre como promover configurações

​
Precisa de Ajuda?

Última atualização: Janeiro 2025