Modal Sandbox

El componente Modal Sandbox actúa como un espacio seguro y controlado donde se ejecutan tus automatizaciones dentro de Nappai. Imagina este componente como una “sala de pruebas” o un entorno aislado donde puedes ejecutar código o procesos complejos sin afectar el resto de tu sistema.

Su propósito principal es garantizar que cada operación se ejecute de forma segura, respetando límites de recursos y manteniendo el aislamiento necesario para proteger la estabilidad de tu entorno de trabajo.

¿Cómo funciona?

Cuando conectas este componente a tu flujo, Nappai prepara un entorno virtual dedicado (basado en la infraestructura de Modal) para ejecutar las instrucciones que le proporciones.

Preparación del Entorno: Al activar el componente, se asignan los recursos necesarios (como memoria y tiempo de procesamiento) según la configuración que definas.
Ejecución Aislada: El código o proceso se ejecuta en una “caja fuerte” virtual. Esto significa que cualquier error o comportamiento inesperado se queda contenido dentro de este sandbox y no interfiere con tus otros flujos o datos.
Delegación Inteligente: Este componente funciona en conjunto con la lógica base del sistema, delegando la gestión de seguridad y rendimiento para que tú solo te preocupes por los resultados.
Retorno de Resultados: Una vez finalizada la ejecución, el componente devuelve los resultados (éxito, errores o datos procesados) para que puedas continuar con los siguientes pasos de tu automatización.

Básicamente, es el “motor seguro” que permite que tus scripts y automatizaciones corran con confianza.

Conexión y Credenciales

Para que Modal Sandbox pueda funcionar correctamente y conectarse a la infraestructura de ejecución en la nube, es necesario configurar una credencial de Modal API.

Sigue estos pasos para configurarla:

Dirígete a la sección de Credenciales en el panel de Nappai.
Crea una nueva credencial del tipo Modal API.
Ingresa los datos requeridos por Modal (Generalmente el Modal Token ID y el Modal Token Secret que obtienes desde tu perfil en la web de Modal).
Guarda la credencial.
Vuelve a tu flujo de trabajo y, en el campo Credential de este componente, selecciona la credencial que acabas de crear.

Nota: Sin una credencial válida y configurada, el componente no podrá iniciar el entorno de ejecución y el flujo se detendrá.

Entradas

Los siguientes campos están disponibles para configurar este componente. Estos parámetros definen cómo se comportará el entorno de ejecución y qué datos se usarán durante el proceso.

Environment Configuration: Define los límites y parámetros del entorno de seguridad. Aquí puedes especificar restricciones de memoria, tiempo de ejecución o permisos si es necesario.
- Tipo: Diccionario (Configuración avanzada)
Context Data: Contiene variables de estado, metadatos de la sesión o parámetros de entrada que el proceso necesita para funcionar correctamente.
- Tipo: Objeto / Diccionario

Salidas

Después de ejecutar el proceso, el componente devuelve un resultado que puedes conectar a otros nodos de tu flujo.

Sandbox Result: Es un objeto que encapsula el resultado final de la ejecución. Puede incluir el valor de retorno, el estado (éxito/error), logs de auditoría y detalles sobre la ejecución (como el tiempo utilizado).

Ejemplo de Respuesta JSON

El siguiente es un ejemplo de cómo se estructura la salida que recibirás al ejecutarse el componente correctamente: json { “status”: “success”, “execution_id”: “modal_exec_9f8e7d”, “result_data”: { “processed_output”: “Automatización completada exitosamente”, “metrics”: { “memory_used_mb”: 45, “execution_time_seconds”: 1.2 } }, “logs”: [ “Iniciando entorno…”, “Ejecutando código…”, “Código finalizado sin errores” ] }

Conectividad

Este componente es ideal para intercalar en flujos de trabajo donde requieras una capa extra de seguridad o where necesites ejecutar scripts que podrían ser intensivos en recursos.

Conexión Entrante: Suele recibir datos de componentes que generan scripts, transformaciones de datos complejas o validaciones previas que necesitan ser aisladas.
Conexión Saliente: Su salida (Sandbox Result) suele conectarse a:
- Componentes de Procesamiento de Datos que requieran los resultados seguros.
- Componentes de Validación para verificar que la ejecución fue exitosa.
- Componentes de Notificación para avisar si hubo errores en el entorno aislado.

Es el puente perfecto entre la preparación de datos y la ejecución final segura.

Ejemplo de Uso

Escenario: Imagina que quieres automatizar el cálculo de un informe financiero utilizando un script en Python. Para evitar que un error en el script afecte todo tu sistema, usas este componente.

Entrada: Conectas los datos del cliente y el script Python al Modal Sandbox.
Configuración: Asegúras de tener configurada la credencial Modal API.
Ejecución: El componente ejecuta el script en su entorno aislado.
Salida: Recibes el Sandbox Result. Si el cálculo fue correcto, extraes los valores financieros para enviarlos por email. Si hubo un error en el código, el resultado te indicará el problema sin romper el flujo.

Este enfoque te permite experimentar y automatizar con mayor tranquilidad, sabiendo que el entorno está protegido.

Consejos y Mejores Prácticas

Valida tu Código: Aunque el sandbox es seguro, asegúrate de que el código que le envías sea eficiente para evitar tiempos de ejecución largos.
Gestiona los Recursos: Si tu automatización es muy pesada, revisa la configuración del entorno para asegurar que tenga suficientes recursos asignados.
Monitorea los Logs: El Sandbox Result incluye logs útiles. Úsalos para depurar errores si la automatización no se comporta como esperabas.
Reutiliza Credenciales: Una vez configurada la credencial Modal API, puedes reutilizarla en múltiples nodos de Modal Sandbox sin necesidad de volverla a ingresar.

Consideraciones de Seguridad

Aislamiento Total: El componente garantiza que el código no pueda acceder a recursos externos no autorizados ni afectar el estado global de Nappai.
Límites de Recursos: El entorno está sujeto a límites de memoria y tiempo definidos por la infraestructura subyacente para prevenir consumos excesivos.
Credenciales Seguras: Asegúrate de mantener tus credenciales de Modal API privadas y no compartirlas públicamente.