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 "Notificador Escolar", uma solução projetada para automatizar a comunicação sobre eventos escolares, garantindo que as famílias estejam sempre informadas sobre datas e detalhes importantes. 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 é transformar a gestão de comunicação escolar, assegurando que todas as famílias recebam informações atualizadas e precisas sobre eventos escolares através de notificações automatizadas e um calendário sempre atualizado.
2. Contexto e Problema
Cenário Atual
Atualmente, muitas escolas enfrentam desafios na comunicação eficaz com as famílias sobre eventos escolares. Problemas comuns incluem:
- Comunicação ineficiente sobre eventos escolares importantes.
- Falta de um sistema automatizado para notificar as famílias sobre datas e detalhes de eventos.
- Necessidade de garantir que todas as famílias recebam informações atualizadas e precisas.
Esses desafios resultam em baixa participação das famílias nos eventos escolares, o que pode impactar negativamente o envolvimento dos alunos e a comunidade escolar como um todo.
Problemas Identificados
- Falta de automação: A comunicação sobre eventos é muitas vezes manual, levando a atrasos e erros.
- Informações inconsistentes: As famílias podem receber informações conflitantes ou desatualizadas.
- Baixa visibilidade: Sem um calendário centralizado, as famílias têm dificuldade em acompanhar as datas importantes.
3. Impactos Esperados
A implementação deste agente visa alcançar os seguintes resultados:
- Aumentar a participação das famílias nos eventos escolares em pelo menos 50%.
- Reduzir erros de comunicação sobre eventos escolares importantes.
- Facilitar o planejamento das famílias através de notificações em tempo hábil e um calendário atualizado.
4. Visão Geral da Solução
O agente de IA para notificações de eventos escolares automatiza a comunicação, enviando notificações estruturadas e mantendo um calendário atualizado, garantindo que todas as famílias estejam informadas sobre eventos importantes. 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 comunicação escolar, assegurando que as famílias recebam informações precisas e em tempo hábil.
A solução consiste em um fluxo de automação onde o agente recebe detalhes de eventos escolares e gera notificações estruturadas para envio às famílias.
A execução do agente é contínua e cíclica, atualizando automaticamente o calendário e enviando lembretes conforme necessário.
| Agente | Função Principal |
|---|---|
Agente de Notificação de Eventos Escolares | Automatizar a comunicação sobre eventos escolares, garantindo que as famílias recebam notificações em tempo hábil. |
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 as famílias receberão. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Notificação de Eventos Escolares
1.1 Tarefa do Agente
Automatizar a comunicação sobre eventos escolares, garantindo que as famílias recebam notificações em tempo hábil.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo detalhes de eventos escolares, incluindo data, horário e descrição. Este é o input necessário para gerar notificações estruturadas para as famílias. # 2. Objetivo Gerar notificações claras e concisas para envio às famílias, destacando as informações principais: data, hora, local e qualquer material necessário. # 3. Regras que você deve seguir para gerar sua resposta - Enviar notificações sobre eventos escolares com pelo menos 7 dias de antecedência para garantir tempo hábil de planejamento para as famílias. - Estruturar as notificações de maneira clara, destacando as informações principais. - Atualizar automaticamente o calendário de eventos escolares sempre que houver uma nova entrada, cancelamento ou alteração de evento. - Confirmar o recebimento das notificações pelas famílias e registrar qualquer feedback ou necessidade de esclarecimento adicional. - Enviar lembretes adicionais 24 horas antes do evento para reforçar o compromisso e aumentar a participação.
1.3 Configurações do Agente
1.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado pelo envio de detalhes do evento escolar 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 é um conjunto de dados estruturados contendo detalhes do evento escolar.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados em 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 uma notificação estruturada para envio às famílias, incluindo todas as informações relevantes do evento.
-
Exemplo de Estrutura de Output:
{ "notification": { "title": "Reunião de Pais e Mestres", "date": "25 de Novembro de 2025", "time": "19:00", "location": "Auditório Principal", "details": "Discutiremos o desempenho escolar e planos para o próximo semestre." } } - Número de caracteres esperado: A notificação gerada deve ser clara e concisa, com um tamanho estimado em torno de 500 caracteres.
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
- 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 sistema de envio de notificações e para a atualização do calendário.
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente deve acionar o sistema de envio de notificações para distribuir as mensagens às famílias.