Preskočiť na hlavný obsah

Používajte LLM s Beancount na import, kontrolu a dopytovanie

Kategorizujte transakcie pomocou LLM, kontrolujte navrhované záznamy Beancount, overujte zostatky výpisov a dopytujte svoje účtovníctvo

Použite AI na navrhovanie účtov a vysvetľovanie transakcií, potom skontrolujte zápisy proti vašim zdrojovým dokumentom pred ich uložením. Táto príručka prevedie malý fiktívny výpis procesom kategorizácie, kontroly, validácie a dopytu, ktorý si môžete overiť.

Vyberte si hostovaný alebo lokálny pracovný postup nižšie. Spracovaný príklad používa lokálny vzorový súbor, aby ste si mohli reprodukovať každú kontrolu pred pripojením AI k vašim vlastným knihám.

Vyberte si pracovný postup​

Vaše nastavenieZačnite tuAko sa zmeny dostanú do vašej účtovnej knihy
Používate Beancount.ioPoužite Smart Import pre súbory výpisov, alebo AI Assistant pre otázky a navrhované úpravy.Skontrolujte riadky pred odoslaním importu. Pre úpravy Asistenta skontrolujte navrhovaný diff a vyberte Schváliť alebo Odmietnuť.
Používate externého AI klientaPostupujte podľa nastavovacej príručky Beancount MCP na pripojenie vášho klienta k hostovanej účtovnej knihe.Skúšobný beh (dry run) zobrazí náhľad operácie úpravy. Samostatné volanie zápisu ju vykoná. Výzvy na schválenie závisia od nastavení vášho klienta.
Uchovávate lokálne súboryPoužite konvertor CSV do Beancountu alebo importer, potom požiadajte AI nástroj o návrh kategórií.Skontrolujete navrhované zápisy, validujete súbor a uložíte prijaté zmeny.

Hostovaný Asistent a MCP sú integrácie Beancount.io. Inštalácia open-source účtovného enginu Beancount nepridáva tieto služby k lokálnej účtovnej knihe.

Pred začiatkom​

Majte k dispozícii zdrojový výpis, účet, ku ktorému patrí, a zoznam povolených cieľových účtov. Uchovajte pôvodný výpis, aby ste ho mohli porovnať s výsledkom.

Pre lokálny postup nainštalujte Beancount pomocou príručky na začatie. Budete tiež potrebovať Beanquery na spustenie záverečného dopytu z terminálu. Príklad predpokladá USD v celom rozsahu a žiadne existujúce transakcie vo vzorovom súbore.

Pre reálne dáta sa rozhodnite, ktoré informácie môže váš AI nástroj dostať. Odstráňte zbytočné identifikátory pred zdieľaním výpisu. Lokálna účtovná kniha môže stále odosielať dáta cloudovému modelu cez editor alebo MCP klienta. Skontrolujte politiky ochrany dát klienta a poskytovateľa modelu; uchovávanie súboru na vašom počítači samo o sebe nezaručuje, že jeho obsah zostane lokálny.

1. Začnite so zdrojovými transakciami​

Náš fiktívny bežný účet začína august s 1 000,00 USD. Jeho výpis obsahuje tri výbery a po týchto výberoch končí na 805,10 USD:

date,payee,description,amount
2026-08-03,Office Depot,Printer paper,-45.00
2026-08-04,Cloud Hosting Inc,Monthly hosting,-120.00
2026-08-05,Amazon,Online purchase,-29.90

Záporné sumy tu znamenajú peniaze odchádzajúce z bežného účtu. Overte konvenciu znamienok vašej banky pred importom; iné exporty a importery môžu používať inú konvenciu.

V konvertore CSV namapujte tieto štyri stĺpce a nastavte zdrojový účet na Assets:Bank:Checking s menou USD. Pre tento vzor nechajte Flip every sign vypnuté. Skontrolujte, či sú zdrojové účtovné zápisy záporné. Dočasný cieľový účet je len zástupný symbol, kým neskontrolujete kategórie.

Ak začínate s obrázkom účtenky alebo PDF, porovnajte extrahované dátumy, sumy, menu a počet transakcií s pôvodným dokumentom pred kategorizáciou čohokoľvek. Uchovajte zdrojové hodnoty nedotknuté pri rozhodovaní o účtoch.

2. Požiadajte o kategórie s explicitnými obmedzeniami​

Použite prompt, ktorý vymenúva povolené účty a ponecháva priestor pre neistotu:

Navrhnite cieľový účet pre každý riadok v tomto vzorovom výpise. Zdrojový účet je Assets:Bank:Checking. Použite iba Expenses:Office:Supplies alebo Expenses:Business:Hosting. Vráťte pôvodný dátum, príjemcu, sumu, navrhovaný účet a krátky dôvod. Ak je popis nedostatočný, vráťte NEEDS_REVIEW a vysvetlite, aké informácie chýbajú. Nevymýšľajte účty, nemeňte sumy a nezapisujte do účtovnej knihy.

Poskytnite tri riadky CSV s promptom. Užitočný výsledok by vyzeral takto; formulácia a návrhy modelu sa môžu líšiť:

DátumPríjemcaSuma (USD)Navrhovaný účetDôvod kontroly
2026-08-03Office Depot-45,00Expenses:Office:SuppliesPopis identifikuje kancelársky papier.
2026-08-04Cloud Hosting Inc-120,00Expenses:Business:HostingPopis identifikuje hosting.
2026-08-05Amazon-29,90NEEDS_REVIEWNázov obchodníka neidentifikuje, čo bolo zakúpené.

Prompt vyjadruje váš zámer. Nevynucuje povolenia na nástroji, ktorý môže zapisovať súbory. Nakonfigurujte ovládacie prvky schvaľovania klienta pred tým, ako mu dáte prístup k reálnej účtovnej knihe.

3. Vyriešte neistotu a skontrolujte zápisy​

Skontrolujte účtenku za nákup na Amazone. V tomto príklade identifikuje USB-C kábel do kancelárie a kontrolór priradí Expenses:Office:Supplies. Bez tohto dôkazu ponechajte riadok na ďalšie posúdenie a neprijímajte odhadnutú kategóriu.

Vytvorte nový súbor s názvom review.beancount s nasledujúcim kompletným príkladom. Obsahuje deklarácie účtov a počiatočný zostatok, ktoré CSV neobsahuje. Ak ste použili konvertor, porovnajte jeho transakcie s týmito skontrolovanými zápismi; nepridávajte obe kópie do tej istej účtovnej knihy.

option "title" "AI bookkeeping review example"
option "operating_currency" "USD"
 
2026-08-01 open Assets:Bank:Checking USD
2026-08-01 open Equity:Opening-Balances USD
2026-08-01 open Expenses:Office:Supplies USD
2026-08-01 open Expenses:Business:Hosting USD
 
2026-08-01 * "Opening balance"
  Assets:Bank:Checking       1000.00 USD
  Equity:Opening-Balances   -1000.00 USD
 
2026-08-03 * "Office Depot" "Printer paper"
  Assets:Bank:Checking        -45.00 USD
  Expenses:Office:Supplies     45.00 USD
 
2026-08-04 * "Cloud Hosting Inc" "Monthly hosting"
  Assets:Bank:Checking          -120.00 USD
  Expenses:Business:Hosting      120.00 USD
 
2026-08-05 * "Amazon" "Online purchase; receipt: office USB-C cable"
  Assets:Bank:Checking        -29.90 USD
  Expenses:Office:Supplies     29.90 USD
 
2026-08-06 balance Assets:Bank:Checking 805.10 USD

Transakcia počiatočného zostatku patrí do tejto prázdnej cvičnej účtovnej knihy. V existujúcej účtovnej knihe použite jej zavedený zostatok a deklarácie účtov namiesto pridania ďalšieho počiatočného zostatku.

Pred prijatím navrhovanej zmeny porovnajte každú transakciu s jej zdrojovým riadkom. Potvrďte znamienka, menu, účty a podpornú účtenku. Známy názov obchodníka sám o sebe nepreukazuje účel nákupu.

4. Validujte a zosúlaďte​

Spustite validátor Beancountu na lokálnom vzorku:

bea --file review.beancount check

Kompletný príklad by mal prejsť bez chýb. Jeho kontrola zostatku overuje sumu na bežnom účte na začiatku 6. augusta, po troch predchádzajúcich výberoch.

Potvrďte výsledok proti výpisu:

  • Tri transakcie z výpisu sa objavia raz každá, okrem počiatočného zostatku.
  • Výbery spolu predstavujú 194,90 USD.
  • Bežný účet drží 805,10 USD: počiatočných 1 000,00 USD mínus tieto výbery.
  • Kancelárske potreby spolu predstavujú 74,90 USD a hosting spolu 120,00 USD.

Ak necháte transakciu Amazon čakajúcu, bežný účet zostane na 835,00 USD a kontrola zlyhá o 29,90 USD. Preskúmajte tento rozdiel; nepridávajte nevysvetlenú úpravu len preto, aby kontrola prešla.

bea check zachytáva chyby syntaxe, účtov, vyrovnania a kontroly zostatkov. Nemôže preukázať, že účtenka je pravá, že ste vybrali správnu kategóriu výdavkov alebo že každý riadok výpisu je prítomný. Transakcia zaúčtovaná na nesprávny výdavkový účet môže stále dokonale sedieť.

Keď niečo nesedí​

PríznakĎalšia kontrola
Zostatok sa líši od výpisuPorovnajte počiatočný zostatok, počet transakcií, znamienka, dátumy a sumy so zdrojom.
Dva zápisy vyzerajú podobnePorovnajte identifikátory zdrojových transakcií a účtenky. Rovnaký obchodník a suma môžu predstavovať dva legitímne nákupy.
Model vymyslí účetVyberte existujúci účet alebo zámerne vytvorte nový po preskúmaní vašej účtovej osnovy.
Extrakcia vynechá riadok alebo zmení desatinné miestoOpravte extrahované dáta proti pôvodnému dokumentu pred kategorizáciou.
Validátor prejde, ale report vyzerá zlePreskúmajte výber účtov, vykazované obdobie a jednotlivé účtovné zápisy.

Požiadajte AI o vysvetlenie nezrovnalostí a poukázanie na dotknuté riadky. Potvrďte dôkazy pred vymazaním podozrivého duplikátu alebo zmenou sumy.

5. Uložte skontrolovaný výsledok a dopytujte sa naň​

Keď zopakujete tento pracovný postup s vlastným výpisom, zlúčte do svojej reálnej účtovnej knihy iba vaše skontrolované transakcie a potom validujte kombinovaný súbor. Uchovajte fiktívne zápisy vo vzorovom súbore. Ak používate Git, preskúmajte diff a commitnite cez svoj bežný pracovný postup. Uchovajte zdrojový výpis dostupný pre neskoršie zosúladenie. Príručka skriptovateľných pracovných postupov pokrýva opakovateľnú lokálnu automatizáciu.

Môžete overiť súčty vzorku pomocou Beancount Query Language. S nainštalovaným Beanquery spustite:

bea --file review.beancount query "SELECT account, sum(position) WHERE account ~ '^Expenses:' AND date >= 2026-08-01 AND date < 2026-09-01 GROUP BY account"

Oba súčty výdavkov by mali byť 74,90 USD pre kancelárske potreby a 120,00 USD pre hosting. Skontrolujte rozsah dátumov a filter účtov dopytu, ako aj jeho výstup.

S AI klientom pripojeným k účtovnej knihe obsahujúcej vzorku sa môžete opýtať:

Dopytujte vzorovú účtovnú knihu na výdavky za august 2026 zoskupené podľa účtu. Ukážte dopyt a jeho výsledky. Nemeňte žiadne súbory.

Porovnajte jeho odpoveď s rovnakými súčtami. Plynulá odpoveď je užitočná len vtedy, keď jej čísla možno vysledovať k účtovnej knihe.

Aplikujte proces kontroly v Beancount.io​

Pre súbory výpisov otvorte Import → Smart Import v bočnom paneli vašej účtovnej knihy. Skontrolujte extrahované riadky, vyberte Source Account a Currency a použite AI Fill pre návrhy cieľových účtov. Opravte kategórie pred odoslaním Import, ktorého tlačidlo obsahuje počet transakcií. Skontrolujte výsledný denník a zostatky vo vzorovej účtovnej knihe pred spracovaním reálneho výpisu. Overte, že výbery znižujú zdrojový účet; CSV vyššie je pripravené pre lokálny konvertor a importery môžu interpretovať znamienka odlišne.

Pre hostovaného Asistenta otvorte Ask Beancount.io vo vašej účtovnej knihe. Začnite otázkou o existujúcich zápisoch. Keď navrhne úpravu súboru, skontrolujte diff pred schválením. Prijaté importy a úpravy Asistenta sú zaznamenané v Gite, takže môžete zmeny preskúmať alebo vrátiť.

Pre MCP postupujte podľa špecifických pokynov na nastavenie klienta uvedených vyššie a autorizujte zamýšľanú účtovnú knihu. Požiadajte o editLedgerFiles s dry_run: true pred povolením úpravy. Skontrolujte navrhovaný obsah a súhrn operácie, potom povoľte samostatné volanie zápisu až po kontrole. Náhľad skúšobného behu nepreukazuje účtovnú správnosť ani nezaručuje, že váš klient požiada o povolenie pred neskorším zápisom.

Udržujte proces kontroly pri automatizácii​

Začnite s malou dávkou a zaznamenajte, ktoré návrhy meníte. Premeňte opakované, potvrdené mapovania na explicitné importné pravidlá alebo poskytnite skontrolované príklady ako kontext. Nepredpokladajte, že model sa trvalo učí z opravy v konverzácii.

Udržujte kontroly extrakcie, kontrolu kategórií a zosúladenie výpisov oddelené. Každá zachytáva iný druh chyby. Pre opakované importy tiež skontrolujte, či import rovnakého zdroja dvakrát ticho nezdvojuje transakcie.

Výskum podporuje tento rozdiel medzi platnou syntaxou a správnym účtovníctvom. Štúdia Figueroa Rosera a kolegov z januára 2025 hodnotila malé open-weight modely na scenároch finančných ukazovateľov a generovaní transakcií pomocou štruktúrovaných promptov. Jej výsledky opisujú tieto modely a úlohy, skôr než mieru presnosti pre dnešných asistentov alebo váš importný pracovný postup. Posudzujte svoj vlastný pracovný postup pomocou skontrolovaných zdrojových transakcií a opráv, ktoré vyžadujú.

Nástroje pre opakovateľný lokálny pracovný postup​

Vyberte nástroj pre časť procesu, ktorú potrebujete opakovať:

  • Beangulp poskytuje rámec importerov. Nahrádza starší rámec beancount.ingest v Beancounte 3.
  • smart_importer je samostatne inštalovaný balík, ktorý pridáva návrhy strojového učenia do importerov. Nie je to vstavaná funkcia LLM.
  • Beanborg dokumentuje kategorizáciu založenú na pravidlách, návrhy strojového učenia a voliteľné predikcie ChatGPT. Skontrolujte jeho aktuálne nastavenie a kompatibilitu pred prijatím.

Pre širší kontext si pozrite príručku automatizácie účtovníctva a príručku mesačného účtovného pracovného postupu.

Preskúmajte väčší príklad​

Verejná účtovná kniha nižšie je oddelená od cvičenia s tromi transakciami. Použite ju na preskúmanie, ako účty, transakcie a reporty zapadajú do seba pred pripojením AI k vašim vlastným knihám.

Otvoriť Verejná vzorová účtovná kniha, oddelená od cvičenia kontroly s AI v novej karte

Zdroj: https://beancount.io/sk/docs/Solutions/using-llms-to-automate-and-enhance-bookkeeping-with-beancount