> ## 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 Crear y Configurar Reglas

> Tutorial interactivo para crear reglas de compliance y detección de riesgo — en el panel gu1 con guía paso a paso, con ejemplos para crear reglas.

## Tutorial Interactivo

<Info>
  **Video en producción**: Este tutorial tendrá un video interactivo de Clueso próximamente. Por ahora, sigue los pasos detallados a continuación.
</Info>

## Pasos para Crear una Regla

<Steps>
  <Step title="Accede al Motor de Reglas">
    Navega a **Rules** desde el menú lateral de tu dashboard.
  </Step>

  <Step title="Haz clic en Create Rule">
    En la esquina superior derecha, haz clic en **"Create Rule"** para abrir el constructor de reglas.
  </Step>

  <Step title="Configura la Información Básica">
    * **Nombre**: Dale un nombre descriptivo a tu regla
    * **Descripción**: Explica el propósito de la regla
    * **Categoría**: Selecciona KYC, KYB, AML, Fraud, etc.
    * **Severidad**: Define la importancia (Low, Medium, High, Critical)
  </Step>

  <Step title="Define las Condiciones">
    Usa el constructor visual o escribe código para definir cuándo se debe activar la regla:

    * Condiciones sobre atributos de entidades
    * Operadores lógicos (AND, OR, NOT)
    * Comparaciones (mayor que, menor que, igual a, etc.)
  </Step>

  <Step title="Configura las Acciones">
    Define qué sucede cuando se cumple la regla:

    * Crear una alerta
    * Enviar notificación
    * Actualizar risk score
    * Ejecutar webhook
    * Bloquear transacción
  </Step>

  <Step title="Prueba la Regla">
    Usa el simulador integrado para probar tu regla con datos de ejemplo antes de activarla.
  </Step>

  <Step title="Activa la Regla">
    Una vez probada, activa la regla para que comience a monitorear en tiempo real.
  </Step>
</Steps>

## Tipos de Reglas

<CardGroup cols={2}>
  <Card title="Reglas de Screening" icon="magnifying-glass">
    **Verificación de listas**

    * Sanciones (OFAC, ONU, UE)
    * PEPs (Personas Expuestas Políticamente)
    * Adverse Media
    * Listas personalizadas
  </Card>

  <Card title="Reglas de Comportamiento" icon="chart-line">
    **Análisis de patrones**

    * Transacciones inusuales
    * Cambios de comportamiento
    * Patrones de fraude
    * Actividad sospechosa
  </Card>

  <Card title="Reglas de Negocio" icon="briefcase">
    **Políticas corporativas**

    * Límites de transacción
    * Horarios permitidos
    * Geografías restringidas
    * Productos no permitidos
  </Card>

  <Card title="Reglas de Enriquecimiento" icon="database">
    **Obtención de datos**

    * APIs externas
    * Validación de documentos
    * Verificación de identidad
    * Scoring crediticio
  </Card>
</CardGroup>

## Constructor Visual vs. Código

<Tabs>
  <Tab title="Constructor Visual">
    Ideal para reglas simples y usuarios no técnicos:

    ```
    IF persona.age >= 18
    AND persona.country IN ["AR", "BR", "UY"]
    THEN create_alert("Mayor de edad en LATAM")
    ```

    * Drag & drop de condiciones
    * Validación en tiempo real
    * Templates predefinidos
  </Tab>

  <Tab title="Código (JavaScript)">
    Para reglas complejas y usuarios técnicos:

    ```javascript theme={null}
    // Detectar estructuración de depósitos
    const deposits = entity.transactions.filter(t => t.type === 'DEPOSIT');
    const last24h = deposits.filter(t =>
      Date.now() - t.timestamp < 86400000
    );

    if (last24h.length >= 5 &&
        last24h.every(d => d.amount < 10000)) {
      return {
        alert: true,
        severity: 'HIGH',
        reason: 'Posible estructuración: múltiples depósitos bajo límite'
      };
    }
    ```

    * Control total sobre la lógica
    * Acceso a APIs y librerías
    * Debugging avanzado
  </Tab>
</Tabs>

<Tip>
  **Mejores Prácticas**:

  * Comienza con reglas simples y ve agregando complejidad
  * Prueba siempre en modo simulación antes de activar
  * Documenta bien el propósito de cada regla
  * Revisa periódicamente el rendimiento de tus reglas
</Tip>

<Warning>
  Reglas mal configuradas pueden generar:

  * **Falsos positivos**: Demasiadas alertas innecesarias
  * **Falsos negativos**: No detectar riesgos reales
  * **Problemas de performance**: Reglas muy complejas pueden ralentizar el sistema
</Warning>

## Templates de Reglas Populares

<AccordionGroup>
  <Accordion title="Detección de PEPs" icon="user-shield">
    ```javascript theme={null}
    // Verificar si la persona es PEP
    if (entity.type === 'person' && entity.isPEP) {
      return {
        alert: true,
        severity: 'HIGH',
        category: 'PEP_DETECTED',
        message: `PEP detectado: ${entity.pepRole}`
      };
    }
    ```
  </Accordion>

  <Accordion title="Transacciones de Alto Valor" icon="dollar-sign">
    ```javascript theme={null}
    // Alerta para transacciones > $50,000
    if (entity.type === 'transaction' &&
        entity.amount > 50000) {
      return {
        alert: true,
        severity: 'MEDIUM',
        category: 'HIGH_VALUE_TRANSACTION',
        message: `Transacción de alto valor: $${entity.amount}`
      };
    }
    ```
  </Accordion>

  <Accordion title="País de Alto Riesgo" icon="globe">
    ```javascript theme={null}
    // Lista de países de alto riesgo
    const highRiskCountries = ['IR', 'KP', 'SY', 'VE'];

    if (highRiskCountries.includes(entity.countryCode)) {
      return {
        alert: true,
        severity: 'CRITICAL',
        category: 'HIGH_RISK_JURISDICTION',
        message: `Entidad de país de alto riesgo: ${entity.countryCode}`
      };
    }
    ```
  </Accordion>
</AccordionGroup>

## Tutoriales Relacionados

<CardGroup cols={2}>
  <Card title="Gestionar Alertas" icon="bell" href="/es/tutoriales/gestionar-alertas">
    Aprende a revisar y resolver alertas generadas por reglas
  </Card>

  <Card title="Referencia de API" icon="code" href="/es/api-reference/entities/overview">
    Documentación completa de la API para integraciones avanzadas
  </Card>
</CardGroup>

<Check>
  ¿Tienes dudas sobre cómo crear reglas personalizadas? Contáctanos en [support@gueno.com](mailto:support@gueno.com)
</Check>