DaytonaSandbox

Bienvenido al nodo DaytonaSandbox dentro de Nappai. Imagínalo como una “caja de pruebas” o un entorno preparado específicamente para ejecutar tareas, gestionar procesos o probar integraciones de forma completamente segura. Su función principal es contener tus automatizaciones en un espacio aislado, garantizando que funcionen sin riesgo y manteniendo tus datos y sistemas originales intactos.

¿Cómo funciona?

Este componente actúa como un puente inteligente hacia un servicio externo de entornos virtuales seguros (conocidos como sandboxes). En lugar de realizar cálculos complejos por su cuenta, se conecta directamente a Daytona, una plataforma que levanta espacios de trabajo temporales en la nube. Cuando activas este nodo en tu flujo, el sistema crea un ambiente aislado, ejecuta las instrucciones que le asignes y, una vez terminado el proceso, cierra y destruye ese espacio automáticamente. Esto garantiza que no queden archivos residuales ni alteraciones en tus sistemas principales.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

1. Dirígete a la sección de Credenciales en tu panel de Nappai.
2. Crea una nueva credencial del tipo especificado para este componente y guarda los campos requeridos (claves de API, tokens, etc.).
3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Descripción de la credencial: Daytona cloud sandbox API key. You can get your API key from Daytona Dashboard

Entradas

Dado que la configuración de acceso y seguridad se maneja exclusivamente a través de la credencial de Daytona API, este nodo no requiere campos de entrada manuales adicionales. Su función es puramente estructural: una vez que tu flujo lo activa, se encarga de preparar y gestionar el entorno de ejecución de forma automática, delegando la lógica al sistema base de Nappai.

Salidas

Una vez que el entorno se prepara y ejecuta las instrucciones asignadas por tu flujo, el componente devolverá un resultado estructurado con el estado de la operación. Este resultado indica si el espacio de trabajo se creó correctamente, si se ejecutaron las tareas asignadas y devuelve cualquier dato o log generado dentro de ese entorno aislado, listo para ser utilizado por el siguiente paso de tu automatización.

Ejemplo de Respuesta JSONjson

{ “status”: “success”, “sandbox_id”: “dsb_x8k2m9p0”, “execution_log”: “Entorno inicializado y tareas ejecutadas correctamente.”, “output_data”: null, “timestamp”: “2024-05-20T14:32:00Z” }

Conectividad

Este nodo suele actuar como un punto de inicio o intermedio en flujos de automatización que requieren aislamiento. Es lógico enlazar su salida con componentes de análisis, almacenamiento de datos, base de datos o asistentes de IA que necesiten procesar información generada dentro de un entorno seguro. Su diseño permite fluir suavemente hacia nodos de validación, transformación o notificaciones, garantizando que los resultados se integren de forma segura en tu flujo principal de Nappai.

Ejemplo de Uso

Imagina que necesitas preparar un entorno para ejecutar un script de limpieza o probar una integración con una herramienta externa, pero no quieres arriesgar tus datos de producción. Al añadir DaytonaSandbox a tu flujo y conectar tu credencial, el sistema levantará automáticamente un espacio temporal. Una vez que otros nodos han procesado la información o ejecutado comandos dentro de ese espacio, este nodo devuelve el resultado final listo para ser guardado, analizado o enviado a un asistente de IA, manteniendo tu entorno principal organizado y sin cambios no deseados.

Consejos y Mejores Prácticas

• Verifica que tu clave de API de Daytona esté activa y tenga los permisos adecuados antes de armar tu flujo.
• Este nodo es ideal para automatizaciones que requieren un entorno limpio y temporal; para flujos de alta frecuencia, considera revisar los tiempos de espera y la optimización de recursos en el panel de Nappai.
• Monitorea los registros de ejecución en el dashboard de Nappai para asegurarte de que el entorno se cierra correctamente después de cada uso.

Consideraciones de Seguridad

El componente está diseñado específicamente para operar en un entorno aislado (sandbox), lo que minimiza drásticamente el riesgo de afectar accidentalmente tus datos o sistemas principales. Sin embargo, recuerda que cualquier proceso que se ejecute dentro de este espacio debe ser autorizado por tu equipo de TI. Evita almacenar información sensible directamente en los campos del flujo y confía en las políticas de cifrado y acceso que ofrece el servicio externo de Daytona. Siempre revisa la configuración de permisos en tu credencial para asegurar un uso responsable de la automatización.