Agente de IA para Análise de Crédito de Pessoa Jurídica

Validar consistência e padronizar os demonstrativos financeiros recebidos para um schema único e comparável por período.

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 arquivos ou dados estruturados 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Arquivos ou dados estruturados contendo Balanço Patrimonial, DRE e Fluxo de Caixa.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .xls, .xlsx.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com os demonstrativos padronizados e a qualidade dos dados.
• Exemplo de Estrutura de Output:

   {"empresa":"Razão Social","periodicidade":"anual|trimestral","moeda_padrao":"BRL","norma_contabil":"IFRS|BRGAAP","demonstrativos_normalizados":{"BP":[{...}],"DRE":[{...}],"DFC":[{...}]},"qualidade_dados":{"lacunas_campos":["..."],"inconsistencias":["..."],"ajustes_realizados":["..."],"padronizacao_realizada":"sim|nao"}} 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.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 de padronização e consistência.
• 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 Cálculo de Indicadores Financeiros (RF 2).

1.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 2).

Calcular indicadores de liquidez, alavancagem, rentabilidade, eficiência e geração de caixa a partir dos demonstrativos padronizados.

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: Objeto normalizado com os demonstrativos financeiros padronizados.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os indicadores financeiros calculados.
• Exemplo de Estrutura de Output:

   {"empresa":"Razão Social","metricas":{"liquidez_corrente":1.8,"liquidez_seca":1.2,"alavancagem_div_liq_ebitda":2.3,"alavancagem_div_liq_pl":0.9,"juros_cobertura_ebit":3.4,"margem_ebitda":0.18,"margem_liquida":0.07,"roe":0.12,"roa":0.06,"giro_ativos":1.4,"cagr_receita_3a":0.09,"cagr_ebitda_3a":0.11,"ccc_dias":72,"fcf":1000000.0},"base_calculo":{"periodo_referencia":"YYYY","janela":"TTM|anual","observacoes":["..."]}} 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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: Utiliza lógica interna para cálculos financeiros.
• 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 Execução de Chamada à API (RF 3).

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

Realizar chamadas às APIs externas para obter benchmarks macroeconômicos e setoriais (taxas SELIC/CDI, IPCA, câmbio, médias setoriais 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 2).
• Tipo do input: Payload pronto contendo endpoints para chamadas externas e informações de setor e período de referência.
• 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 JSON contendo os dados brutos retornados pelas APIs externas.
• Exemplo de Estrutura de Output:

   {"macro":{"selic_anual":0.115,"cdi_anual":0.114,"ipca_anual":0.045,"usdbrl":5.20},"setor":{"cnae":"XX.XX- X","benchmarks":{"liquidez_corrente":1.5,"margem_ebitda":0.12,"div_liq_ebitda":2.0,"ccc_dias":65}}} 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.

3.3.3 Parâmetros de Geração

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

3.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 o payload recebido para as APIs externas definidas.

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 Ajustes Macroeconômicos e Setoriais (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Ajustes Macroeconômicos e Setoriais (RF 4).

Ajustar e contextualizar os indicadores da empresa frente ao cenário macro e aos benchmarks setoriais para derivar features de risco comparáveis.

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: Métricas calculadas e dados macro/setoriais.
• 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é 7.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os ajustes realizados nos indicadores.
• Exemplo de Estrutura de Output:

   {"empresa":"Razão Social","ajustes":{"margem_ebitda_zscore":0.8,"liquidez_corrente_rel_setor":1.2,"div_liq_ebitda_gap":0.5,"ccc_excesso_dias":12,"cobertura_juros_stress_+300bps":2.1,"margem_inflacao_ajustada":0.06},"premissas":{"taxa_stress":0.03,"setor_cnae":"XX.XX- X"}} 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.200 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álculos de ajustes.
• 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 Análise de Risco e Política 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 Análise de Risco e Política de Crédito (RF 5).

Classificar o risco, estimar probabilidade de default (PD) por faixas e emitir decisão preliminar de crédito conforme política.

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: Indicadores brutos e ajustados dos agentes anteriores, além de metadados da empresa.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a classificação de risco e a decisão preliminar de crédito.
• Exemplo de Estrutura de Output:

   {"empresa":"Razão Social","classe_risco":"A|B|C|D|E","faixa_pd":"<=1%|>1%-3%|>3%-7%|>7%-15%|>15%","decisao_preliminar":"aprovar|condicionar|recusar","racional":"texto objetivo","sinais_alerta":["cobertura_juros<1.5","ccc_excesso>30d"],"pendencias_documentais":["DRE auditada","comprovação de garantias"],"parametros_utilizados":{"limiares":{"cobertura_juros":1.5,"divliq_ebitda":3.5,"liquidez_corrente":1.0}}} 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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 classificação de risco.
• 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 Recomendação de Limite e Condições 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 Recomendação de Limite e Condições de Crédito (RF 6).

Propor limite de crédito, prazo e condições (taxa, garantias, covenants) compatíveis com o risco e a capacidade de pagamento.

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: Classe de risco, faixa de PD, métricas de geração de caixa, sazonalidade e necessidade de capital de giro estimada.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a recomendação de limite e condições de crédito.
• Exemplo de Estrutura de Output:

   {"empresa":"Razão Social","recomendacao":{"limite_credito":1500000.0,"prazo_max_meses":24,"taxa_referencial":"CDI+3.2% a.a.","covenants":["Div Líq/EBITDA<=3.0","Cobertura Juros>=2.0"],"garantias_sugeridas":["fiança","alienação fiduciária"],"condicionantes":["apresentar DRE auditada","reduzir inadimplência clientes"]},"metodologia":{"limite_min": "min(2.0x EBITDA, 0.8x NCG)","ncg":"Estoque + Contas a Receber - Contas a Pagar"}} 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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 cálculos de limite de crédito e condições.
• 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. A recomendação gerada é o resultado que deve ser disponibilizado ao usuário.