Dê ao seu agente de IA um livro-razão
Transforme uma tarefa em livros que você pode inspecionar. Dê ao seu agente com acesso ao shell o CLI bea para registrar transações, verificar seu trabalho e retornar um saldo respaldado por texto simples.
Instalar bea
Escolha seu instalador e verifique a versão. Livros locais não precisam de conta Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS ou Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDTexto simples. Seu para manter.
Arquivos .bean locais que você pode ler, comparar e versionar com Git.
Uma verificação antes de cada alteração.
As adições padrão da CLI devem ser validadas antes que seu livro-razão seja substituído.
Traga o agente que você usa.
Um agente com acesso ao shell, uma tarefa e comandos que você pode inspecionar.
O que você precisa
Um terminal, uma conexão de rede e Homebrew ou uv com Python 3.12 ou mais recente. A contabilidade local não requer conta Beancount.io — ela só entra em cena para a etapa hospedada opcional abaixo.
bea --versionExemplo verificado com bea 0.1.0: a distribuição Python é beancount-io e o executável que ela instala é bea.
Uma pequena tarefa. Um conjunto real de livros.
Comece com 1,000 USD. Registre um café de 12.50 USD. Peça ao seu agente para verificar o livro-razão e mostrar a consulta por trás da resposta.
Prompt da tarefa do agente
Você tem acesso ao shell e o CLI `bea` instalado. Primeiro execute `bea --help` e leia o que ele oferece. Em seguida, em um NOVO diretório de demonstração vazio (não toque em nenhum livro-razão existente): 1) crie um livro-razão USD abrindo Ativos:Caixa em 1000 em 2026-08-01; 2) adicione uma compra de 12.50 USD com narrativa "Café" em Despesas:Alimentação em 2026-08-02; 3) execute `bea check`; 4) informe o saldo de Ativos:Caixa juntamente com a consulta BQL exata que você usou. Resultado esperado: 987.50 USD.- Criar um livro-razão de demonstração novo
- Registrar a compra do café
- Verificar os livros e consultar o saldo
Resultado esperado: Ativos:Caixa detém 987.50 USD.
Execute você mesmo, comando por comando
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"Coloque seu agente à prova.
Três transações bancárias. Uma execução registrada do agente. Baixe as mesmas entradas, reproduza o resultado e inspecione o que aconteceu ao longo do caminho.
Leia a execução gravadaDados sintéticos, verificados com bea 0.1.0. Uma execução observada; o registro completo inclui falhas e limitações.
As entradas exatas do desafio
Um livro-razão inicial, um extrato bancário e regras de categoria.
Vá além da demonstração.
Duas receitas copiáveis baseiam-se na demonstração acima: importe um CSV bancário com categorias propostas pelo agente e depois responda a uma pergunta de saldo a partir da saída da consulta. Cada uma combina um prompt de agente com equivalentes CLI e resultados esperados.
Leia as receitas para agentesEscolhendo entre ferramentas? O Beancount.io é um dos cinco comparados nos mesmos critérios de fluxo de trabalho de agente, com fontes datadas.
Leia a comparação de cinco ferramentasAlgumas coisas antes de começar.
Seus livros permanecem na sua máquina
Cada comando abaixo trabalha com arquivos .bean de texto simples em um diretório de sua escolha. Novos arquivos de livro-razão são privados para o seu usuário, e cada adição é validada contra o livro-razão completo antes que o arquivo seja substituído — no caminho CLI local padrão, uma conta desconhecida ou uma transação desbalanceada é um erro com orientação, e o arquivo é deixado intocado.
Preciso de uma conta Beancount.io?
Não, para nada nesta página. Instalar bea, criar um livro-razão local, registrar compras e verificar saldos funcionam sem conta. Você só entra para os extras hospedados opcionais: bea ask, o servidor MCP e livros-razão hospedados.
Instalar o CLI configura meu agente de IA?
Não. A instalação dá a você o comando bea; seu agente permanece exatamente como está. Você cola a tarefa acima no agente com capacidade de shell que já usa, e carregar habilidades de agente é uma etapa separada.
Meu livro-razão sai da minha máquina?
Os comandos locais trabalham em arquivos .bean locais e não fazem chamadas de rede. Somente os comandos hospedados — bea cloud e bea ask, cujas chamadas de modelo passam pelo proxy de IA hospedado — falam com os serviços Beancount.io.
O que acontece se meu agente escrever uma entrada ruim?
No caminho CLI local padrão, cada adição é verificada contra o livro-razão completo antes que o arquivo seja substituído. Uma conta desconhecida ou uma transação desbalanceada falha com orientação e deixa seu arquivo intocado — peça também ao agente para executar bea check após qualquer edição manual.
O que exatamente bea ask precisa?
Duas coisas além desta página: o extra de dependência ask e credenciais hospedadas para entrar. A instalação padrão de bea omite intencionalmente as dependências de IA até que você as peça.
Conecte ferramentas hospedadas quando precisar
Os comandos locais da CLI funcionam sem conta Beancount.io. A ajuda de IA hospedada e o acesso via MCP são conexões separadas e opcionais.
bea ask responde a perguntas sobre um livro-razão local por meio do serviço de IA hospedado. Ele precisa do extra ask — uv tool install 'beancount-io[ask]' — além das suas credenciais Beancount.io.
O servidor MCP e os livros-razão hospedados também entram com a sua conta Beancount.io para autorizar o acesso. Comece local; conecte a hospedagem somente se quiser.
As habilidades de agente para Beancount residem no repositório do produto e são carregadas no seu agente separadamente — instalar o CLI não as instala nem configura.
Explore a conexão MCPSeu agente pode fazer a contabilidade. Você pode ver o trabalho.
Comece com um livro-razão local e um resultado verificável.