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 Gestão de Calendário 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 é automatizar a atualização e manutenção do calendário escolar, incluindo eventos, feriados e atividades extracurriculares, e notificar todas as partes interessadas sobre mudanças e atualizações no calendário.
2. Contexto e Problema
No cenário atual, as instituições de ensino enfrentam dificuldades em manter o calendário escolar atualizado e acessível para todos os stakeholders. Isso resulta em desorganização, falta de comunicação eficaz e, muitas vezes, em conflitos de agendamento que afetam alunos, professores e pais.
Os principais problemas identificados são:
- Dificuldade em manter o calendário escolar atualizado e acessível para todos os stakeholders.
- Falta de notificações automáticas para mudanças e atualizações no calendário.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Automatização e eficiência: Manter o calendário escolar atualizado automaticamente, reduzindo o esforço manual.
- Comunicação eficaz: Notificar todas as partes interessadas sobre mudanças e atualizações no calendário de forma clara e rápida.
- Acessibilidade: Tornar o calendário escolar facilmente acessível a todos os stakeholders, melhorando a organização e o planejamento.
4. Visão Geral da Solução
O agente de IA para gestão de calendário escolar organiza e mantém atualizado o calendário escolar, incluindo eventos, feriados e atividades extracurriculares. 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 gestão do calendário escolar.
| Agentes | Função Principal |
|---|---|
Agente de Atualização do Calendário Escolar (RF 1)
| Automatizar a atualização e manutenção do calendário escolar. |
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 do agente e o resultado final que os stakeholders receberão. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Atualização do Calendário Escolar
1.1 Tarefa do Agente
Automatizar a atualização e manutenção do calendário escolar, garantindo que eventos, feriados e atividades extracurriculares sejam incluídos de forma clara e acessível.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo requisições para atualizar o calendário escolar com novos eventos, feriados ou atividades. # 2. Objetivo Automatizar a atualização e manutenção do calendário escolar, garantindo que eventos, feriados e atividades extracurriculares sejam incluídos de forma clara e acessível. # 3. Regras que você deve seguir para gerar sua resposta - Identificar e categorizar corretamente cada novo evento, feriado ou atividade extracurricular, garantindo que cada entrada no calendário seja precisa e compreensível. - Verificar a ausência de conflitos de datas e horários entre novos e eventos já existentes antes de atualizar o calendário. Se houver conflitos, notifique o responsável pelo calendário para resolução manual. - Atualizar o calendário em tempo real para que todos os stakeholders tenham acesso imediato às informações mais recentes. - Enviar notificações automáticas e personalizadas a todos os stakeholders impactados, destacando as mudanças realizadas no calendário. Inclua detalhes como data, hora e descrição do evento nas notificações.
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 requisições de atualização do calendário escolar via API. Na fase de testes, as atualizações serão enviadas manualmente através da interface da Prototipe AI para acelerar o processo de validação.
- Tipo do input: Requisições de atualização do calendário com novos eventos, feriados ou atividades.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um calendário atualizado refletindo os novos eventos, feriados e atividades incluídas.
-
Exemplo de Estrutura de Output:
{ "calendario_atualizado": [ { "data": "2025-11-15", "evento": "Reunião de Pais e Mestres" }, { "data": "2025-12-25", "evento": "Natal - Feriado" } ] } - Número de caracteres esperado: O output deve ser conciso, com um tamanho estimado em torno de 3.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: 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 os stakeholders para confirmação das atualizações.
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente envia notificações automáticas para todos os stakeholders sobre as atualizações realizadas no calendário.