Como criar um agente de IA no financeiro sem programar
Como criar um agente de IA no financeiro sem programar: 5 passos, skill do Claude como ferramenta e aprovação humana para o que mexe com dinheiro.
Resposta direta
Para criar um agente de IA no financeiro sem programar, siga cinco passos: escolha um processo repetitivo e de baixo risco, escreva em português o objetivo e as regras, dê a ele uma ferramenta que faça a conta (uma skill do Claude, por exemplo), entregue os dados num formato fixo e ponha uma aprovação humana antes de qualquer coisa que mexa com dinheiro.
Uma forma de criar o agente é empacotar a instrução e a ferramenta numa skill: uma pasta com um arquivo de instruções que diz ao Claude o que fazer e quando. A skill não é o agente inteiro; o agente é o Claude conduzindo a skill, dentro das paradas e da aprovação que você definir. Comece assistido (ele propõe, você aprova) e só dê autonomia depois de conferir as saídas em alguns ciclos.
Quais são os 5 passos para criar um agente de IA?
É o mesmo arco de treinar um analista júnior: você diz o que entregar, mostra as ferramentas, entrega os dados e confere cada passo no começo. Exemplo: um agente que audita as tarifas de um extrato bancário.
- Escolha um processo estreito. “Somar as tarifas do extrato do ano e mostrar por banco, mês e tipo.” Um escopo amplo mistura regras de áreas diferentes, e você deixa de saber qual regra gerou qual número; um agente de uma tarefa dá para conferir.
- Escreva o objetivo e as regras em português. O que ele entrega, em que formato, o que ele nunca faz (lançar, pagar, alterar cadastro) e quando ele para e te chama. Esse texto vira a instrução do agente, seja numa skill ou num Project.
- Dê uma ferramenta que calcule. Pedir ao modelo que “some de cabeça” é o erro clássico. O agente decide quando chamar a ferramenta e o que fazer com o resultado; quem faz a conta é o motor (um script); a skill traz as instruções para o Claude acioná-lo.
- Arrume os dados uma vez. No exemplo, o extrato do ano em OFX ou CSV, um arquivo por conta, do jeito que o internet banking exporta. A fricção costuma estar na entrada, não na IA: extrato em PDF e cadastro com CNPJ trocado viram erro em escala.
- Coloque a aprovação humana. Começa em tudo (você aprova cada passo) e vira exceção (ele resolve sozinho até uma alçada e escala o resto). O ponto de controle humano é o que torna razoável deixar um software trabalhar perto de dinheiro.
Como criar um agente de IA como skill do Claude?
A skill empacota os passos 2 e 3 sem você escrever programa. Segundo a documentação da Anthropic, ela é uma pasta com um arquivo de skill que começa com um cabeçalho com name e description, e o zip deve ter a pasta da skill na raiz. O recurso exige a execução de código ligada. O nome do arquivo depende de onde você usa: a ajuda do claude.ai manda criar skill.md; no Claude Code ele se chama SKILL.md (com essa grafia), em ~/.claude/skills/<nome>/ para a skill pessoal ou .claude/skills/<nome>/ para a de projeto.
O que vai dentro do arquivo de instruções, para o agente de auditar tarifas:
---
name: auditar-tarifas
description: Soma as tarifas de um extrato OFX por banco, mês e tipo, com o IOF separado. Use quando eu pedir para auditar as tarifas do banco.
---
# Auditar tarifas
1. Peça o extrato em OFX ou CSV: o caminho do arquivo ou o arquivo anexado. Não peça para colar o conteúdo.
2. Rode o script scripts/auditar_tarifas.py desta skill pelo caminho
completo da pasta dela, com o arquivo entre aspas. No Claude Code:
python "${CLAUDE_SKILL_DIR}/scripts/auditar_tarifas.py" "<arquivo.ofx>" --ano <ano>
3. Leia só o resumo que o script imprime e me apresente: total de
tarifa, quebra por tipo e o IOF à parte.
4. Se o veredicto for CONFERIR, pare e me diga quantos lançamentos
ficaram sem classificação. Não adivinhe o tipo.
5. Termine pedindo que eu revise o relatório e aprove antes de usá-lo.
## Nunca
- Lançar, pagar ou alterar qualquer coisa.
- Somar de cabeça: o número vem sempre do script.
- Aceitar PDF: avise que o extrato precisa ser OFX ou CSV.
No comando, ${CLAUDE_SKILL_DIR} é uma variável do Claude Code que aponta para a pasta da skill, então o script é chamado de qualquer pasta de trabalho. A pasta pronta, com o motor do Auditor de Tarifas ao lado do arquivo de instruções, fica assim (no zip do claude.ai o arquivo se chama skill.md; no Claude Code, SKILL.md):
auditar-tarifas/
SKILL.md (skill.md no zip do claude.ai)
scripts/
auditar_tarifas.py
engine/
exemplo/
extrato_341.ofx
O passo a passo, para quem é do financeiro:
- Baixe o motor. A página do Auditor de Tarifas leva ao repositório aberto (Apache-2.0). Copie de lá as pastas
scriptseexemplopara dentro deauditar-tarifase grave o arquivo acima: comoSKILL.mdpara o Claude Code, ou comoskill.mdse for montar o zip para o claude.ai. - Compacte
auditar-tarifasem zip, com a pasta no topo e não o arquivo solto, e instale como no tutorial como instalar uma skill no Claude. No Claude Code, também vale deixar a pasta direto em~/.claude/skills/ou.claude/skills/, e o Claude acessa o arquivo pelo caminho; no claude.ai você anexa o extrato na conversa, e o tutorial explica o que sobe em cada caso. - Teste com o extrato fictício
exemplo/extrato_341.ofx, pedindo “audite as tarifas de 2025 desse extrato”. É o mesmo comando da demo da página da ferramenta, e a saída é esta:
Total de tarifa no periodo: R$ 191.90
Total de IOF (imposto, a parte): R$ 8.32
Periodo coberto: 2025-01 a 2025-02
Por tipo:
boleto: R$ 3.90
cartao: R$ 120.00
custodia: R$ 15.00
manutencao: R$ 29.90
outra_tarifa: R$ 4.20
pix: R$ 1.50
saque_extrato: R$ 6.50
transferencia: R$ 10.90
Nao-classificados a conferir: 1
Veredicto: CONFERIR
- Leia o veredicto. O extrato tem um lançamento que o motor não reconheceu (
outra_tarifa), e por isso o veredicto é CONFERIR: o agente da skill acima deve parar e avisar, em vez de adivinhar. Isso é uma regra de parada, não uma aprovação: quem aprova é você, ao revisar o relatório. - Revise e aprove. Confira o relatório contra uma conta à mão e só então use um arquivo real.
O limite: a skill é instrução, e o Claude pode não segui-la à risca, por isso o teste do passo 3. Uma regra de parada escrita na skill orienta o Claude, mas não é trava de permissão; para ação financeira, a aprovação é humana e fica fora da skill. A skill também não cria o motor: exija sempre um resultado verificável do script, não uma conta feita pelo modelo. O Auditor serve de modelo porque já vem com motor; ele só audita tarifa de OFX ou CSV, não serve para PDF e não concilia.
Onde montar o agente: skill ou Project?
- Project: você guarda o contexto (plano de contas, política) numa pasta de conhecimento e pede a tarefa em português. Funciona bem quando o trabalho é organizar texto e contexto.
- Skill: o Claude conduz uma instrução sua e, se houver, aciona um motor. Dá controle sobre a regra e sobre quando parar. Para escolher entre as peças, veja skill, prompt e Project.
Escolha pela entrada que você tem: se o dado já é um arquivo exportável e a saída é conferível, a skill com motor se encaixa; se o trabalho é organizar texto e contexto, o Project pode bastar.
Quais são os limites e os riscos de um agente de IA?
Montar ficou fácil, responder pelo número não. Quem responde pelo resultado continua sendo você: o agente não assina o SPED, não defende a divergência na diretoria e não decide o tratamento fiscal.
Onde ele roda é decisão de privacidade. No claude.ai e no Cowork, o trabalho roda na nuvem da Anthropic e o arquivo sobe para lá. Nas skills da FAL, como o Auditor, no Claude Code em sessão local, a skill foi feita para o Claude ler só o resumo, mas o seu pedido, esse resumo e qualquer arquivo que o Claude abrir vão para a Anthropic.
Ele não tem o seu faro. Um analista estranha um lançamento que “não tem cara de aluguel”. O agente segue o que você desenhou, inclusive o erro, e pode errar mesmo com a regra certa. Por isso as saídas precisam de conferência, principalmente no começo.
Autonomia sem log é problema de auditoria. Antes de subir os níveis de autonomia, garanta o registro: se o agente mexe com dinheiro, você precisa reconstruir qual regra rodou, com qual dado e quem liberou. “A IA fez” não fecha a conversa com o auditor.
Perguntas relacionadas
Preciso saber programar para criar um agente de IA?
Para usar, não: o Claude executa por você o comando do motor. O que você precisa é saber ler o resultado e refazer uma conta à mão. Programar só entra se quiser escrever o seu próprio motor; até lá, use um pronto, como o do Auditor de Tarifas (Apache-2.0), e anote o que precisaria mudar.
Por onde começo a criar meu primeiro agente?
Escolha o primeiro processo com três testes: a entrada existe como arquivo que você exporta hoje (OFX, CSV), você consegue conferir a saída com uma conta à mão, e alguém aprova antes de o resultado sair da sua mesa. Somar as tarifas de um extrato passa nos três. Fechamento inteiro, não.
Um agente de IA é diferente de um chatbot?
Sim. O chatbot responde ao que você escreve. O agente recebe um objetivo, decide quais ferramentas chamar e em que ordem, e entrega um resultado, parando onde você definiu a regra de parada. Na prática financeira, a diferença é ter ferramenta que calcula e regra de parada, não só uma boa conversa.
Como testar um agente de IA antes de usar com dado real?
Monte um arquivo fictício com os mesmos campos do real e inclua de propósito os casos difíceis: linha duplicada, valor com sinal trocado, documento em branco. Rode o agente, calcule o resultado à mão e compare. Se a saída divergir, ajuste a regra escrita e repita. Só depois use um arquivo real, com você revisando o resultado.
Próximo passo
Rode a demo do passo 3 antes de escrever a sua: com o extrato fictício você vê a saída e o CONFERIR antes de usar um extrato seu. Para entender o que você está montando, leia o que um agente de IA realmente é e onde ele quebra.
Esta peça é um degrau de IA para finanças: o guia do operador, o mapa que reúne a escada completa, do que é IA à aplicação no fechamento.
O guia do operador: IA para finanças, do chão à aplicação.
A escada inteira do Aprender num PDF só. O que destrava a sua rotina, sem teoria.
- Um exemplo brasileiro real em cada conceito (NFS-e, OFX, plano de contas)
- O que a IA faz, e o que ela NÃO faz no seu fechamento
- Da primeira conversa ao agente que concilia o seu extrato
- Conciliação, FP&A e régua de cobrança aplicados
Recebe no seu e-mail
Confirma no link que chega. Sem spam, cancela quando quiser.