1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, consulta a documentos e demais requisitos funcionais para o Fluxo de Agentes "Criação de Planos de Ensino Individualizados", uma solução de automação projetada para analisar as necessidades individuais dos alunos e desenvolver planos de ensino personalizados com base em dados de desempenho e feedback dos professores. 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 dados de desempenho e feedback dos professores em planos de ensino individualizados que atendam às necessidades específicas de cada aluno, melhorando a eficácia do ensino e a experiência de aprendizado.
2. Contexto e Problema
Cenário Atual
Nas escolas, os professores enfrentam desafios significativos para identificar as necessidades individuais dos alunos devido à grande quantidade de dados disponíveis. Além disso, os planos de ensino atuais frequentemente carecem de personalização, não atendendo adequadamente às necessidades específicas de cada aluno.
Problemas Identificados
- Dificuldade em identificar necessidades individuais: A quantidade de dados de desempenho dos alunos pode ser avassaladora, dificultando a identificação de padrões e necessidades específicas.
- Falta de personalização: Os planos de ensino padrão muitas vezes não levam em consideração as particularidades de cada aluno, resultando em uma abordagem de ensino pouco eficaz.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Melhorar a personalização dos planos de ensino para atender às necessidades específicas de cada aluno.
- Aumentar a eficácia do ensino através de intervenções direcionadas e baseadas em dados.
- Reduzir o tempo e esforço necessários para analisar dados de desempenho e ajustar planos de ensino.
4. Visão Geral da Solução
O agente de IA para criação de planos de ensino individualizados analisa dados de desempenho dos alunos e feedback dos professores, aplicando regras específicas para desenvolver planos de ensino personalizados. 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 personalização do ensino.
A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a análise dos dados de desempenho dos alunos e termina com o ajuste dos planos de ensino com base no feedback dos professores.
| Agentes | Função Principal |
|---|---|
Agente de Análise de Dados de Desempenho dos Alunos (RF 1)
| Analisar dados de desempenho dos alunos para identificar padrões e necessidades individuais. |
Agente de Ajuste de Planos de Ensino (RF 2)
| Utilizar feedback dos professores para ajustar os planos de ensino de acordo com as necessidades específicas de cada aluno. |
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 os educadores receberão. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Dados de Desempenho dos Alunos
1.1 Tarefa do Agente
Analisar dados de desempenho dos alunos para identificar padrões e necessidades individuais.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de desempenho dos alunos em formato JSON. Este conjunto de dados inclui métricas como notas, frequência e participação.
# 2. Objetivo
Analisar os dados para identificar padrões de desempenho e necessidades individuais dos alunos, gerando insights que orientem intervenções personalizadas.
# 3. Regras que você deve seguir para gerar sua resposta
- Extraia e analise métricas de desempenho-chave para cada aluno, como notas, frequência e participação. Registre essas métricas de forma estruturada.
- Identifique padrões de dificuldade ou progresso em disciplinas específicas, utilizando análise estatística para determinar tendências significativas.
- Gere insights detalhados sobre as áreas que necessitam de atenção especial para cada aluno, recomendando intervenções específicas.
- Classifique os alunos em grupos de necessidades semelhantes com base em análises estatísticas para facilitar intervenções direcionadas e personalizadas.
# 4. Exemplo de Output que você deve produzir
{
"aluno_id": "123",
"padrões": {
"dificuldade": "Matemática",
"progresso": "Ciências"
},
"necessidades": "Apoio adicional em Matemática",
"grupo": "Grupo de Apoio Matemático"
} 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 desempenho dos alunos 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 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 dados de desempenho dos alunos.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON, contendo a identificação dos padrões de desempenho e necessidades individuais para cada aluno.
-
Exemplo de Estrutura de Output:
{ "aluno_id": "123", "padrões": { "dificuldade": "Matemática", "progresso": "Ciências" }, "necessidades": "Apoio adicional em Matemática", "grupo": "Grupo de Apoio Matemático" } - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 caracteres por aluno.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
1.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para análise estatística.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 (JSON de padrões e necessidades) deve ser visível para o Agente de Ajuste de Planos de Ensino (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Ajuste de Planos de Ensino (RF 2).
RF 2. Agente de Ajuste de Planos de Ensino
2.1 Tarefa do Agente
Utilizar feedback dos professores para ajustar os planos de ensino de acordo com as necessidades específicas de cada aluno.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo feedback dos professores e necessidades individuais dos alunos em formato JSON.
# 2. Objetivo
Ajustar os planos de ensino com base no feedback dos professores e nas necessidades específicas identificadas para cada aluno.
# 3. Regras que você deve seguir para gerar sua resposta
- Incorpore feedback qualitativo dos professores sobre o desempenho e comportamento dos alunos, mapeando diretamente para ajustes nos planos de ensino.
- Ajuste os objetivos de aprendizado com base nas recomendações específicas dos professores, priorizando áreas críticas identificadas.
- Revisite e modifique os planos de ensino para incluir estratégias de ensino diferenciadas, garantindo que cada estratégia esteja alinhada com as necessidades individuais.
- Avalie a eficácia dos ajustes realizados através de indicadores de sucesso definidos, como melhoria nas notas ou aumento na participação, e proponha ajustes contínuos.
# 4. Exemplo de Output que você deve produzir
{
"aluno_id": "123",
"plano_ensino": {
"objetivos": ["Melhorar habilidades matemáticas", "Aumentar participação em sala"],
"estratégias": ["Aulas práticas de matemática", "Sessões de tutoria individuais"],
"indicadores_sucesso": ["Notas acima de 70%", "Participação em 80% das aulas"]
}
} 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 arquivo JSON contendo feedback dos professores e necessidades individuais 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 até 50.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON, detalhando os planos de ensino ajustados para cada aluno.
-
Exemplo de Estrutura de Output:
{ "aluno_id": "123", "plano_ensino": { "objetivos": ["Melhorar habilidades matemáticas", "Aumentar participação em sala"], "estratégias": ["Aulas práticas de matemática", "Sessões de tutoria individuais"], "indicadores_sucesso": ["Notas acima de 70%", "Participação em 80% das aulas"] } } - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 caracteres por aluno.
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 (JSON dos planos de ensino ajustados) é 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. O JSON gerado com os planos de ensino ajustados é o resultado que deve ser disponibilizado ao usuário.