Agente de IA para Relatórios Personalizados de Desempenho Financeiro

Receber dados financeiros do cliente e entregar um dataset padronizado e consistente 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 um arquivo JSON contendo os dados financeiros 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 arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial é um JSON com dados financeiros 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é 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON padronizado contendo as demonstrações financeiras reclassificadas, KPIs calculados, flags de qualidade de dados e suposições aplicadas.
• Exemplo de Estrutura de Output:

   {
    "demonstrações": {
      "receita": 500000,
      "cpv": 300000,
      "despesas_operacionais": 100000,
      "ebitda": 100000
    },
    "kpis": {
      "margem_bruta": 0.4,
      "roe": 0.15
    },
    "flags": {
      "qualidade_dados": "alta",
      "outliers": ["receita"]
    },
    "suposições": {
      "moeda_base": "USD"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter aproximadamente 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: Utiliza lógica interna para cálculos financeiros.
• 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 Análise de Desempenho e Diagnóstico de Gaps (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Desempenho e Diagnóstico de Gaps (RF 2).

Diagnosticar o desempenho financeiro do cliente e apontar, de forma quantificada, as áreas de melhoria com suas causas prováveis.

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 recebe um JSON padronizado com dados financeiros e KPIs.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com diagnóstico de desempenho, incluindo gaps quantificados, ranking de prioridades, hipóteses de causas e métricas indisponíveis.
• Exemplo de Estrutura de Output:

   {
    "diagnostico": {
      "crescimento": {
        "delta": -0.02,
        "prioridade": "alta"
      },
      "rentabilidade": {
        "delta": 0.05,
        "prioridade": "média"
      }
    },
    "alertas": ["alta alavancagem"],
    "causas": ["pressão de custos"]
  } 

• Número de caracteres esperado: O JSON gerado deve ter aproximadamente 4.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: Utiliza lógica interna para cálculos de desempenho.
• 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 Perfil e Restrições do Cliente (RF 3).

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

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

Estruturar o perfil do cliente e restrições que orientarão as recomendações e oportunidades de investimento.

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 recebe o perfil bruto do cliente e o diagnóstico de desempenho financeiro.
• 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é 4.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com o perfil normalizado do cliente, incluindo informações de risco, horizonte, liquidez, restrições e preferências.
• Exemplo de Estrutura de Output:

   {
    "perfil": {
      "risco": "moderado",
      "horizonte": 24,
      "liquidez": 90,
      "restricoes": ["ESG", "setorial"],
      "preferencias": {"liquidez_alta": true}
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter aproximadamente 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 cálculos de normalização.
• 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 Busca Online de Dados de Mercado e Produtos (RF 4) e o Agente de Identificação e Priorização de Oportunidades de Investimento (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online de Dados de Mercado e Produtos (RF 4).

Realizar buscas online para coletar benchmarks setoriais, taxas de referência e universo de produtos elegíveis conforme perfil.

4.3.1 Condições de Ativação

Este agente é acionado somente se a seguinte condição for atendida:

• O campo necessita_busca_mercado no output do Agente de Saneamento e Padronização de Dados Financeiros (RF 1) é igual a "true".

4.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 3), apenas se a busca de mercado for necessária.
• Tipo do input: Este agente recebe parâmetros de busca prontos em formato 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é 3.000 caracteres.

4.3.3 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados recuperados contendo benchmarks setoriais, taxas de juros/inflacao vigentes e lista de produtos/ativos.
• Exemplo de Estrutura de Output:

   {
    "benchmarks": {
      "margens": 0.15,
      "alavancagem": 2.5
    },
    "taxas": {
      "juros": 0.05,
      "inflacao": 0.03
    },
    "produtos": ["fundo x", "ação y"]
  } 

• Número de caracteres esperado: O JSON gerado deve ter aproximadamente 2.000 caracteres.

4.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.5 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Executa buscas online com os parâmetros recebidos.
• Sistemas Externos: Não se conecta a sistemas externos.

4.3.6 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 Identificação e Priorização de Oportunidades de Investimento (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação e Priorização de Oportunidades de Investimento (RF 5).

Propor oportunidades de investimento alinhadas ao perfil e aos gaps do diagnóstico, priorizadas por adequação risco-retorno e restrições.

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 recebe o diagnóstico de desempenho, perfil normalizado e dados de mercado/produtos.
• 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é 6.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista priorizada de oportunidades de investimento, detalhando classe de ativo, tese, aderência ao perfil, risco esperado, retorno esperado e outros atributos.
• Exemplo de Estrutura de Output:

   {
    "oportunidades": [
      {
        "classe_ativo": "ações",
        "tese": "crescimento",
        "aderencia_perfil": 85,
        "risco": "alto",
        "retorno": "alto"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter aproximadamente 3.500 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 cálculos de score de adequação.
• 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 Geração de Relatório Personalizado (RF 6).

5.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 Personalizado (RF 6).

Produzir relatório final claro e acionável, destacando áreas de melhoria e oportunidades de investimento personalizadas.

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 recebe as saídas dos agentes anteriores em formato 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório estruturado em texto, incluindo resumo executivo, visão geral do cliente, KPIs, áreas de melhoria, oportunidades de investimento e próximos passos, além de um anexo JSON com todos os objetos-chave.
• Exemplo de Estrutura de Output:

   {
    "relatorio": {
      "resumo_executivo": "O cliente apresenta oportunidades significativas de melhoria em rentabilidade e liquidez...",
      "kpis": {
        "margem_bruta": 0.4,
        "roe": 0.15
      },
      "oportunidades": ["ação y"]
    }
  } 

• Número de caracteres esperado: O relatório estruturado deve ter aproximadamente 7.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 documentos externos.
• Calculadora: Não utiliza.
• 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 é o entregável final e não é passada para outros agentes internos.

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