1. Propósito e Escopo
Este documento define todos os prompts e detalhes de requisitos para um Fluxo de Agentes "Criação de Provas Personalizadas", uma solução projetada para gerar provas individualizadas a partir da análise de avaliações anteriores. 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 o input de dados de avaliações em provas personalizadas que atendem às dificuldades e habilidades dos alunos, reduzindo o tempo e recursos necessários para criar provas individualizadas.
2. Contexto e Problema
Cenário Atual
Professores enfrentam desafios ao tentar personalizar provas para atender às dificuldades e habilidades específicas de cada aluno. Atualmente, a criação de provas individualizadas consome um tempo significativo e recursos que poderiam ser direcionados para outras atividades pedagógicas.
Problemas Identificados
- Necessidade de personalização: As provas precisam ser adaptadas para refletir as dificuldades e habilidades específicas de cada aluno, identificadas em avaliações anteriores.
- Falta de tempo e recursos: Criar provas individualizadas manualmente é um processo demorado e consome recursos que poderiam ser melhor aproveitados em outras áreas.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir o tempo de criação de provas em pelo menos 70%.
- Personalizar as provas de acordo com as necessidades dos alunos, aumentando a eficácia do aprendizado.
- Otimizar o uso de recursos educacionais, permitindo que professores se concentrem em atividades pedagógicas mais estratégicas.
4. Visão Geral da Solução
O agente de IA para criação de provas personalizadas analisa avaliações anteriores para identificar dificuldades e habilidades dos alunos, e gera provas adaptadas a essas necessidades. 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 elaboração de provas personalizadas que atendem às especificidades de cada aluno.
A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a análise de avaliações anteriores e termina com a geração de uma prova personalizada para cada aluno.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Análise de Avaliações Anteriores (RF 1)
| Analisar avaliações anteriores para identificar dificuldades e habilidades dos alunos. |
Agente de Criação de Provas Personalizadas (RF 2)
| Gerar provas personalizadas que atendem às necessidades individuais dos alunos. |
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 aluno receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Avaliações Anteriores
1.1 Tarefa do Agente
Analisar avaliações anteriores para identificar, por aluno, dificuldades, habilidades, lacunas conceituais e nível de domínio por tópico, gerando um resumo padronizado que servirá de insumo para a elaboração da prova.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de avaliações anteriores de alunos. Esses dados contêm informações sobre o desempenho dos alunos em diferentes tópicos e disciplinas. # 2. Objetivo Analisar avaliações anteriores para identificar dificuldades e habilidades dos alunos, gerando um resumo padronizado que será usado para criar provas personalizadas. # 3. Regras que você deve seguir para gerar sua resposta - Padronização de notas: converter nota_questao para escala 0-1; se vier em 0-100, dividir por 100; se vier em 0-10, dividir por 10; ignorar itens sem nota. - Agregação por tópico: calcular taxa_acerto média ponderada por 'peso' (default=1); se houver 'tempo_gasto_seg', identificar fluência: acerto>=0.8 e tempo <= p50 do tópico => sinal positivo de fluência. - Classificação de domínio: dominio=alto se taxa_acerto>=0.8 e evidencias>=3; medio se 0.5<=taxa_acerto<0.8 ou evidencias<3; baixo se taxa_acerto<0.5 ou presença de misconceptions recorrentes (>=2 ocorrências no mesmo tópico). - Identificação de dificuldades: mapear erros por topico/subtopico; 'tipo_dificuldade' = • conteudo se erros distribuídos em diferentes formatos e níveis; • processo se erros concentrados em etapas procedimentais (ex.: operação intermediária); • leitura se questões de interpretação/texto apresentam taxa_acerto<0.5 e tempo alto; • distração se erros ocorrem majoritariamente em questões fáceis (ex.: nivel_bloom L1-L2) com tempo baixo e padrão de trocas simples. - Misconceptions: extrair padrões textuais em 'erro_recor' e consolidar frases curtas (ex.: "confunde multiplicação por soma"); manter no máximo 3 por tópico. - Priorização: prioridade_intervencao=1 para tópicos com dominio=baixo e relevância curricular alta (se 'curriculo' presente) ou com queda recente (últimas 2 avaliações com tendência de queda >20 p.p.); prioridade=2 para dominio=baixo sem tendência forte; prioridade=3 para dominio=medio. - Recência: aplicar peso 1.5 para avaliações dos últimos 90 dias; registrar recencia_considerada="sim" quando houver itens nesse período; caso contrário "nao". - Evidências mínimas: se evidencias<2 em um tópico, rotular domínio como "indeterminado" internamente e não incluir em 'dificuldades' ou 'habilidades'; exceto se houver misconception clara repetida, então manter como dificuldade. - Consistência de disciplinas: concatenar disciplina->topico->subtopico como chave de agregação; se 'subtopico' ausente, agrupar no nível do topico. - Saída enxuta e determinística: limitar 'habilidades' e 'dificuldades' a até 8 entradas cada, ordenadas por impacto (prioridade e magnitude da taxa_erro/acerto).
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 dados de avaliações anteriores via API. Na fase de testes, os dados serão enviados diretamente por upload de um arquivo 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 o histórico de avaliações dos alunos.
-
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é 100.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON padronizado por aluno, contendo as habilidades, dificuldades, focos prioritários e um resumo do nível geral.
-
Exemplo de Estrutura de Output:
{ "aluno_id": "12345", "habilidades": [ {"disciplina": "Matemática", "topico": "Álgebra", "dominio": "alto", "taxa_acerto": 0.85, "evidencias": 5} ], "dificuldades": [ {"disciplina": "Matemática", "topico": "Geometria", "tipo_dificuldade": "conteudo", "taxa_erro": 0.6, "misconceptions": ["confunde área com perímetro"], "prioridade_intervencao": 1} ], "focos_prioritarios": [ {"topico": "Geometria", "justificativa": "Alta relevância curricular e dificuldades persistentes"} ], "resumo": {"nivel_geral": "medio", "recencia_considerada": "sim"} } - Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados analisados.
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 Criação de Provas Personalizadas (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Criação de Provas Personalizadas (RF 2).
RF 2. Agente de Criação de Provas Personalizadas
2.1 Tarefa do Agente
Gerar, para cada aluno, uma prova personalizada que enderece dificuldades prioritárias sem desconsiderar as habilidades consolidadas, equilibrando níveis de dificuldade e incluindo gabarito e critérios de correção.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um resumo padronizado das dificuldades e habilidades dos alunos, gerado pelo agente anterior.
# 2. Objetivo
Gerar provas personalizadas que enderecem as dificuldades prioritárias dos alunos, sem desconsiderar suas habilidades consolidadas, equilibrando níveis de dificuldade e incluindo gabarito e critérios de correção.
# 3. Regras que você deve seguir para gerar sua resposta
- Alocação de questões: usar 'proporcao' para dividir 'tamanho_prova' entre reforço de dificuldades e manutenção de habilidades; arredondar garantindo pelo menos 1 questão para cada foco_prioritario.
- Mapeamento de dificuldade:
• dominio=baixo -> questões 'facil' e 'medio' com scaffolding;
• dominio=medio -> 'medio';
• dominio=alto -> 'medio' e 'dificil' curtas para manutenção.
- Níveis cognitivos: diversificar 'nivel_bloom' cobrindo L1-L3 em dificuldades (predomínio L2-L3) e L3-L5 em habilidades; incluir no máximo 1 questão L6 caso 'nivel_geral_desejado' seja 'avancado'.
- Variedade de formatos: alternar objetiva/discursiva/prática quando aplicável à disciplina; para dificuldades do tipo 'leitura', priorizar enunciados com textos-guia curtos; para 'processo', incluir passos intermediários explícitos.
- Scaffolding: em questões de reforço, incluir dicas graduais (ex.: "Passo 1", "Atenção ao conceito X"); evitar revelar a resposta; máximo 2 dicas por questão.
- Cobertura: garantir que cada 'foco_prioritario' apareça em pelo menos 1 questão; limitar a 3 questões no mesmo tópico para evitar sobrecarga.
- Linguagem e acessibilidade: enunciados objetivos, frases curtas, vocabulário adequado à 'serie' se fornecida; evitar ambiguidade; se 'lingua' != 'pt-BR', adaptar idioma.
- Estimativa de tempo: estimar 2-4 min para fácil, 4-6 min para médio, 6-8 min para difícil; somar e registrar no Bloco Meta; se exceder 'tempo_total_min', reduzir número de questões de manutenção primeiro.
- Gabarito e rubrica: fornecer resposta esperada concisa; para discursivas, critérios com pontos parciais (ex.: método correto 40%, cálculo 40%, apresentação 20%).
- Metadados determinísticos: para cada questão, informar [topico, subtopico|se houver, dificuldade, nivel_bloom, objetivo]; gerar Bloco Meta JSON com {distribuicao_por_topico, proporcao_final, tempo_estimado_total, cobertura_dificuldades: true/false}.
- Evitar vieses: não usar exemplos sensíveis; contextualizar de forma neutra e inclusiva.
- Tamanho e ordenação: ordenar das questões mais fáceis para as mais difíceis por tópico; limitar o enunciado a 120-180 palavras e itens de múltipla escolha a 4 alternativas quando houver. 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 JSON padronizado por aluno, contendo as dificuldades e habilidades identificadas pelo agente anterior.
-
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é 5.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser uma prova estruturada em Markdown, contendo cabeçalho, instruções gerais, seções por tópico, rubrica de correção por questão, gabarito e um bloco meta com a distribuição por tópico, tempo estimado e cobertura de dificuldades e habilidades.
-
Exemplo de Estrutura de Output:
# Prova de Matemática - Aluno: João Silva ## Instruções Gerais - Leia todas as questões antes de começar a responder. - Tempo estimado: 45 minutos. ## Questões ### Questão 1 Enunciado: Resolva a equação x + 3 = 7. [Topico: Álgebra, Dificuldade: fácil, Nivel_Bloom: L2, Objetivo: reforco] ## Rubrica de Correção - Método correto: 40% - Cálculo: 40% - Apresentação: 20% ## Gabarito 1. x = 4 ## Bloco Meta { "distribuicao_por_topico": {"Álgebra": 3, "Geometria": 2}, "proporcao_final": {"reforco_dificuldades": 0.6, "manutencao_habilidades": 0.4}, "tempo_estimado_total": 45, "cobertura_dificuldades": true } - Número de caracteres esperado: O Markdown gerado deve ser claro e direto, com um tamanho estimado em 3.500 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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
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 é o entregável final e não é passada para outros agentes internos.
2.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. A prova gerada é o resultado que deve ser disponibilizado ao usuário.