Agente de IA para Análise de Histórico de Crédito

Validar consistência estrutural e padronizar o histórico de crédito recebido para um esquema único e coerente.

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 um histórico de crédito do cliente 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 do arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um histórico de crédito bruto do cliente, que pode estar em formato JSON ou texto tabular transformável em JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• 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 documento JSON padronizado que segue o esquema definido nas regras do agente.
• Exemplo de Estrutura de Output:

   {
    "cliente_id": "string",
    "documento": "string",
    "data_referencia": "YYYY-MM-DD",
    "contas": [ ... ],
    "parcelas": [ ... ],
    "eventos": [ ... ],
    "consultas": [ ... ],
    "score_atual": number|null,
    "qualidade_dados": { ... }
  }

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados descritos.

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 Detecção de Erros e Inconsistências 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 Detecção de Erros e Inconsistências de Crédito (RF 2).

Identificar, classificar e qualificar erros e inconsistências no histórico de crédito padronizado, calculando impacto e confiança.

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 histórico de crédito padronizado em formato JSON, que inclui listas de contas, parcelas, eventos, consultas e um bloco de qualidade de dados.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um documento JSON com uma lista de problemas identificados, incluindo tipo, alvo, regra, evidências, severidade, impacto estimado, confiança e recomendação rápida.
• Exemplo de Estrutura de Output:

   {
    "problemas": [
      {
        "id_problema": "string",
        "tipo": "registro_faltante|duplicidade",
        "alvo": {
          "entidade": "conta",
          "id": "string"
        },
        "regra": "string_curta_identificando_regra",
        "evidencias": ["descricoes_concretas"],
        "severidade": "alta",
        "impacto_estimado": {
          "score": "alto",
          "risco_credito": "alto"
        },
        "confianca": 0.9,
        "recomendacao_rapida": "Solicitar atualização de status para 'paga' com comprovante X"
      }
    ],
    "resumo_metricas": {
      "qtde_problemas": 5,
      "por_tipo": {
        "duplicidade": 2
      },
      "por_severidade": {
        "alta": 3,
        "media": 2
      }
    }
  }

• 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: Não utiliza.

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 Geração de Plano de Ações Corretivas (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Plano de Ações Corretivas (RF 3).

Propor ações corretivas personalizadas e priorizadas para resolver os problemas detectados no histórico de crédito.

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 uma lista de problemas detalhados juntamente com o JSON padronizado do cliente para contexto.
• 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um documento JSON com uma lista de ações corretivas propostas, incluindo detalhes como passos, responsável sugerido, artefatos necessários, contatos sugeridos, prazo sugerido, e mensagem modelo.
• Exemplo de Estrutura de Output:

   {
    "acoes_corretivas": [
      {
        "id_problema_referido": "string",
        "acao": "Solicitar atualização de status",
        "passos": ["Contactar credor", "Anexar comprovante"],
        "responsavel_sugerido": "cliente",
        "artefatos_necessarios": ["comprovante_pagamento"],
        "contatos_sugeridos": [
          {
            "entidade": "credor",
            "canal": "email",
            "descricao": "Contato do suporte"
          }
        ],
        "prazo_sugerido_dias": 10,
        "precedencias": [],
        "estimativa_impacto_score": "medio",
        "riscos_observacoes": "Nenhum risco identificado",
        "mensagem_modelo": "Prezado credor, solicito atualização de status..."
      }
    ],
    "priorizacao": [
      {
        "id_acao": "string",
        "prioridade": 1,
        "criterios": {
          "impacto": "alto",
          "esforco": "baixo",
          "urgencia": "alta"
        }
      }
    ]
  }

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

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

A execução deste agente finaliza o fluxo. A lista de ações corretivas gerada é o resultado que deve ser disponibilizado ao usuário.