Opdeling af dokumenter med den Split Agent i n8n

Hej og velkommen til PaperOffice AI Academy. Denne episode handler om Split Agent i n8n: en batch-scanning går ind, og individuelle dokumenter kommer ud.

Resultat først: Batch-scanning ind, dokumenter ud

Lad os se på resultatet først. Vores batch-scanning fra postmodtagelsen har syv sider med et separatorark imellem. Split Agent genkender, hvor det ene dokument slutter, og det næste begynder. Fem dokumenter returneres, hver med sin type, et beskrivende navn og sine sider. Sådan ser det ud i n8n. Som en test starter jeg workflowet i editoren og sender batch-scanningen til webhook’en. Nu kører workflowet node for node. Split-jobbet sendes til PaperOffice, og løkken fortsætter med at tjekke, indtil det er færdigt. Efter lidt under fyrre sekunder er alt færdigt. Pieces-node’en indeholder resultatet: fem poster, én pr. dokument. Det er disse fem dokumenter: købsordre, leveringsnote, faktura, et servicebulletin og en inspektionsrapport. Servicebulletinet har to sider, og de forbliver sammen. Split Agent registrerede separatorarket på side tre og fjernede det. Og hvert dokument får et beskrivende navn baseret på vores regel. Hver del er sin egen PDF. Her er servicebulletinet: begge sider i én fil, navngivet efter vores regel. Resultatet inkluderer downloadlinket, men det er kun gyldigt i en kort periode. Her er en anden batch, en sværere en: seks sider på tre sprog. En engelsk købsordre, en spansk leveringsnote og en spansk faktura, et kreditnota, et fragtfaktura med en kaffefläck og et skævt telefonbillede af en faktura. Split Agent adskiller alle seks og navngiver dem konsekvent på engelsk. Og sådan bygger vi det, i fire trin: input, split-job, ventning og pieces.

Trin 1 af 4: Input

Trin ét er inputtet: en webhook med header-auth, der accepterer filen via POST. Hvis filen mangler, svarer workflowet straks med en klar fejl. Og hvad sker der uden en fil? Jeg sender en anmodning uden vedhæftning. Workflowet tager den korte vej gennem node’en ‘File missing’ og svarer straks med status 400 og en klar besked. Der oprettes intet split-job, så der er heller ingen omkostninger.

Trin 2 af 4: Split-job

Trin to sender batchen til Split Agent via et enkelt HTTP-opkald til PaperOffice-API’et. Det inkluderer den opdelte skabelon, Ultra-modellen og en regel for navngivning af delene: dokumenttype, dato, afsender. I modelfeltet vælger du omfanget. Basic detekterer grænserne og navngiver delene. Premium læser også dokumenttype, dato og afsender. Ultra giver yderligere begrundelsen for hver opdeling og leverer en revisionslog. Faktureringen sker per side. To ting bestemmer prisen: omfanget og behandlingskanalen. Vi har valgt ‘instant’, hvilket betyder et øjeblikkeligt starttidspunkt. Uden startgaranti og uden SLA er prisen lavere. De aktuelle priser finder du på vores hjemmeside under Priser.

Trin 3 af 4: Afventer

Jobbet kører i baggrunden. Hvert sjette sekund tjekker løkken statussen. Når den er færdig, fortsætter kørslen. Hvis den fejler, afsluttes kørslen med en besked.

Trin 4 af 4: Stykker

I fase fire bliver svaret til en liste med ét element pr. dokument. Hvis et adskillelsesark returneres som et selvstændigt element, filtrerer denne node det værd. Til sidst sender webhook’en netop denne liste. Hvad sker der derefter med listen? I hovedvideoen om indbakken er det her, løkken overtager: hvert dokument sendes til IDP Agent for sig selv, læses og arkiveres i en Workspace. På den måde bliver opsplitningen startskuddet til en hel arbejdsgang.

Byg det selv: Legitimationsoplysninger og kald udefra

For at bygge dette selv, skal du bruge to legitimationsoplysninger, begge som header-autentificering i n8n. Du vælger selv nøglen til webhooks med et brugerdefineret header-navn. For PaperOffice bruger du en API-nøgle fra din konto under ‘API og udviklere’. Den indsættes i Authorization-headeren. Udefra kalder du workflowet med en POST-anmodning til webhook-URL’en: filen i feltet ‘file’ og nøglen i headeren. Det kan være et script, et andet program eller et andet workflow. Det, der returneres, er listen over dokumenter, klar til næste trin. Tre tips fra praksis. For det første: du har ikke brug for adskillelsesark; Split Agent registrerer grænserne ud fra indholdet. For det andet: du indstiller navngivningsreglen i feltet ‘naming instruction’, for eksempel dato, afsender, dokumenttype. Og for det tredje: download delene hurtigt eller arkiver dem med det samme, fordi linkene udløber efter kort tid. Det var Split Agent i n8n: en webhook, et kald, en løkke og en liste. I PaperOffice kan du også bruge den direkte ved upload. Hovedvideoen om indbakken viser, hvordan de enkelte dokumenter fortsætter derfra. Indtil næste gang i PaperOffice AI Academy.