Agente de IA para Elaboração de Relatório de Perfil de Investidor

Unificar e validar os dados brutos de entrevistas e questionários em um esquema padronizado, pronto para análise.

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 entrevistas e questionários via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo dados brutos de entrevistas e questionários.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON único e padronizado com campos normalizados, tipos coerentes e uma lista de inconsistências ou ausências tratadas.
• Exemplo de Estrutura de Output:

   {
    "identificacao": {
      "nome": "João Silva",
      "idade": 30,
      "sexo": "masculino",
      "estado_civil": "solteiro"
    },
    "renda": {
      "mensal_liquida": 5000,
      "estabilidade_meses": 24
    },
    "patrimonio": {
      "total": 200000,
      "liquidez_imediata": 50000
    },
    "objetivos": [
      {
        "descricao": "Comprar uma casa",
        "prioridade": 1,
        "horizonte_anos": 10,
        "valor_objetivo": 300000
      }
    ],
    "conhecimento": {
      "autoavaliacao_1a5": 3,
      "experiencia_anos": 5,
      "exposicao_produtos": ["ações", "fundos imobiliários"]
    },
    "risco": {
      "tolerancia_1a5": 4,
      "capacidade_perda_percentual": 10,
      "necessidade_liquidez_1a5": 2
    },
    "preferencias": {
      "esg_boolean": true,
      "restricoes_setoriais": ["tabaco"],
      "preferencia_tributaria": ["isencao_IR"]
    },
    "constraints": {
      "nao_investir_em": ["armas"]
    },
    "inconsistencias": {
      "missing_fields": [],
      "out_of_range": [],
      "contradicoes": []
    },
    "meta": {
      "processing_version": "v1",
      "timestamp_iso": "2025-12-22T08:08:00Z"
    }
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 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: 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 Síntese de Dados de Entrevistas e Questionários (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese de Dados de Entrevistas e Questionários (RF 2).

Gerar uma síntese coerente e acionável dos dados normalizados para suportar classificação de perfil.

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 como input um JSON padronizado e validado contendo dados de entrevistas e questionários.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de síntese com indicadores-chave, resumo narrativo e lista consolidada de riscos e necessidades.
• Exemplo de Estrutura de Output:

   {
    "indicadores_chave": {
      "horizonte_global_anos": 10,
      "necessidade_liquidez": 3,
      "estabilidade_renda_score": 4,
      "conhecimento_score": 3,
      "experiencia_score": 4
    },
    "resumo_narrativo": "João Silva possui uma renda mensal na faixa de 3k-10k e um patrimônio na faixa de 50k-200k. Seus principais objetivos incluem comprar uma casa, e ele possui um horizonte global de 10 anos. Suas necessidades de liquidez são moderadas, e ele tem preferências por investimentos ESG e restrições setoriais em tabaco."
    "riscos_identificados": ["renda_instavel", "conhecimento_baixo"],
    "inconsistencias": {
      "missing_fields": [],
      "out_of_range": [],
      "contradicoes": []
    },
    "meta": {
      "processing_version": "v1",
      "timestamp_iso": "2025-12-22T08:08:00Z"
    }
  } 

• Número de caracteres esperado: O JSON de síntese deve ser conciso e informativo, com um tamanho estimado em torno de 3.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 se conecta a sistemas externos.

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 Classificação de Perfil de Investidor (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Perfil de Investidor (RF 3).

Classificar o perfil de risco do investidor e definir limites de adequação (suitability) com base na síntese.

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 como input um JSON de síntese contendo indicadores de risco, horizonte, conhecimento/experiência e necessidades do investidor.
• 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é 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de perfil contendo categoria, score, justificativas, limites de alocação por classe de ativos e restrições de suitability.
• Exemplo de Estrutura de Output:

   {
    "categoria": "Moderado",
    "risk_score": 55,
    "justificativa": "Com base na tolerância ao risco moderada, horizonte de 10 anos e necessidade de liquidez, o perfil é classificado como Moderado.",
    "limites_de_alocacao": {
      "renda_fixa": "50-80%",
      "multimercado": "0-20%",
      "renda_variavel": "0-30%",
      "internacional": "0-20%",
      "caixa": "0-15%",
      "alternativos": "0-10%"
    },
    "restricoes": {
      "produtos_complexos_permitidos": false,
      "investimento_no_exterior_permitido": true,
      "alavancagem_permitida": false
    },
    "meta": {
      "processing_version": "v1",
      "timestamp_iso": "2025-12-22T08:08:00Z"
    }
  } 

• Número de caracteres esperado: O JSON de perfil deve ser conciso e informativo, com um tamanho estimado em torno de 2.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 Elaboração de Relatório de Perfil de Investidor (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Elaboração de Relatório de Perfil de Investidor (RF 4).

Produzir o relatório final do perfil de investidor com recomendações personalizadas, alinhadas a objetivos e perfil de risco.

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 como input um JSON de perfil contendo categoria, score, limites de alocação por classe de ativos e restrições de suitability, além da síntese de dados do investidor.
• 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é 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório de perfil de investidor em formato markdown, com seções padronizadas e recomendações de alocação; anexo de metadados em JSON.
• Exemplo de Estrutura de Output:

   # Resumo Executivo
  João Silva possui perfil de risco Moderado com um horizonte de investimento de 10 anos. As recomendações a seguir são personalizadas de acordo com seus objetivos e restrições.
  
  # Dados do Investidor
  - Nome: João Silva
  - Renda Mensal: 3k-10k
  - Patrimônio: 50k-200k
  
  # Perfil e Justificativa
  O perfil de risco é classificado como Moderado com base na tolerância ao risco, horizonte de 10 anos e necessidade de liquidez.
  
  # Objetivos e Horizontes
  - Comprar uma casa em 10 anos
  
  # Recomendações de Alocação
  - Renda Fixa: 50-80%
  - Multimercado: 0-20%
  - Renda Variável: 0-30%
  - Internacional: 0-20%
  - Caixa: 0-15%
  - Alternativos: 0-10%
  
  # Sugestões de Produtos Exemplificativos
  - ETF de índice amplo
  - Título público IPCA+ 2030
  
  # Rebalanceamento e Próximos Passos
  Recomenda-se um rebalanceamento trimestral devido à volatilidade esperada.
  
  # Disclaimers de Suitability
  Retornos não são garantidos. A decisão final cabe ao investidor/assessor.
  
  ---
  
  {
    "categoria": "Moderado",
    "risk_score": 55,
    "faixas_usadas": {
      "renda_fixa": "50-80%",
      "multimercado": "0-20%",
      "renda_variavel": "0-30%",
      "internacional": "0-20%",
      "caixa": "0-15%",
      "alternativos": "0-10%"
    },
    "alocacao_recomendada_por_classe": {
      "renda_fixa": 65,
      "multimercado": 10,
      "renda_variavel": 15,
      "internacional": 5,
      "caixa": 5,
      "alternativos": 0
    },
    "restricoes_aplicadas": {
      "produtos_complexos_permitidos": false,
      "investimento_no_exterior_permitido": true,
      "alavancagem_permitida": false
    },
    "data_iso": "2025-12-22T08:08:00Z"
  } 

• Número de caracteres esperado: O relatório final deve ser detalhado e informativo, com um tamanho estimado em torno de 10.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 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 é 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. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.