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 Fluxo de Agentes "Monitoramento de Frequência Escolar", uma solução de automação projetada para monitorar a frequência dos alunos em cursos técnicos e enviar alertas e notificações em caso de ausências frequentes. 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 é garantir o acompanhamento contínuo da frequência dos alunos e notificar automaticamente os responsáveis em caso de ausências prolongadas, além de oferecer relatórios detalhados para análise e intervenção.
2. Contexto e Problema
Cenário Atual
O monitoramento da frequência dos alunos em cursos técnicos é frequentemente ineficaz, resultando em falta de alertas e notificações para ausências frequentes. Isso impacta negativamente o desempenho e o progresso acadêmico dos alunos.
- Monitoramento ineficaz da frequência dos alunos em cursos técnicos.
- Falta de alertas e notificações para ausências frequentes dos alunos.
- Impacto negativo da baixa frequência no desempenho e progresso acadêmico dos alunos.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Melhorar o monitoramento da frequência dos alunos em tempo real.
- Automatizar o envio de alertas e notificações para responsáveis em caso de ausências frequentes.
- Fornecer relatórios detalhados para análise e intervenção por parte dos coordenadores de curso.
- Reduzir o impacto negativo da baixa frequência no desempenho e progresso acadêmico dos alunos.
4. Visão Geral da Solução
O agente de IA para monitoramento de frequência escolar processa dados de presença de alunos, aplica regras para identificar padrões de ausência e envia notificações automáticas para responsáveis. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um monitor eficiente e proativo da frequência escolar.
A solução consiste em um fluxo de automação composto por um agente de IA. O processo inicia com o registro diário da presença dos alunos e termina com o envio de relatórios semanais para os coordenadores de curso.
| Agentes | Função Principal |
|---|---|
Agente de Monitoramento de Frequência Escolar (RF 1)
| Monitorar a frequência dos alunos e enviar alertas automáticos para ausências frequentes. |
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 do agente quanto o resultado final que o coordenador do curso receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Monitoramento de Frequência Escolar
1.1 Tarefa do Agente
Monitorar a frequência dos alunos em cursos técnicos e enviar alertas e notificações para ausências frequentes.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de presença de alunos em formato JSON. Este documento contém campos de identificação do aluno e status de presença. # 2. Objetivo Monitorar continuamente a frequência dos alunos em todas as aulas, enviar alertas automáticos para ausências frequentes e oferecer relatórios para análise. # 3. Regras que você deve seguir para gerar sua resposta - Registre diariamente a presença de cada aluno em todas as aulas registradas. - Identifique alunos com três ou mais ausências consecutivas e gere alerta automático. - Detecte padrão de ausência superior a 20% das aulas em um mês e envie notificação aos responsáveis. - Gere relatórios semanais detalhados de frequência para análise por coordenadores de curso. - Envie notificações de alerta para ausências frequentes via e-mail ou SMS cadastrados no sistema. - Registre no sistema todas as notificações enviadas e as respostas recebidas dos responsáveis. - Atualize o status de presença dos alunos imediatamente após cada aula para garantir precisã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 presença de alunos via API ao final de cada aula. Na fase de testes, os dados serão enviados 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 de presença dos alunos.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados de presença 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 no formato JSON contendo alertas e notificações automáticas, além de relatórios semanais de frequência.
-
Exemplo de Estrutura de Output:
{ "alerts": [ { "student_id": "12345", "alert_type": "Frequência Baixa", "message": "O aluno está com frequência inferior a 80% no último mês." } ], "weekly_reports": [ { "week": "01/11/2025 - 07/11/2025", "report": "Frequência média dos alunos foi de 85%." } ] } - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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: Utiliza lógica interna para calcular padrões de ausência.
- 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 os coordenadores de curso e responsáveis cadastrados.
1.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo, gerando os alertas e relatórios necessários para os coordenadores de curso e responsáveis.