Roteamento da análise financeira

Comece pelo contexto

Toda análise abre com contexto_workspace: ele diz a data de hoje e o último mês fechado (base do período padrão), se a DRE está configurada (vinculo_dre), quais exercícios têm orçamento oficial, quais meses têm dados e o status do saldo âncora. Sem isso você chuta período e esconde premissa.

Indicador de resultado → financeiro_dre

Margem bruta, EBITDA, LAIR, lucro ou prejuízo, resultado, rentabilidade, receita líquida, deduções, "como fechou o mês/ano": tudo vem pronto da DRE, por período total ou por mês/trimestre/ano, realizado e orçado. Nunca monte resultado somando receita, custo e despesa por conta própria — a DRE tem deduções, depreciação, resultado financeiro e IR/CSLL que a soma ignora.

Caixa, saldo, burn, runway → financeiro_fluxo_caixa

"Caixa" sem qualificador é o fluxo de caixa (saldo, geração, queima), não o regime de caixa. Quantos meses de caixa, queima média, saldo inicial e final, entradas e saídas por conta ou por atividade: sempre por aqui.

Receitas, custos e despesas por período, dimensão, ranking e comparativo → financeiro_movimentacoes

tipos vazio traz as três naturezas com subtotais; "gastos" ou "saídas" = custo e despesa juntos; agrupamento por até duas dimensões (ou por mês); filtro por lista de valores de UMA dimensão (dimensao_filtro + filtros), e a busca alcança a subárvore (filtrar "Marketing" inclui as categorias filhas).

Valide o valor do filtro antes de filtrar → financeiro_dimensoes

Só filtre por um valor que existe na dimensão, e na natureza consultada. Categoria e centro de custo podem ter movimento em mais de uma natureza: para "gastos", valide em custo e em despesa; pergunta sem natureza declarada ("movimentações de Assinaturas") valida nas três. Consulte na natureza em que o valor existe, com o valor exato — nunca troque o valor pedido por outro parecido de outra natureza. Valor inexistente em todas as naturezas: não execute a análise; liste as opções válidas.

Fornecedores e clientes de um tema, e contagem de contrapartes → financeiro_contrapartes

A lista devolvida tem teto (limite): "quantos clientes/fornecedores" é total_contrapartes, nunca o tamanho da lista; se truncado = true, diga que a lista mostra os maiores e que o total é maior. Nunca conte rótulos de série das movimentações.

Lançamentos linha a linha → financeiro_lancamentos só quando pedido ("cada transação", "lista detalhada", "linha a linha", "os lançamentos"). Uma natureza por chamada, até 50 linhas, maior valor primeiro; truncado pede que você diga que há mais lançamentos no período.

Consulta temática ("quanto gastei com datacenter", "gastos com folha"): (i) financeiro_dimensoes em Centro_de_custo e em Categoria buscando nomes próximos ao tema; (ii) financeiro_contrapartes para fornecedores relacionados; (iii) uma chamada de financeiro_movimentacoes por dimensão encontrada, cada uma com dimensao_filtro e a lista de valores daquela dimensão — o filtro aceita uma dimensão por chamada; (iv) apresente por critério ("por centro de custo: …; por categoria: …; pelos fornecedores: …") e não some os critérios entre si: o mesmo lançamento pode cair em mais de um. Se o usuário quer um número só, escolha a dimensão mais aderente ao tema e diga qual foi. Nenhum ângulo com dados: "não encontrei movimentações associadas a [tema] nesta empresa".

Antes de afirmar que não há dados, tente ao menos um ângulo alternativo no mesmo turno (outro agrupamento, outra dimensão validada, contrapartes). Só afirme ausência depois de duas tentativas com ângulos diferentes, dizendo quais recortes consultou e oferecendo um ou dois caminhos como afirmação. DRE sem vínculo e orçamento sem cenário não são ausência de dados: são configuração pendente — diga exatamente isso.

Workspace explícito em toda chamada

Um só workspace: use-o. Mais de um: confirme de qual a pessoa fala antes de responder com números. Consolidado: uma chamada por workspace, só nos que liberam a família financeiro; resposta por workspace e o total na mesma convenção de sinal.

listar_workspaces (se ainda não sabe o workspace) → contexto_workspace.

Classifique a pergunta: resultado (DRE) · caixa (fluxo) · movimentação por recorte (movimentações, com dimensões e contrapartes de apoio) · lista (lançamentos).

Fixe o período: o pedido, ou o padrão (do início do ano até o último mês fechado; em janeiro, o ano anterior inteiro; períodos relativos excluem o mês atual), sempre AAAA-MM-01 mensal e inclusivo, dentro dos meses com dados.

Se há filtro ou tema, valide os valores (regras 5 e 8) antes da chamada principal.

Faça a chamada principal; se a comparação se aplica (skill de comparação e projeção), a segunda chamada é o mesmo período do ano anterior.

Leia apresentacao e os avisos de cobertura; responda pela skill de apresentação.

"Qual foi a margem em junho?" → contexto → financeiro_dre de 2026-06-01 a 2026-06-01. Errado: movimentações de receita e custo e a conta feita à mão.

"Quantos meses de caixa temos?" → contexto → financeiro_fluxo_caixa do intervalo recente; runway e queima média vêm prontos. Errado: dividir saldo por despesa mensal.

"Quanto gastei com nuvem este ano?" → dimensões (Categoria e Centro_de_custo, em custo e em despesa) e contrapartes para achar os nomes exatos → uma chamada de movimentações por dimensão encontrada, com tipos custo e despesa → resposta por critério. Errado: filtrar por "cloud" sem validar, ou somar o total por categoria com o total por fornecedor.

"Me mostra cada lançamento de aluguel em julho" → dimensões (Categoria em despesa) → financeiro_lancamentos tipo despesa, filtro Categoria = valor exato.

"Como está a empresa?" com três workspaces disponíveis → confirme o workspace antes de qualquer número.