Como Alternar entre Ambientes (Produção e Sandbox)

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

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)

Clique no Seletor

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

Escolha o Ambiente

Selecione o ambiente para o qual deseja alternar:

Production: Para trabalhar com dados reais
Sandbox: Para testes e experimentação

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

Produção
Sandbox

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

Como funcionam as regras?

Cada ambiente tem suas próprias regras, mas você pode:

Criar regra no Sandbox para testar
Validar com dados de teste
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.

Integrações são compartilhadas?

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

Webhooks são enviados nos dois ambientes?

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
  }
}

Usuários e times são os mesmos?

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.

Posso copiar dados entre ambientes?

Sim, você pode copiar dados de Produção para Sandbox para testes realistas:Via Interface:

Vá para a entidade em Produção
Clique em Actions > Copy to Sandbox
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

Alterne para Sandbox

Clique no seletor e escolha Sandbox.

Crie a Regra

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

Teste com Dados

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

Valide os Resultados

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

Promova para Produção

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

Ative em Produção

Alterne para Production e ative a regra promovida.

2. Treinar Novo Analista

Crie Dados de Teste

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

Configure Regras de Treinamento

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

Convide o Analista

Adicione o novo membro com perfil Viewer inicialmente.

Oriente a Alternar para Sandbox

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

Acompanhe o Progresso

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

Promova para Produção

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

3. Validar Integração

Configure no Sandbox

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

Execute Testes

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

Verifique Logs

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

Ajuste Configurações

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

Atualize Credenciais em Produção

Alterne para Production e atualize com credenciais reais.

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:

Recurso	Produção	Sandbox
Entidades	Ilimitado (plano)	1.000
Alertas/mês	Ilimitado (plano)	500
Análises de IA/mês	Conforme plano	50
Integrações/dia	Ilimitado (plano)	100
Webhooks/dia	Ilimitado	200
Exportações/dia	10	3

Para aumentar limites do Sandbox, entre em contato com [email protected]

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

Posso deletar todos os dados do Sandbox?

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

Quanto custa o ambiente Sandbox?

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

Posso ter mais de um Sandbox?

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

O que acontece se eu esquecer que estou no Sandbox?

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?

Documentação: Navegue por nossas guias completas
Email: [email protected]
Dashboard: Acesse sua conta em app.gu1.ai

Última atualização: Janeiro 2025

Começando

Referência API

Ingestão de Dados

Entidades

Conheça Seu Negócio (KYB)

Conheça Seu Cliente (KYC)

Monitoramento de Transações

Tutoriais Interativos

​Tutorial Interativo

​Visão Geral

​Quando Usar Cada Ambiente

Produção

Sandbox

​Passos para Alternar

​Diferenças Entre Ambientes

​Dados Isolados

​Regras e Configurações

​Indicadores Visuais

​No Dashboard

Badge de Ambiente

Cor de Fundo

Favicon

​No Código (Para Desenvolvedores)

​Casos de Uso Comuns

​1. Testar Nova Regra

​2. Treinar Novo Analista

​3. Validar Integração

​Boas Práticas

Sempre Teste Primeiro

Verifique o Ambiente

Use Dados Realistas

Documente Testes

​Limites e Quotas

​Atalhos de Teclado

​Perguntas Frequentes

​Próximos Passos

Criar Regras

Configurar Integrações

API de Ambientes

Promoção de Regras

​Precisa de Ajuda?

Tutorial Interativo

Visão Geral

Quando Usar Cada Ambiente

Passos para Alternar

Diferenças Entre Ambientes

Dados Isolados

Regras e Configurações

Indicadores Visuais

No Dashboard

No Código (Para Desenvolvedores)

Casos de Uso Comuns

1. Testar Nova Regra

2. Treinar Novo Analista

3. Validar Integração

Boas Práticas

Limites e Quotas

Atalhos de Teclado

Perguntas Frequentes

Próximos Passos

Precisa de Ajuda?