Agente de IA para Produção de Relatórios de Investimento

Normalizar, enriquecer e validar dados financeiros de entrada para um esquema padrão pronto para análise.

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 arquivos de dados financeiros 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 dos arquivos na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Arquivos de dados financeiros em formatos CSV, TSV ou JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .tsv, .json.
• 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 objeto JSON com dados normalizados, metadados e possíveis erros bloqueantes.
• Exemplo de Estrutura de Output:

   {
    "schema_version": "1.0",
    "dados_normalizados": [
      {"data_iso": "2025-01-01", "ticker": "AAPL", "preco_fechamento_ajustado": 150.0, "retorno_diario": 0.002, "moeda_base": "USD", "fonte": "B3"}
    ],
    "metadados": {
      "periodo": {"inicio": "2025-01-01", "fim": "2025-12-31"},
      "ativos": ["AAPL"],
      "soma_pesos_valida": true,
      "linhas_descartadas": 0,
      "metodo_missing": "interpolar",
      "conversoes_cambio": {"moedas_encontradas": ["BRL"], "moeda_base": "USD"},
      "avisos": [],
      "erros_bloqueantes": []
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Cálculo de Métricas de Risco e Retorno (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Métricas de Risco e Retorno (RF 2).

Calcular métricas de performance e risco para ativos e/ou portfólios a partir de dados padronizados.

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: Um JSON contendo dados normalizados com retorno diário por ticker.
• 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 JSON com métricas de performance e risco calculadas para cada ativo ou portfólio.
• Exemplo de Estrutura de Output:

   {
    "metrics_por_ticker": {
      "AAPL": {
        "retorno_total": 0.15,
        "CAGR": 0.12,
        "volatilidade_anual": 0.25,
        "sharpe": 0.48,
        "sortino": 0.60,
        "max_drawdown": -0.20,
        "calmar": 0.60,
        "var_parametrico": -0.05,
        "cvar_historico": -0.07
      }
    },
    "metrics_portfolio": {},
    "metrics_vs_benchmark": {},
    "periodo": {"inicio": "2025-01-01", "fim": "2025-12-31"},
    "supostos": {"dias_uteis_ano": 252, "taxa_sem_risco_anual": 0.04, "nivel_confianca_var": 0.95, "metodo_var": "parametrico"},
    "avisos": []
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

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 Consistência e Auditoria Analítica (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Consistência e Auditoria Analítica (RF 3).

Verificar consistência dos cálculos e coerência econômica, sinalizando anomalias e limites fora de faixas plausíveis.

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: Um JSON de métricas calculadas e uma amostra dos dados normalizados.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com resultados de auditoria e métricas validadas ou sinalizadas para correção.
• Exemplo de Estrutura de Output:

   {
    "auditoria": {
      "checks": [
        {"id_check": "retorno_total_consistencia", "status": "aprovado", "detalhes": "Retorno total consistente com soma dos retornos diários."}
      ],
      "recomendacoes_de_correcao": []
    },
    "metrics_validadas": {
      "AAPL": {
        "retorno_total": 0.15,
        "CAGR": 0.12,
        "volatilidade_anual": 0.25,
        "sharpe": 0.48,
        "sortino": 0.60,
        "max_drawdown": -0.20,
        "calmar": 0.60,
        "var_parametrico": -0.05,
        "cvar_historico": -0.07
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

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 deve ser visível para o Agente Gerador de Relatório de Investimentos (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Gerador de Relatório de Investimentos (RF 4).

Produzir relatório final estruturado com análises de risco e retorno, insights e recomendações baseadas nas métricas validadas.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Um JSON de metrics_validadas e auditoria, metadados do período, supostos e preferências de saída.
• 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é 12.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório final estruturado no formato solicitado (Markdown ou JSON estruturado).
• Exemplo de Estrutura de Output:

   {
    "capa": {"titulo": "Relatório de Investimentos", "data_emissao": "2025-12-04", "periodo": {"inicio": "2025-01-01", "fim": "2025-12-31"}},
    "resumo_executivo": [
      "Retorno total de 15% no período.",
      "Volatilidade anual de 25%, considerada alta.",
      "Drawdown máximo de 20%, dentro do esperado."
    ],
    "visao_geral": [...],
    "desempenho": {"tabela_metricas": [...], "comparacao_benchmark": [...]},
    "risco": {"vol": 0.25, "drawdown": -0.20, "VaR": -0.05, "CVaR": -0.07},
    "alertas_auditoria": [],
    "metodologia": {"definicoes": [...], "supostos": {...}},
    "recomendacoes": ["Revisar dados de câmbio", "Ampliar janela de observação"]
  } 

• Número de caracteres esperado: O relatório final deve ser claro e direto, com um tamanho estimado em 10.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

4.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 deste agente é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.