Razdvajanje dokumenata pomoću alata Split Agent u okruženju n8n

Dobrodošli u akademiju PaperOffice AI. Ova epizoda bavi se Split Agent u n8n: ulazi grupni sken, a izlaze pojedinačni dokumenti.

Prvo rezultat: Grupni sken ulazi, dokumenti izlaze

Pogledajmo prvo rezultat. Naš grupni sken iz pošte ima sedam strana, sa razdvajajućim listom između. Split Agent prepoznaje gde jedan dokument završava i gde drugi počinje. Vraća se pet dokumenata, svaki sa svojim tipom, opisnim imenom i stranama. Evo kako to izgleda u n8n. Za test pokrećem radni tok u editoru i šaljem grupni sken na webhook. Sada radni tok teče čvor po čvor. Zadatak razdvajanja ide na PaperOffice, a petlja stalno proverava dok se ne završi. Nakon nešto manje od četrdeset sekundi, sve je završeno. Čvor Pieces čuva rezultat: pet unosa, jedan po dokumentu. To su ovi dokumenti: nalog za kupovinu, tovarni list, faktura, servisni bilten i izveštaj o inspekciji. Servisni bilten ima dve strane i one ostaju zajedno. Split Agent je detektovao razdvajajući list na trećoj strani i uklonio ga. Svaki dokument dobija opisno ime na osnovu našeg pravila. Svaki deo je zaseban PDF. Evo servisnog biltena: obe strane u jednom fajlu, imenovane prema našem pravilu. Rezultat uključuje link za preuzimanje, ali on važi samo kratko vreme. Evo drugog grupnog skena, težeg: šest strana na tri jezika. Engleski nalog za kupovinu, španski tovarni list i španska faktura, kreditni bilten, faktura za transport sa mrljom od kafe i kriva telefonska fotografija fakture. Split Agent razdvaja svih šest i imenuje ih konzistentno na engleskom. I tako to gradimo, u četiri faze: unos, zadatak razdvajanja, čekanje i delovi.

Faza 1 od 4: Unos

Prva faza je unos: webhook sa autentifikacijom zaglavlja koji prihvata fajl putem POST. Ako fajl nedostaje, radni tok odmah odgovara jasnom greškom. A šta se dešava bez fajla? Šaljem zahtev bez priloga. Radni tok prolazi kratkim putem kroz čvor “Fajl nedostaje” i odmah odgovara statusom 400 i jasnom porukom. Ne kreira se zadatak razdvajanja, pa nema ni troškova.

Faza 2 od 4: Zadatak razdvajanja

Druga faza šalje paket na Split Agent, sa jednim HTTP pozivom na PaperOffice API. Ona uključuje razdvojenu predlošku, model Ultra i pravilo za imenovanje delova: vrsta dokumenta, datum, pošiljalac. U polju modela birate opseg. Basic detektuje granice i imenuje delove. Premium takođe čita vrstu dokumenta, datum i pošiljaoca. Ultra dodatno daje obrazloženje za svako sečenje i obezbeđuje trag revizije. Naplata je po stranici. Dve stvari određuju cenu: opseg i traka za obradu. Izabrali ste trenutni, što znači neposredan početak. Bez garancije početka, bez SLA, košta manje. Trenutne cene možete pronaći na našoj web stranici pod Cenovnik.

Faza 3 od 4: Čekanje

Zadatak se izvršava u pozadini. Svake šest sekundi petlja proverava njegov status. Kada je završen, izvršenje se nastavlja. Ako dođe do greške, izvršenje se završava porukom.

Faza 4 od 4: Delovi

U četvrtoj fazi, odgovor postaje lista, po jedan unos po dokumentu. Ako se odvojni list ikada vrati kao zaseban deo, ovaj čvor ga filtrira. Na kraju, webhook odgovara tačno ovom listom. Šta se dalje dešava sa listom? U glavnom videu na sandučetu, ovde tačno preuzima kontrolu petlja: svaki dokument ide na IDP Agent zasebno, čita se i arhivira u Workspace. Na taj način, razdvajanje postaje početak celog radnog toka.

Izgradite sami: Poverljivi podaci i pozivanje spolja

Da biste ovo napravili sami, potrebna su vam dva kredencijala, oba kao header autentifikacija u n8n. Ključ za webhook birate sami, uz prilagođeno ime zaglavlja. Za PaperOffice koristite API ključ sa svog naloga, pod stavkom API i programeri. On se unosi u Authorization zaglavlje. Spolja pozivate workflow putem POST zahteva na URL webhook-a: fajl u polju file, ključ u zaglavlju. To može biti skripta, drugi program ili drugi workflow. Ono što se vrati je lista dokumenata, spremna za sledeći korak. Tri saveta iz prakse. Prvo: nisu vam potrebni razdvajajući listovi; Split Agent detektuje granice na osnovu sadržaja. Drugo: pravilo imenovanja postavljate u polju za uputstvo imenovanja, na primer datum, pošiljalac, vrsta dokumenta. I treće: preuzmite delove odmah ili ih arhivirajte odmah, jer linkovi ističu nakon kratkog vremena. To je bio Split Agent u n8n: webhook, poziv, petlja i lista. U PaperOffice možete ga koristiti i direktno prilikom otpremanja. Glavni video na inbox-u pokazuje kako se pojedinačni dokumenti nastavljaju od tamo. Do sledećeg puta u Akademiji PaperOffice AI.