Dóna al teu agent d'IA un llibre de comptes
Converteix una tasca en llibres que pots inspeccionar. Dóna al teu agent amb capacitat de shell la CLI bea per registrar transaccions, comprovar la seva feina i retornar un saldo basat en text pla.
Instal·la bea
Tria el teu instal·lador i, després, comprova la versió. Els llibres locals no requereixen un compte de Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS o Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDText pla. És teu i el conserves.
Fitxers .bean locals que pots llegir, comparar i versionar amb Git.
Comprovació abans de cada canvi.
Les addicions per defecte de la CLI s'han de validar abans de substituir el teu llibre de comptes.
Porta l'agent que ja fas servir.
Un agent amb capacitat de shell, una tasca i comandes que pots inspeccionar.
Què necessites
Un terminal, una connexió de xarxa i Homebrew o uv amb Python 3.12 o superior. La comptabilitat local no requereix cap compte de Beancount.io: això només apareix per al pas opcional allotjat a continuació.
bea --versionExemple verificat amb bea 0.1.0: la distribució de Python és beancount-io i l'executable que instal·la és bea.
Una tasca petita. Uns llibres reals.
Comença amb 1,000 USD. Registra un cafè de 12.50 USD. Demana al teu agent que comprovi el llibre de comptes i que mostri la consulta que hi ha darrere de la seva resposta.
Indicació de la tasca de l'agent
Tens accés al shell i la CLI `bea` instal·lada. Primer executa `bea --help` i llegeix què ofereix. Després, en un directori de demostració NOU i buit (no toquis cap llibre existent): 1) crea un llibre en USD que obri Assets:Checking amb 1000 el 2026-08-01; 2) afegeix una compra de 12.50 USD amb la narració "Coffee" a Expenses:Dining el 2026-08-02; 3) executa `bea check`; 4) informa del saldo de Assets:Checking juntament amb la consulta BQL exacta que has utilitzat. Resultat esperat: 987.50 USD.- Crea un llibre de comptes de demostració nou
- Registra la compra del cafè
- Comprova els llibres i consulta el saldo
Resultat esperat: Assets:Checking conté 987.50 USD.
Executa-ho tu mateix, comanda a comanda
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"Posa a prova el teu agent.
Tres transaccions bancàries. Una execució d'agent registrada. Descarrega les mateixes dades d'entrada, reprodueix el resultat i inspecciona el que va passar durant el procés.
Llegeix l'execució enregistradaDades sintètiques, verificades amb bea 0.1.0. Una execució observada; el registre complet inclou errades i limitacions.
Les entrades exactes del repte
Un llibre de comptes inicial, un extracte bancari i regles de categorització.
Més enllà de la demostració.
Dues receptes copiables es basen en la demo anterior: importa un CSV bancari amb categories proposades per l'agent i després respon una pregunta de saldo a partir de la sortida de la consulta. Cadascuna combina una indicació d'agent amb equivalents de CLI i resultats esperats.
Llegeix les receptes d'agentTrieu entre eines? Beancount.io és una de les cinc comparades segons els mateixos criteris de flux de treball d'agents, amb fonts datades.
Llegiu la comparació de les cinc einesAlgunes coses abans de començar.
Els teus llibres es queden a la teva màquina
Tots els comandaments següents funcionen amb fitxers .bean de text pla en un directori que triïs. Els fitxers de llibre nous són privats per al teu usuari i cada addició es valida contra el llibre complet abans de substituir el fitxer: a la ruta CLI local predeterminada, un compte desconegut o una transacció no equilibrada és un error amb orientació i el fitxer no es toca.
Necessito un compte de Beancount.io?
No, per a res d'aquesta pàgina. Instal·lar bea, crear un llibre local, registrar compres i comprovar saldos funciona sense compte. Només has d'iniciar sessió per a les opcions allotjades opcionals: bea ask, el servidor MCP i els llibres allotjats.
Instal·lar la CLI configura el meu agent d'IA?
No. Instal·lar et dona el comandament bea; el teu agent es queda exactament com està. Enganxes la tasca anterior a l'agent amb capacitat de shell que ja utilitzes, i carregar habilitats d'agent és un pas separat.
El meu llibre surt de la meva màquina?
Els comandaments locals funcionen amb fitxers .bean locals i no fan cap trucada de xarxa. Només els comandaments allotjats — bea cloud i bea ask, les crides de model dels quals passen pel proxy d'IA allotjat — parlen amb els serveis de Beancount.io.
Què passa si el meu agent escriu una entrada dolenta?
A la ruta CLI local predeterminada, cada addició es comprova contra el llibre complet abans de substituir el fitxer. Un compte desconegut o una transacció no equilibrada falla amb orientació i deixa el teu fitxer intacte: fes que l'agent executi bea check després de qualsevol edició manual també.
Què necessita exactament bea ask?
Dues coses més enllà d'aquesta pàgina: l'extra de dependència ask i credencials allotjades per iniciar sessió. La instal·lació predeterminada de bea omet intencionadament les dependències d'IA fins que les demanis.
Connecta les eines allotjades quan ho necessitis
Les comandes locals de la CLI funcionen sense un compte de Beancount.io. L'ajuda d'IA allotjada i l'accés MCP són connexions opcionals separades.
bea ask respon preguntes sobre un llibre local mitjançant el servei d'IA allotjat. Necessita l'extra ask — uv tool install 'beancount-io[ask]' — a més de les teves credencials de Beancount.io.
El servidor MCP i els llibres allotjats també inicien sessió amb el teu compte de Beancount.io per autoritzar l'accés. Comença local; connecta l'allotjament només si ho vols.
Les habilitats d'agent per a Beancount viuen al repositori del producte i es carreguen al teu agent per separat: instal·lar la CLI no les instal·la ni les configura.
Explora la connexió MCPEl teu agent pot portar la comptabilitat. Tu pots veure la feina.
Comença amb un llibre de comptes local i un resultat verificable.