Agente de IA para Relatórios de Risco de Crédito

Converter a solicitação do usuário em parâmetros padronizados para coleta de dados financeiros e de crédito.

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 uma solicitação de relatório de risco de crédito 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 é uma solicitação de relatório de risco de crédito, que após ser processada, resulta em parâmetros padronizados para coleta de dados.
• Formatos Suportados: Esse agente deve ser capaz de receber solicitações nos formatos: .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 contendo parâmetros padronizados para coleta de dados financeiros e de crédito.
• Exemplo de Estrutura de Output:

   {
    "parametros_coleta": {
      "bureau_payload": {"documento": "CNPJ/CPF", "periodo": "2025-01-01/2025-12-31", "campos_requeridos": ["score", "faixas_atraso", "consultas", "limites", "enderecos"]},
      "erp_payload": {"cliente_id": "12345", "periodo": "2025-01-01/2025-12-31", "demonstracoes": ["DRE", "Balanço", "Fluxo_Caixa"], "consolidacao": "individual"},
      "core_payload_sql": {"cliente_id": "12345", "periodo": "2025-01-01/2025-12-31", "filtros": {"produtos": ["crédito", "garantias"], "status": ["ativo", "liquidado"]}},
      "normalizacao": {"moeda_base": "BRL", "taxas_cambio": {}, "politica_datas": "ISO-8601"},
      "chaves_conciliacao": {"cnpj_cpf": "00.000.000/0001-91", "cliente_id": "12345", "ids_conta": []},
      "recortes": {"periodo": "2025-01-01/2025-12-31", "granularidade": "trimestral"}
    }
  }

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 - Bureau de Crédito (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 - Bureau de Crédito (RF 2).

Realizar chamada à API do bureau de crédito para obter histórico e atributos de crédito.

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 payload para chamada à 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 até 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos do bureau de crédito.
• Exemplo de Estrutura de Output:

   {
    "dados_bureau_brutos": {
      "score_atual": 720,
      "score_hist": [700, 710, 720],
      "atrasos": {"qtd_por_faixa": {"30": 0, "60": 1, "90": 0}},
      "consultas_recente": 5,
      "limites_contratados": 100000,
      "enderecos": ["Endereço 1", "Endereço 2"],
      "timestamp_coleta": "2025-12-21T04:08:00Z"
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API do bureau de crédito 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 Execução de Chamada à API - ERP/Contábil (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 - ERP/Contábil (RF 3).

Realizar chamada à API do ERP/contabilidade para obter demonstrações financeiras.

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 payload para chamada à API do ERP/contabilidade.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as demonstrações financeiras brutas.
• Exemplo de Estrutura de Output:

   {
    "demonstracoes_financeiras_brutas": {
      "DRE": [...],
      "Balanco": [...],
      "Fluxo_Caixa": [...],
      "timestamp_coleta": "2025-12-21T04:08:00Z"
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API do ERP/contabilidade e retornar os dados recebidos como 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 Execução de Consultas em Banco de Dados - Core Banking (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados - Core Banking (RF 4).

Executar consulta no core banking para obter exposições, garantias e histórico de pagamentos.

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 payload para consulta no core banking.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos do core banking.
• Exemplo de Estrutura de Output:

   {
    "dados_core_banking_brutos": {
      "contratos": [...],
      "parcelas": [...],
      "garantias": [...],
      "produtos": [...],
      "timestamp_coleta": "2025-12-21T04:08:00Z"
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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: O agente deverá enviar o payload recebido para o core banking e retornar os dados recebidos como resposta.

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 Harmonização e Qualidade 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 Harmonização e Qualidade de Dados (RF 5).

Unificar, normalizar e validar a qualidade dos dados coletados das diferentes fontes.

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 brutos coletados de múltiplas fontes.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .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 o dataset unificado e um quality report.
• Exemplo de Estrutura de Output:

   {
    "dataset_unificado": {
      "financeiro": {"periodos": [...]},
      "credito": {"atributos": [...]},
      "exposicoes": {"contratos": [...]},
      "garantias": [...]
    },
    "quality_report": {
      "completude": {"campos_obrigatorios_pct": 90},
      "recencia": {"dias_ultima_atualizacao": 5},
      "consistencia": {"regras_quebradas": []},
      "normalizacoes_aplicadas": [...],
      "moedas_utilizadas": [...],
      "taxa_cambio_utilizada?": {...}
    }
  }

• 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 Cálculo de Métricas de Risco (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 Métricas de Risco (RF 6).

Calcular indicadores financeiros e de risco de crédito padronizados.

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 dataset unificado e um quality report.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .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 as métricas de risco calculadas.
• Exemplo de Estrutura de Output:

   {
    "metricas_risco": {
      "ratios": {"liquidez_corrente": 1.5, "liquidez_seca": 1.2, "giro_estoques": 3.0, "margem_ebitda": 0.25, "margem_liquida": 0.15, "alavancagem_divida_liquida_ebitda": 2.0, "cobertura_juros": 5.0, "endividamento_total": 0.6, "retorno_sobre_ativos": 0.08, "crescimento_receita_yoy": 0.1},
      "comportamento_credito": {"score_bureau": 720, "consultas_ultimos_6m": 5, "atraso_max_faixa": 60, "qtd_parcelas_em_atraso": 2},
      "exposicao": {"ead_atual": 500000, "ead_max_12m": 600000, "concentracao_top5_contratos": 0.4},
      "estimativas": {"pd_classe": "media", "lgd_proxy": 0.45, "ead_calculado": 500000},
      "flags": {"risco_alto": false, "observacoes": []}
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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.
• Calculadora: Não utiliza.
• 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 Cenários e Sensibilidade (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Cenários e Sensibilidade (RF 7).

Projetar sensibilidade de métricas de risco a choques simples.

7.3.1 Condições de Ativação

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

• O campo solicitar_cenarios_sensibilidade no input de parâmetros de coleta é igual a true.

7.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 6), apenas se solicitar_cenarios_sensibilidade for true.
• Tipo do input: Este agente deve ser apto a receber métricas de risco e parâmetros de coleta.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

7.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os cenários de sensibilidade projetados.
• Exemplo de Estrutura de Output:

   {
    "cenarios_sensibilidade": {
      "choques_aplicados": [
        {"nome": "queda_receita_10%", "descricao": "Redução de 10% na receita", "variaveis_afetadas": ["receita", "margem_ebitda"], "impacto_metricas": {"margem_ebitda": 0.2, "cobertura_juros": 4.5, "alavancagem": 2.2, "pd_classe": "alta"}},
        {"nome": "aumento_juros_200bps", "descricao": "Aumento de 2pp nos juros", "variaveis_afetadas": ["despesa_juros", "cobertura_juros"], "impacto_metricas": {"margem_ebitda": 0.25, "cobertura_juros": 3.5, "alavancagem": 2.0, "pd_classe": "media"}}
      ]
    }
  }

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

7.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.5 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

7.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 Geração de Sumário Executivo e Insights (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Sumário Executivo e Insights (RF 8).

Gerar narrativa executiva com principais achados, riscos e oportunidades.

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 métricas de risco e, opcionalmente, cenários de sensibilidade.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo um sumário executivo e insights.
• Exemplo de Estrutura de Output:

   {
    "secao_sumario": {
      "teaser": "Análise de Risco de Crédito",
      "principais_indicadores": [{"nome": "pd_classe", "valor": "media", "referencia": "classificação de risco"}, {"nome": "cobertura_juros", "valor": 5.0, "referencia": "x vezes"}],
      "top_riscos": ["Alto endividamento", "Baixa cobertura de juros"],
      "fatores_mitigadores": ["Reestruturação de dívida", "Aumento de capital"],
      "observacoes_qualidade": ["Dados insuficientes para algumas métricas"]
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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: Não utiliza.
• 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 gerada por este agente deve ser visível para o Agente de Montagem e Personalização do Relatório (RF 9).

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

Ao concluir sua execução, esse agente aciona o Agente de Montagem e Personalização do Relatório (RF 9).

Montar o relatório final estruturado conforme preferências do usuário.

9.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 8).
• Tipo do input: Este agente deve ser apto a receber parâmetros de coleta, dataset unificado, métricas de risco e, opcionalmente, cenários de sensibilidade.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 15.000 caracteres.

9.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório de risco de crédito final.
• Exemplo de Estrutura de Output:

   {
    "relatorio_risco_credito": {
      "metadados": {"cliente_id": "12345", "periodo": "2025-01-01/2025-12-31", "moeda_base": "BRL", "proprietario": "Cheila Portela", "gerado_em": "2025-12-21", "versao_template": "1.0"},
      "secoes": {"sumario": {...}, "panorama_financeiro": {...}, "comportamento_credito": {...}, "exposicao_e_garantias": {...}, "metricas_chave": {...}, "cenarios": {...}},
      "anexos": {"quality_report": {...}},
      "formato_secundario_md": "..."
    }
  }

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

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

9.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 Verificação de Conformidade e Consistência Final (RF 10).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação de Conformidade e Consistência Final (RF 10).

Validar consistência, confidencialidade e completude do relatório final.

10.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 9).
• Tipo do input: Este agente deve ser apto a receber um relatório de risco de crédito finalizado.
• 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.

10.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status de validação do relatório final.
• Exemplo de Estrutura de Output:

   {
    "validacao_final": {
      "status": "aprovado",
      "erros": [],
      "avisos": [],
      "relatorio_validado": {...}
    }
  }

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

10.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

10.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

10.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 não será visível para nenhum outro agente, pois finaliza o fluxo.

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

A execução deste agente finaliza o fluxo. O status de validação é o resultado que deve ser disponibilizado ao usuário.