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 Agente de IA "Assistente Didático", uma solução projetada para auxiliar na criação e revisão de materiais didáticos para aulas de reforço, garantindo a adequação ao currículo escolar. 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 criação de materiais didáticos, revisar conteúdos existentes e atualizar materiais com base no feedback de uso em sala de aula, aliviando a carga de trabalho dos professores.
2. Contexto e Problema
Cenário Atual
Os professores enfrentam desafios significativos na preparação de materiais didáticos que estejam alinhados ao currículo escolar. O tempo limitado e a necessidade de personalização de conteúdo para diferentes turmas e níveis de ensino tornam essa tarefa ainda mais complexa.
- Falta de tempo dos professores para preparar materiais didáticos adequados.
- Dificuldade em garantir que o material esteja alinhado com o currículo.
Atualmente, os professores precisam criar materiais manualmente, revisar cada conteúdo e buscar atualizações sem o auxílio de ferramentas automatizadas que garantam a conformidade curricular.
Problemas Identificados
- Consumo de tempo: A preparação manual de materiais consome um tempo valioso que poderia ser dedicado ao ensino.
- Desalinhamento curricular: Sem uma revisão automatizada, existe o risco de que os materiais não estejam totalmente alinhados com o currículo escolar.
- Falta de feedback: A ausência de um sistema para incorporar feedback de uso em sala de aula limita a evolução dos materiais didáticos.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de preparação de materiais didáticos em pelo menos 70%.
- Assegurar a conformidade com o currículo escolar em 100% dos materiais gerados.
- Incorporar feedback de sala de aula para atualizar e melhorar continuamente os materiais.
- Facilitar a personalização de materiais para diferentes turmas e níveis de ensino.
4. Visão Geral da Solução
O agente de IA para assistência na preparação de material didático automatiza a criação, revisão e atualização de materiais, garantindo a conformidade com o currículo escolar e incorporando feedback de sala de aula. 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 preparação de materiais didáticos.
A solução consiste em um fluxo de automação composto por diversos agentes de IA que colaboram para criar, revisar e atualizar materiais didáticos.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Criação de Materiais (RF 1)
| Gerar materiais didáticos com base no currículo escolar. |
Agente de Revisão de Materiais (RF 2)
| Revisar materiais existentes e sugerir melhorias. |
Agente de Atualização de Materiais (RF 3)
| Atualizar materiais didáticos com base no feedback recebido. |
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.
6. Requisitos Funcionais
RF 1. Agente de Criação de Materiais
1.1 Tarefa do Agente
Gerar materiais didáticos com base no currículo escolar, garantindo que estejam alinhados com as diretrizes educacionais vigentes.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma solicitação para criar materiais didáticos específicos de acordo com o currículo escolar. Este documento é a base para a criação dos conteúdos. # 2. Objetivo Criar materiais didáticos que estejam em conformidade com o currículo escolar, garantindo a qualidade e a relevância dos conteúdos produzidos. # 3. Regras que você deve seguir para gerar sua resposta - Utilize o Currículo Escolar Oficial como referência principal para a criação dos materiais. - Garanta que cada material gerado esteja completo e seja adequado para o nível de ensino especificado. - Inclua exemplos práticos e exercícios para facilitar o aprendizado. - Não adicione conteúdos que não estejam presentes no currículo oficial. # 4. Exemplo de Output que você deve produzir **Matéria:** Matemática - 9º Ano **Conteúdo:** Funções de 1º Grau **Exemplo:** Calcular a raiz de uma função linear. **Exercício:** Resolva a função 2x + 3 = 0 e encontre o valor de x.
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 solicitação de criação de material didático 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 documento na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é uma solicitação textual com especificações do material didático a ser criado.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.txt,.docx. - 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 texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho contendo os campos `Matéria`, `Conteúdo`, `Exemplo` e `Exercício` em negrito.
-
Exemplo de Estrutura de Output:
**Matéria:** Matemática - 9º Ano **Conteúdo:** Funções de 1º Grau **Exemplo:** Calcular a raiz de uma função linear. **Exercício:** Resolva a função 2x + 3 = 0 e encontre o valor de x.
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 2.000 caracteres, podendo variar conforme a complexidade do material descrito.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
1.3.4 Ferramentas do Agente
- Documentos: Consulta o documento "Currículo Escolar Oficial" para garantir a conformidade dos materiais.
- 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 Revisão de Materiais (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Revisão de Materiais (RF 2).
RF 2. Agente de Revisão de Materiais
2.1 Tarefa do Agente
Revisar materiais didáticos existentes e sugerir melhorias com base no currículo escolar e feedback de uso em sala de aula.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um material didático que precisa ser revisado. O material foi criado com base no currículo escolar. # 2. Objetivo Revisar o material didático e sugerir melhorias, garantindo que esteja em conformidade com o currículo escolar e incorporando feedback de uso em sala de aula. # 3. Regras que você deve seguir para gerar sua resposta - Verifique se o material está alinhado com o Currículo Escolar Oficial. - Incorpore feedback de uso em sala de aula para sugerir melhorias práticas. - Sugira mudanças que tornem o conteúdo mais claro e didático, sem alterar o conteúdo curricular. # 4. Exemplo de Output que você deve produzir **Sugestão de Melhoria:** Adicionar mais exemplos práticos para o conteúdo de Funções de 1º Grau. **Feedback Incorporado:** Professores relataram que os alunos têm dificuldade em entender a aplicação prática das funções.
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 bem-sucedida do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input um texto formatado em Markdown, que corresponde ao material didático gerado ou existente.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.md(Markdown). - 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 um texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho contendo os campos `Sugestão de Melhoria` e `Feedback Incorporado` em negrito.
-
Exemplo de Estrutura de Output:
**Sugestão de Melhoria:** Adicionar mais exemplos práticos para o conteúdo de Funções de 1º Grau. **Feedback Incorporado:** Professores relataram que os alunos têm dificuldade em entender a aplicação prática das funções.
- Número de caracteres esperado: O texto final deve ser conciso e direto, com um tamanho estimado em torno de 1.500 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
2.3.4 Ferramentas do Agente
- Documentos: Consulta o documento "Currículo Escolar Oficial" e feedbacks armazenados para garantir melhorias adequadas.
- 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 deve ser visível para o Agente de Atualização de Materiais (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Atualização de Materiais (RF 3).
RF 3. Agente de Atualização de Materiais
3.1 Tarefa do Agente
Atualizar materiais didáticos com base no feedback recebido e nas sugestões de melhoria aprovadas.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um material didático revisado com sugestões de melhoria e feedbacks incorporados. # 2. Objetivo Atualizar o material didático conforme as sugestões de melhoria aprovadas e o feedback recebido. # 3. Regras que você deve seguir para gerar sua resposta - Incorpore as sugestões de melhoria aprovadas no material didático. - Garanta que o material atualizado continue em conformidade com o Currículo Escolar Oficial. - Revise o material atualizado para assegurar clareza e didática. # 4. Exemplo de Output que você deve produzir **Material Atualizado:** - Incluído mais exemplos práticos para o conteúdo de Funções de 1º Grau conforme feedback dos professores. - Revisado para melhorar a clareza e a didática dos conceitos apresentados.
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 bem-sucedida do agente anterior (RF 2).
- Tipo do input: Este agente deve ser apto a receber como input um texto formatado em Markdown, que corresponde ao material didático revisado.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.md(Markdown). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**. A estrutura deve iniciar com um cabeçalho contendo o campo `Material Atualizado` em negrito, seguido pelas mudanças incorporadas.
-
Exemplo de Estrutura de Output:
**Material Atualizado:** - Incluído mais exemplos práticos para o conteúdo de Funções de 1º Grau conforme feedback dos professores. - Revisado para melhorar a clareza e a didática dos conceitos apresentados.
- Número de caracteres esperado: O texto final deve ser claro e objetivo, com um tamanho estimado em torno de 1.500 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.4 Ferramentas do Agente
- Documentos: Consulta o documento "Currículo Escolar Oficial" para garantir a conformidade dos materiais atualizados.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
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 gerada por este agente é 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. O material didático atualizado é o resultado que deve ser disponibilizado ao professor.