Agente de IA para Atualização de Dados de Alunos

24 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que verifica e atualiza periodicamente os dados cadastrais dos alunos.

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 "Atualização de Dados de Alunos", uma solução de automação projetada para garantir a consistência e integridade das informações dos alunos no sistema escolar. 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 é verificar e atualizar periodicamente os dados cadastrais dos alunos, garantindo que as informações estejam sempre corretas e atualizadas.

2. Contexto e Problema

Cenário Atual

As instituições de ensino enfrentam desafios significativos com a manutenção de dados cadastrais precisos e atualizados. Os dados dos alunos muitas vezes ficam desatualizados ou incorretos, o que pode levar a problemas administrativos e de comunicação. Atualmente, não há procedimentos automatizados eficientes para a atualização dessas informações.


Problemas Identificados

  • Dados desatualizados: Informações dos alunos frequentemente não são atualizadas, resultando em registros incorretos.
  • Falta de automação: O processo de atualização de dados é manual e sujeito a erros humanos.
  • Risco de privacidade: Sem automação, a manipulação de dados aumenta o risco de violação de privacidade e segurança das informações dos alunos.

3. Impactos Esperados

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

  • Aprimorar a precisão dos dados cadastrais dos alunos em tempo real.
  • Reduzir o tempo e esforço necessários para a atualização de dados.
  • Garantir a segurança e privacidade das informações dos alunos através de processos automatizados e auditáveis.

4. Visão Geral da Solução

O agente de IA para atualização de dados de alunos verifica periodicamente a consistência dos dados cadastrais, solicita atualizações aos responsáveis quando necessário e automatiza o processo de atualização no sistema escolar. 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 manutenção dos dados cadastrais dos alunos.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a verificação da consistência dos dados e termina com a atualização automática no sistema escolar.

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

Agentes Função Principal
Agente de Verificação de Consistência de Dados (RF 1) Verificar regularmente a consistência dos dados cadastrais dos alunos no sistema escolar.
Agente de Solicitação de Atualização de Dados (RF 2) Solicitar atualizações de dados aos responsáveis quando inconsistências são encontradas.
Agente de Atualização Automática de Dados (RF 3) Automatizar o processo de atualização de dados no sistema escolar.

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 a instituição de ensino receberá. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente de Verificação de Consistência de Dados

1.1 Tarefa do Agente

Verificar regularmente a consistência dos dados cadastrais dos alunos no sistema escolar.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados cadastrais dos alunos em formato JSON. Este conjunto de dados representa as informações registradas no sistema escolar.

# 2. Objetivo
Verificar a consistência desses dados, identificando campos ausentes, formatações incorretas e alterações não autorizadas.

# 3. Regras que você deve seguir para gerar sua resposta
- Verifique se todos os campos obrigatórios estão preenchidos. Se algum campo obrigatório estiver vazio, marque como campo_obrigatorio_ausente.
- Valide se os formatos de dados, como datas e números de telefone, estão corretos. Marque formatação_incorreta se algum dado não seguir o padrão esperado.
- Compare dados com registros anteriores para identificar alterações não autorizadas ou inconsistências. Registre qualquer alteração suspeita como alteração_nao_autorizada.

# 4. Exemplo de Output que você deve produzir
{
  "inconsistencias": [
    {
      "campo": "data_nascimento",
      "tipo": "formatação_incorreta",
      "descricao": "Data de nascimento não segue o formato DD/MM/AAAA."
    },
    {
      "campo": "telefone",
      "tipo": "campo_obrigatorio_ausente",
      "descricao": "Número de telefone não fornecido."
    }
  ]
} 
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 dos alunos 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: Dados cadastrais dos alunos 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.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo JSON contendo uma lista de inconsistências encontradas nos dados cadastrais.
  • Exemplo de Estrutura de Output:
     {
      "inconsistencias": [
        {
          "campo": "data_nascimento",
          "tipo": "formatação_incorreta",
          "descricao": "Data de nascimento não segue o formato DD/MM/AAAA."
        }
      ]
    } 
  • Número de caracteres esperado: O JSON de saída terá um tamanho aproximado de 1.000 caracteres, dependendo do número e tipo de inconsistências encontradas.

1.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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

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

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

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

2.1 Tarefa do Agente

Solicitar atualizações de dados aos responsáveis quando inconsistências são encontradas.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de inconsistências nos dados cadastrais dos alunos. Esta lista foi gerada por um agente anterior e detalha os problemas identificados nos registros.

# 2. Objetivo
Notificar os responsáveis pelos alunos sobre as inconsistências encontradas, solicitando a atualização dos dados e fornecendo orientações claras para correção.

# 3. Regras que você deve seguir para gerar sua resposta
- Notifique os responsáveis sobre cada inconsistência encontrada, especificando o campo e o problema.
- Inclua um link ou instruções claras para atualização dos dados no sistema escolar, garantindo que o processo seja fácil de seguir.
- Assegure que as notificações respeitem as normas de privacidade e segurança de dados, utilizando canais seguros para comunicação.

# 4. Exemplo de Output que você deve produzir
{
  "notificacoes": [
    {
      "responsavel": "João Silva",
      "mensagem": "Por favor, atualize a data de nascimento do aluno. O formato correto é DD/MM/AAAA."
    }
  ]
} 
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 uma lista de inconsistências em formato JSON, gerada 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é 5.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo JSON contendo as notificações enviadas aos responsáveis, detalhando as inconsistências e as instruções para correção.
  • Exemplo de Estrutura de Output:
     {
      "notificacoes": [
        {
          "responsavel": "João Silva",
          "mensagem": "Por favor, atualize a data de nascimento do aluno. O formato correto é DD/MM/AAAA."
        }
      ]
    } 
  • Número de caracteres esperado: O JSON de saída terá um tamanho aproximado de 1.500 caracteres, variando conforme o número de notificações geradas.

2.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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

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 Atualização Automática de Dados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Atualização Automática de Dados (RF 3).

RF 3. Agente de Atualização Automática de Dados

3.1 Tarefa do Agente

Automatizar o processo de atualização de dados no sistema escolar.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados atualizados fornecidos pelos responsáveis dos alunos. Estes dados corrigem as inconsistências previamente identificadas.

# 2. Objetivo
Atualizar automaticamente os dados no sistema escolar, garantindo que as alterações sejam registradas corretamente e com segurança.

# 3. Regras que você deve seguir para gerar sua resposta
- Valide os dados atualizados antes de confirmar a atualização no sistema. Se houver dados inválidos, rejeite a atualização e notifique o responsável.
- Assegure que os dados atualizados substituam corretamente os dados antigos, mantendo a integridade das informações. Se houver falha, registre como erro_de_substituicao.
- Registre log de todas as alterações para auditoria e segurança, incluindo data, hora e responsável pela atualização.

# 4. Exemplo de Output que você deve produzir
{
  "atualizacoes": [
    {
      "campo": "data_nascimento",
      "status": "atualizado_com_sucesso",
      "descricao": "Data de nascimento atualizada para 15/05/2010."
    }
  ]
} 
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 como input dados atualizados em formato JSON, fornecidos pelos responsáveis.
  • 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 arquivo JSON confirmando a atualização bem-sucedida dos dados ou registrando falhas e erros de substituição.
  • Exemplo de Estrutura de Output:
     {
      "atualizacoes": [
        {
          "campo": "data_nascimento",
          "status": "atualizado_com_sucesso",
          "descricao": "Data de nascimento atualizada para 15/05/2010."
        }
      ]
    } 
  • Número de caracteres esperado: O JSON de saída terá um tamanho aproximado de 1.000 caracteres, variando conforme o número de atualizações processadas.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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 é 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 confirmação de atualização ou registro de falhas é o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.