> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Aprenda a trocar entre ambiente de produção e sandbox para testar configurações com segurança — no painel gu1 com orientação passo a passo.

## Tutorial Interativo

<iframe src="https://clueso.site/embed/i8xd8wrx8zfkjod9" frameBorder="0" webkitallowfullscreen mozallowfullscreen allowFullScreen className="w-full aspect-video rounded-xl mb-6" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" />

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

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

<Tip>
  **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.
</Tip>

## Quando Usar Cada Ambiente

<CardGroup cols={2}>
  <Card title="Produção" icon="building" color="#10b981">
    **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
  </Card>

  <Card title="Sandbox" icon="flask" color="#f59e0b">
    **Testes e experimentação**

    * Testar novas regras
    * Validar integrações
    * Treinar novos analistas
    * Simular cenários complexos
    * Ajustar configurações
    * Desenvolver workflows personalizados
  </Card>
</CardGroup>

## Passos para Alternar

<Steps>
  <Step title="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)
  </Step>

  <Step title="Clique no Seletor">
    Clique no toggle ou dropdown para abrir o menu de seleção de ambientes.
  </Step>

  <Step title="Escolha o Ambiente">
    Selecione o ambiente para o qual deseja alternar:

    * **Production**: Para trabalhar com dados reais
    * **Sandbox**: Para testes e experimentação
  </Step>

  <Step title="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
  </Step>
</Steps>

<Warning>
  **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.
</Warning>

## Diferenças Entre Ambientes

### Dados Isolados

<Tabs>
  <Tab title="Produção">
    **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
  </Tab>

  <Tab title="Sandbox">
    **Dados de teste isolados**

    * Entidades criadas para teste
    * Alertas simulados
    * Histórico de experimentos
    * Integrações em modo de teste
    * Webhooks podem ser desabilitados ou redirecionados
  </Tab>
</Tabs>

### Regras e Configurações

<AccordionGroup>
  <Accordion title="Como funcionam as regras?" icon="gavel">
    **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**:

    ```bash theme={null}
    # Via interface
    Settings > Rules > [Selecione a regra] > Promote to Production

    # Via API
    POST /api/rules/{ruleId}/promote
    ```

    <Info>
      A promoção copia a regra do Sandbox para Produção, mas não ativa automaticamente. Você precisa ativar manualmente após promover.
    </Info>
  </Accordion>

  <Accordion title="Integrações são compartilhadas?" icon="plug">
    **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**
  </Accordion>

  <Accordion title="Webhooks são enviados nos dois ambientes?" icon="webhook">
    **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**

    ```json theme={null}
    {
      "sandbox": {
        "enabled": true,
        "redirectTo": "https://webhook-test.com/sandbox",
        "muteErrors": true
      }
    }
    ```
  </Accordion>

  <Accordion title="Usuários e times são os mesmos?" icon="users">
    **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.
  </Accordion>

  <Accordion title="Posso copiar dados entre ambientes?" icon="copy">
    **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**:

    ```bash theme={null}
    POST /api/entities/{entityId}/copy-to-sandbox
    {
      "includeRelationships": true,
      "includeDocuments": false,
      "anonymize": true
    }
    ```

    <Warning>
      **Privacidade**: Ao copiar para Sandbox, considere anonimizar dados sensíveis (CPF, emails, etc.) para proteger a privacidade dos clientes.
    </Warning>

    **Não é possível** copiar de Sandbox para Produção diretamente (por segurança). Você precisa recriar entidades manualmente ou via API.
  </Accordion>
</AccordionGroup>

## Indicadores Visuais

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

### No Dashboard

<CardGroup cols={3}>
  <Card title="Badge de Ambiente" icon="tag">
    **Canto superior direito**

    * 🟢 **PRODUCTION** (verde)
    * 🟡 **SANDBOX** (amarelo/laranja)
  </Card>

  <Card title="Cor de Fundo" icon="palette">
    **Sutil mudança de cor**

    * Produção: fundo padrão
    * Sandbox: leve tom amarelado/laranja no header
  </Card>

  <Card title="Favicon" icon="circle">
    **Ícone da aba do navegador**

    * Produção: logo padrão
    * Sandbox: logo com ponto laranja
  </Card>
</CardGroup>

### No Código (Para Desenvolvedores)

Se você está desenvolvendo integrações customizadas, pode detectar o ambiente:

```javascript theme={null}
// 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

<Steps>
  <Step title="Alterne para Sandbox">
    Clique no seletor e escolha **Sandbox**.
  </Step>

  <Step title="Crie a Regra">
    Vá em **Rules** > **Create Rule** e configure a nova regra.
  </Step>

  <Step title="Teste com Dados">
    * Use dados de teste existentes no Sandbox
    * Ou copie entidades reais de Produção (anonimizadas)
  </Step>

  <Step title="Valide os Resultados">
    Verifique se a regra gera os alertas esperados e não tem falsos positivos.
  </Step>

  <Step title="Promova para Produção">
    Quando estiver satisfeito: **Rules** > \[Sua regra] > **Promote to Production**.
  </Step>

  <Step title="Ative em Produção">
    Alterne para **Production** e ative a regra promovida.
  </Step>
</Steps>

### 2. Treinar Novo Analista

<Steps>
  <Step title="Crie Dados de Teste">
    No Sandbox, crie entidades fictícias representando diferentes cenários (PEP, fraude, etc.).
  </Step>

  <Step title="Configure Regras de Treinamento">
    Ative regras que gerem alertas para os cenários criados.
  </Step>

  <Step title="Convide o Analista">
    Adicione o novo membro com perfil **Viewer** inicialmente.
  </Step>

  <Step title="Oriente a Alternar para Sandbox">
    Mostre como alternar para Sandbox e explique que é um ambiente seguro.
  </Step>

  <Step title="Acompanhe o Progresso">
    Deixe o analista praticar revisão de alertas, criação de investigações, etc.
  </Step>

  <Step title="Promova para Produção">
    Quando estiver pronto, mude o perfil para **Analyst** e oriente a trabalhar em Produção.
  </Step>
</Steps>

### 3. Validar Integração

<Steps>
  <Step title="Configure no Sandbox">
    Vá em **Settings** > **Integrations** e configure a nova integração com credenciais de teste.
  </Step>

  <Step title="Execute Testes">
    Crie entidades de teste e execute a integração manualmente.
  </Step>

  <Step title="Verifique Logs">
    Revise os logs em **Settings** > **Integrations** > \[Integração] > **Logs**.
  </Step>

  <Step title="Ajuste Configurações">
    Corrija erros e refine parâmetros até funcionar perfeitamente.
  </Step>

  <Step title="Atualize Credenciais em Produção">
    Alterne para **Production** e atualize com credenciais reais.
  </Step>

  <Step title="Ative em Produção">
    Habilite a integração e monitore os primeiros usos.
  </Step>
</Steps>

## Boas Práticas

<CardGroup cols={2}>
  <Card title="Sempre Teste Primeiro" icon="flask-vial">
    **Sandbox → Produção**

    Nunca crie ou modifique regras diretamente em Produção. Sempre teste no Sandbox primeiro para evitar impactos negativos.
  </Card>

  <Card title="Verifique o Ambiente" icon="eye">
    **Antes de cada ação importante**

    Sempre confira o badge no canto superior direito antes de:

    * Criar regras
    * Executar integrações
    * Aprovar/rejeitar entidades
    * Exportar dados
  </Card>

  <Card title="Use Dados Realistas" icon="database">
    **Copie de Produção**

    Para testes mais precisos, copie entidades reais de Produção para Sandbox (anonimizadas). Isso garante que suas regras funcionem com dados reais.
  </Card>

  <Card title="Documente Testes" icon="memo">
    **Histórico de validações**

    Mantenha 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.
  </Card>
</CardGroup>

## Limites e Quotas

<Info>
  **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 [support@gueno.com](mailto:support@gueno.com)
</Info>

## Atalhos de Teclado

<Tip>
  **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
</Tip>

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso deletar todos os dados do Sandbox?">
    **Sim!** Você pode limpar o Sandbox completamente sem afetar Produção:

    **Settings** > **Sandbox** > **Reset Sandbox**

    Isso 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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Criar Regras" icon="gavel" href="/pt/tutoriais/criar-regras">
    Aprenda a criar e testar regras no Sandbox
  </Card>

  <Card title="Configurar Integrações" icon="plug" href="/pt/api-reference/integrations/provider-codes">
    Configure integrações com credenciais de teste
  </Card>

  <Card title="API de Ambientes" icon="code" href="/pt/api-reference/environments">
    Gerencie ambientes programaticamente
  </Card>

  <Card title="Promoção de Regras" icon="arrow-up-from-bracket" href="/pt/api-reference/environments">
    Guia completo sobre como promover configurações
  </Card>
</CardGroup>

## Precisa de Ajuda?

* **Documentação**: Navegue por nossas guias completas
* **Email**: [support@gueno.com](mailto:support@gueno.com)
* **Dashboard**: Acesse sua conta em [app.gu1.ai](https://app.gu1.ai)

***

**Última atualização**: Janeiro 2025