Saltearse al contenido

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

  1. Storage Files, operación List Files: los PDF de la carpeta files/facturas-octubre de tu almacenamiento. Devuelve una lista.
  2. Storage Files con Batch Mode, operación Get File: File Path mapeado a {path} y Content en Text. Lee cada PDF como texto.
  3. 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).
  4. 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.
  5. 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.