Agente de IA para Propostas de Alocação de Ativos

Coletar, normalizar e analisar dados de perfis de clientes para identificar padrões, restrições e preferências de investimento e derivar um escore e categoria de risco final utilizável pelo agente de alocação.

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 perfis de investimento via API. Na fase de testes, os dados serão enviados manualmente por upload na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON contendo dados de perfis de investimento dos clientes.
• 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 texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o escore de risco e categoria de risco final, além de padrões e restrições identificadas.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "12345",
    "perfil_declarado": "moderado",
    "score_risco": 0.55,
    "perfil_risco_final": "moderado",
    "horizonte_anos": 10,
    "necessidade_liquidez": "media",
    "restricoes_normalizadas": { "ativos_proibidos": ["acoes_brasil"], "classes_proibidas": [], "esg_obrigatorio": true, "max_concentracao_produto": 0.10, "restricoes_fiscais": [] },
    "preferencias_normalizadas": { "classes_favoritas": ["renda_fixa"], "distribuicao_preferida": { "renda_fixa": 0.70, "caixa": 0.30 } },
    "classes_permitidas": ["renda_fixa", "caixa"],
    "padrões_identificados": [{ "nome": "alto_horizonte", "evidencia": "horizonte >= 7 anos" }, { "nome": "alta_liquidez", "evidencia": "necessidade_liquidez == 'alta'" }],
    "limites_por_classe": { "renda_fixa": { "min": 0.20, "max": 0.60 }, "caixa": { "min": 0.10, "max": 0.20 } },
    "requisitos_liquidez": { "caixa_min": 0.10 }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 1.500 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 devem ser visíveis para o Agente de Geração de Propostas de Alocação de Ativos (RF 2).
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Propostas de Alocação de Ativos (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Propostas de Alocação de Ativos (RF 2).

Gerar uma carteira alvo por classe (e opcionalmente por produto) que maximize retorno esperado respeitando o perfil de risco final, limites de classe, requisitos de liquidez e restrições do cliente.

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 JSON contendo dados normalizados de perfis de investimento dos clientes.
• 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 texto com até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a proposta de alocação de ativos, métricas projetadas e justificativas.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "12345",
    "perfil_risco_final": "moderado",
    "proposta_alocacao": { "por_classe": { "renda_fixa": 0.60, "caixa": 0.40 }, "por_produto": [] },
    "metricas_projetadas": { "retorno_esperado_anual": 0.07, "volatilidade_esperada_anual": 0.05 },
    "faixas_rebalanceamento": { "renda_fixa": { "min": 0.57, "max": 0.63 }, "caixa": { "min": 0.37, "max": 0.43 } },
    "justificativas": ["Perfil de risco moderado com horizonte de longo prazo.", "Necessidade de liquidez média.", "Preferência por renda fixa.", "Limites de classe respeitados.", "Ajustes feitos para otimizar retorno esperado mantendo conformidade."]
  } 

• Número de caracteres esperado: O JSON gerado deve ter 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: Não se conecta a sistemas externos.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente devem ser visíveis para o Agente de Atualização Automática de Propostas (RF 4).
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Atualização Automática de Propostas (RF 4).

2.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 de Mercado (RF 3).

Realizar chamada à API do sistema de dados de mercado para obter indicadores e parâmetros atualizados (retornos esperados, volatilidades, taxas de juros base) que subsidiarão a atualização automática das propostas.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente quando os parâmetros da API de mercado estiverem prontos (parametros_api_mercado_prontos = true).
• Tipo do input: Este agente deve ser apto a receber como input um payload contendo endpoint, headers, parâmetros de consulta e credenciais/token.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o timestamp, parâmetros utilizados e dados de mercado recuperados.
• Exemplo de Estrutura de Output:

   {
    "timestamp_coleta": "2025-12-12T05:22:00Z",
    "parametros_utilizados": { "endpoint": "https://api.mercado.com/dados", "classes": ["renda_fixa", "multimercado"], "moeda": "BRL" },
    "dados_mercado": { "retornos_esperados_por_classe": { "renda_fixa": 0.06, "multimercado": 0.09 }, "volatilidade_por_classe": { "renda_fixa": 0.05, "multimercado": 0.10 }, "taxa_juros_base": 0.035 }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 1.000 caracteres.

3.3.3 Parâmetros de Geração

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

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload para a API externa e retornar os dados recebidos como resposta.

3.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 deve ser visível para o Agente de Atualização Automática de Propostas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Atualização Automática de Propostas (RF 4).

Recalibrar pesos e métricas da proposta vigente com base em dados de mercado atualizados e/ou feedback do cliente, preservando limites, perfil de risco e requisitos de liquidez.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente quando os dados de mercado estiverem disponíveis (mercado_dados_disponiveis = true).
• Tipo do input: Este agente deve ser apto a receber múltiplos artefatos como input, incluindo a proposta vigente (JSON), dados de mercado (JSON) e feedback do cliente opcional (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 combinado de até 15.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a proposta atualizada, métricas projetadas, motivos da atualização e impacto estimado.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "12345",
    "proposta_anterior": { "por_classe": { "renda_fixa": 0.60, "caixa": 0.40 } },
    "proposta_atualizada": { "por_classe": { "renda_fixa": 0.55, "caixa": 0.45 }, "metricas_projetadas": { "retorno_esperado_anual": 0.075, "volatilidade_esperada_anual": 0.052 } },
    "motivos_da_atualizacao": ["Ajuste devido à variação de 0.7pp na taxa de juros base.", "Feedback do cliente solicitando maior liquidez."],
    "impacto_estimado": { "delta_retorno": 0.005, "delta_volatilidade": 0.002 },
    "status": "atualizada"
  } 

• Número de caracteres esperado: O JSON gerado deve ter 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 recalibrar pesos e métricas.
• 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 não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. A proposta atualizada é o resultado que deve ser disponibilizado ao consultor financeiro.