Asiakirjojen jakaminen komponentilla Split Agent kohteessa n8n

Tervetuloa PaperOffice AI -akatemian kurssille. Tässä jaksossa käsitellään Split Agent:ia kohteessa n8n: eräskannetunnistus tuottaa erän sisäänpäin, ja yksittäiset asiakirjat tulevat ulos.

Tulos ensin: Eräskannetunnistus sisään, asiakirjat ulos

Katsotaan tulosta ensin. Postinhallinnosta saatu eräskannetunnistus sisältää seitsemän sivua, ja niiden välissä on erottinsivu. Split Agent tunnistaa, missä yksi asiakirja päättyy ja seuraava alkaa. Viisi asiakirjaa palautuu takaisin, joista jokaisella on tyyppi, kuvaava nimi ja sivut. Näin se näyttää kohteessa n8n. Testinä käynnistetään työvuorokausi editorissa ja lähetetään eräskannetunnistus webhookiin. Nyt työvuorokausi suoritetaan solmu kerrallaan. Jako-toiminto siirtyy kohteeseen PaperOffice, ja silmukka tarkistaa jatkuvasti, kunnes se on valmis. Hieman alle neljänkymmenen sekunnin kuluttua kaikki on valmista. Pieces-solmu sisältää tuloksen: viisi merkintää, yksi per asiakirja. Nämä ovat viisi asiakirjaa: ostotilaus, toimituslasku, lasku, palveluilmoitus ja tarkastuskertomus. Palveluilmoituksessa on kaksi sivua, ja ne pysyvät yhdessä. Split Agent havaitsi erottinsivun kolmannella sivulla ja poisti sen. Jokaiselle asiakirjalle annetaan kuvaava nimi sääntömme mukaisesti. Jokainen osa on oma PDF-tiedostonsa. Tässä palveluilmoitus: molemmat sivut yhdessä tiedostossa, nimetty sääntömme mukaisesti. Tulokseen sisältyy latauslinkki, mutta se on voimassa vain lyhyen aikaa. Tässä toinen erä, vaikeampi: kuusi sivua kolmella kielellä. Englanninkielinen ostotilaus, espanjankielinen toimituslasku ja espanjankielinen lasku, luottolasku, rahtilasku kahvipisaran kanssa ja vinosti otettu puhelinkuva laskusta. Split Agent erottaa kaikki kuusi ja nimetään ne johdonmukaisesti englanniksi. Ja näin se rakennetaan neljässä vaiheessa: syöte, jako-toiminto, odotus ja osat.

Vaihe 1/4: Syöte

Vaihe yksi on syöte: webhook otsikkotodennuksella, joka hyväksyy tiedoston POST-menetelmällä. Jos tiedosto puuttuu, työvuorokausi vastaa välittömästi selkeällä virheellä. Ja mitä tapahtuu ilman tiedostoa? Lähetetään pyyntö ilman liitettä. Työvuorokausi ottaa lyhyen reitin Tiedosto puuttuu -solmun läpi ja vastaa heti tilalla 400 ja selkeällä viestillä. Jako-toimintoa ei luoda, joten kustannuksia ei myöskään synny.

Vaihe 2/4: Jako-toiminto

Vaihe 2 lähettää erän kohteeseen Split Agent tekemällä yhden HTTP-kutsun kohteeseen PaperOffice API. Mukana ovat jaettu malli, Ultra -malli ja sääntö osien nimeämiseen: asiakirjan tyyppi, päivämäärä, lähettäjä. Mallikentässä valitaan laajuus. Basic havaitsee rajat ja nimittää osat. Premium lukee myös asiakirjan tyypin, päivämäärän ja lähettäjän. Ultra antaa lisäksi perustelun jokaiselle leikkaukselle ja tarjoaa tarkistuslistan. Laskutus tapahtuu sivumäärän mukaan. Hintaan vaikuttavat kaksi asiaa: laajuus ja käsittelykaista. Valinta oli välitön, mikä tarkoittaa välitöntä aloitusta. Ilman aloitustakuuta ja ilman SLA:ta hinta on alhaisempi. Nykyiset hinnat löytyvät verkkosivuiltamme kohdasta Hinnasto.

Vaihe 3/4: Odottaa

Työ suoritetaan taustalla. Joka kuuden sekunnin välein silmukka tarkistaa tilan. Kun työ on valmis, suoritus jatkuu. Jos se epäonnistuu, suoritus päättyviin viestillä.

Vaihe 4/4: Osat

Neljännessä vaiheessa vastaus muodostuu listaksi, jossa on yksi merkintä kutakin asiakirjaa kohti. Jos erotinpaperi palautuu erillisenä osana, tämä solu suodattaa sen pois. Lopuksi webhook palauttaa tarkan tämän listan. Mitä listalle tapahtuu seuraavaksi? Postilaatikon päävideossa juuri tässä vaiheessa silmukka ottaa vallan: jokainen asiakirja ohjataan omalle IDP Agent:lle, luetaan ja arkistoidaan Workspace:een. Näin jakaminen muodostuu koko työnkulun alkuun.

Rakenna itse: Tunnistetiedot ja kutsu ulkopuolelta

Tämän rakentaminen vaatii kahden tunnuksen, jotka molemmat toimivat otsikkotodennuksena n8n:ssä. Webhookin avain valitaan itse mukautetulla otsikon nimellä. PaperOffice:ssä käytetään tilin API-avainta, joka löytyy osiosta “API ja kehittäjät”. Se sijoitetaan Authorization-otsikkoon. Ulkopuolelta workflow kutsutaan lähettämällä POST-pyyntö webhookin URL-osoitteeseen: tiedosto syötetään file-kenttään ja avain otsikkoon. Tämä voi olla skripti, toinen ohjelma tai toinen workflow. Tuloksena on lista valmiista asiakirjoista seuraavaa vaihetta varten. Kolme käytännön vinkkiä: Ensinnäkin, erottimia ei tarvita; Split Agent tunnistaa rajat sisällöstä. Toiseksi, nimeämissääntö asetetaan nimeämiskomento-kenttään, esimerkiksi päivämäärä, lähettäjä tai asiakirjatyyppi. Kolmanneksi, lataa osat nopeasti tai arkistoi ne välittömästi, koska linkit vanhenevat lyhyen ajan kuluttua. Tämä oli Split Agent n8n:ssä: webhook, kutsu, silmukka ja lista. PaperOffice:ssä sitä voidaan käyttää myös suoraan latauksen yhteydessä. Inboxin päävideossa näytetään, miten yksittäiset asiakirjat etenevät sieltä. Nähdään seuraavan kerran PaperOffice AI Academyssa.