# O Ask AI da Beancount.io agora pode escrever lançamentos e ler recibos

*O recurso Ask AI evolui de uma ferramenta de perguntas e respostas somente leitura para um assistente completo e capaz de agir — apto a escrever lançamentos no livro-razão, aceitar imagens enviadas e muito mais.*

A Beancount.io anunciou hoje uma grande expansão de seu assistente de IA.

Quando o Ask AI foi lançado, ele respondia perguntas. Você podia perguntar sobre seus gastos, consultar saldos de contas, explorar seu livro-razão por meio de linguagem natural — e a IA respondia com informações extraídas de seus livros. Era um leitor, não um escritor. Um leitor poderoso, mas limitado: se você quisesse mudar algo, estava por conta própria.

Isso muda agora.

O assistente expandido sabe escrever. Peça a ele para corrigir um lançamento mal classificado, rascunhar uma nova transação a partir da sua descrição ou gerar um lote de lançamentos para um conjunto de despesas — e ele produzirá o texto exato do livro-razão, mostrará a você e aguardará sua aprovação antes de confirmar qualquer coisa. Nada muda em seus livros sem o seu aval.

Ele também sabe ler imagens. Envie um recibo, uma captura de tela de extrato bancário ou uma nota fiscal digitalizada. O assistente lê o que está na imagem, conecta-a às contas e categorias corretas com base nos padrões existentes do seu livro-razão e rascunha o lançamento apropriado para sua revisão.

É o mesmo assistente que você já usa. A mesma interface de conversa. O mesmo contexto que se mantém ao longo da sua sessão. A diferença é que agora ele consegue fechar o ciclo — da pergunta ao entendimento e à ação — sem que você precise sair do chat.

> "O Ask AI foi criado para ajudar você a entender suas finanças. Agora ele pode ajudar a mantê-las."
>
> — a equipe da Beancount.io

O assistente expandido está no ar em **/agent**.

## Experimente agora

O Ask AI está disponível para todos os usuários da beancount.io. Abra seu livro-razão e vá até **Ask AI** — a URL segue o padrão:

```
https://beancount.io/ledger/{your-username}/{your-ledger}/agent
```

**Coisas para experimentar:**

- *"Quanto gastei com restaurantes no mês passado?"* — consulta somente leitura, resposta instantânea
- *"Adicione uma transação: \$42 no Whole Foods em 20 de junho, mercado"* — o assistente rascunha o lançamento e aguarda sua aprovação
- Envie a foto de um recibo — o assistente a lê e propõe o lançamento correto no livro-razão

Toda escrita é exibida como uma prévia antes de qualquer coisa ser confirmada. Nada muda em seus livros sem a sua confirmação explícita.

## Perguntas frequentes

**P: O que o Ask AI conseguia fazer antes e o que ele faz agora?**

Antes: o Ask AI conseguia ler seu livro-razão e responder perguntas. Saldos, tendências de gastos, histórico de contas, buscas por transações — qualquer coisa que exigisse ler seus livros, mas não alterá-los.

Agora: ele também sabe escrever. Propor um novo lançamento, corrigir um existente ou registrar uma transação a partir de uma descrição ou de uma imagem enviada. Toda escrita é exibida a você como uma prévia antes de ser confirmada. Você aprova ou rejeita; nada é automático.

**P: Para onde vão os dados do meu livro-razão e das minhas imagens?**

Seus livros continuam sendo seus. O assistente lê apenas o necessário para responder à sua pergunta ou rascunhar o lançamento que você pediu, e nada é escrito ou confirmado sem a sua aprovação explícita. As imagens enviadas são usadas para produzir esse rascunho — nada além disso.

**P: Que tipos de imagens posso enviar?**

Recibos, notas fiscais, capturas de tela de extratos bancários ou qualquer documento que descreva uma transação financeira. O assistente lê o documento, identifica os detalhes relevantes e rascunha um lançamento Beancount. Se algo parecer errado — uma data, um valor, uma conta — você pode corrigir na conversa antes de aprovar a escrita.

**P: Existe algum risco de a IA editar meu livro-razão por engano?**

Não. Toda edição proposta é exibida a você como uma prévia explícita de antes/depois. O assistente não pode escrever no seu livro-razão sem uma etapa de confirmação. Isso não é uma configuração que você possa desativar por acidente — é assim que o fluxo de aprovação foi projetado.

**P: Minhas conversas atuais do Ask AI vão mudar?**

Não. Seu histórico de conversas e a interface familiar são mantidos. O assistente expandido é a mesma experiência do Ask AI, agora em **/agent**.

**P: E se a IA interpretar um recibo de forma errada ou rascunhar o lançamento errado?**

Revise antes de aprovar. O rascunho é exibido por completo — nomes de contas, valores, datas, narração — antes de qualquer coisa ser confirmada. Se algo estiver errado, diga ao assistente o que corrigir e ele revisará o rascunho. Nada é escrito até você autorizar.

**P: Como funciona o fluxo de aprovação para escritas?**

Quando o assistente determina que uma escrita é apropriada, ele produz uma proposta de edição estruturada: o arquivo, o texto original (se estiver modificando) e o texto de substituição. Isso é exibido ao usuário como uma prévia na conversa. O usuário confirma ou recusa. A confirmação dispara a escrita e o commit. A recusa retorna à conversa sem nenhuma alteração. O assistente nunca escreve sem uma etapa de confirmação explícita no meio.

**P: O envio de imagens exige mudanças na forma como o assistente acessa os dados do livro-razão?**

Não. A entrada por imagem é uma nova modalidade de entrada — o assistente agora pode aceitar uma imagem junto com o texto. O que ele faz com a imagem é o mesmo tipo de raciocínio que já aplica ao texto: extrair informações financeiras relevantes, compará-las com o contexto do livro-razão e propor um lançamento apropriado. O modelo de acesso ao livro-razão permanece inalterado.

**P: O que isso destrava no roadmap?**

O envio de imagens para recibos é a primeira modalidade de entrada além do texto. A mesma infraestrutura dá suporte a qualquer tipo de documento que carregue informações financeiras — notas fiscais, PDFs de extratos bancários, relatórios de despesas. A capacidade de escrita é a base para recursos como a conciliação assistida de transações bancárias (via Plaid) e a geração em massa de lançamentos a partir de arquivos importados. Nenhum deles exige rearquitetar o assistente — eles apenas adicionam novas entradas ou novos tipos de ação a um ciclo já existente.
