Agente de IA para Análise Comparativa de Fundos de Investimento

Definir o universo de fundos, período de análise, benchmarks, moedas e fontes; produzir parâmetros prontos para execução de coleta via APIs, consulta a documentos e busca online.

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 lista inicial de fundos 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 é uma lista de fundos e informações do investidor.
• Formatos Suportados: Esse agente deve ser capaz de receber dados em formatos estruturados como JSON ou CSV.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto estruturado em JSON contendo os parâmetros de coleta definidos.
• Exemplo de Estrutura de Output:

   {
    "api_payloads": [...],
    "document_queries": [...],
    "search_terms": [...],
    "normalization_schema": {...},
    "benchmark_map": {...},
    "risk_free_spec": {...},
    "metrics_requested": [...],
    "fontes_priorizadas": [...]
  } 

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

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Consulta documentos externos para definir parâmetros.
• Calculadora: Não utiliza.
• Busca Online: Utiliza para complementar lacunas objetivas.
• Sistemas Externos: Não se conecta a sistemas externos diretamente.

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 Execução de Chamada à API (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

Realizar chamadas às APIs de provedores de dados de fundos para obter séries de cota, AUM, taxas, classificação, benchmark e metadados.

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 api_payloads prontos para a execução das chamadas.
• 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é 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um array em JSON com respostas brutas por chamada, preservando metadados de fonte e timestamps.
• Exemplo de Estrutura de Output:

   {
    "api_results": [
      {
        "source": "B3",
        "data": [...],
        "timestamp": "2025-12-07T12:09:00Z"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Realiza chamadas para APIs externas conforme parâmetros recebidos.

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 Execução de Consulta a Documento (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consulta a Documento (RF 3).

Realizar consultas a documentos (ex.: factsheets, regulamentos, lâminas) para extrair informações de taxas, benchmark declarado, política e eventos relevantes.

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 document_queries prontos para a execução das consultas.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um array em JSON com trechos extraídos e campos estruturados por documento consultado.
• Exemplo de Estrutura de Output:

   {
    "document_results": [
      {
        "doc_type": "factsheet",
        "extracted_fields": {...},
        "timestamp": "2025-12-07T12:09:00Z"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 4.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

3.3.4 Ferramentas do Agente

• Documentos: Realiza consultas a documentos conforme parâmetros recebidos.
• 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 de Busca Online (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online (RF 4).

Executar buscas online restritas a domínios oficiais para recuperar dados ausentes (ex.: último factsheet, comunicados).

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 search_terms prontos para a execução das buscas.
• 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é 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um array em JSON com URLs, snippets, datas e arquivos recuperados.
• Exemplo de Estrutura de Output:

   {
    "search_results": [
      {
        "url": "https://siteoficial.com/docs/factsheet",
        "snippet": "Último factsheet disponível...",
        "date": "2025-12-07",
        "file": "factsheet_2025.pdf"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Realiza buscas online conforme parâmetros recebidos.
• 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 gerada por este agente deve ser visível para o Agente de Normalização e Consolidação de Dados (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Consolidação de Dados (RF 5).

Unificar e normalizar os dados brutos coletados de múltiplas fontes em um dataset consistente para cálculo de métricas.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber dados normalizados de múltiplas fontes.
• 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é 25.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset normalizado contendo séries de cota diárias, séries de benchmark, série risk-free, metadados e data_quality_report.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": {
      "series_cota_diaria": [...],
      "series_benchmark": [...],
      "serie_risk_free": [...],
      "metadados": {...},
      "data_quality_report": {...}
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 10.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para normalização de dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.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 Desempenho (RF 6).

5.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 Desempenho (RF 6).

Calcular métricas de retorno e risco padronizadas para cada fundo e seus benchmarks.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber datasets normalizados para cálculo de 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 até 20.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo metrics_by_fund com valores calculados e flags de qualidade do cálculo.
• Exemplo de Estrutura de Output:

   {
    "metrics_by_fund": {
      "CAGR": [...],
      "Volatilidade": [...],
      "Sharpe": [...],
      "Sortino": [...],
      "DrawdownMáx": [...],
      "Beta": [...],
      "Alfa": [...],
      "TrackingError": [...],
      "InformationRatio": [...],
      "HitRatio": [...],
      "ConsistênciaMensal": [...]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 8.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculo de métricas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.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 Comparação e Rankeamento de Fundos (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Comparação e Rankeamento de Fundos (RF 7).

Comparar fundos utilizando métricas consistentes, aplicar filtros de elegibilidade e produzir um ranking ponderado conforme o perfil do investidor.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber metrics_by_fund e metadados para comparação e rankeamento.
• 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é 15.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo ranking_fundos com score agregado, posição, justificativas e fundos excluídos com motivo.
• Exemplo de Estrutura de Output:

   {
    "ranking_fundos": [
      {
        "fundo_id": "123",
        "score": 95.5,
        "position": 1,
        "justificativa": "Ótimo retorno ajustado ao risco.",
        "excluidos": [
          {
            "fundo_id": "456",
            "motivo": "histórico_insuficiente"
          }
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para comparação e rankeamento.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

7.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órios de Recomendação (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios de Recomendação (RF 8).

Gerar relatório claro e acionável com recomendações de fundos, adequado ao perfil do investidor.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber ranking_fundos e parâmetros aplicados para geração do relatório.
• 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é 15.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em formato markdown com seções padronizadas e apêndice técnico.
• Exemplo de Estrutura de Output:

   # Relatório de Recomendação de Fundos
  
  ## Resumo Executivo
  ...
  
  ## Metodologia
  ...
  
  ## Top Recomendações
  ...
  
  ## Riscos e Limitações
  ...
  
  ## Adequação ao Perfil
  ...
  
  ## Próximos Passos
  ...
  
  ## Apêndice
  ...
  
  ```json
  {
    "ranking_fundos": [...],
    "parâmetros": {...},
    "data_geração": "2025-12-07"
  }
  ``` 

• Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 10.000 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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

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