Agente de IA para Padronização de Relatórios de Crédito

Unificar e normalizar dados financeiros heterogêneos em um esquema canônico consistente para análise 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 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 arquivo csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Lista de payloads financeiros oriundos de múltiplas fontes.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo o esquema canônico padronizado.
• Exemplo de Estrutura de Output:

  {"canonical_schema": {"customer_id": "string", "person_type": "PF|PJ", "income_gross": "number", "income_net": "number", "expenses_total": "number", "loan_amount": "number", "interest_rate_annual": "number", "term_months": "integer", "installment_amount": "number", "open_debts_total": "number", "open_debts_count": "integer", "payment_history": "array", "collateral_value": "number", "currency": "ISO-4217", "reference_date": "YYYY-MM-DD"}, "standardized_records": [...], "mapping_log": [...], "normalization_log": [...], "data_quality_summary": {"records_input": 0, "records_output": 0, "fields_missing_rate": {}, "deduplications": 0}, "acceptance_preread_flag": "true|false"}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.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: 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 Validação de Consistência e Qualidade de Dados (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Consistência e Qualidade de Dados (RF 2).

Avaliar a integridade, consistência e suficiência analítica do dataset padronizado antes do cálculo de risco.

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: Objeto padronizado contendo canonical_schema, standardized_records[], mapping_log[], normalization_log[], data_quality_summary e acceptance_preread_flag.
• 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 standardized_records, dq_report e acceptance_flag.
• Exemplo de Estrutura de Output:

  {"standardized_records": [...], "dq_report": {"checks": [{"name": "missing_rate_income_net", "status": "pass|fail", "value": 0.12, "threshold": 0.2}], "blocking_issues": [], "warnings": []}, "acceptance_flag": "true|false"}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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: Não utiliza.
• 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 Cálculo de Indicadores de Risco 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 Cálculo de Indicadores de Risco de Crédito (RF 3).

Calcular métricas padronizadas de risco e capacidade de pagamento a partir do dataset validado.

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: Standardized_records filtrados como válidos e dq_report com acceptance_flag=true.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo risk_metrics e computation_notes.
• Exemplo de Estrutura de Output:

  {"risk_metrics": [{"customer_id": "string", "dti": 0.35, "leverage": 1.8, "installment_to_income": 0.25, "coverage_ratio": 2.1, "delinquency_ratio_12m": 0.08, "collateral_ltv": 0.6, "risk_band": "A|B|C|D|E", "rationale": "string"}], "computation_notes": []}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 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: Não utiliza.
• 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 Geração de Relatórios de Crédito (RF 4).

3.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 Crédito (RF 4).

Produzir relatório de crédito padronizado e pronto para consumo humano e sistêmico, com indicadores, avaliação e recomendações.

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: Risk_metrics calculados, standardized_records válidos e dq_report.
• 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.

4.3.2 Especificação do Output

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

  {"report": {"header": {"generated_at": "ISO-8601", "owner": "Cheila Portela", "version": "v1.0"}, "customer_summary": {...}, "financial_indicators": {...}, "risk_assessment": {"risk_band": "A-E", "rationale": "string"}, "recommendation": {"decision": "APROVAR|APROVAR_COM_CONDICOES|REPROVAR", "conditions": ["string"]}, "data_quality": {...}, "appendix": {"mapping_log_excerpt": [...]}}, "report_format": "json+markdown", "status": "emitido|nao_emitido"}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.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: Não utiliza.
• 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 é o entregável final e não é passada para outros agentes internos.

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