Agente de IA para Atualização de Propostas de Alocação com Dados de Mercado

Transformar diretrizes de investimento e universo de ativos em parâmetros de consulta e vigilância de eventos 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 diretrizes de investimento e universo de ativos via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de dados estruturados em formato CSV.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv.
• 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 conjunto de parâmetros de consulta e vigilância formatados em JSON.
• Exemplo de Estrutura de Output:

   {
    "query_params": {
      "symbols": ["PETR4.SA", "USDBRL=X"],
      "fields": ["price", "volume", "beta"],
      "thresholds": {"equities": 2.5, "fx": 1.2},
      "slo_freshness": "2 minutes",
      "base_currency": "BRL"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.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 (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 (Mercado) (RF 2).

Realizar chamadas às APIs/fonte de dados de mercado configuradas para obter cotações e indicadores 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 como input um conjunto de parâmetros de consulta formatados em JSON.
• 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é 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados crus de mercado com registros por ativo/fonte/campo/timestamp e metadados de sucesso/falha por chamada.
• Exemplo de Estrutura de Output:

   {
    "raw_market_data": [
      {
        "symbol": "PETR4.SA",
        "price": 28.50,
        "volume": 1000000,
        "timestamp": "2025-12-24T12:00:00Z"
      }
    ],
    "metadata": {
      "success": true,
      "error_message": null
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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 sistemas externos para realizar chamadas à API de mercado.

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

Padronizar e consolidar dados crus de múltiplas fontes em um snapshot coerente, com métricas derivadas e sinalização de qualidade.

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 dados crus de mercado e parâmetros de consulta formatados em JSON.
• 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 snapshot normalizado de mercado contendo preços/indicadores por ativo em moeda-base, retornos e métricas derivadas, com flags de qualidade.
• Exemplo de Estrutura de Output:

   {
    "normalized_market_snapshot": {
      "PETR4.SA": {
        "price": 28.50,
        "ret_1d": 0.025,
        "vol_real_20d": 0.18,
        "flag_outlier": false,
        "stale": false
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.500 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: Utiliza lógica interna para calcular métricas derivadas e normalização de dados.
• 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 Detecção de Eventos de Mercado (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Eventos de Mercado (RF 4).

Identificar eventos de mercado materialmente relevantes para revisão de alocação.

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 um snapshot normalizado de mercado e thresholds definidos em JSON.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de eventos de mercado categorizados, contendo severidade, ativos/classes afetados e evidências.
• Exemplo de Estrutura de Output:

   {
    "eventos_mercado": [
      {
        "tipo": "choque_juros",
        "severidade": "alta",
        "ativos_afetados": ["PETR4.SA"],
        "evidencias": {"delta_bps": 15}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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 detecção de eventos de mercado.
• 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 Preparação de Contexto do Cliente e Restrições (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Contexto do Cliente e Restrições (RF 5).

Consolidar perfil de risco, objetivos, horizonte, restrições e alocação atual em um conjunto de restrições operacionais.

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 informações de perfil de risco, objetivos e restrições do cliente formatados em JSON.
• 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é 7.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de restrições operacionais canônicas, formatado em JSON.
• Exemplo de Estrutura de Output:

   {
    "customer_constraints": {
      "risk_profile": "conservador",
      "bands": {
        "renda_fixa": [60, 90],
        "renda_variavel": [0, 20]
      },
      "turnover_budget": 10,
      "liquidity_constraints": "horizonte de 5 anos"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 consolidação de restrições.
• 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 Rebalanceamento e Atualização de Proposta de Alocação (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Rebalanceamento e Atualização de Proposta de Alocação (RF 6).

Gerar nova proposta de alocação respeitando restrições do cliente e resposta a eventos de mercado.

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 eventos de mercado, restrições do cliente e alocação atual formatados em JSON.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser uma nova proposta de alocação, com pesos por classe/subclasse/ativo, justificativas por mudança e trades sugeridos.
• Exemplo de Estrutura de Output:

   {
    "nova_proposta": {
      "rebalance_required": true,
      "justificativas": "Evento de choque de juros identificado.",
      "sugestoes_trade": [
        {"comprar": "PETR4.SA", "quantidade": 1000},
        {"vender": "VALE3.SA", "quantidade": 500}
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.500 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 otimização de alocação e cálculo de custos.
• 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 deve ser visível para o Agente de Conformidade Regulatória e Adequação (Suitability) (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Conformidade Regulatória e Adequação (Suitability) (RF 7).

Verificar aderência da nova proposta às normas e políticas de suitability e compliance.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber uma nova proposta de alocação e restrições do cliente formatados em JSON.
• 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.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um parecer de compliance com lista de verificações, flags de bloqueio e ajustes recomendados.
• Exemplo de Estrutura de Output:

   {
    "parecer_compliance": {
      "compliance_aprovada": true,
      "blocking_rules": []
    }
  } 

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

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para verificação de compliance e suitability.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

7.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 Saída Operacional e Resumo para Cliente (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Saída Operacional e Resumo para Cliente (RF 8).

Preparar artefatos finais: resumo executivo para cliente e payload operacional para sistema de investimentos.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber a nova proposta de alocação, parecer de compliance e eventos de mercado formatados em JSON.
• 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.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de artefatos finais, incluindo resumo executivo para cliente e payload operacional.
• Exemplo de Estrutura de Output:

   {
    "documento_resumo_cliente": "As mudanças propostas são...",
    "payload_operacional": {
      "pesos": {"PETR4.SA": 0.10, "VALE3.SA": 0.05},
      "aprovado_para_envio": true
    }
  } 

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

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para preparação de artefatos finais.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

8.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.

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

A execução deste agente finaliza o fluxo. Os artefatos gerados são os resultados que devem ser disponibilizados ao usuário.