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
- 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 Sugerir Distribuição de Avaliações (RF 2).
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
- 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 Ferramentas de Visualização e Edição (RF 3).
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.