Agente de IA para Análise de Tendências de Mercado Financeiro

Realizar chamadas às APIs de dados de mercado financeiro (preços, volumes, índices, futuros, moedas e notícias) para obter dados recentes e estruturados 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 um payload com endpoints de APIs de mercado financeiro 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 payload JSON com informações de endpoints de APIs de mercado financeiro.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados crus recuperados das APIs, incluindo preços, volumes, índices e notícias.
• Exemplo de Estrutura de Output:

   {
    "status": "sucesso",
    "fontes": [
      {
        "source": "precos_spot",
        "symbol": "AAPL",
        "timeframe": "1m",
        "data": [
          {"ts": "2025-12-11T04:35:00Z", "open": 195.12, "high": 195.40, "low": 195.05, "close": 195.33, "volume": 120345}
        ],
        "metadata": {"provider": "provedor_x", "moeda": "USD"}
      }
    ],
    "erros": []
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

1.3.3 Parâmetros de Geração

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

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Realiza chamadas a APIs externas de mercado financeiro.

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 Detecção de Tendências 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 Detecção de Tendências de Mercado (RF 2).

Padronizar os dados recuperados e identificar tendências emergentes por ativo, classe de ativo e mercado, com sinalização de força e confiança.

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 o JSON contendo dados crus de mercado financeiro.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as tendências detectadas, incluindo força e confiança por ativo e setor.
• Exemplo de Estrutura de Output:

   {
    "tendencias_detectadas": true,
    "janela_analise": {"inicio": "2025-12-11T00:00:00Z", "fim": "2025-12-11T04:38:00Z", "intervalos": ["15m","1h","4h","1d"]},
    "trends": [
      {
        "symbol": "AAPL",
        "classe": "acao",
        "direcao": "alta",
        "forca": 0.78,
        "confianca": 0.72,
        "timeframe": "1h",
        "inicio_tendencia_ts": "2025-12-11T03:10:00Z",
        "sinais": ["momentum_>_0.8%/h","breakout_20_max","volume_z>2"],
        "validacoes": {"liquidez_ok": true, "dados_completos": true, "conflito_timeframes": false},
        "observacoes": "Quebra da máxima de 20 períodos com volume acima da média de 30 dias."
      }
    ],
    "resumo_mercado": {"amplitude_setorial": {"tecnologia": "forte_alta", "energia": "neutro"}, "breadth": {"percentual_em_alta": 62}, "temas": ["rotaçao_para_growth"]}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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 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 Análise Crítica e Recomendações Táticas de Investimento (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise Crítica e Recomendações Táticas de Investimento (RF 3).

Transformar tendências identificadas em insights acionáveis e sugestões táticas de ajuste de estratégia, com controles de risco claros e condições de invalidaçã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 o JSON contendo as tendências de mercado detectadas.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo insights acionáveis e sugestões táticas de ajuste de estratégia.
• Exemplo de Estrutura de Output:

   {
    "insights": [
      {
        "tema": "forca_em_tecnologia_growth",
        "racional": "Amplitude setorial >60% em alta com momentum e breakouts em large caps.",
        "acoes_sugeridas": ["aumentar_exposicao_setorial_gradual"],
        "gatilhos_de_entrada": ["pullback_ate_EMA20","confirmacao_de_volume_z>1"],
        "niveis_de_invalidacao": ["fechamento_abaixo_minima_20_periodos"],
        "horizonte": "dias_a_semanas",
        "notas_de_risco": ["reprecificacao_rapida_pos_resultados","sensibilidade_a_taxa_juros"],
        "confianca": 0.7,
        "watchlist": ["AAPL","MSFT","NVDA"]
      }
    ],
    "sugestoes_de_ajuste_de_portfolio": [
      {
        "alvo": "setor_tecnologia",
        "acao": "rebalanco",
        "intervalo_percentual": {"min": 2, "max": 5},
        "criterios": ["confianca_tema>=0.65","liquidez_ok"]
      }
    ],
    "alert_level": "atencao",
    "quando_revisitar": "se confianca cair <0.6 ou invalidacao acionada"
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 6.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 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 (JSON de insights) é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. Os insights gerados são o resultado que deve ser disponibilizado ao usuário.