Agente de IA para Atualização Automática de Registros de Crédito

Transformar a lista de fontes financeiras em parâmetros de consulta prontos para execução de busca/coleta.

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 das fontes financeiras 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: Dados estruturados sobre fontes financeiras.
• 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 contendo os parâmetros de busca prontos para execução.
• Exemplo de Estrutura de Output:

  {
    "parametros_busca": [{
      "id_fonte": "123",
      "tipo_fonte": "api",
      "endpoint_ou_url": "https://api.fonte.com",
      "periodo": {"inicio": "2025-12-23T10:00:00Z", "fim": "2025-12-23T11:00:00Z"},
      "filtro_incremental": {"campo_referencia": "updated_at", "operador": ">=", "valor": "2025-12-23T10:00:00Z"},
      "campos_solicitados": ["identificador_cliente", "data_evento", "tipo_evento", "valor_evento"],
      "timezone": "UTC",
      "id_execucao": "exec123"
    }],
    "checkpoint_planejado_fim": "2025-12-23T11:00:00Z"
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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: Utiliza lógica interna para determinar intervalos de tempo e checkpoints.
• 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 Busca Online.

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online.

Realizar chamadas de busca/coleta nas fontes financeiras com base nos parâmetros preparados.

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: Parâmetros de busca prontos para execução.
• 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 estruturado com os dados brutos coletados de cada fonte financeira.
• Exemplo de Estrutura de Output:

  {
    "dados_brutos_por_fonte": [{
      "id_fonte": "123",
      "id_execucao": "exec123",
      "lote_coleta": [{
        "pagina_ou_fatia": 1,
        "registros_brutos": [
          {"identificador_cliente": "12345678901", "data_evento": "2025-12-23T10:00:00Z", "tipo_evento": "pagamento", "valor_evento": 100.00}
        ]
      }]
    }]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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: Este agente realizará chamadas a sistemas externos utilizando as APIs das fontes financeiras.

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 Deduplicação de Eventos Financeiros.

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Deduplicação de Eventos Financeiros.

Converter registros brutos de múltiplas fontes em um esquema unificado e remover duplicidades antes da análise 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: Dados brutos coletados de múltiplas fontes financeiras.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com eventos financeiros normalizados e deduplicados.
• Exemplo de Estrutura de Output:

  {
    "eventos_financeiros_normalizados": [{
      "id_fonte": "123",
      "id_execucao": "exec123",
      "id_evento_composto": "12345678901_pagamento_2025-12-23T10:00:00Z_100.00_123",
      "identificador_cliente": "12345678901",
      "data_evento": "2025-12-23T10:00:00Z",
      "tipo_evento_normalizado": "pagamento",
      "valor_evento": 100.00,
      "moeda": "BRL",
      "status_evento_normalizado": "confirmado",
      "origem": "123",
      "descricao": "Pagamento de fatura",
      "referencia_externa": "abcd1234"
    }]
  }

• Número de caracteres esperado: O JSON gerado 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 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 Classificação de Relevância para Atualização de Crédito.

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Relevância para Atualização de Crédito.

Determinar quais eventos normalizados são relevantes para impactar registros de crédito e com qual prioridade.

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: Eventos financeiros normalizados para análise de relevância.
• 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 estruturado com eventos relevantes para crédito e suas classificações.
• Exemplo de Estrutura de Output:

  {
    "eventos_relevantes_para_credito": [{
      "id_evento_composto": "12345678901_pagamento_2025-12-23T10:00:00Z_100.00_123",
      "identificador_cliente": "12345678901",
      "categoria_impacto": "pagamento",
      "prioridade": "alta",
      "score_relevancia": 0.85,
      "motivo_relevancia": "alta recência e valor",
      "gatilho_atualizacao": true
    }]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.500 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: Utiliza lógica interna para calcular score de relevância.
• 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 Mapeamento e Geração de Payload de Atualização de Crédito.

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

Ao concluir sua execução, esse agente aciona o Agente de Mapeamento e Geração de Payload de Atualização de Crédito.

Preparar, para cada evento relevante, o payload padronizado de atualização do registro de crédito.

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: Eventos relevantes para crédito que precisam ser transformados em payloads.
• 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 estruturado com payloads de atualização de crédito prontos para envio.
• Exemplo de Estrutura de Output:

  {
    "lista_payloads_atualizacao": [{
      "idempotency_key": "12345678901_pagamento_2025-12-23T10:00:00Z_100.00_123",
      "acao": "upsert",
      "identificador_cliente": "12345678901",
      "campos_atualizados": {
        "pagamento": 100.00,
        "saldo": -100.00
      },
      "metadados": {
        "origem_evento": "123",
        "id_evento_composto": "12345678901_pagamento_2025-12-23T10:00:00Z_100.00_123",
        "categoria_impacto": "pagamento",
        "score_relevancia": 0.85
      }
    }]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 Execução de Chamada à API.

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

Realizar chamada à API do Sistema de Crédito para enviar os payloads de atualização dos registros.

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: Payloads de atualização de crédito prontos para envio.
• 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 as respostas da API para cada payload enviado.
• Exemplo de Estrutura de Output:

  {
    "respostas_api_por_evento": [{
      "idempotency_key": "12345678901_pagamento_2025-12-23T10:00:00Z_100.00_123",
      "status_execucao": "sucesso",
      "codigo_resposta": 200,
      "mensagem_resposta": "Atualização realizada com sucesso",
      "id_registro_credito_resultante": "cred123456"
    }]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Este agente realizará chamadas a sistemas externos utilizando a API do Sistema de Crédito.

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 Reconciliação e Confirmação de Atualizações.

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

Ao concluir sua execução, esse agente aciona o Agente de Reconciliação e Confirmação de Atualizações.

Conciliar respostas da API com os eventos enviados, consolidar o resultado, definir próximo checkpoint e identificar itens para reprocessamento.

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: Respostas da API para os payloads enviados e eventos relevantes para 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é 15.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o resumo da execução, incluindo totais, falhas e recomendações de ação.
• Exemplo de Estrutura de Output:

  {
    "resumo_execucao": {
      "total_eventos": 100,
      "atualizados": 90,
      "ignorados": 5,
      "falhas": 5,
      "para_reprocessamento": [{
        "idempotency_key": "12345678901_pagamento_2025-12-23T10:00:00Z_100.00_123",
        "motivo_falha": "rate_limit",
        "recomendacao_acao": "Tentar novamente mais tarde"
      }]
    },
    "next_checkpoint_timestamp": "2025-12-23T11:00:00Z"
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.500 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: Utiliza lógica interna para conciliação de dados e cálculo de totais.
• 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 é 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 resumo da execução é o resultado que deve ser disponibilizado para análise.