Skip to main content

​
Tutorial Interactivo

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

​
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
Ventaja: Prueba nuevas reglas, configuraciones e integraciones en Sandbox antes de activarlas en Producción, sin riesgo de afectar tus datos reales.

​
Cuándo Usar Cada Ambiente

Producción

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

Sandbox

Pruebas y experimentación
  • Probar nuevas reglas
  • Validar integraciones
  • Entrenar nuevos analistas
  • Simular escenarios complejos
  • Ajustar configuraciones
  • Desarrollar workflows personalizados

​
Pasos para Alternar

1

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)
2

Haz Clic en el Selector

Haz clic en el toggle o dropdown para abrir el menú de selección de ambientes.
3

Elige el Ambiente

Selecciona el ambiente al que deseas cambiar:
  • Production: Para trabajar con datos reales
  • Sandbox: Para pruebas y experimentación
4

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

​
Diferencias Entre Ambientes

​
Datos Aislados

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

​
Reglas y Configuraciones

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:
# Vía interfaz
Settings > Rules > [Selecciona la regla] > Promote to Production

# Vía API
POST /api/rules/{ruleId}/promote
La promoción copia la regla de Sandbox a Producción, pero no la activa automáticamente. Necesitas activarla manualmente después de promoverla.
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
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
{
  "sandbox": {
    "enabled": true,
    "redirectTo": "https://webhook-test.com/sandbox",
    "muteErrors": true
  }
}
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.
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:
POST /api/entities/{entityId}/copy-to-sandbox
{
  "includeRelationships": true,
  "includeDocuments": false,
  "anonymize": true
}
Privacidad: Al copiar a Sandbox, considera anonimizar datos sensibles (DNI, emails, etc.) para proteger la privacidad de los clientes.
No es posible copiar de Sandbox a Producción directamente (por seguridad). Necesitas recrear entidades manualmente o vía API.

​
Indicadores Visuales

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

​
En el Dashboard

Badge de Ambiente

Esquina superior derecha
  • 🟢 PRODUCTION (verde)
  • 🟡 SANDBOX (amarillo/naranja)

Color de Fondo

Cambio sutil de color
  • Producción: fondo estándar
  • Sandbox: ligero tono amarillado/naranja en el header

Favicon

Ícono de la pestaña del navegador
  • Producción: logo estándar
  • Sandbox: logo con punto naranja

​
En el Código (Para Desarrolladores)

Si estás desarrollando integraciones personalizadas, puedes detectar el ambiente: 
// 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

1

Cambia a Sandbox

Haz clic en el selector y elige Sandbox.
2

Crea la Regla

Ve a Rules > Create Rule y configura la nueva regla.
3

Prueba con Datos

  • Usa datos de prueba existentes en Sandbox
  • O copia entidades reales de Producción (anonimizadas)
4

Valida los Resultados

Verifica si la regla genera las alertas esperadas y no tiene falsos positivos.
5

Promueve a Producción

Cuando estés satisfecho: Rules > [Tu regla] > Promote to Production.
6

Activa en Producción

Cambia a Production y activa la regla promovida.

​
2. Entrenar Nuevo Analista

1

Crea Datos de Prueba

En Sandbox, crea entidades ficticias representando diferentes escenarios (PEP, fraude, etc.).
2

Configura Reglas de Entrenamiento

Activa reglas que generen alertas para los escenarios creados.
3

Invita al Analista

Agrega al nuevo miembro con rol Viewer inicialmente.
4

Orienta a Cambiar a Sandbox

Muestra cómo cambiar a Sandbox y explica que es un ambiente seguro.
5

Monitorea el Progreso

Deja que el analista practique revisión de alertas, creación de investigaciones, etc.
6

Promueve a Producción

Cuando esté listo, cambia el rol a Analyst y orienta a trabajar en Producción.

​
3. Validar Integración

1

Configura en Sandbox

Ve a Settings > Integrations y configura la nueva integración con credenciales de prueba.
2

Ejecuta Pruebas

Crea entidades de prueba y ejecuta la integración manualmente.
3

Verifica Logs

Revisa los logs en Settings > Integrations > [Integración] > Logs.
4

Ajusta Configuraciones

Corrige errores y refina parámetros hasta que funcione perfectamente.
5

Actualiza Credenciales en Producción

Cambia a Production y actualiza con credenciales reales.
6

Activa en Producción

Habilita la integración y monitorea los primeros usos.

​
Buenas Prácticas

Siempre Prueba Primero

Sandbox → ProducciónNunca crees o modifiques reglas directamente en Producción. Siempre prueba en Sandbox primero para evitar impactos negativos.

Verifica el Ambiente

Antes de cada acción importanteSiempre revisa el badge en la esquina superior derecha antes de:
  • Crear reglas
  • Ejecutar integraciones
  • Aprobar/rechazar entidades
  • Exportar datos

Usa Datos Realistas

Copia de ProducciónPara pruebas más precisas, copia entidades reales de Producción a Sandbox (anonimizadas). Esto garantiza que tus reglas funcionen con datos reales.

Documenta Pruebas

Historial de validacionesManté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.

​
Límites y Cuotas

Sandbox tiene límites diferentes a Producción para proteger recursos:
RecursoProducciónSandbox
EntidadesIlimitado (plan)1.000
Alertas/mesIlimitado (plan)500
Análisis de IA/mesSegún plan50
Integraciones/díaIlimitado (plan)100
Webhooks/díaIlimitado200
Exportaciones/día103
Para aumentar límites de Sandbox, contacta a [email protected]

​
Atajos de Teclado

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

​
Preguntas Frecuentes

¡Sí! Puedes limpiar el Sandbox completamente sin afectar Producción:Settings > Sandbox > Reset SandboxEsto 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
¡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
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
¡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.

​
Próximos Pasos

Crear Reglas

Aprende a crear y probar reglas en Sandbox

Configurar Integraciones

Configura integraciones con credenciales de prueba

API de Ambientes

Gestiona ambientes programáticamente

Promoción de Reglas

Guía completa sobre cómo promover configuraciones

​
¿Necesitas Ayuda?

Última actualización: Enero 2025