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.