Loop
El bloque Loop es un bloque contenedor en Sim que permite crear flujos de trabajo iterativos ejecutando un grupo de bloques repetidamente. Los bucles permiten el procesamiento iterativo en tus flujos de trabajo.
El bloque Loop admite cuatro tipos de iteración:
Los bloques Loop son nodos contenedores que pueden albergar otros bloques dentro de ellos. Los bloques dentro de un bucle se ejecutarán múltiples veces según tu configuración.
Descripción general
El bloque Loop te permite:
Iterar sobre colecciones: Procesar arrays u objetos un elemento a la vez
Repetir operaciones: Ejecutar bloques un número fijo de veces
Bucles con condiciones: Continuar ejecutando mientras o hasta que se cumpla una condición
Agregar resultados: Recopilar salidas de todas las iteraciones del bucle
Cómo funciona
El bloque Loop ejecuta los bloques contenidos a través de iteración secuencial:
- Inicializar bucle - Configurar parámetros de iteración (contador o colección)
- Ejecutar iteración - Ejecutar bloques contenidos para la iteración actual
- Recopilar resultados - Almacenar la salida de cada iteración
- Continuar o completar - Pasar a la siguiente iteración o finalizar el bucle
Opciones de configuración
Tipo de bucle
Elige entre cuatro tipos de bucles:
Bucle For (Iteraciones) - Un bucle numérico que se ejecuta un número fijo de veces:
Úsalo cuando necesites repetir una operación un número específico de veces.
Example: Run 5 times
- Iteration 1
- Iteration 2
- Iteration 3
- Iteration 4
- Iteration 5Bucle ForEach (Colección) - Un bucle basado en colecciones que itera sobre cada elemento en un array u objeto:
Úsalo cuando necesites procesar una colección de elementos.
Example: Process ["apple", "banana", "orange"]
- Iteration 1: Process "apple"
- Iteration 2: Process "banana"
- Iteration 3: Process "orange"Bucle While (Basado en condición) - Continúa ejecutándose mientras una condición se evalúe como verdadera:
Úsalo cuando necesites hacer un bucle hasta que se cumpla una condición específica. La condición se comprueba antes de cada iteración.
Example: While <variable.i> < 10
- Check condition → Execute if true
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Execute if true
- Check condition → Exit if falseBucle Do-While (Basado en condición) - Se ejecuta al menos una vez, luego continúa mientras una condición sea verdadera:
Úsalo cuando necesites ejecutar al menos una vez, luego hacer un bucle hasta que se cumpla una condición. La condición se comprueba después de cada iteración.
Example: Do-while <variable.i> < 10
- Execute blocks
- Inside loop: Increment <variable.i>
- Inside loop: Variables assigns i = <variable.i> + 1
- Check condition → Continue if true
- Check condition → Exit if falseCómo usar los bucles
Creando un bucle
- Arrastra un bloque Loop desde la barra de herramientas a tu lienzo
- Configura el tipo de bucle y los parámetros
- Arrastra otros bloques dentro del contenedor del bucle
- Conecta los bloques según sea necesario
Acceso a los resultados
Después de que un bucle se completa, puedes acceder a los resultados agregados:
<loop.results>: Array de resultados de todas las iteraciones del bucle
Ejemplos de casos de uso
Procesamiento de resultados de API
Escenario: Procesar múltiples registros de clientes
- El bloque API obtiene la lista de clientes
- El bucle ForEach itera sobre cada cliente
- Dentro del bucle: El agente analiza los datos del cliente
- Dentro del bucle: La función almacena los resultados del análisis
Generación iterativa de contenido
Escenario: Generar múltiples variaciones
- Configurar bucle For para 5 iteraciones
- Dentro del bucle: El agente genera una variación de contenido
- Dentro del bucle: El evaluador puntúa el contenido
- Después del bucle: La función selecciona la mejor variación
Contador con bucle While
Escenario: Procesar elementos con bucle basado en contador
- Inicializar variable de flujo de trabajo:
i = 0 - Bucle While con condición:
<variable.i>< 10 - Dentro del bucle: El agente procesa el elemento en el índice
<variable.i> - Dentro del bucle: La variable incrementa
i = <variable.i> + 1 - El bucle continúa mientras i sea menor que 10
Características avanzadas
Limitaciones
Los bloques contenedores (Bucles y Paralelos) no pueden anidarse dentro de otros. Esto significa:
- No puedes colocar un bloque de Bucle dentro de otro bloque de Bucle
- No puedes colocar un bloque Paralelo dentro de un bloque de Bucle
- No puedes colocar ningún bloque contenedor dentro de otro bloque contenedor
Si necesitas iteración multidimensional, considera reestructurar tu flujo de trabajo para usar bucles secuenciales o procesar datos por etapas.
Los bucles se ejecutan secuencialmente, no en paralelo. Si necesitas ejecución concurrente, usa el bloque Paralelo en su lugar.
Entradas y salidas
Tipo de bucle: Elige entre 'for', 'forEach', 'while', o 'doWhile'
Iteraciones: Número de veces a ejecutar (bucles for)
Colección: Array u objeto sobre el que iterar (bucles forEach)
Condición: Expresión booleana a evaluar (bucles while/do-while)
loop.currentItem: Elemento actual que se está procesando
loop.index: Número de iteración actual (base 0)
loop.items: Colección completa (bucles forEach)
loop.results: Array de todos los resultados de iteración
Estructura: Los resultados mantienen el orden de iteración
Acceso: Disponible en bloques después del bucle
Mejores prácticas
- Establece límites razonables: Mantén el número de iteraciones razonable para evitar tiempos de ejecución largos
- Usa ForEach para colecciones: Cuando proceses arrays u objetos, usa bucles ForEach en lugar de bucles For
- Maneja los errores con elegancia: Considera añadir manejo de errores dentro de los bucles para flujos de trabajo robustos