Agente de IA para Gestão de Carteira de Investimentos

Normalizar a carteira e objetivos do cliente, definir thresholds e preparar o payload de consulta de mercado.

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 JSON com a carteira de investimentos e objetivos do cliente 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 JSON estruturado com detalhes da carteira de investimentos e objetivos financeiros 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os parâmetros de monitoramento normalizados e prontos para uso nas etapas subsequentes.
• Exemplo de Estrutura de Output:

   {
    "parametros_monitoramento": {
      "tickers_consulta": ["AAPL", "GOOGL"],
      "janelas": {"retornos_dias": [1, 5, 20], "volatilidade_dias": 20},
      "thresholds": {"drift_banda_pp": 5, "flutuacao_d1_pct": 3, "drawdown_pct": 15},
      "carteira_normalizada": {"alocacao_atual_pct": {"tecnologia": 50, "saude": 50}},
      "metas": {"alvos_por_classe_pct": {"tecnologia": 60, "saude": 40}},
      "pode_continuar": true
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 de Cotações de Mercado (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 de Cotações de Mercado (RF 2).

Realizar chamada à API de mercado para obter preços recentes, séries de preços e informações essenciais dos tickers informados.

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 com os parâmetros de monitoramento necessários para a consulta 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 JSON contendo os dados de mercado obtidos, incluindo preços atuais, históricos e a fonte de dados.
• Exemplo de Estrutura de Output:

   {
    "market_data": [
      {"ticker": "AAPL", "preco_atual": 150.00, "preco_1d_atras": 148.50, "serie_20d": [{"data": "2025-08-01", "preco_fechamento": 145.00}]},
      {"ticker": "GOOGL", "preco_atual": 2800.00, "preco_1d_atras": 2750.00, "serie_20d": [{"data": "2025-08-01", "preco_fechamento": 2700.00}]}
    ],
    "timestamp_consulta": "2025-08-12T12:09:00Z",
    "fonte_api": "MarketAPI"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar chamadas à API de mercado para obter os dados necessários.

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 Cálculo de Métricas e Detecção de Eventos (RF 3).

2.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 e Detecção de Eventos (RF 3).

Calcular métricas de desempenho e risco e detectar flutuações significativas e desvios de alocaçã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 os dados de mercado mais recentes e os parâmetros de monitoramento.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo alertas de monitoramento e recomendações preliminares para ajustes na carteira.
• Exemplo de Estrutura de Output:

   {
    "alertas_monitoramento": {
      "resumo": {
        "flutuacao_significativa": true,
        "drift_excedido": false,
        "risco_excedido": true,
        "drawdown_excedido": false
      },
      "por_ativo": [
        {"ticker": "AAPL", "ret_d1_pct": 1.5, "ret_5d_pct": 2.5, "ret_20d_pct": 5.0, "vol_20d_anualizada_pct": 18.0, "alerta_flutuacao": true}
      ],
      "por_classe": [
        {"classe": "tecnologia", "atual_pct": 55, "alvo_pct": 50, "drift_pp": 5, "alerta_drift": true}
      ],
      "recomendacoes_preliminares": [
        {"tipo": "reduzir", "alvo": "classe", "id": "tecnologia", "ajuste_pp_sugerido": 5}
      ],
      "flags": {
        "flutuacao_significativa": true,
        "drift_excedido": true,
        "risco_excedido": true,
        "quaisquer_erros": false
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 3.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.
• Calculadora: Utiliza lógica interna para calcular métricas de desempenho e risco.
• 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 Análise de Ajustes e Relatório (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Ajustes e Relatório (RF 4).

Converter alertas em recomendações detalhadas de ajuste de carteira alinhadas aos objetivos financeiros e gerar relatório claro e conciso.

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 os alertas de monitoramento e os objetivos financeiros 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 até 12.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as recomendações detalhadas de ajustes e um relatório em formato Markdown.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes_detalhadas": {
      "acoes": [
        {"classe": "tecnologia", "tipo_acao": "reduzir", "ajuste_pp": 5, "prioridade": "alta", "justificativa": "Drift 5pp acima do alvo."}
      ],
      "plano_rebalanceamento": {
        "de": [{"classe": "tecnologia", "reduzir_pp": 5}],
        "para": [{"classe": "saude", "aumentar_pp": 5}]
      },
      "flags": {
        "revisao_recomendada": false
      }
    },
    "relatorio": "## Resumo Executivo\nA carteira apresentou flutuações significativas em tecnologia, com um drift de 5pp acima do alvo. Recomenda-se um ajuste imediato.\n\n## Desempenho Recente\nAAPL apresentou um retorno de 1,5% no último dia.\n\n## Desvios de Alocação\nA tecnologia está com 55% de alocação, 5pp acima do alvo de 50%.\n\n## Risco e Volatilidade\nA volatilidade anualizada está em 18%, acima do limite de 15%.\n\n## Recomendações de Ajuste\nReduzir a alocação em tecnologia em 5pp.\n\n## Próximos Passos\nRevisar a carteira mensalmente para ajustes adicionais."
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.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 priorizar ajustes e gerar relatórios.
• 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 (JSON com recomendações e relatório) é 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. As recomendações e o relatório gerados são os resultados que devem ser disponibilizados ao usuário.