Procesamiento en lote
Muchos trabajos son la misma tarea repetida sobre una lista: leer cada factura, resumir cada correo, clasificar cada fila. En NappAI no hace falta un bucle: activas Batch Mode en el componente y se ejecuta una vez por cada elemento de la lista que recibe.
En este vídeo, un flujo procesa las doce facturas de proveedor de una carpeta: lee cada PDF, saca sus datos con un agente, los comprueba con Python y deja un Excel y un resumen para contabilidad.
Cómo funciona
- Batch Mode está en la pestaña del mismo nombre de cada componente que lo admite. Activado, el componente muestra la entrada Batch Input: ahí conectas la lista.
- Cada campo puede ser Fixed (el mismo valor para todos) o Mapped: escribes entre llaves una clave del elemento, por ejemplo
{path}, y en cada ejecución toma el valor de ese elemento. También puedes mezclar texto y claves:{Factura {numero} de {proveedor}}. - Tras una ejecución, el panel Ejecución previa muestra un elemento real con sus claves: arrastra una al campo y queda mapeada.
- Parallel Executions dice cuántos elementos se procesan a la vez (3 por defecto).
- La salida de un componente en lote es otra lista, con un resultado por elemento. El siguiente componente puede seguir en lote o recibir la lista entera, por ejemplo para crear un Excel o escribir un resumen.
El ejemplo del vídeo
- Storage Files, operación List Files: los PDF de la carpeta
files/facturas-octubrede tu almacenamiento. Devuelve una lista. - Storage Files con Batch Mode, operación Get File: File Path mapeado a
{path}y Content en Text. Lee cada PDF como texto. - Agent con Batch Mode y salida estructurada (pestaña Output Format): de cada texto devuelve siempre los mismos campos (proveedor, NIF, número, fecha, categoría, base, IVA y total).
- Python Code con Batch Mode: comprueba que base más IVA dé el total, que el IVA sea el 21 % y que la factura sea del mes, y añade un campo
estado. - Dos ramas con la lista completa: XLS Writer crea el Excel y Storage Files (Upload Files) lo guarda en la misma carpeta; Data to JSON y un Prompt pasan todas las facturas a un segundo Agent, que escribe el resumen.
Show node outputs, en los ajustes de un componente, enseña su salida como tabla: una fila por elemento.
Consejos
- Prueba primero con pocos elementos y mira la tabla de salida de cada paso.
- Los cálculos y las comprobaciones, mejor en Python Code; deja al agente lo que necesita entender el texto.