Zverte externému AI agentovi dve účtovnícke úlohy a udržte každú zmenu v hlavnej knihe pod vašou kontrolou: import bankového CSV s predbežným prehľadom, potom zodpovedzte na otázku o salde z výstupu query a reportu.
Inštalujte bea pomocou rýchleho začiatku CLI. Lokálne príkazy importu, query a reportu nevyžadujú konto Beancount.io. Váš chat agent potrebuje iba vlastné predplatné alebo API kľúč. Len vstavaný pomocník bea ask vyžaduje hostované prihlasovacie údaje, a tieto recepty ho nepoužívajú.
Čo robí agent a čo robí bea
Agent navrhuje kategórie a píše návrhy dotazov. Bea validuje štruktúru hlavnej knihy a vypočítava sumy. Všetky príkazy nižšie púštáte sami. Agent nikdy nepiše priamo do vašej hlavnej knihy.
Recept 1: Import výpisu s kategóriami navrhnutými agentom
Preveďte bankový export na valídované záznamy. Agent navrhuje pravidlá kategorizácie. Predbežný prehľad a revízia duplikátov určujú, čo sa zapíše.
Predpoklady
Potrebujete bea a čerstvý demo priečnik. Žiadné konto a žiadný Python importer.
Príprava vstupov
Vytvorte priečnik a hlavnú knihu. Explicítne --file ciele držia každý príkaz namierený na demo knihy.
mkdir ai-agent-demo && cd ai-agent-demo
bea --no-input init books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
bea --file books/main.bean add open --date 2026-08-01 --account Expenses:Transport:Fuel -c USDUložte tento príklad ako statement.csv:
Date,Payee,Narration,Amount
2026-08-02,Whole Foods,groceries,-20.00
2026-08-03,Shell,gas,-40.00
2026-08-04,Unknown Shop,mystery,-9.99Uložte tieto pravidlá kategorizácie ako rules.toml:
[[rule]]
match = "whole foods|trader joe|corner market"
account = "Expenses:Groceries"
[[rule]]
match = "shell|chevron|exxon"
account = "Expenses:Transport:Fuel"Kopírujte príkaz úlohy
Vložte tento príkaz svojmu externému agentovi spolu s obsahom CSV:
Navrhnite Beancount pravidlá kategorizácie pre mňa bankové CSV rádky.
Navrhnite jedno TOML pravidlo na obchodníka s match patternom a
cieľovým nákladovým kontom. Nikdy nemenте dátumy, payee alebo sumy.
Rádky, ktore neviete s jistotou kategorizovať, ostavte nezaradené:
postia sa na Expenses:Uncategorized s flagom ! pre moju revíziu. Ja
púštam bea import preview a apply lokálne. Vy nepúšite moju hlavnú knihu.Púštajte CLI ekvivalenty
Predbežný prehľad najprv, potom aplikujte revidované záznamy a ověřite výsledok:
bea --file books/main.bean import statement.csv --csv date=Date,amount=Amount,payee=Payee,narration=Narration --account Assets:Checking --rules rules.toml
bea --file books/main.bean import statement.csv --apply
bea --file books/main.bean check
bea --file books/main.bean list transaction --flag '!'
bea --file books/main.bean query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"Overíte očakávaný výstup
Predbežný prehľad hlási 3 ready, 0 exact duplicates, 0 possible duplicates a vychôdzi s 0. Nič nespiše. Aplikovaný beh hlási Wrote 3 entries. Check hlási žiadné chýby. ! fronta lista jeden nezaradený rádok z Unknown Shop na -9.99 USD. Saldová dotaz hlási 930.01 USD na checking. Ponovenie aplikácie hlási 0 ready, 3 exact duplicates a zapíše 0 záznamov.
Revízia a korekcia
Prekategórujte ! rádok zámerne v svojej hlavnej knihe po prečítaní. Prešlicheck iba dokazuje, že hlavná kniha bilancuje. Nič nesvedčí o tom, či Expenses:Uncategorized je správné konto. Pre politiku duplikátov, spôsob rešenia konfliktov a pokročilý Python postup, postupujte podľa walkthrough bankového CSV.
Recept 2: Odpovedzte na otázku o salde bez zapisov
Odpovedzte na jednu otázku z demo kníh: kolko zašlo na grocéries a fuel v auguste 2026. Agent píše návrh dotazu. Read-only príkazy produkujú odpoveď.
Predpoklady
Potrebujete demo hlavnú knihu z receptu 1 alebo vlastné knihy. Všetky príkazy nižšie sú read-only.
Kopírujte príkaz úlohy
Vložte tento príkaz svojmu externému agentovi:
Navrhnite Beancount dotaz (BQL), ktorá odpovedá: kolko som zatratil na
grocéries a fuel v auguste 2026. Použite moje názvy kont presne tak, ako
sú listed by bea list open. Navrhnite iba read-only príkazy: bea query
alebo bea report s explicítnym --file cieľom. Nenavrhujte editácie hlavnej
knihy na opravenie prekvapeného celku. Prekvapený celok znamená, že dotaz
alebo knihy potrebujú revíziu, nie kompenzujúci zápis.Púštajte CLI ekvivalenty
Púštajte navrhnutú dotazu s explicítnym cieľom hlavnej knihy, potom kríž-ovrite s reportom:
bea --file books/main.bean query "SELECT account, sum(position) WHERE account ~ 'Expenses' GROUP BY account"
bea --file books/main.bean report income-statement --time 2026-08Strojoví konzumenti pridávajú globálny --json flag pred subcommand:
bea --file books/main.bean --json query "SELECT account, sum(position) WHERE account ~ 'Expenses' GROUP BY account"JSON obálky, exit kódy a miesto globálneho flagu idú podľa CLI reference. Príručka dotazového jazyka dokumentuje celý BQL povrch.
Overíte očakávaný výstup
Dotaz hlási 20.00 USD pre Expenses:Groceries, 40.00 USD pre Expenses:Transport:Fuel a 9.99 USD pre Expenses:Uncategorized. Grocéries plus fuel je 60.00 USD. Income statement sa zhoduje: 69.99 USD augustových nákladov s net profitom -69.99 USD. JSON varianta vracia tie isté rádky vo «data.rows» s metaúdajmi o stĺpcoch vo «data.columns».
Revízia a korekcia
Dotaz na chybný názov konta píše (no rows) na stderr a stále vychôdzi s 0. Porovnajte názov s výstupom bea list open a púštajte dotazu znova. Nikdy neopravujte prekvapený celok editáciou hlavnej knihy, aby sa zhoda s odpoveďou. Opravte dotazu alebo knihy, potom púštajte bea check znova.
Keď recept sa stáva opakovným úlohom
Príkazy vyššie sú pre jednorázové úlohy, ktoré riadite ručne. Úlohy, ktoré opakujete každý týždeň, sedia verziovaným skills v produktovom repozitórii. Každý link nižšie otvára aktuálny zdroj toho skills, ktorý nesie svoje vlastné inštaláčné a trigger inštrukcie. Tento CMS nekopia tieto súbory.
- Začnite čerstvu hlavnú knihu z prázdného priečnika s beancount-init. Vytvára súbor hlavnej knihy, Fava runner a Python projekt.
- Preveďte bankový export na kategorizované záznamy s beancount-import. Stadium každej rádky, navrhuje kategórie z histórie hlavnej knihy, přeskočí rádky už importované a píše iba po potvrdení. Recept 1 vyššie je manuálna forma tej úlohy.
- Dokázte, že jedno konto sa zhoduje so svojým výpisom s beancount-reconcile. Diffs hlavnú knihu voči výpisu a na konci obdobia zapíše balancovú aserciu po potvrdení.
- Odpovedzte na otázku z kníh s beancount-ask. Púšťa read-only dotazy a ukazuje každú dotazu po jej čísle. Recept 2 vyššie je manuálna forma tej úlohy.
- Vykončite mesiac s beancount-close. Reconciles každé aktívne konto, kontroluje opakovné záznamy a revízne flagy a zapisuje zakončenie ako commit.
Celá kolekcia je v canonical skills tree.
Dajte shell-kompetentnému agentovi bea, alebo načítajte skill do klienta
Tieto sú dve separátne kroky. Inštalácia bea nikdy neinštaluje ani nekonfiguruje skills.
Shell-kompetentný agent potrebuje príkaz na svojom path. Inštalujte ho s rýchlym začiatkom CLI, potom agent púšťa tie isté bea príkazy, ktoré recepty ukazujú. Agent navrhuje, vy revídujete a bea validuje.
Skill sa načítá do samého klienta agenta, cez vlastný skill mechanizmus toho klienta. Produktové repozitórium vystavuje jednu canonical tree obom podporovaným klientom: Claude Code číta ju pod .claude/skills a Codex pod .agents/skills, ako linked directories do toho istého zdroja. Ukazte skill location klienta na skill priečnik, ktorý potrebujete, a čitajte jeho aktuálny zdroj pre trigger frázy a aktualizácie.
Ask-like otázky bez bea ask
Recept 2 odpovedá na otázky o knihe s externým agentom plus read-only bea query a bea report príkazy. Ten cesta je lokálna. Nevyžaduje konto ani extra inštaláciu.
bea ask je separátny vstavaný pomocník. Nie je ani recept vyššie ani skill beancount-ask. On preposielá otázku cez hostovanú AI službu, takže vyžaduje ask extra a hostované prihlasovacie údaje, ako dokumentované v CLI reference. Inštalujte base CLI najprv, potom pridajte extra iba keď chcete hostované odpovede.
Citované výstupy a CLI verifikácia
Každý príkaz vyššie bol vykonaný voči publikovanému bea 0.1.0 paketu vo čerstvom priečniku. Citované počty, salda a správy sú CLI verifikácia. Task prompts neboli vykonané voči žiadnemu modelovi. Modelové chovanie je hodnotované separátne.
