Dajte svojmu AI agentovi účtovnú knihu
Premeňte úlohu na knihy, ktoré môžete kontrolovať. Dajte svojmu agentovi s podporou shellu príkaz bea, aby zaznamenal transakcie, skontroloval svoju prácu a vrátil zostatok podložený obyčajným textom.
Inštalácia bea
Vyberte svoj inštalátor, potom skontrolujte verziu. Lokálne knihy nevyžadujú konto Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS alebo Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDObyčajný text. Váš na vždy.
Lokálne .bean súbory, ktoré môžete čítať, porovnávať a verziovať v Git.
Kontrola pred každou zmenou.
Predvolené pridané príkazy CLI musia prejsť validáciu, než vaša hlavná kniha bude zamienená.
Prineste agenta, ktorého používate.
Agent s podporou shellu, jedna úloha a príkazy, ktoré môžete kontrolovať.
Čo potrebujete
Terminál, sieťové pripojenie a buď Homebrew alebo uv s Python 3.12 alebo novším. Lokálne účtovníctvo nevyžaduje účet Beancount.io — ten vstupuje do hry iba pri voliteľnom hostovanom kroku nižšie.
bea --versionPríklad overený s bea 0.1.0: Python distribúcia je beancount-io a spustiteľný súbor, ktorý inštaluje, je bea.
Jedna malá úloha. Skutočné knihy.
Začnite s 1,000 USD. Zaznamenajte kávu za 12.50 USD. Požiadajte agenta, aby skontroloval hlavnú knihu a zobrazil dotaz, na ktorom založená jeho odpoveď.
Prompt úlohy agenta
Máte prístup k shellu a nainštalované CLI `bea`. Najprv spustite `bea --help` a prečítajte si, čo ponúka. Potom v NOVOM prázdnom demo adresári (nedotýkajte sa žiadnej existujúcej účtovnej knihy): 1) vytvorte USD účtovnú knihu s otvorením Assets:Checking na 1000 dňa 2026-08-01; 2) pridajte nákup za 12.50 USD s popisom "Coffee" do Expenses:Dining dňa 2026-08-02; 3) spustite `bea check`; 4) nahláste zostatok Assets:Checking spolu s presným BQL dopytom, ktorý ste použili. Očakávaný výsledok: 987.50 USD.- Vytvorte nové demo knihy
- Zaznamenajte nákup kávy
- Kontrolujte knihy a zistajte zostatok
Očakávaný výsledok: Assets:Checking má 987.50 USD.
Vykonajte to sami, príkaz za príkazom
bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
cd demo-books
bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
bea check
bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"Požiadajte svojho agenta na testovanie.
Tri bankové transakcie. Jedna zaznamenaná vykonanie agenta. Zoberte tie isté vstupy, reprodukujte výsledok a skontrolujte, čo sa stalo na ceste.
Prečítajte si zaznamenaný behSyntetické dáta, overené s bea 0.1.0. Jedna pozorovaná vykonanie; kompletný záznam obsahuje chyby a obmedzenia.
Presné vstupy výzvy
Startovacia hlavná kniha, bankový výpis a pravidlá kategorií.
Prejdite ďalej než demo.
Dva kopírovateľné recepty nadväzujú na vyššie uvedené demo: importujte bankové CSV s kategóriami navrhnutými agentom a potom odpovedzte na otázku o zostatku z výstupu dotazu. Každý spája prompt agenta s ekvivalentmi CLI a očakávanými výsledkami.
Prečítajte si recepty pre agentovVyberáte medzi nástrojmi? Beancount.io je jedným z piatich porovnávaných podľa rovnakých kritérií pre agent-workflow, s datovanými zdrojmi.
Prečítajte si porovnanie piatich nástrojovNiekoľko vecí pred začatím.
Vaše knihy zostávajú na vašom počítači
Každý príkaz nižšie funguje na obyčajných textových .bean súboroch v adresári, ktorý si vyberiete. Nové súbory účtovnej knihy sú súkromné pre vášho používateľa a každý prídavok je overený proti celej účtovnej knihe predtým, ako je súbor nahradený — na predvolenej lokálnej CLI ceste je neznámy účet alebo nevyvážená transakcia chybou s usmernením a súbor zostáva nedotknutý.
Potrebujem účet Beancount.io?
Nie pre nič na tejto stránke. Inštalácia bea, vytvorenie lokálnej účtovnej knihy, zaznamenávanie nákupov a kontrola zostatkov fungujú bez účtu. Prihlasujete sa iba kvôli voliteľným hostovaným extra funkciám: bea ask, MCP server a hostované účtovné knihy.
Nastaví inštalácia CLI môjho AI agenta?
Nie. Inštalácia vám dá príkaz bea; váš agent zostáva presne taký, aký je. Vy vložíte vyššie uvedenú úlohu do agenta s podporou shellu, ktorého už používate, a načítanie zručností agenta je samostatný krok.
Opustí moja účtovná kniha môj počítač?
Lokálne príkazy pracujú s lokálnymi .bean súbormi a neuskutočňujú žiadne sieťové volania. Iba hostované príkazy — bea cloud a bea ask, ktorých volania modelov prebiehajú cez hostovaný AI proxy — komunikujú so službami Beancount.io.
Čo sa stane, ak môj agent napíše zlý záznam?
Na predvolenej lokálnej CLI ceste je každý prídavok skontrolovaný proti celej účtovnej knihe predtým, ako je súbor nahradený. Neznámy účet alebo nevyvážená transakcia zlyhá s usmernením a nechá váš súbor nedotknutý — nechajte agenta spustiť bea check aj po akýchkoľvek ručných úpravách.
Čo presne vyžaduje bea ask?
Dve veci okrem tejto stránky: extra závislosť ask a hostované prihlasovacie údaje na prihlásenie. Predvolená inštalácia bea úmyselne vynecháva AI závislosti, kým o ne nepožiadate.
Pripojte hostované nástroje, keď ich potrebujete
Lokálne príkazy CLI fungujú bez konta Beancount.io. Hostovaná AI pomoc a prístup MCP sú zvlášné, opcionálne pripojenia.
bea ask odpovedá na otázky o lokálnej účtovnej knihe prostredníctvom hostovanej AI služby. Vyžaduje extra ask — uv tool install 'beancount-io[ask]' — plus vaše prihlasovacie údaje Beancount.io.
MCP server a hostované účtovné knihy sa tiež prihlasujú pomocou vášho účtu Beancount.io na autorizáciu prístupu. Začnite lokálne; pripojte hosting, len ak ho chcete.
Zručnosti agenta pre Beancount žijú v produktovom repozitári a načítavajú sa do vášho agenta samostatne — inštalácia CLI ich neinštaluje ani nekonfiguruje.
Preskúmajte MCP pripojenieVáš agent môže robiť účtovníctvo. Vy môžete vidieť jeho prácu.
Začnite s lokálnou hlavnou knihou a jedným overitelným výsledkom.