1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e requisitos funcionais para o Agente de IA "Suporte em Planejamento de Turmas", uma solução de automação projetada para auxiliar na alocação de estudantes em turmas, considerando critérios como idade, nível de ensino e necessidades especiais. 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 que a alocação de estudantes seja feita de forma equilibrada e inclusiva, otimizando o processo e assegurando que todas as necessidades dos alunos sejam atendidas.
2. Contexto e Problema
Cenário Atual
A alocação manual de estudantes em turmas muitas vezes não considera todas as variáveis importantes, o que pode resultar em turmas desbalanceadas e em uma falta de atenção a necessidades especiais dos alunos. Isso pode afetar negativamente o aprendizado dos estudantes.
Problemas Identificados
- Alocação manual ineficiente: O processo manual pode não considerar todos os critérios relevantes, levando a uma alocação inadequada.
- Falta de consideração por necessidades especiais: A não consideração de necessidades especiais pode impactar negativamente o aprendizado e a experiência dos estudantes.
- Dificuldade em ajustes de última hora: Mudanças de última hora, como novas matrículas ou mudanças nas necessidades dos estudantes, são difíceis de gerenciar manualmente.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Otimizar a alocação de estudantes em turmas, considerando múltiplos critérios de forma eficiente.
- Garantir a inclusão de estudantes com necessidades especiais em turmas adequadas.
- Facilitar ajustes rápidos nas alocações devido a mudanças de última hora.
4. Visão Geral da Solução
O agente de IA para suporte em planejamento de turmas processa dados dos estudantes e aplica regras de alocação para distribuir os alunos de forma equilibrada e inclusiva nas turmas. 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 de turmas que atendem às especificidades de cada estudante.
A solução consiste em um fluxo de automação composto por um agente de IA que realiza a alocação dos estudantes.
| Agente | Função Principal |
|---|---|
Agente de Alocação de Estudantes (RF 1)
| Auxiliar na alocação de estudantes em turmas, considerando critérios como idade, nível de ensino e necessidades especiais. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos que demonstram o fluxo de trabalho do agente e o resultado final que a instituição de ensino receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Alocação de Estudantes
1.1 Tarefa do Agente
Auxiliar na alocação de estudantes em turmas, considerando critérios como idade, nível de ensino e necessidades especiais.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma lista de estudantes com informações sobre idade, nível de ensino e necessidades especiais. Este é o registro de estudantes que precisam ser alocados em turmas. # 2. Objetivo Auxiliar na alocação de estudantes em turmas, garantindo que múltiplos critérios sejam considerados e atendidos. # 3. Regras que você deve seguir para gerar sua resposta - Distribua estudantes entre as turmas de forma equilibrada com base na idade, assegurando diversidade etária adequada. - Alinhe o nível de ensino dos estudantes com as turmas apropriadas, garantindo que o currículo e a capacidade de ensino sejam compatíveis. - Identifique e aloque estudantes com necessidades especiais em turmas com suporte adequado, verificando a presença de recursos e pessoal capacitado. - Implemente um sistema dinâmico para permitir ajustes rápidos nas alocações devido a mudanças de última hora, como matrículas tardias ou novos requisitos de estudantes já alocados. - Monitore e controle o número de estudantes em cada turma, assegurando que não ultrapasse o limite máximo estabelecido para manter a qualidade do ensino. - Em casos onde múltiplos critérios resultam em empate para alocação, utilize a proximidade geográfica do estudante à instituição como critério de desempate. # 4. Exemplo de Output que você deve produzir Lista de estudantes alocados em turmas, considerando todos os critérios fornecidos.
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 uma lista de estudantes 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 de um arquivo csv na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é uma lista de estudantes com informações sobre idade, nível de ensino e necessidades especiais.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv,.xlsx. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser uma lista de estudantes alocados em turmas, considerando todos os critérios fornecidos.
-
Exemplo de Estrutura de Output:
Lista de estudantes alocados em turmas, considerando critérios como idade, nível de ensino e necessidades especiais.
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade do projeto descrito.
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 não precisa ser visível para outros agentes, pois encerra o fluxo.
1.3.6 Regras de Orquestração e Transição
Este agente é o único no fluxo e não aciona outros agentes. A execução do agente finaliza o processo de alocação.