PrototipeAI | Agente de IA para Atualização de Dados Cadastrais de Empresas

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Agente de IA para Atualização de Dados Cadastrais de Empresas. Esta solução visa automatizar a coleta, verificação e atualização de dados cadastrais de empresas em sistemas de bureaus de crédito, garantindo a precisão e atualidade das informações. Esta documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é transformar a atualização manual e propensa a erros em um processo automatizado, eficiente e integrado, reduzindo o risco de decisões de crédito incorretas devido a dados desatualizados ou imprecisos.

2. Contexto e Problema

Cenário Atual

As empresas frequentemente enfrentam problemas devido a dados cadastrais desatualizados. Este cenário pode levar a decisões de crédito incorretas, afetando tanto as empresas quanto os bureaus de crédito. Atualmente, a atualização de dados cadastrais é um processo manual, demorado e propenso a erros, com pouca integração entre diferentes sistemas de bureaus de crédito.

Problemas Identificados

Dados desatualizados: Levam a decisões de crédito incorretas, afetando a confiabilidade das análises de crédito.
Processo manual ineficiente: A atualização de dados é demorada e sujeita a erros humanos.
Falta de integração: Sistemas de bureaus de crédito não estão integrados, resultando em inconsistências nos dados.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

Automatizar o processo de atualização de dados, reduzindo o tempo e esforço manual necessário.
Melhorar a precisão dos dados cadastrais, garantindo informações atualizadas e confiáveis.
Integrar sistemas de bureaus de crédito, permitindo um fluxo de dados consistente e unificado.
Reduzir o risco de decisões de crédito incorretas devido a informações desatualizadas.

4. Visão Geral da Solução

O agente de IA para atualização de dados cadastrais de empresas verifica automaticamente a precisão dos dados em tempo real, atualiza quando novas informações estão disponíveis e garante a integração entre diferentes plataformas de bureaus de crédito. 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 atualização de dados cadastrais de empresas.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo se inicia com a verificação dos dados cadastrais e termina com a atualização dos dados em sistemas de bureaus de crédito.

Agentes	Função Principal
`Agente de Verificação de Dados Cadastrais` (RF 1)	Verificar automaticamente a precisão dos dados cadastrais de empresas em tempo real.
`Agente de Atualização de Dados Cadastrais` (RF 2)	Atualizar automaticamente os dados cadastrais de empresas em sistemas de bureaus de crédito.

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 Verificação de Dados Cadastrais

1.1 Tarefa do Agente

Verificar automaticamente a precisão dos dados cadastrais de empresas em tempo real.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados cadastrais de empresas como nome, endereço e CNPJ em formato JSON.

# 2. Objetivo
Verificar a precisão dos dados cadastrais e identificar possíveis correções necessárias.

# 3. Regras que você deve seguir para gerar sua resposta
- Valide o CNPJ utilizando algoritmos de verificação para assegurar que está correto e ativo.
- Confirme que o endereço da empresa corresponde ao registrado em fontes confiáveis, como Receita Federal.
- Analise a consistência dos dados entre diferentes fontes para identificar discrepâncias.
- Utilize padrões de formatação para garantir uniformidade nos dados (ex.: CEP, formatação de CNPJ).
- Registre no output se os dados são precisos e se correções são necessárias.

# 4. Exemplo de Output que você deve produzir
{
  "cnpj": "00.000.000/0001-91",
  "nome": "Empresa Exemplo Ltda",
  "endereco": "Rua Exemplo, 123",
  "status": "Preciso",
  "correcoes": {}
}

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 cadastrais 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 de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo dados cadastrais de empresas.
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.

1.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON contendo os dados verificados, com status de precisão e possíveis correções necessárias.

Exemplo de Estrutura de Output:

 {
  "cnpj": "00.000.000/0001-91",
  "nome": "Empresa Exemplo Ltda",
  "endereco": "Rua Exemplo, 123",
  "status": "Preciso",
  "correcoes": {}
}

Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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: 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 Atualização de Dados Cadastrais (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Atualização de Dados Cadastrais (RF 2).

RF 2. Agente de Atualização de Dados Cadastrais

2.1 Tarefa do Agente

Atualizar automaticamente os dados cadastrais de empresas em sistemas de bureaus de crédito.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados verificados e corrigidos de empresas em formato JSON.

# 2. Objetivo
Atualizar os dados cadastrais nos sistemas de bureaus de crédito integrados.

# 3. Regras que você deve seguir para gerar sua resposta
- Verifique se o status de precisão dos dados é 'Preciso' antes de proceder com a atualização.
- Execute a atualização dos dados em todas as plataformas de bureaus de crédito integradas.
- Confirme a compatibilidade dos formatos de dados antes de enviar para cada plataforma.
- Envie confirmações de atualização para logs internos para auditoria.
- Garanta que o tempo de atualização seja registrado para controle de atualidade dos dados.

# 4. Exemplo de Output que você deve produzir
{
  "atualizacao": "Concluida",
  "sistemas_atualizados": ["Bureau 1", "Bureau 2"],
  "data_hora": "2025-11-20T07:54:00Z"
}

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 do agente anterior (RF 1).
Tipo do input: Este agente deve ser apto a receber como input dados verificados e corrigidos de empresas 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 até 1.500 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo JSON contendo a confirmação da atualização dos dados cadastrais nos sistemas de bureaus de crédito.