Agente de IA para Relatórios de Acompanhamento de Mercado

Consolidar o escopo diário e preparar parâmetros de consulta para cada fonte aprovada 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 dados de configuração do dia 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: Dados estruturados contendo configuração do dia, janela temporal, fuso horário, lista de classes de ativos e tickers, moeda de referência e catálogo de fontes.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de payloads de busca por fonte contendo: endpoint_id, símbolos/tickers, campos necessários, janela temporal em UTC, limites de paginação, taxa máxima de requisições, prioridade de execução e chaves de autenticação já referenciadas.
• Exemplo de Estrutura de Output:

   [{
    "endpoint_id": "fonte_1",
    "symbols": ["AAPL", "GOOGL"],
    "fields": ["price_last", "pct_change", "volume"],
    "time_window": {"start": "2025-12-06T00:00:00Z", "end": "2025-12-06T23:59:59Z"},
    "pagination": {"limit": 100},
    "max_requests": 10,
    "priority": "high",
    "auth_keys": "key_123"
  }] 

• Número de caracteres esperado: O output deve ser conciso e informativo, com um tamanho estimado em torno de 3.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 Busca Online (RF 2).

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

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

Realizar chamadas de busca online e/ou APIs de mercado com os parâmetros prontos para obter os dados brutos.

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: Lista de payloads de busca contendo endpoint_id, símbolos/tickers, campos necessários, janela temporal em UTC, limites de paginação, taxa máxima de requisições, prioridade de execução e chaves de autenticação.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 uma coleção de dados brutos recuperados por fonte, preservando metadados essenciais.
• Exemplo de Estrutura de Output:

   [{
    "source_name": "fonte_1",
    "endpoint_id": "fonte_1",
    "payload_hash": "hash_123",
    "timestamp_coleta_utc": "2025-12-06T14:08:00Z",
    "pages_obtained": 2,
    "total_records": 200,
    "data_block": [
      {"symbol": "AAPL", "price_last": 150.00, "volume": 1000000}
    ]
  }] 

• Número de caracteres esperado: O output deve ser conciso e informativo, com um tamanho estimado em torno 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: Utiliza a ferramenta de busca online para obter dados de mercado.
• Sistemas Externos: Se conecta a APIs externas de mercado para coleta de dados.

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 Normalização e Qualidade de Dados (RF 3).

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

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

Unificar o esquema, remover duplicidades e avaliar a qualidade e atualidade dos dados coletados.

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 brutos por fonte com metadados de coleta e a moeda de referência do relatório.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 dataset unificado em esquema padronizado e um relatório de qualidade com indicadores e flags por ativo e por fonte.
• Exemplo de Estrutura de Output:

   {
    "unified_dataset": [
      {"symbol": "AAPL", "asset_class": "equity", "ts_utc": "2025-12-06T14:08:00Z", "price_last": 150.00, "pct_change": 0.02, "volume": 1000000, "currency": "USD"}
    ],
    "quality_report": {
      "cobertura_por_classe": 95,
      "qtd_outliers": 2,
      "qtd_stale": 1,
      "fontes_mais_confiaveis": ["fonte_1", "fonte_2"]
    }
  } 

• Número de caracteres esperado: O output deve ser detalhado e informativo, com um tamanho estimado em torno de 10.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 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 Análise e Detecção de Tendências (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 e Detecção de Tendências (RF 4).

Identificar informações críticas e tendências emergentes a partir do dataset normalizado.

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: Dataset unificado com flags de qualidade e conversões, além de eventos/notícias estruturados quando disponíveis.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 uma lista priorizada de insights e um resumo de mercado padronizado.
• Exemplo de Estrutura de Output:

   {
    "insights": [
      {"id": "insight_01", "titulo_curto": "AAPL em alta", "descricao": "AAPL apresenta alta significativa com volume acima da média.", "direcao": "alta", "classe": "equity", "symbols": ["AAPL"], "evidencias": [{"tipo": "preco", "referencia": "150.00", "ts_utc": "2025-12-06T14:08:00Z"}], "impacto_est": "medio", "horizonte": "curto", "acao_sugerida": "observar", "confianca": 0.9, "score": 85, "fontes": ["fonte_1"]}
    ],
    "resumo_mercado": {"mapa_setorial_com_var": {}, "%avanco_vs_queda": "60/40", "top_alta": ["AAPL"], "top_baixa": [], "ativos_maior_vol_spike": ["AAPL"], "riscos_latentes": []}
  } 

• Número de caracteres esperado: O output deve ser detalhado e informativo, com um tamanho estimado em torno de 8.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 variações e volatilidade.
• 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 Geração de Relatórios (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 Relatórios (RF 5).

Gerar relatório diário claro, conciso e acionável para consultorias de investimento.

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: Top insights priorizados, resumo_mercado, indicadores de qualidade e metadados (data de emissão, moeda do relatório, consulta_pack_id).
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 12.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório diário em formato Markdown e um bloco JSON final de metadados do relatório.
• Exemplo de Estrutura de Output:

   {
    "relatorio_markdown": "# Relatório Diário\n## Resumo Executivo\n- AAPL em alta;\n- Mercado volátil;\n- Volume anômalo em tech;\n- Riscos geopolíticos;\n- Oportunidades em energia.\n## Destaques do Dia\n1. AAPL em alta com volume acima da média.\n2. ...",
    "report_metadata": {
      "emissao_ts_local": "2025-12-06T14:08:00-03:00",
      "consulta_pack_id": "pack_123",
      "moeda_relatorio": "USD",
      "data_quality_ok": true,
      "fontes_usadas": ["fonte_1", "fonte_2"],
      "classes_cobertas": ["equity", "commodity"],
      "qtd_insights": 5,
      "versao_relatorio": "1.0"
    }
  } 

• Número de caracteres esperado: O output deve ser detalhado e informativo, com um tamanho estimado em torno de 15.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 se conecta a sistemas externos.

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.