---
title: Os 12 agentes de finanças e folha de pagamento
persona: all
category: Documentação técnica
version: 1.0.0
updated: 2026-06-09
---

# 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

```mermaid
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](security.pt.html) 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*.