Agente de IA para Consolidação de Relatórios Financeiros

04 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que coleta e organiza dados financeiros de diversas fontes para gerar relatórios consolidados.

Biblioteca de Prompts e Agentes

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Fluxo de Agentes "Consolidação de Relatórios Financeiros", uma solução de automação projetada para integrar dados financeiros de múltiplas fontes e gerar relatórios consolidados. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é automatizar a coleta, consolidação e análise de dados financeiros, transformando informações dispersas em relatórios financeiros precisos e atualizados, prontos para análise e tomada de decisão.

2. Contexto e Problema

Cenário Atual

As empresas lidam com dados financeiros provenientes de diversas fontes, como APIs, documentos e bancos de dados. Este cenário gera desafios significativos:

  • Integração de dados financeiros de múltiplas fontes para consolidação eficiente.
  • Automatização de geração de relatórios financeiros precisos e atualizados.

Atualmente, o processo de consolidação é manual, o que aumenta o risco de erros, consome tempo valioso e limita a capacidade de gerar insights financeiros em tempo hábil.


Problemas Identificados

  • Fragmentação de Dados: Dados financeiros estão distribuídos em múltiplas fontes e formatos, dificultando a integração.
  • Processo Manual: A consolidação manual é demorada e propensa a erros, atrasando a geração de relatórios.
  • Falta de Insights: A ausência de uma visão consolidada dos dados financeiros impede a identificação de tendências e insights valiosos.
  • Dependência de Equipes: A necessidade de intervenção humana em cada etapa do processo sobrecarrega as equipes financeiras.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

  • Reduzir o tempo de consolidação de dados em pelo menos 70%.
  • Aumentar a precisão dos relatórios financeiros gerados.
  • Capacitar a geração de insights financeiros através de análises consolidadas e visualizações claras.
  • Diminuir a dependência das equipes financeiras para tarefas repetitivas e manuais.

4. Visão Geral da Solução

O agente de IA para consolidação de relatórios financeiros coleta e organiza dados financeiros de diversas fontes, aplica regras de mapeamento e normalização, e gera relatórios consolidados automaticamente. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente eficiente na consolidação de dados financeiros e geração de relatórios precisos.

A solução consiste em um fluxo de automação composto por 7 agentes de IA. O processo inicia com a definição do esquema de dados financeiros e termina com a geração de relatórios financeiros e insights.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes Função Principal
Agente de Definição de Esquema e Mapeamento Financeiro (RF 1) Definir o esquema unificado de dados financeiros, regras de mapeamento de contas e preparar parâmetros de coleta.
Agente de Execução de Chamada à API (RF 2) Realizar chamadas às APIs financeiras definidas e retornar dados brutos.
Agente de Execução de Consulta a Documento (RF 3) Ler arquivos CSV/XLSX informados e retornar os dados brutos.
Agente de Execução de Consultas em Banco de Dados (RF 4) Executar queries SQL nas conexões definidas e retornar dados brutos.
Agente de Harmonização e Consolidação Financeira (RF 5) Padronizar, deduplicar, mapear contas, converter moedas e consolidar registros no esquema unificado.
Agente de Fechamento e Consolidação Contábil (Opcional) Agente Condicionado (RF 6) Agrupar dados consolidados para gerar balancete, DRE simplificada e BP simplificado.
Agente de Geração de Relatórios Financeiros e Insights (RF 7) Gerar relatórios automatizados com análises e visualizações textuais claras.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Definição de Esquema e Mapeamento Financeiro

1.1 Tarefa do Agente

Definir o esquema unificado de dados financeiros, regras de mapeamento de contas, normalização de períodos e moedas, e preparar parâmetros de coleta para as diferentes fontes.

1.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de diferentes fontes financeiras. Este input inclui informações sobre APIs, documentos e bancos de dados que fornecem dados financeiros brutos.

# 2. Objetivo
Definir o esquema unificado de dados financeiros, regras de mapeamento de contas, normalização de períodos e moedas, e preparar parâmetros de coleta para as diferentes fontes.

# 3. Regras que você deve seguir para gerar sua resposta
- Derive moeda_base a partir do input; se ausente, definir como BRL.
- Definir campos_obrigatorios exatamente como: data_lancamento, conta, descricao, valor, moeda, fonte_id, id_transacao_origem.
- Normalizar timezone: todos os datetimes devem ser convertidos para UTC no schema (guardar apenas data se hora não for fornecida).
- Construir regras_mapeamento_contas combinando aliases do plano de contas de referência com padrões de texto (case-insensitive, acentuação ignorada).
- Gerar chaves_idempotencia como array mantendo a ordem [fonte_id, id_transacao_origem]; não incluir outros campos.
- Definir padroes_datas.ordem_tentativas exatamente na ordem: YYYY-MM-DD, DD/MM/YYYY, MM/DD/YYYY.
- Preparar parametros_execucao separados por tipo de fonte: apis, documentos, bancos; cada item deve referenciar fonte_id existente.
- Se tipo = api, preencher payload com method, url, headers, query e body conforme fontes; se algum campo não existir, usar valores vazios {}.
- Se tipo = documento, definir path absoluto ou lógico, sheet quando xlsx e delimitador quando csv.
- Se tipo = banco, definir alias de conexão e query SQL parametrizada dentro do período_referencia.
- Definir fx.fonte como BCB para BRL, ECB para EUR; se moeda_base não for suportada, usar Custom.
1.3 Configurações do Agente

1.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de dados financeiros de múltiplas fontes via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo consiste em dados financeiros de diferentes fontes, incluindo APIs, documentos e bancos de dados.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv, .xlsx, .sql.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados financeiros com até 100.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON que define o esquema unificado de dados financeiros e os parâmetros de execução para coleta de dados de diferentes fontes.
  • Exemplo de Estrutura de Output: 
     {
  "schema_unificado": {"campos_obrigatorios":[{"nome":"data_lancamento","tipo":"date"},{"nome":"conta","tipo":"string"},{"nome":"descricao","tipo":"string"},{"nome":"valor","tipo":"number"},{"nome":"moeda","tipo":"string"},{"nome":"fonte_id","tipo":"string"},{"nome":"id_transacao_origem","tipo":"string"}], "campos_opcionais":[{"nome":"centro_custo","tipo":"string"},{"nome":"projeto","tipo":"string"}]}, "moeda_base":"BRL", "fx": {"fonte":"BCB|ECB|Custom","metodo":"fechamento_diario","fallback":"ultimo_disponivel"}, "regras_mapeamento_contas": [{"conta_padrao":"Receita","criterios":{"descricao_contendo":["sale","faturamento"],"conta_origem":["4000","REV"]}}], "padroes_datas": {"ordem_tentativas":["YYYY-MM-DD","DD/MM/YYYY","MM/DD/YYYY"], "timezone_padrao":"UTC"}, "chaves_idempotencia": ["fonte_id","id_transacao_origem"], "parametros_execucao": {"apis": [{"fonte_id":"str","payload":{"method":"GET|POST","url":"str","headers":{},"query":{},"body":{}}}], "documentos": [{"fonte_id":"str","path":"/caminho/arquivo.csv|xlsx","sheet":"opcional","delimitador":","}], "bancos": [{"fonte_id":"str","conexao":"alias","query":"SELECT ..."}] } }
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.500 caracteres.

1.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

1.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

RF 2. Agente de Execução de Chamada à API

2.1 Tarefa do Agente

Realizar chamadas às APIs financeiras definidas e retornar dados brutos no período solicitado.

2.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de execução para realizar chamadas às APIs financeiras. Estes parâmetros incluem detalhes sobre o método de chamada, URL, cabeçalhos e outros dados necessários para a execução.

# 2. Objetivo
Realizar chamadas às APIs financeiras definidas e retornar dados brutos no período solicitado.

# 3. Regras que você deve seguir para gerar sua resposta
- Executar chamadas conforme os parâmetros fornecidos no payload.
- Retornar os dados brutos recebidos das APIs sem realizar transformações.
- Garantir que todas as chamadas sejam realizadas dentro do período especificado nos parâmetros de execução.
- Em caso de erro, registrar o erro para análise posterior e não interromper o fluxo de execução dos demais agentes.
2.3 Configurações do Agente

2.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
  • Tipo do input: Este agente deve ser apto a receber como input um objeto JSON que contém os parâmetros de execução para chamadas às APIs financeiras.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo os dados brutos retornados pelas APIs financeiras.
  • Exemplo de Estrutura de Output: 
     { "dados_api": [{"fonte_id":"str","registros":[{}]}] }
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: Não se aplica (uso de ferramenta)
  • Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: O agente deverá executar chamadas às APIs externas conforme os parâmetros de execução definidos.

2.3.5 Memória

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consulta a Documento (RF 3).

RF 3. Agente de Execução de Consulta a Documento

3.1 Tarefa do Agente

Ler arquivos CSV/XLSX informados e retornar os dados brutos respeitando delimitadores e planilhas.

3.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de execução para leitura de documentos financeiros. Estes parâmetros incluem detalhes sobre o caminho do arquivo, delimitadores e planilhas a serem lidas.

# 2. Objetivo
Ler arquivos CSV/XLSX informados e retornar os dados brutos respeitando delimitadores e planilhas.

# 3. Regras que você deve seguir para gerar sua resposta
- Carregar os arquivos conforme os parâmetros fornecidos, respeitando os delimitadores e planilhas especificadas.
- Retornar os dados brutos dos documentos sem realizar transformações.
- Em caso de erro na leitura, registrar o erro para análise posterior e não interromper o fluxo de execução dos demais agentes.
3.3 Configurações do Agente

3.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
  • Tipo do input: Este agente deve ser apto a receber como input um objeto JSON que contém os parâmetros de execução para leitura de documentos financeiros.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo os dados brutos retornados dos documentos financeiros.
  • Exemplo de Estrutura de Output: 
     { "dados_documentos": [{"fonte_id":"str","registros":[{}]}] }
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: Não se aplica (uso de ferramenta)
  • Temperatura: Não se aplica

3.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: O agente deverá ler documentos de arquivos CSV/XLSX conforme os parâmetros de execução definidos.

3.3.5 Memória

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados (RF 4).

RF 4. Agente de Execução de Consultas em Banco de Dados

4.1 Tarefa do Agente

Executar queries SQL nas conexões definidas e retornar dados brutos.

4.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de execução para consultas em banco de dados. Estes parâmetros incluem detalhes sobre a conexão e a query SQL a ser executada.

# 2. Objetivo
Executar queries SQL nas conexões definidas e retornar dados brutos.

# 3. Regras que você deve seguir para gerar sua resposta
- Executar as queries SQL conforme os parâmetros fornecidos.
- Retornar os dados brutos dos bancos de dados sem realizar transformações.
- Em caso de erro na execução da query, registrar o erro para análise posterior e não interromper o fluxo de execução dos demais agentes.
4.3 Configurações do Agente

4.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
  • Tipo do input: Este agente deve ser apto a receber como input um objeto JSON que contém os parâmetros de execução para consultas em banco de dados.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo os dados brutos retornados das consultas em banco de dados.
  • Exemplo de Estrutura de Output: 
     { "dados_bancos": [{"fonte_id":"str","registros":[{}]}] }
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 caracteres.

4.3.3 Parâmetros de Geração

  • Modelo: Não se aplica (uso de ferramenta)
  • Temperatura: Não se aplica

4.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: O agente deverá executar consultas SQL em bancos de dados conforme os parâmetros de execução definidos.

4.3.5 Memória

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Harmonização e Consolidação Financeira (RF 5).

RF 5. Agente de Harmonização e Consolidação Financeira

5.1 Tarefa do Agente

Padronizar, deduplicar, mapear contas, converter moedas e consolidar todos os registros brutos no schema unificado.

5.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados brutos de diferentes fontes financeiras, bem como o esquema unificado e as regras de mapeamento de contas.

# 2. Objetivo
Padronizar, deduplicar, mapear contas, converter moedas e consolidar todos os registros brutos no schema unificado.

# 3. Regras que você deve seguir para gerar sua resposta
- Unir registros de dados_api, dados_documentos e dados_bancos em uma única lista antes da transformação.
- Padronizar nomes de campos de origem para os do schema_unificado; se um campo obrigatório estiver ausente, descartar o registro e registrar o motivo como campo_obrigatorio_ausente..
- Parsing de datas: tentar na ordem definida em padroes_datas.ordem_tentativas; se não parsear, descartar com motivo data_invalida.
- Deduplicação: calcular hash_normalizado = SHA256(lower(trim(fonte_id)) + '|' + lower(trim(id_transacao_origem))); manter apenas o primeiro por hash; descartar duplicatas com motivo duplicado.
- Conversão cambial: se moeda_original == moeda_base, set cambio = 1; caso contrário, aplicar taxa do dia de data_lancamento; se indisponível, usar fallback definido; se ainda indisponível, descartar com motivo fx_indisponivel.
- Valor em moeda base: valor_moeda_base = round(valor_original * cambio, 2) com arredondamento half-up.
- Mapeamento de contas: aplicar regras_mapeamento_contas por prioridade: (1) conta_origem exata, (2) aliases no texto de descricao (case-insensitive), (3) fallback para 'Outras' se nada casar.
- Normalizar strings: remover acentos, trim e colapsar múltiplos espaços.
- Garantir que valor_original seja numérico; se vier como string com separador de milhar, remover separadores e converter usando ponto como decimal; se falhar, descartar com motivo valor_invalido.
- Limitar periodo: incluir apenas registros com data_lancamento entre periodo_referencia.inicio e fim; fora do período, descartar com motivo fora_do_periodo.
- Popular qualidade.registros_processados, qualidade.registros_validos e qualidade.registros_descartados coerentemente com as listas resultantes.
- Preencher proveniencia com par (id_transacao_origem, fonte_id, hash_normalizado) para todos os registros válidos.
5.3 Configurações do Agente

5.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
  • Tipo do input: Este agente deve ser apto a receber como input um objeto JSON que contém dados brutos de diferentes fontes financeiras, bem como o esquema unificado e as regras de mapeamento de contas.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 20.000 caracteres.

5.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo os dados financeiros consolidados e informações sobre a qualidade dos dados processados.
  • Exemplo de Estrutura de Output: 
     { "dados_consolidados": [{"data_lancamento":"YYYY-MM-DD","conta":"str","descricao":"str","valor_original":number,"moeda_original":"str","cambio":number,"valor_moeda_base":number,"fonte_id":"str","id_transacao_origem":"str","centro_custo":"str opcional","projeto":"str opcional"}], "qualidade": {"registros_processados": number, "registros_validos": number, "registros_descartados": number, "motivos_descarte": [{"motivo":"str","quantidade": number}]}, "proveniencia": [{"id_transacao_origem":"str","fonte_id":"str","hash_normalizado":"str"}] }
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.000 caracteres.

5.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

5.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

5.3.5 Memória

5.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente avalia a necessidade de acionar o Agente de Fechamento e Consolidação Contábil (RF 6). Se a política de consolidação exigir, este agente será acionado; caso contrário, o fluxo prossegue diretamente para o Agente de Geração de Relatórios Financeiros e Insights (RF 7).

RF 6. Agente de Fechamento e Consolidação Contábil (Opcional) Agente Condicionado

6.1 Tarefa do Agente

Agrupar os dados consolidados por período e contas para gerar balancete, DRE simplificada e BP simplificado quando a política de consolidação exigir.

6.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados financeiros consolidados e uma política de consolidação que determina a necessidade de gerar balancetes e demonstrações.

# 2. Objetivo
Agrupar os dados consolidados por período e contas para gerar balancete, DRE simplificada e BP simplificado quando a política de consolidação exigir.

# 3. Regras que você deve seguir para gerar sua resposta
- Executar apenas quando politica_consolidacao.consolidar = true.
- Mapear contas para grupos DRE/BP com base no plano de contas de referência: Receita, Deduções, Custo, Despesas Operacionais, Financeiro, Ativos, Passivos, PL.
- Somar valores em moeda base por conta/grupo respeitando sinais contábeis (receitas positivas, despesas negativas).
- Calcular receita_liquida = receita_bruta - deducoes; lucro_bruto = receita_liquida - custo_vendas; resultado_operacional = lucro_bruto - despesas_operacionais; lucro_prejuizo = resultado_operacional + resultado_financeiro.
- Se eliminacao_intercompany = true, marcar linhas que tenham contrapartes entre entidades e zerar pares; se não for possível identificar, adicionar nota 'intercompany_nao_identificado'.
6.3 Configurações do Agente

6.3.1 Condições de Ativação

Este agente é acionado somente se a seguinte condição for atendida:

6.3.2 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 5), apenas se a política de consolidação exigir.
  • Tipo do input: Este agente deve ser apto a receber como input um objeto JSON que contém dados financeiros consolidados e a política de consolidação.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 15.000 caracteres.

6.3.3 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo as demonstrações financeiras geradas, incluindo balancete, DRE e BP.
  • Exemplo de Estrutura de Output: 
     { "balancete": [{"conta":"str","valor_moeda_base": number}], "dre": {"receita_bruta": number, "deducoes": number, "receita_liquida": number, "custo_vendas": number, "lucro_bruto": number, "despesas_operacionais": number, "resultado_operacional": number, "resultado_financeiro": number, "lucro_prejuizo": number}, "bp": {"ativo_circulante": number, "ativo_nao_circulante": number, "passivo_circulante": number, "passivo_nao_circulante": number, "patrimonio_liquido": number} }
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 8.000 caracteres.

6.3.4 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

6.3.5 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

6.3.6 Memória

6.3.7 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios Financeiros e Insights (RF 7).

RF 7. Agente de Geração de Relatórios Financeiros e Insights

7.1 Tarefa do Agente

Gerar relatórios automatizados com análises e visualizações textuais claras a partir dos dados consolidados (e demonstrações, quando disponíveis).

7.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados financeiros consolidados, bem como demonstrações financeiras, quando disponíveis, para a geração de relatórios.

# 2. Objetivo
Gerar relatórios automatizados com análises e visualizações textuais claras a partir dos dados consolidados (e demonstrações, quando disponíveis).

# 3. Regras que você deve seguir para gerar sua resposta
- No Sumário Executivo, declarar período, moeda_base e totais agregados (soma de valor_moeda_base).
- Em Qualidade dos Dados, listar registros_processados, validos, descartados e top-3 motivos de descarte por quantidade.
- Em Principais Tendências, calcular variações percentuais m/m se o período cobrir mais de um mês; caso contrário, apresentar top-5 contas por valor absoluto.
- Em Detalhamento por Conta, produzir tabela com colunas: conta, total, percentual_do_total (round 1 casa).
- Se DRE estiver disponível, calcular e exibir: receita_liquida, lucro_bruto, resultado_operacional, lucro_prejuizo; comentar brevemente variações relevantes (>10%).
- Se BP estiver disponível, mostrar estrutura de capital: passivo total, PL e razão dívida/PL quando calculável.
- Gerar resumo_estruturado JSON com campos: total_periodo, top_contas:[{conta, valor}], margem_bruta (se DRE), qualidade:{processados, validos, descartados}.
7.3 Configurações do Agente

7.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5 ou RF 6).
  • Tipo do input: Este agente deve ser apto a receber como input um objeto JSON que contém dados financeiros consolidados e, opcionalmente, demonstrações financeiras.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 25.000 caracteres.

7.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório em markdown com seções detalhadas e um bloco JSON 'resumo_estruturado' com métricas-chave.
  • Exemplo de Estrutura de Output: 
     Relatório em markdown com seções: 1) Sumário Executivo, 2) Qualidade dos Dados, 3) Principais Tendências, 4) Detalhamento por Conta, 5) Indicadores, 6) Anexos. Além do markdown, produzir um bloco JSON 'resumo_estruturado' com métricas-chave.
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 12.000 caracteres.

7.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

7.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

7.3.5 Memória

  • Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
  • Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

7.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.

Posts Relacionados

© 2025 prototipe.ai. Todos os direitos reservados.