PrototipeAI | Agente de IA para Relatórios Financeiros Personalizados

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Agente de IA "Relatórios Financeiros Personalizados". 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 é desenvolver um sistema de geração de relatórios que utilize dados específicos de cada cliente para criar documentos personalizados, incluindo análises detalhadas e visualizações que facilitem o entendimento do status financeiro e dos investimentos.

2. Contexto e Problema

No cenário atual, muitos clientes recebem relatórios financeiros genéricos, que não atendem às suas necessidades individuais. A falta de personalização na apresentação do status financeiro e dos investimentos é um problema recorrente, dificultando a compreensão e a tomada de decisões informadas pelos clientes.

3. Impactos Esperados

A implementação deste agente visa alcançar os seguintes resultados:

Melhoria na personalização dos relatórios financeiros, atendendo às necessidades específicas de cada cliente.
Aumento da clareza e da compreensão dos relatórios através de análises detalhadas e visualizações eficazes.
Facilitação da tomada de decisões financeiras mais informadas por parte dos clientes.

4. Visão Geral da Solução

O agente de IA para relatórios financeiros personalizados coleta dados financeiros específicos de cada cliente, analisa e gera relatórios detalhados, incluindo visualizações que facilitam o entendimento do status financeiro e dos investimentos. 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 elaboração de relatórios personalizados que seguem as especificidades de cada cliente.

A solução consiste em um fluxo de automação composto por dois agentes de IA. O processo inicia com a coleta de dados financeiros e culmina na geração de um relatório financeiro personalizado.

Agentes	Função Principal
`Agente de Coleta de Dados Financeiros` (RF 1)	Coletar e organizar dados financeiros específicos de cada cliente para a geração de relatórios personalizados.
`Agente de Análise e Visualização Financeira` (RF 2)	Analisar os dados financeiros coletados e gerar visualizações que facilitem o entendimento do status financeiro e dos investimentos.

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 Coleta de Dados Financeiros

1.1 Tarefa do Agente

Coletar e organizar dados financeiros específicos de cada cliente para a geração de relatórios personalizados.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados financeiros brutos de clientes, incluindo investimentos, despesas e receitas. Este é o ponto de partida para a geração de relatórios financeiros personalizados.

# 2. Objetivo
Coletar e organizar dados financeiros específicos de cada cliente para a geração de relatórios personalizados.

# 3. Regras que você deve seguir para gerar sua resposta
- Os dados devem ser categorizados por tipo de investimento e período.
- Garantir a precisão dos dados coletados, corrigindo discrepâncias através de validação cruzada com fontes confiáveis.
- Assegurar que os dados financeiros recebidos estejam atualizados e dentro do período de relatório especificado.

# 4. Exemplo de Output que você deve produzir
{
  "cliente_id": "12345",
  "dados_financeiros": {
    "investimentos": [
      { "tipo": "ações", "valor": 50000 },
      { "tipo": "imóveis", "valor": 150000 }
    ],
    "despesas": 20000,
    "receitas": 100000
  }
}

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 de clientes 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 é um conjunto de dados financeiros brutos.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .json.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um JSON estruturado com dados financeiros organizados por cliente.

Exemplo de Estrutura de Output:

 {
  "cliente_id": "12345",
  "dados_financeiros": {
    "investimentos": [
      { "tipo": "ações", "valor": 50000 },
      { "tipo": "imóveis", "valor": 150000 }
    ],
    "despesas": 20000,
    "receitas": 100000
  }
}

Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.000 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

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 e Visualização Financeira (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 e Visualização Financeira (RF 2).

RF 2. Agente de Análise e Visualização Financeira

2.1 Tarefa do Agente

Analisar os dados financeiros coletados e gerar visualizações que facilitem o entendimento do status financeiro e dos investimentos.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON estruturado com dados financeiros organizados por cliente. Este é o ponto de partida para a análise e visualização dos dados financeiros.

# 2. Objetivo
Analisar os dados financeiros coletados e gerar visualizações que facilitem o entendimento do status financeiro e dos investimentos.

# 3. Regras que você deve seguir para gerar sua resposta
- Incluir visualizações que representem o desempenho dos investimentos ao longo do tempo, utilizando gráficos de linha e barras para clareza.
- Identificar e destacar áreas de melhoria ou risco com base em análises comparativas e tendências históricas.
- Incluir comparações com benchmarks de mercado relevantes, fornecendo contexto para o desempenho financeiro do cliente.

# 4. Exemplo de Output que você deve produzir
**Relatório Financeiro para Cliente 12345**

### Investimentos
- **Ações:** R$ 50.000
- **Imóveis:** R$ 150.000

### Desempenho ao Longo do Tempo
- Gráfico de linha representando o crescimento das ações nos últimos 5 anos.
- Gráfico de barras comparando o desempenho de imóveis com o mercado.

### Análise de Risco
- Identificação de áreas de risco em investimentos de ações.
- Recomendações para mitigação de riscos identificados.

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 bem-sucedida do agente anterior (RF 1).
Tipo do input: Este agente deve ser apto a receber como input um JSON estruturado com dados financeiros organizados por cliente.
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é 5.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório financeiro detalhado em formato markdown com gráficos e análises personalizadas.