Agente de IA para Monitoramento de Alocações de Ativos

Realizar chamadas às APIs dos sistemas de portfólios para obter posições, alocações, políticas-alvo e perfil/objetivos do cliente.

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 parâmetros 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 contendo client_id(s), portfolio_id(s), data_referencia, entre outros.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com os dados crus recuperados da chamada à API.
• Exemplo de Estrutura de Output:

   {
    "posicoes": [
      {"id_ativo": "AAPL", "classe_ativo": "Ações", "quantidade": 50, "preco_ultimo": 150.00, "valor": 7500.00, "peso_atual": 0.15},
      {"id_ativo": "GOOGL", "classe_ativo": "Ações", "quantidade": 30, "preco_ultimo": 2800.00, "valor": 84000.00, "peso_atual": 0.70}
    ],
    "metas": {"peso_alvo": {"Ações": 0.65, "Renda Fixa": 0.35}, "bandas_tolerancia_min": {"Ações": 0.60, "Renda Fixa": 0.30}, "bandas_tolerancia_max": {"Ações": 0.70, "Renda Fixa": 0.40}},
    "perfil_risco": {"nivel_risco": "Moderado", "limites_vol": 0.15, "limites_exposicao": {"Ações": 0.75}},
    "objetivos": {"horizonte": "5 anos", "meta_retorno": 0.10}
  } 

• Número de caracteres esperado: O JSON final terá um tamanho estimado em torno de 5.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: Não se aplica (execução de chamada à API)
• 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: Executa chamadas a sistemas externos via API.

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 Análise de Desvios e Conformidade de Risco (RF 3).

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 e Benchmarks (RF 2).

Realizar chamadas às APIs de mercado para obter cotações, séries históricas e composições de benchmarks.

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 parâmetros prontos, como lista de ativos/benchmarks, janelas_historicas, data_referencia, etc.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com os dados crus recuperados da chamada à API.
• Exemplo de Estrutura de Output:

   {
    "precos_atualizados": [
      {"ativo": "AAPL", "preco": 150.00},
      {"ativo": "GOOGL", "preco": 2800.00}
    ],
    "retornos_historicos": {"AAPL": {"21_dias": 0.05, "63_dias": 0.10, "252_dias": 0.20}},
    "composicao_benchmarks": {"Ações": 0.70, "Renda Fixa": 0.30},
    "taxas_livres_risco": 0.02
  } 

• Número de caracteres esperado: O JSON final terá um tamanho estimado em torno de 3.500 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (execução de chamada à API)
• Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa chamadas a sistemas externos via API.

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 Desvios e Conformidade de Risco (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 Desvios e Conformidade de Risco (RF 3).

Calcular desvios de alocação e verificar conformidade com perfil de risco, metas e bandas de tolerância.

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 consolidados de alocações atuais, metas, restrições, perfil de risco, objetivos e dados de mercado/benchmarks.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON analítico com os resultados da análise de desvios e conformidade de risco.
• Exemplo de Estrutura de Output:

   {
    "classe_ativo": "Ações",
    "peso_atual": 0.70,
    "peso_alvo": 0.65,
    "banda_min": 0.60,
    "banda_max": 0.70,
    "desvio_absoluto": 0.05,
    "desvio_relativo": 0.0769,
    "em_breach": false,
    "severidade": "baixa",
    "exposicao_por_classe": 0.70,
    "proxy_volatilidade_portfolio": 0.15,
    "tracking_drift": 0.02,
    "sumario_portfolio": {"qtde_breaches": 0, "maior_desvio": 0.05, "status_geral": "ok"}
  } 

• Número de caracteres esperado: O JSON final terá um tamanho estimado em torno de 7.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: Utiliza lógica interna para cálculos de desvios e conformidade.
• 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 Recomendações de Rebalanceamento (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Rebalanceamento (RF 4).

Gerar propostas de ajustes nas alocações com listas de trades que levem o portfólio a aderir às metas e limites do perfil.

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 output analítico com breaches/severidades, metas/bandas, restrições operacionais, dados de preços atuais, custos de transação e parâmetros 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 com propostas de ajustes nas alocações e lista de trades.
• Exemplo de Estrutura de Output:

   {
    "estrategia_rebalance": "full",
    "lista_trades": [
      {"ativo_id": "AAPL", "lado": "comprar", "delta_peso": 0.05, "quantidade_estimada": 10, "preco_referencia": 150.00, "custo_est_transacao": 1.50, "impacto_turnover": 0.005}
    ],
    "pós_trade_estimado": {"pesos_por_classe": {"Ações": 0.65}, "aderência_bandas": true, "buffer_caixa": 0.02},
    "checagens_conformidade": {"restrições_violadas": []},
    "métricas": {"turnover_total": 0.01, "custo_total_estimado": 1.50}
  } 

• Número de caracteres esperado: O JSON final terá um tamanho estimado em torno de 4.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 cálculos de ajustes e trades.
• 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 Alertas e Sumário Executivo (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 Alertas e Sumário Executivo (RF 5).

Transformar a análise e as recomendações em alertas acionáveis e comunicações para stakeholders.

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 outputs dos agentes de Análise e Recomendações.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de alerta com detalhes de comunicação e próximos passos.
• Exemplo de Estrutura de Output:

   {
    "severidade_alerta": "alta",
    "titulo": "Desvios Críticos Identificados",
    "motivos_chave": ["Desvio significativo em Ações", "Risco fora dos limites"],
    "itens_em_breach": ["Ações"],
    "KPIs": {"maior_desvio": 0.05, "qtde_breaches": 2, "turnover_total": 0.01, "custo_total": 1.50},
    "próximos_passos": "aprovar_execução",
    "mensagens_formatadas": {"cliente_final": "Recomendamos ajustes imediatos.", "assessor": "Favor revisar os desvios identificados e proceder conforme necessário."},
    "anexos_dados": ["relatório_123"],
    "SLA_sugestao": "24 horas"
  } 

• Número de caracteres esperado: O JSON final terá um tamanho estimado em torno de 6.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 formatação de alertas e comunicações.
• 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 JSON de alerta gerado é o resultado que deve ser disponibilizado ao usuário.