PrototipeAI | Agente de IA para Avaliação de Planos de Aulas Inclusivas

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 Fluxo de Agentes "Avaliação de Planos de Aulas Inclusivas", uma solução projetada para analisar planos de aula e sugerir adaptações inclusivas. 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 é fornecer feedback detalhado e estratégias de inclusão para professores, ajudando-os a criar planos de aula que atendam à diversidade de alunos.

2. Contexto e Problema

Cenário Atual

Professores enfrentam desafios significativos ao elaborar planos de aula que atendam à diversidade de alunos. Atualmente, muitos planos de aula carecem de estratégias inclusivas, o que limita a capacidade de atender a todos os estudantes de forma equitativa.

Dificuldade dos professores em elaborar planos de aula que atendam a diversidade de alunos.
Falta de estratégias inclusivas nos planos de aula atuais.

Problemas Identificados

Falta de adaptação: Planos de aula frequentemente não consideram as diferentes necessidades dos alunos.
Ausência de estratégias inclusivas: Não há diretrizes claras para incorporar práticas inclusivas nos planos de aula.
Feedback insuficiente: Professores não recebem feedback detalhado sobre como melhorar a inclusão em seus planos de aula.

3. Impactos Esperados

A implementação deste fluxo de agentes visa alcançar os seguintes resultados:

Melhoria na qualidade dos planos de aula com estratégias inclusivas claras.
Maior engajamento dos alunos através de práticas educacionais inclusivas.
Redução das lacunas de aprendizagem ao atender às diversas necessidades dos alunos.

4. Visão Geral da Solução

O agente de IA para avaliação de planos de aulas inclusivas analisa planos de aula existentes, identifica áreas que precisam de adaptações e sugere estratégias inclusivas. 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 planos de aula inclusivos que atendam as especificidades da sua escola.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a extração do conteúdo dos planos de aula e termina com a geração de um relatório detalhado de sugestões inclusivas.

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

Agentes	Função Principal
`Agente de Extração de Conteúdo de Plano de Aula` (RF 1)	Realizar extração e organização do conteúdo textual de um plano de aula fornecido em PDF.
`Agente de Avaliação e Adaptação Inclusiva de Planos de Aula` (RF 2)	Analisar o plano de aula e sugerir adaptações e estratégias inclusivas concretas.

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 professor receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Extração de Conteúdo de Plano de Aula

1.1 Tarefa do Agente

Realizar extração e organização do conteúdo textual de um plano de aula fornecido em PDF para viabilizar análise inclusiva no próximo agente.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um arquivo PDF de um plano de aula. Seu objetivo é extrair e organizar o conteúdo textual desse plano de forma que possa ser analisado para inclusão.

# 2. Objetivo
Extrair o conteúdo textual do plano de aula e organizá-lo em seções identificáveis para análise posterior.

# 3. Regras que você deve seguir para gerar sua resposta
- Preserve o formato de seções do plano de aula original, quando detectável.
- Remova cabeçalhos e rodapés repetidos no texto extraído.
- Sinalize trechos ilegíveis com o token [ilegivel] e não inferir dados ausentes.
- Adicione um campo 'confianca_extracao' ∈ {alto, medio, baixo} baseado na consistência do texto extraído.

# 4. Exemplo de Output que você deve produzir
{
  "titulo": "Aula de Matemática Inclusiva",
  "etapa_ensino": "Ensino Fundamental",
  "ano_serie": "5º ano",
  "componentes_curricular": "Matemática",
  "objetivos": "Desenvolver o raciocínio lógico e a resolução de problemas.",
  "habilidades": ["Interpretação de problemas", "Cálculo mental"],
  "conteudos": "Operações básicas e problemas do cotidiano.",
  "metodologia": "Uso de jogos e atividades práticas.",
  "atividades": "Resolução de problemas em grupo.",
  "recursos": "Quadro branco, jogos matemáticos.",
  "avaliacao": "Observação e registro de participação.",
  "tempo_previsto": "50 minutos",
  "observacoes": "Atender às necessidades individuais dos alunos.",
  "anexos_detectados": false
}

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 PDF do plano de aula 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 PDF na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo é um arquivo PDF, que após ser processado, resulta em um texto estruturado que é o input direto para o próximo agente.
Formatos Suportados: Esse agente deve ser capaz de receber planos de aula nos formatos: .pdf.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um objeto JSON com campos pré-definidos para cada seção identificada do plano de aula.

Exemplo de Estrutura de Output:

 {
  "titulo": "Aula de Matemática Inclusiva",
  "etapa_ensino": "Ensino Fundamental",
  "ano_serie": "5º ano",
  "componentes_curricular": "Matemática",
  "objetivos": "Desenvolver o raciocínio lógico e a resolução de problemas.",
  "habilidades": ["Interpretação de problemas", "Cálculo mental"],
  "conteudos": "Operações básicas e problemas do cotidiano.",
  "metodologia": "Uso de jogos e atividades práticas.",
  "atividades": "Resolução de problemas em grupo.",
  "recursos": "Quadro branco, jogos matemáticos.",
  "avaliacao": "Observação e registro de participação.",
  "tempo_previsto": "50 minutos",
  "observacoes": "Atender às necessidades individuais dos alunos.",
  "anexos_detectados": false
}

Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 2.500 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 o próximo agente.
Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Avaliação e Adaptação Inclusiva de Planos de Aula (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Avaliação e Adaptação Inclusiva de Planos de Aula (RF 2).

RF 2. Agente de Avaliação e Adaptação Inclusiva de Planos de Aula

2.1 Tarefa do Agente

Analisar o plano de aula e sugerir adaptações e estratégias inclusivas concretas e acionáveis para atender à diversidade de estudantes.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o texto de um plano de aula extraído e organizado pelo agente anterior. Além disso, pode receber metadados adicionais sobre o contexto escolar.

# 2. Objetivo
Analisar o plano de aula e sugerir adaptações e estratégias inclusivas concretas para atender à diversidade de estudantes.

# 3. Regras que você deve seguir para gerar sua resposta
- Identifique áreas que precisam de adaptações para serem mais inclusivas.
- Sugira estratégias e atividades que possam ser incorporadas aos planos de aula para promover a inclusão.
- Ofereça feedback detalhado aos professores sobre como melhorar seus planos de aula em termos de inclusão.

# 4. Exemplo de Output que você deve produzir
{
  "diagnostico_inclusao": "medio",
  "lacunas_detectadas": ["metodologia", "recursos"],
  "adaptacoes_propostas": {
    "engajamento": ["Incluir jogos interativos", "Usar exemplos culturais relevantes"],
    "representacao": ["Fornecer materiais em áudio e vídeo", "Utilizar linguagem simples"],
    "acao_expressao": ["Oferecer múltiplas opções de resposta", "Incorporar tecnologia assistiva"]
  },
  "plano_avaliacao_inclusiva": "Incluir autoavaliação e portfólios.",
  "ajustes_acessibilidade": "Fornecer materiais em braille e áudio.",
  "gestao_sala_ambiente": "Organizar sala em grupos colaborativos.",
  "indicadores_sucesso": ["Aumento no engajamento dos alunos", "Melhoria nas avaliações de aprendizagem"]
}

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 texto estruturado em JSON, que corresponde ao conteúdo do plano de aula extraído 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é 10.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório em formato markdown com diagnóstico de inclusão, lacunas e riscos, adaptações propostas e indicadores de sucesso.