Agente de IA para Classificação de Ativos Financeiros

Sanear, padronizar e validar os dados financeiros de cada ativo antes do cálculo de métricas.

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 um arquivo JSON contendo dados de ativos 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 do JSON 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 uma lista de ativos financeiros com seus dados associados.
• 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é 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON normalizado com dados padronizados e validados de cada ativo.
• Exemplo de Estrutura de Output:

   [{ 'ativo_id': '123', 'classe': 'acao', 'moeda': 'USD', 'datas_validas': ['2025-01-01'], 'precos_diarios': [{ 'data': '2025-01-01', 'preco_ajustado': 100.0 }], 'retornos_diarios': [{ 'data': '2025-01-01', 'ret': 0.01 }], 'benchmark_alinhado': [{ 'data': '2025-01-01', 'ret': 0.02 }], 'taxa_livre_risco_anual': 0.02, 'janela_dias': 252, 'qualidade_dado': { 'status': 'ok', 'motivos': [] }, 'elegivel_metricas': true }] 

• Número de caracteres esperado: O JSON final deve conter os dados padronizados e validados de cada ativo, com um tamanho estimado em torno de 5.000 caracteres por ativo.

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: Utiliza lógica interna para cálculos de retornos e validação de dados.
• 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 padronizadas de risco e retorno por ativo a partir dos dados validados.

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 JSON normalizado e validado com dados de ativos financeiros.
• 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é 100.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com métricas por ativo, incluindo retorno anualizado, volatilidade, Sharpe, Sortino, max drawdown, beta, tracking error, downside deviation, VaR 95% e qualidade das métricas.
• Exemplo de Estrutura de Output:

   [{ 'ativo_id': '123', 'janela_dias': 252, 'retorno_anualizado': 0.10, 'vol_anualizada': 0.15, 'sharpe': 0.67, 'sortino': 0.85, 'max_drawdown': -0.20, 'beta': 0.95, 'tracking_error': 0.05, 'downside_deviation': 0.12, 'var_95': -0.02, 'assuncoes': [], 'qualidade_metricas': 'alta' }] 

• Número de caracteres esperado: O JSON final deve conter as métricas calculadas para cada ativo, com um tamanho estimado em torno de 5.000 caracteres por ativo.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculos de métricas financeiras.
• 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 Classificação de Ativos Financeiros (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Ativos Financeiros (RF 3).

Classificar cada ativo em categorias de risco e retorno e gerar um escore composto para priorização.

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 JSON com métricas financeiras por ativo.
• 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é 100.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de classificação por ativo, incluindo categorias de risco e retorno, escore composto e justificativas.
• Exemplo de Estrutura de Output:

   [{ 'ativo_id': '123', 'categoria_risco': 'Médio', 'categoria_retorno': 'Alto', 'escore_composto': 85, 'metodologia': { 'base_limiar': 'percentil', 'limiares_risco': { 'baixo': 0.10, 'medio': 0.20 }, 'limiares_retorno': { 'baixo': 0.05, 'medio': 0.10 } }, 'justificativa': 'Vol: 0.15, Ret: 0.10, Sharpe: 0.67, Critério: percentil' }] 

• Número de caracteres esperado: O JSON final deve conter a classificação de cada ativo, com um tamanho estimado em torno de 5.000 caracteres por ativo.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculos de classificação.
• 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 deve ser visível para o Agente de Geração de Relatório de Investimento (RF 4).

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

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

Produzir relatório estruturado que auxilie a tomada de decisão de investimento a partir das classificações e métricas.

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: Este agente deve ser apto a receber como input um JSON de classificação por ativo e métricas.
• 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é 100.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em dois formatos: a) JSON estruturado com sumário e recomendações; b) Markdown com seções: Sumário executivo, Metodologia resumida, Tabela de ativos, Top recomendações por perfil, Alertas e ressalvas, Anexos de parâmetros.
• Exemplo de Estrutura de Output:

   {
    "sumario_executivo": "3 ativos em risco baixo, 2 em alto, melhor Sharpe: 0.67",
    "recomendacoes": {
      "conservador": ["ativo_1", "ativo_2"],
      "moderado": ["ativo_3"],
      "arrojado": ["ativo_4", "ativo_5"]
    }
  } 

   ## Sumário Executivo
  - 3 ativos em risco baixo
  - Melhor Sharpe: 0.67
  
  ## Metodologia Resumida
  ...
  
  ## Tabela de Ativos
  | Ativo | Risco | Retorno | Sharpe |
  |------|------|--------|--------|
  | ativo_1 | Baixo | Alto | 0.67 |
  
  ## Top Recomendações
  ### Conservador
  - ativo_1
  
  ## Alertas e Ressalvas
  - rf zero assumido
  
  ## Anexos de Parâmetros
  ...
  

• Número de caracteres esperado: O relatório final deve ser detalhado, com um tamanho estimado em torno de 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.
• Calculadora: Utiliza lógica interna para gerar recomendações e alertas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 gerada por este 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.