Agente de IA para Avaliação de Risco de Investimento

Derivar, a partir do universo de investimentos e do horizonte de análise informados, os parâmetros padronizados para coleta de dados de mercado e econômicos, bem como critérios opcionais de busca de notícias.

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 objeto JSON com informações sobre o universo de investimentos e o horizonte de análise 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 objeto JSON que contém informações detalhadas sobre os investimentos e o horizonte de análise.
• 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é 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os parâmetros padronizados para coleta de dados de mercado e econômicos.
• Exemplo de Estrutura de Output:

   {
    "params_api_mercado": { ... },
    "params_api_economicos": { ... },
    "params_busca_noticias": { ... },
    "schema_campos_padrao": { ... }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.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 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 mercado e econômicas para obter séries históricas de preços/volumes e indicadores macroeconômicos conforme parâmetros recebidos.

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 payloads prontos contendo parâmetros para chamadas às APIs de mercado e econômicas.
• 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 dados brutos recuperados das APIs em JSON/CSV por fonte, mantendo metadados de origem (fonte, endpoint, horário da coleta) e estrutura por série/ativo/indicador.
• Exemplo de Estrutura de Output:

   {
    "dados_mercado": { ... },
    "dados_economicos": { ... }
  } 

• 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: Conecta-se a APIs externas de mercado e econômicas para realizar as chamadas conforme especificado nos 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 Consolidação e Normalização de Dados (RF 4).

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

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

Realizar busca online de notícias e eventos recentes relacionados aos ativos e setores informados para detecção de sinais de risco qualitativo.

3.3.1 Condições de Ativação

Este agente é acionado somente se a seguinte condição for atendida:

• O campo incluir_noticias no input recebido for igual a true.

3.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 1), apenas se o parâmetro incluir_noticias for verdadeiro.
• Tipo do input: Este agente deve ser apto a receber parâmetros prontos para busca online de notícias e eventos recentes relacionados aos ativos e setores informados.
• 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é 5.000 caracteres.

3.3.3 Especificação do Output

• Formato de output: O output deve ser uma lista de resultados de notícias com campos: timestamp_publicacao, titulo, resumo/trecho, fonte, url, idioma, termos_correlatos, ativo_relacionado (quando aplicável).
• Exemplo de Estrutura de Output:

   [
    {
      "timestamp_publicacao": "...",
      "titulo": "...",
      "resumo": "...",
      "fonte": "...",
      "url": "...",
      "idioma": "...",
      "termos_correlatos": [ ... ],
      "ativo_relacionado": "..."
    }
  ] 

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

3.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.5 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Conecta-se a serviços de busca online para realizar buscas de notícias conforme especificado nos parâmetros recebidos.
• Sistemas Externos: Não se conecta a sistemas externos.

3.3.6 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 Consolidação e Normalização de Dados (RF 4).

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

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

Padronizar, limpar e consolidar os dados de mercado, FX, indicadores macro e notícias em um único dataset pronto para avaliação de risco.

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 2 ou RF 3).
• Tipo do input: Este agente deve ser apto a receber dados brutos de mercado e econômicos, além de resultados de busca online de notícias.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset consolidado com séries por ativo em moeda_base, features calculadas e indicadores macro alinhados temporalmente, além de um relatório de qualidade_dados e dicionario_dados.
• Exemplo de Estrutura de Output:

   {
    "dataset_consolidado": { ... },
    "qualidade_dados": { ... },
    "dicionario_dados": { ... }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 6.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: Utiliza lógica interna para calcular métricas financeiras e indicadores de risco.
• 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 gerada por este agente deve ser visível para o Agente de Avaliação de Risco e Classificação de Investimentos (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Avaliação de Risco e Classificação de Investimentos (RF 5).

Calcular uma pontuação de risco composta por ativo/opção de investimento e classificá-los em faixas de risco com base em métricas quantitativas e sinais qualitativos.

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 um dataset consolidado com features de risco por janelas 30/90/252d, sinais de notícias (se existentes), benchmark por classe de ativo e perfil_risco do cliente.
• 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é 15.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma matriz de risco contendo, por ativo: componentes de risco, sinais qualitativos, cenários de estresse e risk_score, faixa_risco, prioridade_para_revisao.
• Exemplo de Estrutura de Output:

   {
    "matriz_risco": [ ... ]
  } 

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

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular métricas financeiras e indicadores de risco.
• 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 Recomendações Baseadas em Risco (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações Baseadas em Risco (RF 6).

Gerar recomendações de alocação e ações táticas com base na matriz de risco, respeitando o perfil do cliente e limites operacionais.

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 uma matriz de risco por ativo, perfil_risco do cliente, objetivos do cliente e restrições operacionais.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de recomendações por ativo: ação sugerida, tamanho máximo sugerido, justificativas, alternativas e sugestões de hedge.
• Exemplo de Estrutura de Output:

   [
    {
      "ativo": "...",
      "acao_sugerida": "...",
      "tamanho_maximo_sugerido": "...",
      "justificativas": "...",
      "alternativas": "...",
      "sugestoes_hedge": "..."
    }
  ] 

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

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular métricas financeiras e indicadores de risco.
• 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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. As recomendações geradas são o resultado que deve ser disponibilizado ao usuário.