Dividir documentos con el Split Agent en n8n

Hola y bienvenido a la PaperOffice AI Academy. Este episodio trata sobre el Split Agent en n8n: se introduce un escaneo por lotes y salen documentos individuales.

Resultado primero: Escaneo por lotes de entrada, documentos de salida

Veamos primero el resultado. Nuestro escaneo por lotes desde la sala de correo tiene siete páginas, con una hoja separadora en medio. El Split Agent reconoce dónde termina un documento y comienza el siguiente. Se devuelven cinco documentos, cada uno con su tipo, un nombre descriptivo y sus páginas. Así es como se ve en n8n. Para una prueba, inicio el flujo de trabajo en el editor y envío el archivo de escaneo por lotes al webhook. Ahora el flujo de trabajo se ejecuta nodo por nodo. El trabajo de división se envía a PaperOffice, y el bucle sigue verificando hasta que esté completo. Después de apenas cuarenta segundos, todo ha terminado. El nodo Pieces contiene el resultado: cinco entradas, una por documento. Estos son los cinco documentos: orden de compra, albarán de entrega, factura, boletín de servicio e informe de inspección. El boletín de servicio tiene dos páginas y ambas páginas permanecen juntas en un solo documento. El Split Agent detectó la hoja separadora en la página tres y la eliminó. Y cada documento recibe un nombre descriptivo basado en nuestra regla. Cada pieza es un PDF independiente. Aquí tiene el boletín de servicio: ambas páginas en un solo archivo, nombrado según nuestra norma. El resultado incluye el enlace de descarga, pero solo es válido por un breve período de tiempo. Aquí hay un segundo lote, más difícil: seis páginas en tres idiomas. Una orden de compra en inglés, una nota de entrega en español y una factura en español, una nota de crédito, una factura de flete con una mancha de café y una foto inclinada por teléfono móvil de una factura. El Split Agent separa las seis y las nombra de manera coherente en inglés. Y así es como lo construimos en cuatro etapas: entrada, división del trabajo, espera y piezas.

Etapa 1 de 4: Entrada

La primera etapa es la entrada: un webhook con autenticación en el encabezado que acepta el archivo mediante POST. Si falta el archivo, el flujo de trabajo responde inmediatamente con un error claro. ¿Y qué ocurre sin un archivo? Envío una solicitud sin un adjunto. El flujo de trabajo toma el camino corto a través del nodo Archivo faltante y responde inmediatamente con el estado 400 y un mensaje claro. No se crea ningún trabajo dividido, por lo que tampoco hay costos.

Etapa 2 de 4: El trabajo Split

La segunda etapa envía el lote al Split Agent, mediante una única llamada HTTP a la API de PaperOffice. Incluye la plantilla para dividir los documentos, el modelo Ultra y una regla para nombrar las partes: tipo de documento, fecha, remitente. En el campo de modelo, usted elige el alcance. Basic detecta los límites y nombra las partes. Premium también lee el tipo de documento, la fecha y el remitente. Ultra además proporciona el razonamiento para cada corte y ofrece una pista de auditoría. La facturación es por página. Dos factores determinan el precio: el alcance y la vía de procesamiento. Elegimos instantáneo, lo que significa un inicio inmediato. Sin garantía de inicio, sin SLA, cuesta menos. Puede encontrar los precios actuales en nuestro sitio web bajo Precios.

Etapa 3 de 4: Esperando

El trabajo se ejecuta en segundo plano. Cada seis segundos, el bucle verifica su estado. Cuando finaliza, la ejecución continúa. Si falla, la ejecución termina con un mensaje.

Etapa 4 de 4: Piezas

En la etapa cuatro, la respuesta se convierte en una lista, con una entrada por documento. Si alguna vez una hoja separadora se devuelve como un elemento independiente, este nodo la filtra. Finalmente, el webhook responde con exactamente esta lista. ¿Y qué ocurre con la lista a continuación? En el episodio principal sobre la bandeja de entrada, es exactamente aquí donde el bucle toma el control: cada documento se dirige al IDP Agent por su cuenta, se lee y se archiva en un Workspace. De esta manera, la división se convierte en el inicio de todo un flujo de trabajo.

Constrúyalo usted mismo: Credenciales y llamadas desde el exterior

Para construir esto usted mismo, necesita dos credenciales, ambas como autenticación de encabezado en n8n. Usted elige la clave para el webhook usted mismo, con un nombre de encabezado personalizado. Para PaperOffice, utiliza una clave API de su cuenta, en la sección de API y desarrolladores. Esta se incluye en el encabezado Authorization. Desde el exterior, se llama al flujo de trabajo con un POST a la URL del webhook: el archivo en el campo de archivo, la clave en el encabezado. Eso puede ser un script, otro programa o un segundo flujo de trabajo. Lo que se devuelve es la lista de documentos, lista para el siguiente paso. Tres consejos de la práctica. Primero: no necesita hojas separadoras; el Split Agent detecta los límites a partir del contenido. Segundo: establezca la regla de nomenclatura en el campo de instrucciones de nomenclatura, por ejemplo, fecha, remitente, tipo de documento. Y tercero: descargue las piezas rápidamente o archívelas de inmediato, ya que los enlaces caducan después de un breve período. Ese fue el Split Agent en n8n: un webhook, una llamada, un bucle y una lista. En PaperOffice, usted también puede iniciarlo directamente desde la lista de documentos. El vídeo principal de la bandeja de entrada muestra cómo continúan los documentos individuales a partir de ahí. Hasta la próxima vez en la PaperOffice AI Academy.