Agente de IA para Revisão de Estratégias de Investimento

Realizar chamadas às APIs de mercado para obter cotações, volumes, curvas de juros, índices, preços de commodities, câmbio e calendários de eventos econômicos em tempo quase real.

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 solicitação de dados de mercado 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: Solicitações de dados de mercado.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: JSON contendo os dados de mercado coletados.
• Exemplo de Estrutura de Output:

  {"market_api_fetched": true, "datasets": {"precos_eq": [{"ticker":"SPY","ts":"2025-12-20T15:19:00Z","px":473.12,"vol":152340}], "yield_curve": [{"tenor":"10Y","ts":"2025-12-20","rate":0.0421}]}, "metadados": {"latencia_ms": 320, "fonte":"api.market"}}

• Número de caracteres esperado: Até 5.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: Conecta-se a APIs de mercado para coleta de dados.

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 Preparação e Consolidação de Dados 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 Preparação e Consolidação de Dados de Mercado (RF 2).

Consolidar e preparar os dados brutos de mercado para análise, padronizando frequências, alinhando carimbos de tempo e calculando métricas derivadas necessárias à detecção de mudanças.

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: Dados brutos de mercado em formato JSON.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: JSON contendo os dados de mercado consolidados e preparados.
• Exemplo de Estrutura de Output:

  {"data_prepared": true, "painel": {"series_padronizadas": {"freq_base":"1m","eq": [{"ticker":"SPY","ts":"2025-12-20T15:19:00Z","px":473.12,"ret_1m":0.0008,"ret_1h":-0.0045}], "rates": [{"tenor":"10Y","ts":"2025-12-20T15:00:00Z","rate":0.0421,"steepener_2s10s":-0.0007}]}, "lacunas_preenchidas": true, "flags": {"mercado_fechado": false, "dados_incompletos": false}}}

• Número de caracteres esperado: Até 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 de Mudanças de Mercado (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 de Mudanças de Mercado (RF 3).

Identificar mudanças relevantes de mercado e qualificá-las por classe de ativo, direção, intensidade e horizonte, apontando possíveis impactos em estratégias de investimento.

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: Dados de mercado preparados em formato JSON.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: JSON contendo as mudanças de mercado identificadas e qualificadas.
• Exemplo de Estrutura de Output:

  {"change_signals_ready": true, "mudancas_identificadas": [{"tema":"steepening_US_2s10s","direcao":"alta","intensidade_bps":8,"horizonte":"posicional","relevancia":"alta","ativos_relacionados":["bancos_US","utilities_US"],"justificativa":"Inclinação 2s10s subiu 8 bps em 2 dias"},{"tema":"selloff_tecnologia_US","direcao":"baixa","intensidade_ret_1d":-0.025,"horizonte":"swing","relevancia":"média","ativos_relacionados":["QQQ","SOXX"],"justificativa":"Queda superior ao percentil 95 histórico diário"}], "resumo_risco": {"vol_intraday_alta": true, "flight_to_quality": false}}

• Número de caracteres esperado: Até 5.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 gerada por este agente deve ser visível para o Agente de Sugestão de Ajustes de Estratégia (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Ajustes de Estratégia (RF 4).

Converter sinais de mudança de mercado em ajustes concretos de portfólio respeitando restrições de risco, liquidez e mandato da estratégia.

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: Sinais de mudança de mercado em formato JSON.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: JSON contendo as sugestões de ajustes de estratégia.
• Exemplo de Estrutura de Output:

  {"sugestoes_ready": true, "sugestoes_ajustes": [{"acao":"reduzir","ativo":"QQQ","delta_peso":-0.03,"justificativa":"Selloff tecnologia com relevância 'média' e persistência >3 intervalos","efeito_esperado":"reduz exposição setorial e drawdown potencial"},{"acao":"aumentar","ativo":"XLF","delta_peso":0.02,"justificativa":"Steepening 2s10s alta favorece bancos","efeito_esperado":"capturar melhora margem financeira"}], "hedges": [{"ativo":"TLT","tipo":"proteção","peso_sugerido":0.02,"gatilho_ativacao":"var_d1_SPY < -1.5%"}], "verificacoes_restricoes": {"gross_ok": true, "net_ok": true, "limite_por_ativo_ok": true}}

• Número de caracteres esperado: Até 5.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: Não utiliza.
• 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 deve ser visível para o Agente de Geração de Insights Acionáveis (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights Acionáveis (RF 5).

Entregar um resumo executivo com o que fazer agora, por que fazer, riscos, métricas de monitoramento e gatilhos de revisão/saída.

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: Sugestões de ajustes de estratégia em formato JSON.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Até 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: JSON contendo o resumo executivo com insights acionáveis.
• Exemplo de Estrutura de Output:

  {"insights_acionaveis": {"plano_acao_imediato": [{"passo":1, "descricao":"Enviar ordem para reduzir QQQ em 3 p.p."},{"passo":2, "descricao":"Aumentar XLF em 2 p.p."}], "racional": "Steepening da curva e queda em tecnologia sugerem rotação setorial", "riscos_chave": ["reversão rápida da inclinação","surpresa de política monetária"], "metricas_monitoramento": [{"indicador":"2s10s","gatilho_revisao":"<-3 bps/d"},{"indicador":"ret_diario_QQQ","gatilho_stop":"<-2,5%"}], "janela_revisao": "intraday a cada 30 min; fim de dia consolidado"}}

• Número de caracteres esperado: Até 5.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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O resumo executivo gerado é o resultado que deve ser disponibilizado ao usuário.