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

Preparar o plano de coleta consolidando fontes autorizadas, janelas temporais e campos requeridos para cada tipo de usuário (PF/PJ).

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 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 de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo as solicitações de dados 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é 20.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as requisições preparadas para coleta de dados de crédito.
• Exemplo de Estrutura de Output:

   {
    "prepared_requests": [
      {
        "source_id": "bureau_nacional",
        "endpoint": "/consulta/credito",
        "method": "GET",
        "headers": {"Authorization": "Bearer token"},
        "query/body": {"cpf": "***.***.***-1234"},
        "pagination_rules": {"limit": 100, "cursor": ""},
        "rate_limit_hints": {"max_requests_per_minute": 10},
        "required_fields": ["tradelines", "pagamentos", "consultas"],
        "lookback_months": 24,
        "priority": 1,
        "expected_schema_hint": {"volume": "large"}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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 Execução de Chamada à API (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 (RF 2).

Realizar chamadas às APIs das fontes de crédito autorizadas para obter os dados solicitados.

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 contendo as requisições preparadas para coleta de dados 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 as respostas brutas das chamadas às APIs das fontes de crédito.
• Exemplo de Estrutura de Output:

   {
    "raw_responses": [
      {
        "source_id": "bureau_nacional",
        "status_code": 200,
        "headers": {"Content-Type": "application/json"},
        "body_raw": "{...}",
        "retrieved_at": "2025-12-13T05:39:00Z",
        "request_meta": {"endpoint": "/consulta/credito"}
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado será denso, com um tamanho mínimo esperado de 10.000 caracteres.

2.3.3 Parâmetros de Geração

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

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Este agente realiza chamadas às APIs das fontes de crédito autorizadas.

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

Padronizar esquemas, eliminar duplicidades entre fontes e consolidar um dataset único de crédito com métricas derivadas.

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 contendo as respostas brutas das chamadas às APIs das fontes 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é 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o dataset unificado de crédito com métricas derivadas.
• Exemplo de Estrutura de Output:

   {
    "unified_credit_dataset": {
      "party": {"entity_type": "PF", "cpf_masked": "***.***.***-1234", "nome_razao_social": "Fulano de Tal"},
      "snapshot_at": "2025-12-13T05:39:00Z",
      "tradelines": [...],
      "inquiries": [...],
      "payments": [...],
      "limits": [...],
      "delinquencies": [...],
      "guarantees": [...],
      "partners_pj": [...],
      "derived_metrics": {"utilization_rate": 0.25, "dti": 0.3, "avg_days_past_due_12m": 5, "inquiries_12m": 3, "on_time_ratio_12m": 0.9, "credit_mix_index": 0.8, "exposure_concentration_top5": 0.4, "highest_dpd_24m": 15},
      "data_quality": {"missing_fields": [], "source_conflicts": [], "recency_ok": true}
    }
  } 

• Número de caracteres esperado: O JSON gerado será denso, com um tamanho mínimo esperado de 15.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: Utiliza lógica interna para calcular métricas derivadas.
• 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 Perfil e Preferências do Usuário (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Perfil e Preferências do Usuário (RF 4).

Transformar preferências e necessidades do usuário em parâmetros de personalização aplicáveis ao 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 3).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo as preferências e necessidades do usuário para personalização do relatório 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é 3.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o perfil de personalização do relatório de crédito.
• Exemplo de Estrutura de Output:

   {
    "personalization_profile": {
      "sections_enabled": ["resumo_executivo", "kpis", "riscos", "oportunidades", "acoes_recomendadas"],
      "ordering": ["resumo", "kpis", "riscos", "oportunidades", "ações", "detalhamento", "metodologia"],
      "thresholds": {"utilization_warn": 0.3, "dti_warn": 0.35, "inquiries_warn": 6},
      "tone": {"linguagem": "leiga", "idioma": "pt-BR"},
      "kpi_focus": "utilization_rate",
      "redaction_level": "alto"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.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 deve ser visível para o Agente de Personalização da Estrutura do Relatório (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Personalização da Estrutura do Relatório (RF 5).

Gerar o esqueleto do relatório (outline) combinando dataset consolidado e perfil de personalização.

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 como input um dataset consolidado de crédito e um perfil de personalização para o relatório.
• 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 JSON contendo o esqueleto do relatório de crédito.
• Exemplo de Estrutura de Output:

   {
    "report_outline": [
      {"section_id": "resumo_executivo", "title": "Resumo Executivo", "intent": "Sumário dos principais KPIs", "kpis_alvo": ["utilization_rate", "dti"], "incluir": true, "notas_de_personalizacao": ""},
      {"section_id": "kpis", "title": "KPIs Detalhados", "intent": "Detalhamento dos KPIs principais", "kpis_alvo": ["utilization_rate", "dti", "inquiries_12m", "on_time_ratio_12m", "highest_dpd_24m"], "incluir": true, "notas_de_personalizacao": ""}
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.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 documentos externos.
• Calculadora: Não utiliza.
• 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 Geração de Insights Financeiros (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights Financeiros (RF 6).

Produzir insights e recomendações acionáveis com base nos dados consolidados e no outline.

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 de crédito e um outline do relatório.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os insights financeiros gerados a partir dos dados consolidados.
• Exemplo de Estrutura de Output:

   {
    "insights": [
      {"category": "risco", "metric_ref": "utilization_rate", "value": 0.35, "threshold": 0.3, "finding": "Utilização acima do recomendado.", "recommended_action": "Reduzir utilização para <0.3 redistribuindo gastos.", "expected_impact": "Redução de juros em 5%", "priority": 1, "horizon": "curto"}
    ]
  } 

• Número de caracteres esperado: O JSON gerado será denso, com um tamanho mínimo esperado de 5.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 documentos externos.
• Calculadora: Utiliza lógica interna para calcular impactos estimados.
• 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 deve ser visível para o Agente de Verificação de Conformidade e Privacidade (RF 7).

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

Revisar o conteúdo para aderência a privacidade, consentimento e linguagem apropriada.

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 um dataset consolidado de crédito, insights e um outline do relatório.
• 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é 20.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório de conformidade e privacidade.
• Exemplo de Estrutura de Output:

   {
    "compliance_report": {
      "ok": true,
      "issues": [],
      "redactions_aplicadas": []
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Redação e Montagem do Relatório (RF 8).

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

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

Gerar o relatório final em linguagem natural e pacote JSON estruturado para consumo por sistemas.

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 um outline do relatório, insights, um dataset consolidado de crédito e um relatório de conformidade.
• 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é 25.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório final em linguagem natural e estruturado para consumo por sistemas.
• Exemplo de Estrutura de Output:

   {
    "report_package": {
      "human_readable": {
        "titulo": "Relatório de Crédito Personalizado",
        "resumo_executivo": "O relatório apresenta uma visão geral dos principais indicadores de crédito...",
        "kpis": [...],
        "seções": [...],
        "acoes_recomendadas": [...],
        "disclaimers": "As informações apresentadas são baseadas em dados disponíveis..."
      },
      "machine_json": {
        "snapshot_at": "2025-12-13T05:39:00Z",
        "kpis": [...],
        "insights": [...],
        "seções": [...],
        "data_quality": {...}
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado será denso, com um tamanho mínimo esperado de 10.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 é 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.