PrototipeAI | Agente de IA para Inclusão de Registros em Bureaus de Crédito

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Fluxo de Agentes "Inclusão de Registros em Bureaus de Crédito", uma solução de automação projetada para garantir a acurácia e completude dos dados submetidos aos bureaus de crédito. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é automatizar o processo de validação e envio de registros de crédito, assegurando que os dados estejam corretos e completos antes de serem submetidos, e manter um log detalhado para auditoria e conformidade.

2. Contexto e Problema

Cenário Atual

As instituições financeiras enfrentam desafios significativos ao incluir registros de crédito nos bureaus devido a erros e omissões nos dados submetidos, além do tempo elevado necessário para o processamento manual desses registros. Esses problemas podem resultar em informações imprecisas e atrasos, impactando o desempenho financeiro e a conformidade regulatória das instituições.

Problemas Identificados

Erros e omissões: A inclusão manual de registros de crédito está sujeita a erros humanos, como dados incorretos ou incompletos, que podem afetar negativamente as avaliações de crédito.
Tempo elevado de processamento: O processo manual de verificação e inclusão é demorado, retardando a atualização dos registros de crédito nos bureaus.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

Reduzir o tempo de processamento de registros de crédito em pelo menos 70%.
Garantir a acurácia e completude dos dados submetidos aos bureaus de crédito.
Facilitar a auditoria e conformidade com a manutenção de logs detalhados de todos os registros submetidos.

4. Visão Geral da Solução

O agente de IA para inclusão de registros em bureaus de crédito valida a completude e correção dos dados antes da inclusão, automatiza o processo de envio e mantém um log de todos os registros submetidos para auditoria e conformidade. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na inclusão de registros de crédito que seguem as especificidades da sua empresa.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a validação dos dados de crédito e termina com a manutenção de um log detalhado para auditoria.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes	Função Principal
`Agente de Validação de Dados de Crédito` (RF 1)	Validar a completude e correção dos dados de registros de crédito antes da inclusão.
`Agente de Automação de Envio para Bureaus de Crédito` (RF 2)	Automatizar o processo de envio de registros validados para os bureaus de crédito.
`Agente de Manutenção de Log de Envio` (RF 3)	Manter um log de todos os registros submetidos aos bureaus para auditoria e conformidade.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Validação de Dados de Crédito

1.1 Tarefa do Agente

Validar a completude e correção dos dados de registros de crédito antes da inclusão.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de registros de crédito em formato JSON. Este conjunto de dados contém informações essenciais para a inclusão de registros em bureaus de crédito.

# 2. Objetivo
Validar a completude e correção dos dados, identificando e relatando quaisquer erros ou omissões para garantir que apenas registros precisos sejam submetidos.

# 3. Regras que você deve seguir para gerar sua resposta
- Regra 1: Certifique-se de que todos os campos obrigatórios estão preenchidos corretamente, incluindo nome, CPF/CNPJ, endereço, valor do crédito e data da transação. Se algum campo estiver ausente ou incorreto, registre o erro.
- Regra 2: Valide o formato dos dados, assegurando que campos como CPF/CNPJ, valores monetários e datas estejam no padrão esperado. Utilize expressões regulares para garantir a precisão dos formatos.
- Regra 3: Antes da inclusão, consulte uma base de dados interna para garantir que não haja duplicidade de registros. Registre qualquer duplicidade encontrada e impeça a inclusão do registro duplicado.
- Regra 4: Liste todos os erros identificados nos dados, fornecendo detalhes específicos sobre o tipo e a localização de cada erro para facilitar a correção.

1.3 Configurações do Agente

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 registros de crédito em formato 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 na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo são dados de registros de crédito em formato JSON.
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 a validação dos dados, incluindo um indicador de validade e uma lista de erros identificados.
Exemplo de Estrutura de Output:
```
 { "valido": true, "erros": [] }
```
Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 500 caracteres.

1.3.3 Parâmetros de Geração

Modelo: GPT-5
Temperatura: 0.3

1.3.4 Ferramentas do Agente

Documentos: Não consulta documentos externos.
Calculadora: Não utiliza.
Busca Online: Não utiliza.
Sistemas Externos: Consulta uma base de dados interna para verificação de duplicidade de registros.

1.3.5 Memória

Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Automação de Envio para Bureaus 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 Automação de Envio para Bureaus de Crédito (RF 2) se a validação for bem-sucedida.

RF 2. Agente de Automação de Envio para Bureaus de Crédito

2.1 Tarefa do Agente

Automatizar o processo de envio de registros validados para os bureaus de crédito.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo registros de crédito validados em formato JSON. Estes registros foram verificados quanto à sua completude e correção pelo agente anterior.

# 2. Objetivo
Automatizar o envio desses registros para os bureaus de crédito, garantindo a integridade e confidencialidade das informações durante a transmissão.

# 3. Regras que você deve seguir para gerar sua resposta
- Regra 1: Envie registros apenas após validação completa e correta dos dados, assegurando a precisão das informações transmitidas.
- Regra 2: Utilize uma API segura e autenticada para o envio dos dados aos bureaus de crédito, garantindo a integridade e confidencialidade das informações durante a transmissão.
- Regra 3: Receba e registre a confirmação de recebimento dos bureaus de crédito, incluindo data, hora e status do envio, para garantir a rastreabilidade do processo.
- Regra 4: Implemente um mecanismo de reenvio automático em caso de falha na transmissão inicial, limitando o número de tentativas e notificando o suporte técnico se necessário.

2.3 Configurações do Agente

2.3.1 Especificação do Input

Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
Tipo do input: Este agente deve ser apto a receber registros de crédito validados em formato JSON.
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 uma confirmação de envio bem-sucedido para os bureaus de crédito.

Exemplo de Estrutura de Output:

 { "status": "enviado", "data_hora": "2025-11-11T06:07:00", "detalhes": "Enviado com sucesso para Bureau XYZ." }

Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 300 caracteres.

2.3.3 Parâmetros de Geração

Modelo: GPT-5
Temperatura: 0.3

2.3.4 Ferramentas do Agente

Documentos: Não consulta documentos externos.
Calculadora: Não utiliza.
Busca Online: Não utiliza.
Sistemas Externos: Utiliza uma API segura e autenticada para envio de dados aos bureaus 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.
Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Manutenção de Log de Envio (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Manutenção de Log de Envio (RF 3).

RF 3. Agente de Manutenção de Log de Envio

3.1 Tarefa do Agente

Manter um log de todos os registros submetidos aos bureaus para auditoria e conformidade.

3.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo a confirmação de envio bem-sucedido e os registros submetidos aos bureaus de crédito.

# 2. Objetivo
Manter um log detalhado de todos os registros submetidos, garantindo a rastreabilidade e conformidade com requisitos de auditoria.

# 3. Regras que você deve seguir para gerar sua resposta
- Regra 1: Registre no log a data, hora, ID do registro, status de envio e detalhes do bureau de crédito destinatário para cada transação, garantindo a transparência e rastreabilidade do processo.
- Regra 2: Assegure que o log seja armazenado em um sistema seguro e esteja acessível para auditorias futuras, com controle de acesso adequado para proteger a integridade dos dados.
- Regra 3: Implemente uma rotina de backup regular para o log, garantindo a recuperação em caso de falhas no sistema ou perda de dados.
- Regra 4: Forneça relatórios periódicos sobre o status dos envios e quaisquer anomalias detectadas, facilitando a gestão de conformidade regulatória e permitindo ações corretivas prontas.

3.3 Configurações do Agente

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 a confirmação de envio e os registros submetidos.
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.

3.3.2 Especificação do Output

Formato de output: O output deve ser um log atualizado com detalhes dos registros enviados.