Divizarea documentelor cu ajutorul componentei Split Agent din n8n

Bine ați venit la Academia PaperOffice AI. Acest episod tratează Split Agent în n8n: intră un scanare în lot, ies documente individuale.

Rezultatul mai întâi: scanare în lot intră, documente ies

Să analizăm mai întâi rezultatul. Scanarea noastră în lot din camera poștei are șapte pagini, cu o foaie separatoră între ele. Split Agent recunoaște unde se termină un document și începe următorul. Cinci documente sunt returnate, fiecare cu tipul său, un nume descriptiv și paginile sale. Iată cum arată acest lucru în n8n. Pentru un test, pornesc fluxul de lucru în editor și trimit scanarea în lot la webhook. Acum fluxul de lucru rulează nod cu nod. Lucrul de divizare se trimite către PaperOffice, iar bucla continuă să verifice până când este finalizată. După puțin sub patruzeci de secunde, totul este terminat. Nodul Pieces păstrează rezultatul: cinci intrări, câte una per document. Acestea sunt cele cinci documente: comandă de achiziție, aviz de livrare, factură, buletin de service și raport de inspecție. Buletinul de service are două pagini, care rămân împreună. Split Agent a detectat foaia separatoră de pe pagina trei și a eliminat-o. Fiecare document primește un nume descriptiv bazat pe regula noastră. Fiecare piesă este un PDF separat. Iată buletinul de service: ambele pagini într-un singur fișier, denumit conform regulii noastre. Rezultatul include link-ul de descărcare, dar acesta este valabil doar pentru o perioadă scurtă. Iată un al doilea lot, unul mai dificil: șase pagini în trei limbi. O comandă de achiziție în engleză, un aviz de livrare în spaniolă și o factură în spaniolă, o notă de credit, o factură de transport cu o pată de cafea și o poză îndoită a unui telefon cu o factură. Split Agent separă toate cele șase și le denumește consecvent în engleză. Și iată cum construim acest lucru, în patru etape: intrare, lucru de divizare, așteptare și piese.

Etapa 1 din 4: Intrare

Prima etapă este intrarea: un webhook cu autentificare prin antet care acceptă fișierul prin POST. Dacă lipsește fișierul, fluxul de lucru răspunde imediat cu o eroare clară. Și ce se întâmplă fără un fișier? Trimit o cerere fără atașament. Fluxul de lucru urmează calea scurtă prin nodul „Fișier lipsă” și răspunde imediat cu status 400 și un mesaj clar. Nu este creat niciun lucru de divizare, deci nu există nici costuri.

Etapa 2 din 4: Lucru de divizare

Etapa a doua trimite lotul către Split Agent, printr-o singură apelare HTTP către API-ul PaperOffice. Aceasta include șablonul de divizare, modelul Ultra și o regulă pentru denumirea părților: tipul documentului, data, expeditorul. În câmpul model, alegeți domeniul de aplicare. Basic detectează limitele și denumește părțile. Premium citește, de asemenea, tipul documentului, data și expeditorul. Ultra oferă, suplimentar, raționamentul pentru fiecare tăietură și asigură o urmă auditabilă. Facturarea se face pe pagină. Două aspecte determină prețul: domeniul de aplicare și canalul de procesare. Am ales instantaneu, ceea ce înseamnă un start imediat. Fără garanție de start, fără SLA, costă mai puțin. Puteți găsi prețurile actuale pe site-ul nostru la secțiunea Prețuri.

Etapa 3 din 4: Așteptare

Lucrarea rulează în fundal. La fiecare șase secunde, bucla verifică starea sa. Când este finalizată, execuția continuă. Dacă eșuează, execuția se termină cu un mesaj.

Etapa 4 din 4: Piese

În etapa a patra, răspunsul devine o listă, cu câte o intrare per document. Dacă o foaie de separator este returnată ca un element separat, acest nod o filtrează. În final, webhook-ul răspunde exact cu această listă. Ce se întâmplă cu lista în continuare? În videoclipul principal despre inbox, acesta este exact momentul în care bucla preia controlul: fiecare document este trimis la IDP Agent individual, este citit și arhivat într-un Workspace. Astfel, divizarea devine punctul de plecare al unui flux de lucru întreg.

Construiți-vă propriul sistem: Credențiale și apelare din exterior

Pentru a construi acest lucru singur, aveți nevoie de două acreditări, ambele ca autentificare prin antet în n8n. Alegeți cheia pentru webhook-ul dumneavoastră, cu un nume de antet personalizat. Pentru PaperOffice, utilizați o cheie API din contul dumneavoastră, secțiunea API și dezvoltatori. Aceasta se introduce în antetul Authorization. Din exterior, apelați fluxul de lucru printr-o cerere POST către URL-ul webhook-ului: fișierul din câmpul file, cheia în antet. Acesta poate fi un script, un alt program sau un al doilea flux de lucru. Ce se returnează este lista de documente, gata pentru următorul pas. Trei sfaturi din practică. În primul rând: nu aveți nevoie de foi separator; Split Agent detectează limitele din conținut. În al doilea rând: setați regula de denumire în câmpul instrucțiunii de denumire, de exemplu dată, expeditor, tip document. Și în al treilea rând: descărcați fragmentele prompt sau arhivați-le imediat, deoarece link-urile expiră după un timp scurt. Acesta a fost Split Agent în n8n: un webhook, o apelare, un buclă și o listă. În PaperOffice, îl puteți utiliza și direct la încărcare. Videoclipul principal despre căsuța de intrare arată cum continuă documentele individuale de acolo. Până data viitoare în Academia PaperOffice AI.