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

Converter a solicitação do analista financeiro em um especificador estruturado de relatório de crédito, padronizando critérios, métricas, segmentos, limites e formato de saída.

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 instruções do analista financeiro 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 são instruções textuais estruturadas.
• Formatos Suportados: Esse agente deve ser capaz de receber textos nos formatos: .txt, .docx.
• 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 objeto JSON estruturado com a especificação completa do relatório de crédito.
• Exemplo de Estrutura de Output:

   {
    "subject_type": "jurídica",
    "subject_identifiers": ["CNPJ", "ID interno"],
    "analysis_period": {"start": "2023-01-01", "end": "2023-12-31"},
    "required_metrics": ["dpd90", "utilization_rate"],
    "segments": ["produto", "regiao"],
    "thresholds": {"dpd90": ">=0.10"},
    "business_policies": {"precedência_fonte": "interno > bureau > watchlists"},
    "data_requirements": {"requires_bureau_data": true, "requires_internal_data": true},
    "privacy_rules": {"masking": true},
    "output_format": {"structure": "json", "idioma": "pt-BR"},
    "insight_prefs": {"priorizar_riscos": true},
    "compliance_constraints": {"LGPD_minimization": true}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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(s) bureau(s) de crédito para obter dados de score, consultas, negativações, histórico de pagamentos e limites informados quando requisitado no spec.

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: Este agente deve ser apto a receber um payload JSON com subject_identifiers, analysis_period e lista de endpoints a consultar.
• 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 retornados pelos bureaus, com metadados de timestamp e origem.
• Exemplo de Estrutura de Output:

   {
    "score": 750,
    "consultas": [
      {
        "data": "2023-01-15",
        "origem": "Bureau XYZ",
        "detalhes": "Consulta de crédito realizada por Banco ABC"
      }
    ],
    "negativações": [],
    "historico_pagamentos": [
      {
        "data": "2023-02-01",
        "valor": 1000.00,
        "status": "Pago"
      }
    ]
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 3.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: Executa chamadas à API externa dos bureaus de crédito.

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

2.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 (Dados Internos) (RF 3) se requires_internal_data=true, caso contrário, aciona o Agente de Consolidação e Qualidade de Dados de Crédito (RF 4).

Realizar conexão com o banco de dados interno para recuperar limites, exposições, histórico de faturas/pagamentos, ratings internos e eventos de cobrança.

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) se requires_internal_data=true.
• Tipo do input: Este agente deve ser apto a receber parâmetros para execução de consulta, incluindo subject_identifiers, analysis_period e campos/tabelas de origem.
• 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 o dataset interno bruto com registros relevantes ao período e aos sujeitos solicitados, acompanhado de metadados de origem e extração.
• Exemplo de Estrutura de Output:

   {
    "limites": [
      {
        "data": "2023-01-01",
        "valor": 5000.00,
        "tipo": "Crédito Pessoal"
      }
    ],
    "exposicoes": [],
    "historico_pagamentos": [
      {
        "data": "2023-02-01",
        "valor": 1000.00,
        "status": "Pago"
      }
    ]
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 3.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa consultas no banco de dados interno.

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 Consolidação e Qualidade de Dados 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 Consolidação e Qualidade de Dados de Crédito (RF 4).

Unificar dados de múltiplas fontes, deduplicar, resolver conflitos por precedência, tratar faltantes e calcular variáveis derivadas para a geração do relatório.

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 2 ou RF 3).
• Tipo do input: Este agente deve ser apto a receber o spec do Agente de Definição de Critérios, dados brutos do bureau (se houver) e dados internos (se houver).
• 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 objeto consolidated_data pronto para consumo pelo gerador de relatório.
• Exemplo de Estrutura de Output:

   {
    "subjects": ["ID interno"],
    "eventos_normalizados": [],
    "métricas_base": {},
    "variáveis_derivadas": {},
    "data_quality_summary": {"completude": "alta", "consistência": "média", "duplicidades": "baixa", "conflitos_resolvidos": true, "campos_faltantes_por_fonte": []},
    "lineage": {"campo->fonte": "interno"}
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 5.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.
• Calculadora: Utiliza lógica interna para validação e cálculos de variáveis derivadas.
• Busca Online: Não utiliza.
• 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 Gerador de Relatório de Crédito Personalizado (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente Gerador de Relatório de Crédito Personalizado (RF 5).

Produzir relatório de crédito personalizado alinhado ao spec, com insights acionáveis, evidências e recomendações para decisão financeira.

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 o spec validado (spec.ready=true) e consolidated_data.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto credit_report estruturado com seções detalhadas do relatório de crédito.
• Exemplo de Estrutura de Output:

   {
    "capa": {},
    "sumário_executivo": {},
    "perfil_risco": {},
    "métricas-chave": {},
    "análise_segmentos": {},
    "alertas_exceções": {},
    "tendências": {},
    "recomendações_acionáveis": {},
    "anexo_metodológico": {},
    "evidence_map": {}
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 10.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: Utiliza lógica interna para cálculo de insights e confidence_score.
• 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 Verificação de Conformidade e Adequação (RF 6).

5.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 Adequação (RF 6).

Verificar se o relatório cumpre os critérios do spec, políticas de privacidade e utilidade para decisão, marcando não conformidades e sugerindo ajustes.

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 o credit_report gerado e spec original.
• 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 objeto compliance_check com status, non_compliance_items, redactions_applied, adequacy_score e sugestões_de_ajuste.
• Exemplo de Estrutura de Output:

   {
    "status": "revisar",
    "non_compliance_items": [],
    "redactions_applied": [],
    "adequacy_score": 85,
    "sugestões_de_ajuste": []
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 2.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 adequacy_score.
• 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 Preparação de Entrega (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Entrega (RF 7).

Empacotar a saída no formato solicitado, com estrutura estável para renderização e campos de metadados para versionamento.

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 o credit_report aprovado (ou com ajustes aplicados) e compliance_check.
• 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 objeto render_package com metadados e estrutura pronta para entrega.
• Exemplo de Estrutura de Output:

   {
    "format": "json",
    "locale": "pt-BR",
    "sections": [],
    "attachments": [],
    "metadata": {"versao": "1.0", "gerado_em": "2025-08-12T08:39:00Z", "fonte_dados": "interno, bureau", "confidencialidade": "Confidencial - Uso Interno", "adequacy_score": 85}
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 3.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.
• Calculadora: Utiliza lógica interna para geração de metadados.
• 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 é 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 render_package gerado é o resultado que deve ser disponibilizado ao usuário.