PrototipeAI | Agente de IA para Relatórios de Desempenho de Investimentos

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 "Relatórios de Desempenho de Investimentos", uma solução de automação projetada para gerar relatórios detalhados sobre o desempenho dos investimentos dos clientes. 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 geração de relatórios com dados atualizados e precisos, destacando informações chave como ganhos, perdas e tendências de mercado de forma clara.

2. Contexto e Problema

Cenário Atual

As empresas enfrentam dificuldades em gerar relatórios precisos e detalhados sobre o desempenho dos investimentos, o que pode impactar negativamente a tomada de decisões dos clientes. Problemas específicos incluem:

Dificuldade em destacar de forma clara as tendências de mercado e o impacto nos investimentos.
Necessidade de dados atualizados e precisos para análises confiáveis.

Atualmente, a geração de relatórios é um processo manual, suscetível a erros e demorado, o que pode atrasar a entrega de informações críticas aos clientes.

3. Impactos Esperados

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

Automatizar a geração de relatórios para garantir precisão e atualidade das informações.
Destacar informações chave como ganhos, perdas e tendências de mercado de forma clara e compreensível.
Acelerar o processo de geração de relatórios, reduzindo o tempo de entrega aos clientes.
Auxiliar na tomada de decisões dos clientes com base em análises precisas e atualizadas.

4. Visão Geral da Solução

O agente de IA para relatórios de desempenho de investimentos processa dados atualizados sobre ganhos, perdas e tendências de mercado, gerando relatórios detalhados e precisos para os clientes. 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 que seguem as especificidades da sua empresa.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a coleta de dados de investimentos e termina com a geração de relatórios detalhados.

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

Agentes	Função Principal
`Agente de Coleta de Dados de Investimentos` (RF 1)	Automatizar a coleta de dados atualizados sobre o desempenho dos investimentos dos clientes.
`Agente de Análise de Desempenho de Investimentos` (RF 2)	Analisar os dados de investimentos para gerar relatórios detalhados sobre desempenho.

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 de Investimentos

1.1 Tarefa do Agente

Automatizar a coleta de dados atualizados sobre o desempenho dos investimentos dos clientes.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você deve coletar dados atualizados sobre o desempenho dos investimentos dos clientes a partir de fontes confiáveis.

# 2. Objetivo
Garantir que os dados coletados sejam completos, precisos e estejam no formato correto para análise posterior.

# 3. Regras que você deve seguir para gerar sua resposta
- Obtenha dados de fontes confiáveis, garantindo precisão e atualize os dados em tempo real para refletir as mudanças de mercado.
- Certifique-se de que os dados coletados sejam completos e estejam no formato correto para análise posterior.

# 4. Exemplo de Output que você deve produzir
Dados brutos sobre ganhos, perdas e tendências de mercado.

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 uma requisição via API para coleta de dados de investimentos. 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 é uma requisição de dados de investimentos.
Formatos Suportados: Esse agente deve ser capaz de receber requisições em formatos: .json.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo no formato JSON contendo dados brutos sobre ganhos, perdas e tendências de mercado.

Exemplo de Estrutura de Output:

 {
  "dados_investimentos": [
    {
      "tipo": "ganhos",
      "valor": "1000"
    },
    {
      "tipo": "perdas",
      "valor": "500"
    }
  ]
}

Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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.
Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Desempenho de Investimentos (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 Desempenho de Investimentos (RF 2).

RF 2. Agente de Análise de Desempenho de Investimentos

2.1 Tarefa do Agente

Analisar os dados de investimentos para gerar relatórios detalhados sobre desempenho.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados brutos sobre ganhos, perdas e tendências de mercado.

# 2. Objetivo
Analisar os dados coletados para identificar ganhos, perdas e tendências de mercado e gerar relatórios detalhados sobre o desempenho dos investimentos.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise os dados coletados para identificar ganhos, perdas e tendências de mercado.
- Destaque as informações chave de forma clara e interprete padrões que possam impactar os investimentos.
- Certifique-se de que os relatórios sejam compreensíveis e úteis para a tomada de decisões dos clientes.

# 4. Exemplo de Output que você deve produzir
Relatórios detalhados sobre o desempenho dos investimentos, destacando ganhos, perdas e tendências de mercado.

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 contendo dados brutos sobre ganhos, perdas e tendências de mercado.
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 arquivo no formato JSON contendo relatórios detalhados sobre o desempenho dos investimentos.