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

# Cómo Alternar entre Ambientes (Producción y Sandbox)

> Aprende a cambiar entre ambiente de producción y sandbox para probar configuraciones de forma segura — en el panel gu1 con guía paso a paso.

## Tutorial Interactivo

<Info>
  **Próximamente**: Vídeo interactivo con Clueso estará disponible aquí. Por ahora, sigue la guía paso a paso a continuación.
</Info>

## Visión General

El **sistema de ambientes duales** de gu1 te permite trabajar con dos ambientes aislados dentro de la misma organización:

* **Producción**: Datos reales, clientes activos, reglas en operación
* **Sandbox**: Ambiente de pruebas seguro, datos aislados, experimentación libre

<Tip>
  **Ventaja**: Prueba nuevas reglas, configuraciones e integraciones en Sandbox antes de activarlas en Producción, sin riesgo de afectar tus datos reales.
</Tip>

## Cuándo Usar Cada Ambiente

<CardGroup cols={2}>
  <Card title="Producción" icon="building" color="#10b981">
    **Operación del día a día**

    * Onboarding de clientes reales
    * Análisis de alertas de producción
    * Investigaciones en curso
    * Decisiones de aprobación/rechazo
    * Integraciones activas
    * Webhooks en tiempo real
  </Card>

  <Card title="Sandbox" icon="flask" color="#f59e0b">
    **Pruebas y experimentación**

    * Probar nuevas reglas
    * Validar integraciones
    * Entrenar nuevos analistas
    * Simular escenarios complejos
    * Ajustar configuraciones
    * Desarrollar workflows personalizados
  </Card>
</CardGroup>

## Pasos para Alternar

<Steps>
  <Step title="Localiza el Selector de Ambiente">
    En la esquina superior derecha del dashboard, al lado de tu nombre de usuario, verás un **toggle** o **dropdown** indicando el ambiente actual:

    * 🟢 **Production** (verde)
    * 🟡 **Sandbox** (amarillo/naranja)
  </Step>

  <Step title="Haz Clic en el Selector">
    Haz clic en el toggle o dropdown para abrir el menú de selección de ambientes.
  </Step>

  <Step title="Elige el Ambiente">
    Selecciona el ambiente al que deseas cambiar:

    * **Production**: Para trabajar con datos reales
    * **Sandbox**: Para pruebas y experimentación
  </Step>

  <Step title="Confirma el Cambio">
    El dashboard se recargará automáticamente y verás:

    * Indicador visual del ambiente actual
    * Badge en la esquina superior (Sandbox tendrá badge amarillo/naranja)
    * Datos correspondientes al ambiente seleccionado
  </Step>
</Steps>

<Warning>
  **Importante**: Todas tus acciones (crear entidades, reglas, alertas) ocurrirán en el ambiente actualmente seleccionado. Siempre verifica el indicador antes de hacer cambios críticos.
</Warning>

## Diferencias Entre Ambientes

### Datos Aislados

<Tabs>
  <Tab title="Producción">
    **Datos reales de clientes**

    * Entidades (personas, empresas) reales
    * Alertas e investigaciones activas
    * Historial completo de decisiones
    * Integraciones conectadas a sistemas reales
    * Webhooks enviados a endpoints de producción
  </Tab>

  <Tab title="Sandbox">
    **Datos de prueba aislados**

    * Entidades creadas para testing
    * Alertas simuladas
    * Historial de experimentos
    * Integraciones en modo de prueba
    * Webhooks pueden ser deshabilitados o redirigidos
  </Tab>
</Tabs>

### Reglas y Configuraciones

<AccordionGroup>
  <Accordion title="¿Cómo funcionan las reglas?" icon="gavel">
    **Cada ambiente tiene sus propias reglas**, pero puedes:

    1. **Crear regla en Sandbox** para probar
    2. **Validar** con datos de prueba
    3. **Promover a Producción** cuando esté lista

    **Promoción de reglas**:

    ```bash theme={null}
    # Vía interfaz
    Settings > Rules > [Selecciona la regla] > Promote to Production

    # Vía API
    POST /api/rules/{ruleId}/promote
    ```

    <Info>
      La promoción copia la regla de Sandbox a Producción, pero no la activa automáticamente. Necesitas activarla manualmente después de promoverla.
    </Info>
  </Accordion>

  <Accordion title="¿Las integraciones son compartidas?" icon="plug">
    **Las configuraciones de integraciones son compartidas**, pero puedes:

    * Usar credenciales diferentes por ambiente
    * Deshabilitar integraciones en Sandbox
    * Configurar modo de prueba para APIs externas

    **Ejemplo**: ComplyAdvantage

    * **Producción**: Credenciales reales, consultas cobradas
    * **Sandbox**: Credenciales de prueba, consultas gratuitas (si disponible)

    Configura en: **Settings** > **Integrations** > \[Integración] > **Environment Settings**
  </Accordion>

  <Accordion title="¿Los webhooks se envían en ambos ambientes?" icon="webhook">
    **Sí, pero controlas el comportamiento**:

    **Producción**:

    * Webhooks siempre activos
    * Enviados a endpoints de producción
    * Fallos generan alertas críticas

    **Sandbox**:

    * Webhooks pueden ser deshabilitados globalmente
    * Pueden ser redirigidos a endpoints de prueba
    * Fallos no generan alertas críticas

    Configura en: **Settings** > **Webhooks** > **Sandbox Behavior**

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

  <Accordion title="¿Usuarios y equipos son los mismos?" icon="users">
    **Sí, usuarios y equipos son compartidos** entre ambientes:

    * Mismos miembros de la organización
    * Mismos permisos y roles
    * Mismos equipos configurados

    **Pero**: Cada usuario puede trabajar independientemente en cada ambiente. Por ejemplo:

    * **Analista A** está en Producción revisando alertas reales
    * **Analista B** está en Sandbox probando una nueva regla

    Ambos pueden trabajar simultáneamente sin conflicto.
  </Accordion>

  <Accordion title="¿Puedo copiar datos entre ambientes?" icon="copy">
    **Sí, puedes copiar datos de Producción a Sandbox** para pruebas realistas:

    **Vía Interfaz**:

    1. Ve a la entidad en Producción
    2. Haz clic en **Actions** > **Copy to Sandbox**
    3. La entidad (y opcionalmente sus relaciones) será copiada

    **Vía API**:

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

    <Warning>
      **Privacidad**: Al copiar a Sandbox, considera anonimizar datos sensibles (DNI, emails, etc.) para proteger la privacidad de los clientes.
    </Warning>

    **No es posible** copiar de Sandbox a Producción directamente (por seguridad). Necesitas recrear entidades manualmente o vía API.
  </Accordion>
</AccordionGroup>

## Indicadores Visuales

Para evitar confusión, gu1 ofrece múltiples indicadores visuales:

### En el Dashboard

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

    * 🟢 **PRODUCTION** (verde)
    * 🟡 **SANDBOX** (amarillo/naranja)
  </Card>

  <Card title="Color de Fondo" icon="palette">
    **Cambio sutil de color**

    * Producción: fondo estándar
    * Sandbox: ligero tono amarillado/naranja en el header
  </Card>

  <Card title="Favicon" icon="circle">
    **Ícono de la pestaña del navegador**

    * Producción: logo estándar
    * Sandbox: logo con punto naranja
  </Card>
</CardGroup>

### En el Código (Para Desarrolladores)

Si estás desarrollando integraciones personalizadas, puedes detectar el ambiente:

```javascript theme={null}
// Vía API
const response = await fetch('https://api.gu1.ai/me', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});
const { currentEnvironment } = await response.json();
console.log(currentEnvironment); // "production" o "sandbox"

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

## Casos de Uso Comunes

### 1. Probar Nueva Regla

<Steps>
  <Step title="Cambia a Sandbox">
    Haz clic en el selector y elige **Sandbox**.
  </Step>

  <Step title="Crea la Regla">
    Ve a **Rules** > **Create Rule** y configura la nueva regla.
  </Step>

  <Step title="Prueba con Datos">
    * Usa datos de prueba existentes en Sandbox
    * O copia entidades reales de Producción (anonimizadas)
  </Step>

  <Step title="Valida los Resultados">
    Verifica si la regla genera las alertas esperadas y no tiene falsos positivos.
  </Step>

  <Step title="Promueve a Producción">
    Cuando estés satisfecho: **Rules** > \[Tu regla] > **Promote to Production**.
  </Step>

  <Step title="Activa en Producción">
    Cambia a **Production** y activa la regla promovida.
  </Step>
</Steps>

### 2. Entrenar Nuevo Analista

<Steps>
  <Step title="Crea Datos de Prueba">
    En Sandbox, crea entidades ficticias representando diferentes escenarios (PEP, fraude, etc.).
  </Step>

  <Step title="Configura Reglas de Entrenamiento">
    Activa reglas que generen alertas para los escenarios creados.
  </Step>

  <Step title="Invita al Analista">
    Agrega al nuevo miembro con rol **Viewer** inicialmente.
  </Step>

  <Step title="Orienta a Cambiar a Sandbox">
    Muestra cómo cambiar a Sandbox y explica que es un ambiente seguro.
  </Step>

  <Step title="Monitorea el Progreso">
    Deja que el analista practique revisión de alertas, creación de investigaciones, etc.
  </Step>

  <Step title="Promueve a Producción">
    Cuando esté listo, cambia el rol a **Analyst** y orienta a trabajar en Producción.
  </Step>
</Steps>

### 3. Validar Integración

<Steps>
  <Step title="Configura en Sandbox">
    Ve a **Settings** > **Integrations** y configura la nueva integración con credenciales de prueba.
  </Step>

  <Step title="Ejecuta Pruebas">
    Crea entidades de prueba y ejecuta la integración manualmente.
  </Step>

  <Step title="Verifica Logs">
    Revisa los logs en **Settings** > **Integrations** > \[Integración] > **Logs**.
  </Step>

  <Step title="Ajusta Configuraciones">
    Corrige errores y refina parámetros hasta que funcione perfectamente.
  </Step>

  <Step title="Actualiza Credenciales en Producción">
    Cambia a **Production** y actualiza con credenciales reales.
  </Step>

  <Step title="Activa en Producción">
    Habilita la integración y monitorea los primeros usos.
  </Step>
</Steps>

## Buenas Prácticas

<CardGroup cols={2}>
  <Card title="Siempre Prueba Primero" icon="flask-vial">
    **Sandbox → Producción**

    Nunca crees o modifiques reglas directamente en Producción. Siempre prueba en Sandbox primero para evitar impactos negativos.
  </Card>

  <Card title="Verifica el Ambiente" icon="eye">
    **Antes de cada acción importante**

    Siempre revisa el badge en la esquina superior derecha antes de:

    * Crear reglas
    * Ejecutar integraciones
    * Aprobar/rechazar entidades
    * Exportar datos
  </Card>

  <Card title="Usa Datos Realistas" icon="database">
    **Copia de Producción**

    Para pruebas más precisas, copia entidades reales de Producción a Sandbox (anonimizadas). Esto garantiza que tus reglas funcionen con datos reales.
  </Card>

  <Card title="Documenta Pruebas" icon="memo">
    **Historial de validaciones**

    Mantén un registro de:

    * Qué reglas fueron probadas
    * Qué escenarios fueron validados
    * Resultados obtenidos
    * Ajustes realizados

    Esto ayuda en auditorías y onboarding de nuevos miembros.
  </Card>
</CardGroup>

## Límites y Cuotas

<Info>
  **Sandbox tiene límites diferentes a Producción** para proteger recursos:

  | Recurso                | Producción       | Sandbox |
  | ---------------------- | ---------------- | ------- |
  | **Entidades**          | Ilimitado (plan) | 1.000   |
  | **Alertas/mes**        | Ilimitado (plan) | 500     |
  | **Análisis de IA/mes** | Según plan       | 50      |
  | **Integraciones/día**  | Ilimitado (plan) | 100     |
  | **Webhooks/día**       | Ilimitado        | 200     |
  | **Exportaciones/día**  | 10               | 3       |

  Para aumentar límites de Sandbox, contacta a [support@gueno.com](mailto:support@gueno.com)
</Info>

## Atajos de Teclado

<Tip>
  **Productividad**: Usa atajos para cambiar rápidamente entre ambientes:

  * `g + e` - Abrir selector de ambiente
  * `p` - Cambiar a Production (cuando selector abierto)
  * `s` - Cambiar a Sandbox (cuando selector abierto)
  * `?` - Ver todos los atajos disponibles
</Tip>

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo eliminar todos los datos del Sandbox?">
    **¡Sí!** Puedes limpiar el Sandbox completamente sin afectar Producción:

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

    Esto elimina:

    * Todas las entidades de prueba
    * Todas las alertas e investigaciones
    * Historial de acciones

    **No elimina**:

    * Reglas (puedes elegir mantener o eliminar)
    * Configuraciones de integraciones
    * Usuarios y equipos
  </Accordion>

  <Accordion title="¿Cuánto cuesta el ambiente Sandbox?">
    **¡Incluido en tu plan**, sin costo adicional!

    * Todos los planes (Starter, Professional, Enterprise) incluyen Sandbox
    * Los límites de cuota son menores (ver tabla arriba)
    * Los análisis de IA en Sandbox consumen de tu cuota total
  </Accordion>

  <Accordion title="¿Puedo tener más de un Sandbox?">
    **No actualmente**. Cada organización tiene:

    * 1 ambiente de Producción
    * 1 ambiente de Sandbox

    Si necesitas múltiples ambientes de prueba, considera:

    * Crear una organización separada
    * Usar branches de desarrollo (para integraciones vía API)
    * Contactar a nuestro equipo Enterprise para soluciones personalizadas
  </Accordion>

  <Accordion title="¿Qué pasa si olvido que estoy en Sandbox?">
    **¡No hay problema!** Los datos creados en Sandbox quedan aislados allí.

    Si accidentalmente:

    * Creas entidades en Sandbox: no afecta Producción
    * Creas reglas en Sandbox: no afecta Producción (hasta que las promuevas)
    * Ejecutas integraciones: usan credenciales de prueba

    **Consejo**: Configura notificaciones de ambiente en **Settings** > **Notifications** para recibir un recordatorio al cambiar.
  </Accordion>
</AccordionGroup>

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Crear Reglas" icon="gavel" href="/es/tutoriales/crear-reglas">
    Aprende a crear y probar reglas en Sandbox
  </Card>

  <Card title="Configurar Integraciones" icon="plug" href="/es/api-reference/integrations/provider-codes">
    Configura integraciones con credenciales de prueba
  </Card>

  <Card title="API de Ambientes" icon="code" href="/es/api-reference/environments">
    Gestiona ambientes programáticamente
  </Card>

  <Card title="Promoción de Reglas" icon="arrow-up-from-bracket" href="/es/api-reference/environments">
    Guía completa sobre cómo promover configuraciones
  </Card>
</CardGroup>

## ¿Necesitas Ayuda?

* **Documentación**: Navega por nuestras guías completas
* **Email**: [support@gueno.com](mailto:support@gueno.com)
* **Dashboard**: Accede a tu cuenta en [app.gu1.ai](https://app.gu1.ai)

***

**Última actualización**: Enero 2025