Agente de IA para Geração de Relatórios de Pagamentos

16 de November de 2025 • Tempo de leitura: 5 min

Automatiza a geração de relatórios detalhados sobre transações financeiras e oferece insights valiosos.

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 "Geração de Relatórios de Pagamentos", uma solução de automação projetada para gerar relatórios financeiros detalhados e oferecer insights valiosos para a gestão financeira. 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 compilação e análise de dados financeiros, gerando relatórios que oferecem insights sobre transações e tendências, além de fornecer visualizações claras para apoiar a tomada de decisão.

2. Contexto e Problema

Cenário Atual

O processo manual de geração de relatórios financeiros é demorado e frequentemente falho em oferecer insights detalhados e precisos para a gestão financeira. Atualmente, a equipe financeira enfrenta desafios significativos:

  • Tempo excessivo gasto na compilação manual de dados financeiros de diversas fontes.
  • Falta de insights detalhados sobre transações e tendências financeiras.
  • Necessidade de visualizações claras que facilitem a interpretação dos dados para a tomada de decisão.

Problemas Identificados

  • Consumo de tempo: O processo manual consome recursos significativos que poderiam ser utilizados em atividades mais estratégicas.
  • Falta de precisão: A análise manual está sujeita a erros e não captura adequadamente as tendências financeiras.
  • Dificuldade na visualização: A ausência de visualizações claras dificulta a interpretação dos dados e a tomada de decisões rápidas e informadas.

3. Impactos Esperados

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

  • Reduzir o tempo de geração de relatórios em pelo menos 70%.
  • Fornecer insights financeiros detalhados que suportem a gestão financeira estratégica.
  • Melhorar a precisão e a qualidade dos relatórios financeiros.
  • Facilitar a tomada de decisão através de visualizações claras e intuitivas.

4. Visão Geral da Solução

O agente de IA para geração de relatórios de pagamentos automatiza a compilação e análise de dados financeiros, gerando relatórios detalhados e visualizações que oferecem insights valiosos para a gestão financeira. 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 útil e autônomo na geração de relatórios financeiros que suportam a gestão estratégica.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a compilação de dados financeiros e termina com a geração de visualizações gráficas para apoio à decisão.

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

Agentes Função Principal
Agente de Compilação de Dados Financeiros (RF 1) Automatizar a compilação de dados financeiros para geração de relatórios.
Agente de Análise de Transações Financeiras (RF 2) Analisar dados financeiros compilados para identificar insights sobre transações e tendências.
Agente de Visualização de Dados Financeiros (RF 3) Gerar visualizações claras e fáceis de entender para apoiar a tomada de decisão financeira.

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.

6. Requisitos Funcionais

RF 1. Agente de Compilação de Dados Financeiros

1.1 Tarefa do Agente

Automatizar a compilação de dados financeiros para geração de relatórios.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados financeiros brutos em formato CSV ou planilhas Excel. Esses dados representam transações financeiras de diversas fontes.

# 2. Objetivo
Automatizar a compilação e conversão desses dados em um formato consolidado e estruturado para análise posterior.

# 3. Regras que você deve seguir para gerar sua resposta
- Coletar dados financeiros de todas as fontes especificadas.
- Converter os dados coletados no formato JSON, garantindo que estejam estruturados de forma consistente para análise posterior.
- Validar a integridade dos dados durante o processo de conversão.

# 4. Exemplo de Output que você deve produzir
{
  "transacoes": [
    { "data": "2025-11-16", "valor": 1500.00, "descricao": "Pagamento recebido" },
    { "data": "2025-11-16", "valor": -200.00, "descricao": "Taxa de serviço" }
  ]
} 
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 brutos em formato CSV ou Excel 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 são dados financeiros em formato CSV ou Excel.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .xlsx.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo no formato JSON que consolida os dados financeiros de forma estruturada.
  • Exemplo de Estrutura de Output:
     {
      "transacoes": [
        { "data": "2025-11-16", "valor": 1500.00, "descricao": "Pagamento recebido" },
        { "data": "2025-11-16", "valor": -200.00, "descricao": "Taxa de serviço" }
      ]
    } 
  • Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a quantidade de dados processados.

1.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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

  • 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 deve ser visível para o Agente de Análise de Transações Financeiras (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Transações Financeiras (RF 2).

RF 2. Agente de Análise de Transações Financeiras

2.1 Tarefa do Agente

Analisar dados financeiros compilados para identificar insights sobre transações e tendências.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados financeiros consolidados em formato JSON. Esses dados foram compilados por um agente anterior e contêm informações detalhadas sobre transações financeiras.

# 2. Objetivo
Analisar os dados consolidados para identificar padrões e anomalias nas transações, gerando insights detalhados sobre o comportamento financeiro.

# 3. Regras que você deve seguir para gerar sua resposta
- Analisar os dados para identificar padrões e anomalias nas transações.
- Gerar insights detalhados sobre o comportamento financeiro, destacando tendências significativas e potenciais áreas de risco.
- Estruturar o relatório analítico em Markdown, garantindo clareza nas informações apresentadas e destacando insights críticos para a gestão financeira.

# 4. Exemplo de Output que você deve produzir
**Relatório Analítico de Transações**

- **Data:** 2025-11-16
- **Transações Significativas:**
  - Pagamento recebido: R$ 1500,00
  - Taxa de serviço: R$ -200,00

### Tendências Identificadas
- Aumento significativo nas taxas de serviço no último mês.
- Redução nas receitas de pagamentos recorrentes. 
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 arquivo JSON que contém dados financeiros consolidados.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório analítico em formato Markdown, contendo insights sobre transações e tendências financeiras.
  • Exemplo de Estrutura de Output:
     **Relatório Analítico de Transações**
    
    - **Data:** 2025-11-16
    - **Transações Significativas:**
      - Pagamento recebido: R$ 1500,00
      - Taxa de serviço: R$ -200,00
    
    ### Tendências Identificadas
    - Aumento significativo nas taxas de serviço no último mês.
    - Redução nas receitas de pagamentos recorrentes. 
  • Número de caracteres esperado: O relatório deve ser conciso e informativo, com um tamanho estimado em torno de 3.000 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

2.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

2.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 deve ser visível para o Agente de Visualização de Dados Financeiros (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Visualização de Dados Financeiros (RF 3).

RF 3. Agente de Visualização de Dados Financeiros

3.1 Tarefa do Agente

Gerar visualizações claras e fáceis de entender para apoiar a tomada de decisão financeira.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um relatório analítico em formato Markdown. Este relatório foi gerado por um agente anterior e contém insights detalhados sobre transações e tendências financeiras.

# 2. Objetivo
Transformar os insights do relatório analítico em visualizações gráficas intuitivas que possam ser facilmente interpretadas por gestores financeiros.

# 3. Regras que você deve seguir para gerar sua resposta
- Transformar os insights do relatório analítico em visualizações gráficas intuitivas.
- Garantir que as visualizações sejam interativas e possam ser facilmente interpretadas por gestores financeiros.
- Assegurar que as visualizações ajudem na identificação rápida de tendências e padrões, facilitando a tomada de decisão.

# 4. Exemplo de Output que você deve produzir
```html

Tendências de Transações

```
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 relatório analítico em formato Markdown.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .md (Markdown).
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser em formato HTML, contendo visualizações gráficas dos insights financeiros.
  • Exemplo de Estrutura de Output:
    ```html
    

    Tendências de Transações

    ```
  • Número de caracteres esperado: O HTML gerado deve ser conciso e funcional, com um tamanho estimado em torno de 1.500 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

3.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

3.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.

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

A execução deste agente finaliza o fluxo. As visualizações geradas são o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.