PrototipeAI | Agente de IA para Validação de Simulações de Investimento

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 Agente de IA "Validação de Simulações de Investimento", uma solução projetada para validar simulações de investimento, garantindo que as premissas e cálculos estejam corretos e alinhados com as expectativas de mercado. 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 é assegurar a precisão das simulações de investimento, corrigindo premissas e cálculos inadequados que possam levar a decisões financeiras erradas.

2. Contexto e Problema

Cenário Atual

No cenário atual, analistas financeiros e investidores dependem de simulações de investimento para tomar decisões informadas. Contudo, erros nas premissas ou cálculos podem resultar em decisões de investimento prejudiciais. Problemas críticos incluem:

Uso de premissas desatualizadas ou incorretas nas simulações.
Erros nos cálculos que afetam a precisão dos resultados das simulações.

Problemas Identificados

Premissas Incorretas: As premissas usadas nas simulações podem não refletir as condições atuais do mercado, levando a projeções imprecisas.
Cálculos Errôneos: Pequenos erros nos cálculos podem se amplificar, resultando em previsões financeiras distorcidas.
Impacto nas Decisões: Decisões de investimento baseadas em simulações incorretas podem resultar em perdas financeiras significativas.

3. Impactos Esperados

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

Aumento da precisão das simulações de investimento em pelo menos 90%.
Redução do risco associado a decisões de investimento baseadas em simulações incorretas.
Otimização do tempo dos analistas financeiros, automatizando a validação de premissas e cálculos.

4. Visão Geral da Solução

O agente de IA para validação de simulações de investimento analisa dados de simulações, verifica a precisão das premissas e cálculos, e sugere ajustes conforme necessário. 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 eficaz na validação de simulações de investimento.

A solução é composta por dois agentes principais que trabalham em conjunto para garantir a precisão das simulações de investimento.

Agentes	Função Principal
`Agente de Validação de Premissas de Simulação` (RF 1)	Validar as premissas de simulações de investimento com base em dados de mercado atualizados.
`Agente de Verificação de Cálculos de Simulação` (RF 2)	Verificar a precisão dos cálculos envolvidos nas simulações de investimento.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram o fluxo de validação das simulações de investimento. 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 Validação de Premissas de Simulação

1.1 Tarefa do Agente

Validar as premissas de simulações de investimento com base em dados de mercado atualizados.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo premissas de simulação de investimento em formato JSON. Este documento contém suposições feitas por analistas financeiros para prever o desempenho de ativos.

# 2. Objetivo
Validar as premissas de simulação com base em dados de mercado atualizados e assegurar que estejam alinhadas com as expectativas e benchmarks do setor.

# 3. Regras que você deve seguir para gerar sua resposta
- Compare as premissas de simulação fornecidas com dados de mercado atualizados e benchmarks do setor.
- Identifique premissas desatualizadas ou inconsistentes e forneça sugestões de correção específicas com base nas últimas tendências e dados de mercado.
- O output deve ser um JSON com o status de validação das premissas e sugestões de correções, se necessário.

# 4. Exemplo de Output que você deve produzir
{
  "premissas": {
    "taxa_crescimento": "5%",
    "inflacao_esperada": "3%"
  },
  "status": "validação bem-sucedida",
  "sugestoes": "Nenhuma sugestão necessária."
}

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 premissas de simulação de investimento em formato JSON 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 arquivo JSON contendo as premissas de simulação de investimento.
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 texto com até 10.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON que contenha o status de validação das premissas e sugestões de correções, se necessário.

Exemplo de Estrutura de Output:

 {
  "premissas": {
    "taxa_crescimento": "5%",
    "inflacao_esperada": "3%"
  },
  "status": "validação bem-sucedida",
  "sugestoes": "Nenhuma sugestão necessária."
}

Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.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 diretamente.
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 Verificação de Cálculos de Simulação (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação de Cálculos de Simulação (RF 2).

RF 2. Agente de Verificação de Cálculos de Simulação

2.1 Tarefa do Agente

Verificar a precisão dos cálculos envolvidos nas simulações de investimento.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo cálculos de simulação de investimento em formato JSON. Este documento contém cálculos realizados por analistas financeiros para prever o desempenho de ativos.

# 2. Objetivo
Verificar a precisão dos cálculos envolvidos nas simulações, assegurando que sigam fórmulas financeiras padrão e práticas recomendadas do setor.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise cada cálculo para assegurar que siga fórmulas financeiras padrão e práticas recomendadas do setor.
- Identifique e destaque discrepâncias nos resultados, sugerindo ajustes específicos para corrigir erros e validar a consistência dos cálculos em relação a simulações semelhantes no mercado.
- O output deve ser um JSON com o status de precisão dos cálculos e sugestões de correções, se necessário.

# 4. Exemplo de Output que você deve produzir
{
  "calculos": {
    "roi": "8%",
    "lucro_liquido": "R$ 100.000"
  },
  "status": "validação bem-sucedida",
  "sugestoes": "Rever cálculo de ROI para considerar taxas de câmbio atuais."
}

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 arquivo JSON contendo cálculos de simulação de investimento.
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 texto com até 10.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON contendo o status de precisão dos cálculos e sugestões de correções, se necessário.