Os 12 agentes · finanças e folha de pagamento

O MyFinAI roda sobre o Lopettia Agent Framework (LAF): uma família de doze agentes com persona única —Felipe, o copiloto financeiro— que cobrem o ciclo completo do dinheiro, da captura ao fechamento. Cada agente tem um arquétipo, um lugar no fluxo e um alcance delimitado. Eles trabalham para a equipe; não a substituem.

O ciclo

flowchart LR
  Lente --> Libro --> Espejo --> Mayor
  Cobro & Mecenas & Salario & Fisco --> Mayor
  Caudal & Guardian & Norte -.observam.- Mayor
  Conclave((Cónclave)) --- Lente & Cobro & Salario & Fisco

O catálogo

Agente	Arquétipo	O que faz no negócio	No lar
Cónclave	Orquestrador (núcleo)	Detecta a intenção financeira e roteia ao especialista	O mesmo: coordena os demais
Lente	Captura / OCR	Lê recibos, banco e cartão e cria a movimentação	Captura lançamentos do lar
Libro	Contabilidade	Propõe a conta e monta o lançamento por partida dobrada	Categoriza o gasto doméstico
Espejo	Conciliação	Concilia o livro contra o extrato do banco	Concilia as contas do lar
Cobro	Contas a receber	Prioriza quais faturas perseguir e quando	—
Mecenas	Contas a pagar	Marca vencimentos e descontos por pagamento antecipado	Hipoteca, serviços, assinaturas
Salario	Folha de pagamento	Calcula bruto, retenções e líquido de cada rodada	As receitas que entram no lar
Fisco	Impostos	Prepara IVU, 941 e vencimentos a partir do livro	A declaração pessoal
Caudal	Fluxo de caixa	Projeta entradas e saídas semana a semana	As metas de poupança
Guardián	Fraude / anomalias	Marca lançamentos duplicados ou comércios desconhecidos	Fraude de cartão e assinaturas zumbi
Norte	Assistente NL + saúde	Responde em linguagem natural lendo o livro	A saúde do lar
Mayor	Fechamento e auditoria	Fecha o balancete, sela o fechamento e a cadeia de hash	O fechamento do mês em casa

Como trabalham

Determinísticos primeiro. Cada agente resolve com regras sobre o livro; a IA

(Claude) *pole* a resposta quando há chave disponível. Sem chave, o sistema segue operando.

Rastreáveis. Cada rodada é registrada em agent_runs com seu modelo, entrada,

saída e custo. Nada ocorre fora do registro.

Delimitados por papel e por inquilino. Um agente só vê o livro do espaço

ativo, e só os papéis autorizados o invocam. Norte, por exemplo, devolve 403 a um funcionário: não se extraem os livros pelo chat.

Somente leitura, por enquanto. Nesta versão os agentes informam e propõem;

mover dinheiro (emitir, pagar, rodar a folha) passa por uma pessoa. O caminho para dar-lhes ferramentas com aprovação humana (HITL) e teto de gasto está descrito em Segurança e em api/AUDIT.md.

A mesma família, dois contextos

Os doze agentes são os mesmos no negócio e no lar; apenas são reetiquetados. Mecenas paga fornecedores no café e a hipoteca em casa; Salario roda a folha de pagamento do negócio e registra a receita familiar. Uma única inteligência financeira, posta a serviço das duas faces da vida econômica de uma pessoa.

A ficha viva de cada agente (arquétipo, modelo, estado) é servida na seção

Agentes do console e está catalogada no repositório AIaaSAgents

como a vertical *Finanças & Folha de pagamento*.