Agente de IA para Consolidação de Dados de Crédito Multisource

Validar identificadores do consumidor e preparar, para cada fonte, os parâmetros e payloads de coleta de dados de crédito, além do esquema canônico de mapeamento.

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 identificadores do consumidor e escopo de fontes pretendidas 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 identificadores do consumidor e escopo de fontes pretendidas.
• 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 texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com os parâmetros e payloads de coleta de dados, além do esquema canônico de mapeamento.
• Exemplo de Estrutura de Output:

   {
    "canonical_schema": {...},
    "field_mapping": {...},
    "api_calls": [...],
    "staleness_policies": {...},
    "prioridade_de_fontes": [...]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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 definidas para obter dados de crédito brutos.

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 um objeto api_calls gerado previamente.
• 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 uma lista de objetos JSON contendo as respostas brutas das APIs.
• Exemplo de Estrutura de Output:

  raw_responses: [
    {
      "fonte": "bureau_A",
      "status_http": 200,
      "corpo_resposta": { ... },
      "data_coleta": "2025-12-19"
    }
  ]

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o objeto api_calls para as APIs externas e registrar as respostas recebidas.

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

Transformar as respostas brutas das fontes no esquema canônico unificado preservando proveniência por campo.

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 raw_responses, canonical_schema e field_mapping.
• 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 no esquema canônico com arrays de tradelines, inquiries, ocorrencias_negativas, dados_cadastrais e metadados de proveniência por campo.
• Exemplo de Estrutura de Output:

  normalized_records: {
    "tradelines": [...],
    "inquiries": [...],
    "ocorrencias_negativas": [...],
    "dados_cadastrais": [...],
    "provenance": { ... }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Resolução de Identidades e Deduplicação (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Resolução de Identidades e Deduplicação (RF 4).

Unificar registros referentes ao mesmo contrato/evento e resolver conflitos de valores entre fontes.

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 normalized_records e prioridade_de_fontes.
• 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 JSON contendo dados_unificados no esquema canônico, duplicate_groups, match_scores e conflict_resolutions.
• Exemplo de Estrutura de Output:

  deduped_records: {
    "dados_unificados": [...],
    "duplicate_groups": [...],
    "match_scores": [...],
    "conflict_resolutions": [...]
  }

• Número de caracteres esperado: O JSON gerado 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: Não utiliza.
• 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 de Validação de Qualidade e Atualidade (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Qualidade e Atualidade (RF 5).

Avaliar completude, consistência e frescor dos dados consolidados e sinalizar bloqueios.

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 deduped_records e staleness_policies.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com completeness_percent, freshness_ok, inconsistencies, blocking_issues e recommendations.
• Exemplo de Estrutura de Output:

  quality_report: {
    "completeness_percent": { ... },
    "freshness_ok": { ... },
    "inconsistencies": [...],
    "blocking_issues": false,
    "recommendations": [...]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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 Consolidação de Perfil e Cálculo de Indicadores (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação de Perfil e Cálculo de Indicadores (RF 6).

Produzir a visão unificada do perfil de crédito e calcular KPIs de risco e comportamento.

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 deduped_records e quality_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é 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com a visão unificada do perfil de crédito e os KPIs calculados.
• Exemplo de Estrutura de Output:

  consolidated_profile: {
    "total_de_divida": 10000.00,
    "limite_total": 50000.00,
    "utilizacao_percentual": 20.0,
    "taxa_pagamento_em_dia": 98.5,
    "atraso_max_dias": 0,
    "consultas_6m": 5,
    "ocorrencias_ativas": 0,
    "score_proxy": "baixo",
    "risk_band": "B"
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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.
• 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 Geração de Relatório Consolidado para Usuário Final (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório Consolidado para Usuário Final (RF 7).

Transformar o perfil consolidado em um relatório claro, acionável e de fácil entendimento.

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 consolidated_profile e quality_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é 10.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com seções: cabecalho, sumario_executivo, indicadores_chave, detalhes_por_conta, ocorrencias, consultas, qualidade_dos_dados, limitacoes, glossario e anexos.
• Exemplo de Estrutura de Output:

  final_report: {
    "cabecalho": {...},
    "sumario_executivo": [...],
    "indicadores_chave": {...},
    "detalhes_por_conta": [...],
    "qualidade_dos_dados": {...},
    "limitacoes": {...},
    "glossario": {...},
    "anexos": [...]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

7.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta (relatório final) é 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.