RunloopSandbox

Este componente actúa como un entorno seguro y aislado (similar a un “cuarto de pruebas” o sandbox) diseñado para gestionar el ciclo de vida de procesos que se repiten o de agentes autónomos. Su función principal es preparar el contexto, asegurar la configuración y delegar la lógica de ejecución a los servicios de Runloop, garantizando que tus automatizaciones funcionen de forma estable y predecible.

Piensa en RunloopSandbox como el contenedor inteligente que organiza y protege la ejecución de tus flujos de trabajo complejos.

¿Cómo funciona?

Internamente, este componente funciona como un “wrapper” o envoltorio ligero. No procesa datos por su cuenta, sino que actúa como un intermediario que:

1. Prepara el entorno: Recibe la configuración y el contexto necesarios para la ejecución.
2. Delega la acción: Transfiere la lógica de ejecución a la plataforma de Runloop mediante la credencial API configurada.
3. Gestiona el ciclo de vida: Asegura que el proceso se inicie correctamente, se ejecute según las reglas establecidas y finalice de manera ordenada, liberando recursos al terminar.

Es ideal para escenarios donde necesitas ejecutar bucles iterativos o procesos automatizados que requieren un entorno controlado y aislado para evitar interferencias con otras partes de tu sistema.

Conexión y Credenciales

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

1. Dirígete a la sección de Credenciales en tu panel de Nappai.
2. Crea una nueva credencial del tipo Runloop API y guarda tu clave de API proporcionada por la plataforma.
3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente:

• Credential: Selección de la credencial Runloop API que contiene la clave de autenticación necesaria para ejecutar los procesos.
  • Visible en: Todas las operaciones

Salidas

Este componente devuelve un objeto de estado que encapsula el resultado de la ejecución, metadatos de control y logs de depuración.

Al finalizar, podrás acceder a información como el estatus de la ejecución (status), los resultados generados (output), el tiempo transcurrido (elapsed_time) y el número de iteraciones realizadas. Esta salida es fundamental para el siguiente paso de tu flujo, permitiendo tomar decisiones basadas en el éxito o fallo del proceso.

Ejemplo de Respuesta JSON

json { “status”: “completed”, “output”: { “data_processed”: true, “summary”: “Procesamiento finalizado exitosamente” }, “elapsed_time”: 2.45, “iteration_count”: 1, “logs”: [ { “level”: “info”, “message”: “Inicialización del sandbox completada” }, { “level”: “info”, “message”: “Ejecución del bucle finalizada” } ] }

Conectividad

Este componente suele conectarse a nodos de tipo Trigger o Agente que inician flujos de trabajo iterativos. Su salida se conecta lógicamente a nodos de Procesamiento de Datos, Validación o Almacenamiento, ya que proporciona el estado final y los resultados generados por el bucle de ejecución.

Es común utilizar su campo de salida output para mapear datos a componentes posteriores que necesiten consumir los resultados del proceso automatizado.

Ejemplo de Uso

Escenario: Automatización de procesamiento de archivos en lotes.

Imagina que necesitas procesar una lista de documentos. Puedes utilizar RunloopSandbox como el entorno donde se ejecuta el agente o bucle que recorre cada archivo. La credencial Runloop API permite al sandbox acceder a las herramientas necesarias para leer y transformar los datos. Al finalizar, el componente devuelve un estado completed junto con el resumen de los archivos procesados, que luego puedes enviar a un nodo de Envío de Correo para notificar al usuario.

Consejos y Mejores Prácticas

• Monitoreo: Verifica los logs y el estado de salida para asegurar que las ejecuciones iterativas se completen sin errores.
• Seguridad: Asegúrate de utilizar credenciales con los permisos mínimos necesarios para el proceso.
• Optimización: Configura adecuadamente los límites de iteración y tiempo si son disponibles en el contexto de tu flujo para evitar ejecuciones prolongadas.

Consideraciones de Seguridad

El aislamiento proporcionado por el entorno sandbox ayuda a mitigar riesgos al ejecutar código o procesos externos. Sin embargo, es crucial proteger la Runloop API Key en la sección de credenciales y evitar exponer salidas sensibles en logs públicos.