Agente de IA para Comparação de Produtos de Investimento

Transformar o briefing do cliente em parâmetros de busca objetivos e critérios de comparação padronizados para produtos de investimento.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio do briefing do cliente 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 do briefing na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um documento de texto contendo o briefing do cliente.
• Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos: .txt, .pdf.
• 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 arquivo no formato JSON contendo os parâmetros de busca e critérios de comparação.
• Exemplo de Estrutura de Output:

   {
    "parametros_busca": {
      "termos": "string",
      "classes_alvo": "string",
      "janelas_históricas": "string",
      "data_minima_atualizacao": "date"
    },
    "criterios_inclusao": {
      "liquidez": "D+X",
      "rating_minimo": "string"
    },
    "metadados_comparacao": {
      "pesos": {
        "risco": 0.4,
        "liquidez": 0.3,
        "retorno": 0.15
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 800 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 busca online para obter dados públicos atualizados dos produtos conforme parâmetros de busca.

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 contendo parâmetros de busca e critérios de comparaçã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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados brutos contendo informações dos produtos, fonte, URL e data de coleta.
• Exemplo de Estrutura de Output:

   {
    "produto": "Produto XYZ",
    "fonte": "Fonte ABC",
    "url": "http://exemplo.com",
    "data_coleta": "2025-12-16"
  } 

• Número de caracteres esperado: O conjunto de dados gerado terá um tamanho aproximado 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.
• Calculadora: Não utiliza.
• Busca Online: Utiliza ferramenta interna para busca online.
• Sistemas Externos: Não utiliza.

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 Validação de Dados (RF 4).

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

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

Realizar chamadas às APIs de provedores/mercados para obter dados estruturados dos produtos informados.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 1), apenas se a propriedade "precisa_chamada_api" no objeto JSON for true.
• Tipo do input: Este agente deve ser apto a receber como input payloads prontos com endpoints e parâmetros necessários para a chamada à API.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados estruturados retornados pelas APIs, incluindo metadados de fonte e timestamp.
• Exemplo de Estrutura de Output:

   {
    "produto": "Produto XYZ",
    "dados": {
      "campo1": "valor1",
      "campo2": "valor2"
    },
    "fonte": "Fonte API",
    "timestamp": "2025-12-16T13:23:00"
  } 

• Número de caracteres esperado: O conjunto de dados gerado terá um tamanho aproximado de 3.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá executar chamadas para APIs externas conforme especificado nos payloads.

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

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

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

Consolidar, normalizar e validar os dados brutos em um esquema único e comparável.

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 2 ou RF 3).
• Tipo do input: Este agente deve ser apto a receber dados brutos de busca online e/ou APIs, além de metadados de comparação e critérios do cliente.
• 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 até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON padronizado por produto com campos normalizados e validados.
• Exemplo de Estrutura de Output:

   {
    "produto": "Produto XYZ",
    "identificadores": {
      "nome": "string",
      "ticker": "string"
    },
    "custos": {
      "taxa_admin": "percent",
      "taxa_performance": "percent"
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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.
• Calculadora: Não utiliza.
• 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 Adequação ao Perfil (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Adequação ao Perfil (RF 5).

Aplicar regras de suitability ao conjunto de produtos normalizados conforme perfil de risco, horizonte e restrições do cliente.

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 dados normalizados por produto, perfil de risco, horizonte e restrições do cliente.
• 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é 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com cada produto anotado com informações de suitability.
• Exemplo de Estrutura de Output:

   {
    "produto": "Produto XYZ",
    "suitability": {
      "apto": true,
      "motivos_exclusao": []
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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.
• Calculadora: Não utiliza.
• 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 deve ser visível para o Agente de Comparação e Ranking (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Comparação e Ranking (RF 6).

Comparar os produtos aptos, calcular escores ponderados e produzir ranking com trade-offs.

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 produtos aptos com métricas padronizadas, pesos por perfil e objetivos.
• 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é 8.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser uma tabela comparativa com métricas-chave, escore_total e ranking dos produtos.
• Exemplo de Estrutura de Output:

   [
    {
      "produto": "Produto XYZ",
      "escore_total": 85.0,
      "ranking": 1
    }
  ] 

• Número de caracteres esperado: O output terá um tamanho aproximado de 2.000 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.
• Calculadora: Utiliza lógica interna para calcular escores.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Geração de Relatório e Recomendações (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório e Recomendações (RF 7).

Produzir relatório final claro e objetivo com as comparações, recomendações alinhadas ao perfil e próximos passos.

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 ranking, tabela comparativa, suitability e briefing do cliente.
• 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.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório estruturado em JSON com todas as comparações e recomendações.
• Exemplo de Estrutura de Output:

   {
    "resumo_executivo": "string",
    "top_recomendados": ["Produto XYZ"],
    "tabela_comparativa": "string"
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 finaliza o fluxo e é o entregável final ao cliente.

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