PrototipeAI | Agente de IA para Monitoramento de Frequência em Aulas Práticas

1. Propósito e Escopo

Este documento define todos os prompts e detalhes de requisitos para um Fluxo de Agentes de IA para Monitoramento de Frequência em Aulas Práticas. 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 é registrar automaticamente a frequência dos alunos em aulas práticas e gerar relatórios precisos para a coordenação pedagógica, garantindo monitoramento eficaz.

2. Contexto e Problema

O monitoramento da frequência dos alunos em aulas práticas é uma tarefa desafiadora devido à falta de sistemas automatizados que possam capturar e relatar a presença de forma precisa e em tempo real.

Atualmente, a frequência dos alunos é registrada manualmente, o que pode levar a inconsistências, atrasos e erros nos relatórios. Além disso, a falta de dados em tempo real impede que a coordenação pedagógica intervenha rapidamente quando necessário.

3. Impactos Esperados

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

Automatização do registro de frequência: Reduzir o tempo e o esforço manual na coleta de dados de frequência.
Precisão nos relatórios: Garantir que os dados de presença sejam precisos e atualizados.
Intervenção proativa: Permitir que a coordenação pedagógica identifique rapidamente alunos com baixa frequência e tome medidas corretivas.

4. Visão Geral da Solução

O agente de IA para monitoramento de frequência em aulas práticas registra automaticamente a presença dos alunos e gera relatórios detalhados para a coordenação. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue de forma eficaz.

A solução consiste em um fluxo de automação composto por dois agentes de IA. O processo inicia com o registro automático de frequência e culmina na geração de relatórios semanais.

Agentes	Função Principal
`Agente de Registro de Frequência` (RF 1)	Registrar automaticamente a frequência dos alunos em aulas práticas.
`Agente de Geração de Relatórios de Frequência` (RF 2)	Gerar relatórios precisos para a coordenação pedagógica sobre a frequência dos alunos.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram o fluxo de trabalho dos agentes. 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 Registro de Frequência

1.1 Tarefa do Agente

Registrar automaticamente a frequência dos alunos em aulas práticas, garantindo que os dados sejam precisos e atualizados em tempo real.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de presença dos alunos em formato digital de dispositivos de controle de acesso.

# 2. Objetivo
Registrar a presença dos alunos automaticamente e garantir que permaneçam por pelo menos 75% do tempo total da aula para confirmar a presença.

# 3. Regras que você deve seguir para gerar sua resposta
- Registre presença ao detectar entrada do aluno na sala e confirme apenas se ele permanecer por 75% do tempo.
- Atualize o registro de frequência em tempo real para acesso imediato pela coordenação pedagógica.

# 4. Exemplo de Output que você deve produzir
{"aluno_id": "12345", "data": "2025-11-15", "presenca": true}

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 presença 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 digital na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: Dados de presença dos alunos em formato digital.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
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 que registra a presença dos alunos.

Exemplo de Estrutura de Output:

{"aluno_id": "12345", "data": "2025-11-15", "presenca": true}

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

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 Geração de Relatórios de Frequência (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios de Frequência (RF 2).

RF 2. Agente de Geração de Relatórios de Frequência

2.1 Tarefa do Agente

Gerar relatórios precisos para a coordenação pedagógica sobre a frequência dos alunos, compilando dados semanalmente.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de frequência registrados pelo agente anterior.

# 2. Objetivo
Compilar dados de frequência semanalmente para gerar relatórios abrangentes que incluam estatísticas de presença por aluno e por aula.

# 3. Regras que você deve seguir para gerar sua resposta
- Compilar dados semanalmente para gerar relatórios abrangentes.
- Incluir estatísticas de presença individual e geral, destacando alunos com frequências abaixo de 75%.
- Enviar relatórios automaticamente para a coordenação pedagógica toda sexta-feira.

# 4. Exemplo de Output que você deve produzir
Relatório em formato markdown com estatísticas de presença por aluno e por aula

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: Dados de frequência registrados em formato digital.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório em formato markdown.