Agente de IA para Planejamento de Calendário Escolar

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

Como criar um agente de IA que auxilia na organização e planejamento do calendário escolar.

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 "Planejamento de Calendário Escolar", uma solução projetada para auxiliar na organização e planejamento do calendário escolar, considerando feriados, eventos e períodos de avaliação. 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 integração de datas importantes no calendário escolar, sugerir a melhor distribuição de períodos de avaliação e fornecer ferramentas de visualização e edição para facilitar a gestão do calendário.

2. Contexto e Problema

Cenário Atual

A organização do calendário escolar é uma tarefa complexa que envolve a consideração de diversos fatores, como feriados, eventos escolares e períodos de avaliação. Atualmente, muitas escolas enfrentam dificuldades em gerenciar essas datas de forma eficiente, o que pode levar a conflitos de agendamento e sobrecarga de trabalho para alunos e professores.

A falta de ferramentas eficientes para auxiliar na gestão do calendário escolar resulta em um processo manual e propenso a erros, dificultando a criação de um cronograma escolar equilibrado e bem planejado.


Problemas Identificados

  • Complexidade na organização: A necessidade de considerar múltiplas variáveis torna o planejamento do calendário escolar uma tarefa desafiadora.
  • Falta de integração: A ausência de uma ferramenta que integre automaticamente feriados e eventos ao calendário escolar aumenta o risco de conflitos.
  • Gestão ineficiente: Sem ferramentas adequadas, a gestão do calendário escolar consome tempo e é suscetível a erros.

3. Impactos Esperados

A implementação do agente de IA para planejamento de calendário escolar visa alcançar os seguintes resultados:

  • Automatizar a integração de datas importantes, reduzindo o risco de conflitos de agendamento.
  • Otimizar a distribuição de avaliações ao longo do ano letivo para equilibrar a carga de trabalho de alunos e professores.
  • Fornecer ferramentas de visualização e edição que facilitem a gestão do calendário escolar.

4. Visão Geral da Solução

O agente de IA para planejamento de calendário escolar analisa datas importantes, como feriados e eventos, e sugere a melhor distribuição de períodos de avaliação ao longo do ano letivo. Além disso, fornece ferramentas de visualização e edição para facilitar a gestão do calendário 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 no planejamento do calendário escolar.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a análise de datas importantes e termina com a disponibilização de ferramentas de visualização e edição do calendário escolar.

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

Agentes Função Principal
Agente de Análise de Datas Importantes (RF 1) Analisar feriados e eventos para integrá-los no calendário escolar.
Agente de Sugerir Distribuição de Avaliações (RF 2) Sugerir a melhor distribuição de períodos de avaliação ao longo do ano letivo.
Agente de Ferramentas de Visualização e Edição (RF 3) Fornecer ferramentas de visualização e edição para facilitar a gestã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 tanto o fluxo de trabalho dos agentes quanto o resultado final que o usuário receberá. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente de Análise de Datas Importantes

1.1 Tarefa do Agente

Analisar feriados e eventos para integrá-los no calendário escolar.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma lista de datas relevantes, incluindo feriados e eventos escolares, fornecida em formato JSON.

# 2. Objetivo
Analisar essas datas para integrá-las ao calendário escolar, sugerindo ajustes conforme necessário.

# 3. Regras que você deve seguir para gerar sua resposta
- Classifique cada data recebida como feriado nacional, regional ou evento escolar e registre essa classificação.
- Para eventos escolares, identifique a duração típica e a importância do evento e sugira datas que maximizem a participação e minimizem conflitos.
- Detecte conflitos entre feriados e eventos e proponha ajustes para evitar sobreposições, priorizando a maximização da participação e a utilização eficiente do calendário.

# 4. Exemplo de Output que você deve produzir
{
  "integrated_dates": [
    {
      "date": "2025-09-07",
      "type": "feriado nacional",
      "suggestion": ""
    },
    {
      "date": "2025-10-12",
      "type": "evento escolar",
      "suggestion": "Sugerir adiamento para maximizar participaçã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 um arquivo JSON com as datas relevantes 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 do 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 uma lista de datas relevantes.
  • Formatos Suportados: Esse agente deve ser capaz de receber arquivos 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 as datas integradas ao calendário escolar e sugestões de ajustes, quando necessário.
  • Exemplo de Estrutura de Output:
     {
      "integrated_dates": [
        {
          "date": "2025-09-07",
          "type": "feriado nacional",
          "suggestion": ""
        },
        {
          "date": "2025-10-12",
          "type": "evento escolar",
          "suggestion": "Sugerir adiamento para maximizar participação"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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

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

Ao concluir sua execução, esse agente aciona o Agente de Sugerir Distribuição de Avaliações (RF 2).

RF 2. Agente de Sugerir Distribuição de Avaliações

2.1 Tarefa do Agente

Sugerir a melhor distribuição de períodos de avaliação ao longo do ano letivo.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o calendário escolar com datas de início e término do ano letivo e períodos de feriados e eventos.

# 2. Objetivo
Sugerir períodos de avaliação ao longo do ano letivo, equilibrando carga de trabalho e eventos.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise o calendário escolar para distribuir avaliações de forma a evitar sobrecargas, garantindo intervalos adequados entre avaliações.
- Evite agendar avaliações próximas a feriados prolongados e eventos significativos para otimizar o desempenho dos alunos.
- Leve em consideração a carga de trabalho de alunos e professores, garantindo um espaçamento adequado entre as avaliações para um equilíbrio eficaz.

# 4. Exemplo de Output que você deve produzir
{
  "evaluation_periods": [
    {
      "start_date": "2025-04-01",
      "end_date": "2025-04-15",
      "suggestion": ""
    },
    {
      "start_date": "2025-06-10",
      "end_date": "2025-06-20",
      "suggestion": "Evitar proximidade com feriado de 15 de Junho"
    }
  ]
} 
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 um calendário escolar atualizado com feriados, eventos e períodos de avaliação.
  • 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.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo no formato JSON contendo sugestões de períodos de avaliação ao longo do ano letivo.
  • Exemplo de Estrutura de Output:
     {
      "evaluation_periods": [
        {
          "start_date": "2025-04-01",
          "end_date": "2025-04-15",
          "suggestion": ""
        },
        {
          "start_date": "2025-06-10",
          "end_date": "2025-06-20",
          "suggestion": "Evitar proximidade com feriado de 15 de Junho"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.000 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

2.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

2.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Ferramentas de Visualização e Edição (RF 3).

RF 3. Agente de Ferramentas de Visualização e Edição

3.1 Tarefa do Agente

Fornecer ferramentas de visualização e edição para facilitar a gestão do calendário escolar.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o calendário escolar atualizado com feriados, eventos e períodos de avaliação.

# 2. Objetivo
Fornecer uma interface gráfica interativa que permita a visualização e edição do calendário escolar.

# 3. Regras que você deve seguir para gerar sua resposta
- Crie visualizações claras e intuitivas que realcem feriados, eventos e períodos de avaliação, permitindo fácil interpretação.
- Desenvolva ferramentas de edição que permitam ajustes manuais, assegurando que as modificações não causem conflitos de datas.
- Ofereça opções de exportação do calendário em formatos amplamente utilizados, como PDF e CSV, para facilitar o compartilhamento e a impressão, garantindo acessibilidade e usabilidade.

# 4. Exemplo de Output que você deve produzir
{
  "interface": "URL da interface gráfica de visualização e edição",
  "export_options": ["PDF", "CSV"]
} 
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 um calendário escolar atualizado com feriados, eventos e períodos de avaliação.
  • 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.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo a URL da interface gráfica de visualização e edição e as opções de exportação disponíveis.
  • Exemplo de Estrutura de Output:
     {
      "interface": "URL da interface gráfica de visualização e edição",
      "export_options": ["PDF", "CSV"]
    } 
  • Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 500 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

3.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

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 (JSON com URL e opções de exportação) é 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 URL gerada é o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.