Agente de IA para Classificação de Crédito Empresarial

Receber dados financeiros brutos de empresas, detectar a origem, padronizar nomenclaturas e moedas, estruturar períodos e preparar payloads caso a fonte seja API.

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 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 de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de dados financeiros brutos em formato JSON ou CSV.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo os dados normalizados e prontos para análise. Deve incluir informações sobre conversão de moedas, periodização e preparação para chamadas à API.
• Exemplo de Estrutura de Output:

   {
    "empresa_id": "123456",
    "setor_normalizado": "Tecnologia",
    "moeda_destino": "BRL",
    "taxa_conversao_utilizada": {"2024": 5.2},
    "dados_normalizados": {
      "balanco_norm": {...},
      "dre_norm": {...},
      "fluxo_caixa_norm": {...}
    },
    "pronto_para_validacao": true
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 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 conversão de moedas e periodização.
• 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 Consolidação e Validação de Dados (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 (RF 2) se fonte_dados_tipo_resolvida for 'api', caso contrário, aciona o Agente de Consolidação e Validação de Dados (RF 3).

Realizar chamada à API de fontes financeiras externas para obter demonstrações e indicadores complementares conforme payloads preparados.

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) quando fonte_dados_tipo_resolvida for 'api'.
• Tipo do input: Este agente deve ser apto a receber payloads preparados para chamadas à API contendo endpoint, método, headers públicos, parâmetros e empresa_id.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos obtidos de cada chamada à API, identificados por endpoint e empresa_id.
• Exemplo de Estrutura de Output:

   {
    "empresa_id": "123456",
    "dados_api_recuperados": [
      {
        "endpoint": "https://api.financeira.com/dados",
        "resposta": {...}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• 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: O agente deverá enviar os payloads para a API externa e retornar os dados recebidos como resposta.

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

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

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

Consolidar dados normalizados com respostas de API (se houver), verificar integridade contábil e gerar dataset válido para cálculo de indicadores.

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 1 ou RF 2).
• Tipo do input: Este agente deve ser apto a receber um JSON com dados normalizados e, opcionalmente, dados recuperados de API.
• 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 contendo o dataset consolidado e validado, pronto para o cálculo de indicadores financeiros.
• Exemplo de Estrutura de Output:

   {
    "dataset_validado": {
      "empresa_id": "123456",
      "demonstrativos_consolidados": {...},
      "balanco_equilibra": true,
      "dre_fluxo_consistente": true,
      "qualidade_dados_nivel": "alto",
      "pronto_para_calculo": true
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 5.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 validação de balanço e consistência de dados.
• 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 Cálculo de Indicadores Financeiros (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Indicadores Financeiros (RF 4).

Calcular indicadores financeiros padronizados por período e métricas agregadas para uso na classificação de crédito.

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 JSON contendo o dataset validado e consolidado, pronto para cálculo de indicadores.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os indicadores financeiros calculados e as métricas agregadas, prontos para uso na classificação de crédito.
• Exemplo de Estrutura de Output:

   {
    "indicadores_calculados": {
      "empresa_id": "123456",
      "indicadores": {
        "liquidez_corrente": 1.5,
        "endividamento_total": 0.4,
        "margem_liquida": 0.12,
        "roe": 0.15,
        "roa": 0.08
      },
      "pronto_para_classificacao": true
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 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 documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de indicadores financeiros.
• 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 deve ser visível para o Agente de Classificação de Crédito (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Crédito (RF 5).

Atribuir categoria de crédito com base em score composto de indicadores financeiros e ajustes setoriais.

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 um JSON contendo indicadores financeiros calculados e métricas agregadas.
• 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 contendo a classificação preliminar de crédito, com score, categoria e justificativas.
• Exemplo de Estrutura de Output:

   {
    "classificacao_preliminar": {
      "empresa_id": "123456",
      "score_0a100": 85,
      "categoria_preliminar": "AA",
      "justificativas": ["Liquidez Corrente alta", "Endividamento controlado"],
      "pronto_para_politicas": true
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 3.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 cálculo de score e classificaçã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 Regras de Políticas de Crédito (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Regras de Políticas de Crédito (RF 6).

Aplicar regras mandatórias e exceções de política que podem elevar ou rebaixar a classificação preliminar ou torná-la inelegível.

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 um JSON contendo a classificação preliminar e dados adicionais para ajuste de política.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a classificação final de crédito, com categoria, score ajustado e motivos dos ajustes.
• Exemplo de Estrutura de Output:

   {
    "classificacao_final": {
      "empresa_id": "123456",
      "categoria_final": "A",
      "score_final": 82,
      "motivo_ajustes": ["Garantias reais elevadas", "Protestos recentes"],
      "elegibilidade": "elegivel"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 3.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: Utiliza lógica interna para ajustes de classificação.
• 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 deve ser visível para o Agente de Geração de Relatórios de Classificação (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órios de Classificação (RF 7).

Produzir relatório estruturado de classificação de crédito com sumário executivo, análise, recomendações 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 um JSON contendo a classificação final de crédito, indicadores financeiros e dados consolidados.
• 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.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON detalhado contendo o relatório de classificação de crédito, com sumário executivo, análise e recomendações.
• Exemplo de Estrutura de Output:

   {
    "relatorio_classificacao": {
      "cabecalho": {
        "empresa": "Empresa XYZ",
        "data": "07 de Dezembro de 2025",
        "setor": "Tecnologia"
      },
      "sumario_executivo": {
        "categoria_final": "A",
        "score_final": 82,
        "elegibilidade": "elegivel",
        "motivos_determinantes": ["Garantias reais elevadas", "Protestos recentes"]
      },
      "tabela_indicadores_chave": {...},
      "recomendacoes_credor": {
        "limites": "Até 20% da Receita anual",
        "prazos": "Até 24 meses"
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e preciso, com um tamanho estimado em 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 documentos externos.
• Calculadora: Utiliza lógica interna para análise de dados e recomendações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 é o entregável final e não é passada para outros agentes internos.

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.