Agente de IA para Coleta Automatizada de Dados de Crédito

Definir fontes, escopo e preparar os payloads padronizados para consulta de dados de crédito de consumidores.

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 objeto JSON 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um objeto JSON contendo identificadores de consumidores e preferências de coleta.
• 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é 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os parâmetros de coleta, incluindo fonte_alvos, chave_deduplicacao, criterios_priorizacao, e politica_rate_limit.
• Exemplo de Estrutura de Output:

   {"fonte_alvos":[{"fonte_id":"fonte_cadastral_X","endpoint":"/v1/credit/consumers","metodo":"POST","headers":{"Authorization":"Bearer {{auth_token}}","Content-Type":"application/json"},"body":{"cpf":"00000000000","janela_temporal_meses":24,"itens":["dados_cadastrais"]},"timeout_ms":15000,"retentativas":2,"versao":"v1"}],"chave_deduplicacao":"cpf:00000000000:2025-11-28","criterios_priorizacao":["fonte_cadastral_X"],"politica_rate_limit":{"max_por_minuto":60,"backoff_ms":500}}

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 confiáveis selecionadas para obter dados de crédito do(s) consumidor(es).

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 objeto JSON contendo os parâmetros de coleta preparados pelo agente anterior.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os resultados das chamadas API, incluindo status de sucesso ou falha para cada fonte.
• Exemplo de Estrutura de Output:

   {"resultados":[{"fonte_id":"fonte_cadastral_X","status_http":200,"tempo_ms":842,"dados":{...}}],"falhas":[{"fonte_id":"fonte_Z","status_http":504,"erro":"timeout"}],"resumo":{"total_chamadas":3,"sucesso":2,"falhas":1}}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.000 caracteres.

2.3.3 Parâmetros de Geração

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

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deve se conectar às APIs externas das fontes de dados 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 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).

Unificar e padronizar os dados brutos retornados pelas múltiplas fontes em um esquema canônico, com preservação de proveniência.

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 um objeto JSON com campos resultados e falhas, conforme output do executor de API.
• 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é 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON canônico, com dados normalizados e proveniência dos dados.
• Exemplo de Estrutura de Output:

   {"consumidor":{"cpf":"00000000000","nome":"Fulano de Tal","data_nascimento":"1990-05-10"},"canonico":{"dados_cadastrais":{"enderecos":[...],"telefones":[...],"emails":[...]},"contas_credito":[{"instituicao":"","tipo_conta":"cartao","limite_total":0,"saldo_atual":0,"situacao":"ativa","abertura":"AAAA-MM-DD","moeda":"BRL","atualizado_em":"AAAA-MM-DD","fonte":"fonte_tradelines_Y"}]},"proveniencia":{"mapa":[{"campo":"contas_credito[0]","fonte":"fonte_tradelines_Y","quando":"AAAA-MM-DD"}]},"lacunas_informacao":[{"campo":"dados_cadastrais.enderecos[0].cep","motivo":"ausente","severidade":"media"}]}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 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 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 Verificaçã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 Verificação e Qualidade de Dados de Crédito (RF 4).

Aplicar verificações, validações cruzadas e scoring de qualidade para assegurar precisão dos dados consolidados.

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 um objeto JSON canônico consolidado, incluindo proveniencia e lacunas_informacao.
• 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é 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo dados validados, relatório de qualidade, discrepâncias e score de confiança.
• Exemplo de Estrutura de Output:

   {"dados_validados":{...},"relatorio_qualidade":{"erros":[{"campo":"contas_credito[0].saldo_atual","tipo":"valor_incoerente","descricao":"Saldo negativo sem flag de chargeoff"}],"avisos":[{"campo":"dados_cadastrais.endereco","tipo":"lacuna","descricao":"CEP ausente"}],"regras_aplicadas":["coerencia_numerica_v1","coerencia_temporal_v1"]},"discrepancias":[{"tipo":"divergencia_valor","campo":"limite_total","fontes_envovidas":["fonte_A","fonte_B"],"criterio_selecao":"mais_recente"}],"confianca":0.92,"validacao_aprovada":true}

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 4.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 Preparação de Payload para Bureaus de Crédito (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Payload para Bureaus de Crédito (RF 5).

Transformar os dados validados no formato exigido por cada bureau de crédito, com idempotência e versionamento do envio.

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 um objeto JSON com dados_validados, relatorio_qualidade, confianca e o identificador do bureau de destino.
• 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é 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON pronto para envio, incluindo idempotency_key, lotes, criterios_transformacao, e status de pronto_para_envio.
• Exemplo de Estrutura de Output:

   {"bureau":"bureau_alpha","versao_payload":"1.0.0","idempotency_key":"cpf:00000000000:2025-11-28:v1","lotes":[{"sequencia":1,"itens":[{...}]}],"criterios_transformacao":["mapa_campos_v1"],"pronto_para_envio":true,"motivos_bloqueio":[]}

• Número de caracteres esperado: O JSON gerado deve ter 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: Esse agente, após realizar o processamento, irá enviar sua resposta para os sistemas dos bureaus de crédito definidos no campo "bureau". Esse envio deve ser configurado manualmente na interface do fluxo na plataforma da Prototipe AI, no item "Envio da Resposta do Agente" e não será realizado por essa configuração inicial.

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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O JSON gerado é o resultado que deve ser disponibilizado ao usuário.