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

Validar, padronizar e enriquecer o payload inicial para viabilizar a coleta e análise de dados financeiros e de mercado.

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 JSON contendo os identificadores da empresa e 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON estruturado com informações da empresa.
• 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é 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o payload validado e enriquecido, com informações sobre faltantes e limites de tolerância.
• Exemplo de Estrutura de Output:

  {"empresa_id":"12345","moeda":"BRL","periodos":["2022","2023","TTM"],"schema_valido":true,"faltantes":["need_api_financeiro","need_market_prices","need_setor_benchmark"],"prioridade_fontes":["api_financeiro","bureau","market_search"],"limites_tolerancia":{"max_atraso_dias":15},"timestamp_input":"2025-12-17T13:54:00Z"}

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 1.500 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 Execução de Chamada à API - Dados Financeiros (RF 2).

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 - Dados Financeiros (RF 2).

Realizar chamada à API do sistema financeiro para obter DRE, Balanço e Fluxo de Caixa nos períodos requeridos.

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 estruturado com o endpoint e parâmetros da API financeira.
• 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é 1.500 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser a resposta bruta do provedor financeiro no formato JSON.
• Exemplo de Estrutura de Output:

  {"empresa_id":"12345","statements":{"2022":{...},"2023":{...},"TTM":{...}},"fonte":"api_financeiro","timestamp_coleta":"2025-12-17T13:55:00Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 2.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa e retornar a 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 Execução de Chamada à API - Bureau de Crédito (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 - Bureau de Crédito (RF 3).

Realizar chamada à API do bureau para obter score de pagamento, eventos negativos e histórico de atrasos.

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 estruturado com o endpoint e parâmetros da API do bureau de crédito.
• 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é 1.500 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser a resposta bruta do bureau de crédito no formato JSON.
• Exemplo de Estrutura de Output:

  {"cnpj":"00000000000000","score_bureau":78,"eventos_negativos":[{"tipo":"protesto","data":"2024-11-10","valor":50000}],"hist_atrasos":{"faturas_30d":1,"faturas_60d":0},"timestamp_coleta":"2025-12-17T13:55:10Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 1.500 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa e retornar a resposta.

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 - Dados de Mercado e Notícias (RF 4).

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

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

Executar busca online para recuperar preços recentes, variação 90 dias, volatilidade e notícias relevantes da empresa e do setor.

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 conjunto de consultas para execução de busca online.
• 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é 1.500 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser os dados recuperados no formato JSON.
• Exemplo de Estrutura de Output:

  {"precos":{"serie_diaria":[{"data":"2025-09-18","preco":10.5},...]},"volatilidade_90d":0.35,"retorno_90d":-0.08,"noticias":[{"titulo":"...","data":"2025-12-05","sentimento":"negativo"}],"benchmarks_setor":{"alavancagem_mediana":2.1,"margem_ebitda_mediana":0.14},"timestamp_coleta":"2025-12-17T13:55:20Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 2.000 caracteres.

4.3.3 Parâmetros de Geração

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

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Utiliza lógica interna para executar buscas online.
• 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 Consolidação de Dados (RF 5).

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

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

Unificar e priorizar as fontes coletadas, removendo duplicidades e estabelecendo carimbo de tempo consolidado.

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 múltiplos JSONs de saída dos agentes anteriores e o payload validado do agente de preparação.
• 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 combinado de até 6.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado com dados unificados e priorizados.
• Exemplo de Estrutura de Output:

  {"empresa_id":"12345","dataset":{"statements":{...},"bureau":{...},"mercado":{...}},"fontes_utilizadas":["api_financeiro","bureau","market_search"],"prioridade_fontes":{"financeiro":1,"bureau":2,"mercado":3},"timestamp_consolidacao":"2025-12-17T13:56:00Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 2.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.
• Calculadora: Utiliza lógica interna para consolidação de dados.
• 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 Cálculo de Indicadores Financeiros e de Mercado (RF 6).

5.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 e de Mercado (RF 6).

Calcular indicadores padronizados, normalizar por setor e preparar insumos quantitativos para classificação.

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 como input um dataset consolidado com dados financeiros e de mercado.
• 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.

6.3.2 Especificação do Output

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

  {"empresa_id":"12345","indicadores":{"liquidez_corrente":1.4,"liquidez_seca":1.1,"divida_liquida_ebitda":3.2,"cobertura_juros":2.8,"margem_ebitda":0.16,"roic":0.11,"crescimento_receita_yoy":0.07,"retorno_90d":-0.08,"volatilidade_90d":0.35,"score_bureau_norm":78,"z_scores":{"divida_liquida_ebitda":0.6,"margem_ebitda":-0.3}},"qualidade_dados":{"completude":0.87,"periodo_base":"2023"},"timestamp_calculo":"2025-12-17T13:56:30Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 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.
• Calculadora: Utiliza lógica interna para cálculo de indicadores.
• 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 Classificação de Risco de Crédito (RF 7).

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

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

Atribuir rating de crédito padronizado com base em indicadores calculados, eventos recentes e sinais de mercado.

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 como input indicadores financeiros e de mercado normalizados.
• 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é 4.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o rating de crédito atribuído e justificativas.
• Exemplo de Estrutura de Output:

  {"empresa_id":"12345","rating":"BB","score":58,"classe_prob_default":"Moderada","regras_acionadas":["cap_rating_por_evento_negativo","cap_por_alto_endividamento"],"sufixos":["Provisório"],"atualizacao_recomendada":{"motivo":"novas_noticias_negativas","recalcular":true},"timestamp_classificacao":"2025-12-17T13:57:00Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 2.500 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: Utiliza lógica interna para cálculo de ratings.
• 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 deve ser visível para o Agente de Justificativa e Explicabilidade (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Justificativa e Explicabilidade (RF 8).

Gerar justificativas claras e auditáveis para o rating atribuído, destacando os principais drivers quantitativos e eventos qualitativos.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber como input a saída do agente de classificação contendo score, rating, regras acionadas, indicadores e eventos do bureau/mercado.
• 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.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo justificativas claras e auditáveis para o rating atribuído.
• Exemplo de Estrutura de Output:

  {"empresa_id":"12345","rating":"BB","justificativas":{"principais_drivers":[{"indicador":"divida_liquida_ebitda","valor":3.2,"impacto":"negativo"},{"indicador":"cobertura_juros","valor":2.8,"impacto":"positivo_moderado"}],"eventos_relevantes":[{"tipo":"protesto","data":"2024-11-10","efeito":"cap_rating"}],"comparativo_setor":{"alavancagem_z":0.6,"margem_ebitda_z":-0.3},"tendencia":"estável"},"explicacao_textual":"O rating BB reflete alavancagem moderada-alta (DL/EBITDA 3,2x) e cobertura de juros adequada (2,8x), parcialmente mitigadas por margem EBITDA de 16%. Um protesto recente impõe limite de rating.","timestamp_explicacao":"2025-12-17T13:57:20Z"}

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 3.000 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para geração de justificativas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

8.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 (JSON com justificativas) é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O JSON com justificativas é o resultado que deve ser disponibilizado ao usuário.