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 Agente de IA "Criação de Materiais Didáticos". 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 é gerar materiais didáticos personalizados que atendam às necessidades específicas de turmas ou alunos, considerando diferentes níveis de aprendizado e estilos de ensino.
2. Contexto e Problema
Cenário Atual
Os educadores enfrentam desafios significativos ao tentar personalizar materiais didáticos para atender a diferentes níveis de aprendizado e estilos de ensino. Além disso, a falta de tempo dos educadores para criar materiais adaptados às necessidades específicas dos alunos é um problema recorrente.
Outro desafio é a necessidade de atualização constante dos materiais didáticos para refletir as mudanças no currículo e nas diretrizes educacionais.
Problemas Identificados
- Personalização Insuficiente: A dificuldade em adaptar materiais didáticos para diferentes estilos de aprendizagem e níveis de conhecimento dos alunos.
- Tempo Limitado dos Educadores: Educadores não têm tempo suficiente para criar materiais personalizados e atualizados.
- Atualização Constante: A necessidade de manter os materiais didáticos atualizados conforme mudanças no currículo e diretrizes educacionais.
3. Impactos Esperados
A implementação deste agente visa alcançar os seguintes resultados:
- Personalização Aumentada: Melhorar a personalização dos materiais didáticos para atender às necessidades específicas de cada aluno ou turma.
- Eficiência dos Educadores: Reduzir o tempo necessário para criar e atualizar materiais didáticos.
- Atualização Automatizada: Manter os materiais didáticos sempre alinhados com o currículo e as diretrizes mais recentes.
4. Visão Geral da Solução
O agente de IA para criação de materiais didáticos analisa dados de turmas ou alunos, aplica regras de personalização e gera materiais didáticos adaptados às necessidades específicas de aprendizado. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que este agente atue como um assistente útil e autônomo na criação de materiais didáticos personalizados.
A solução consiste em um fluxo de automação composto por diversos agentes de IA. O processo inicia com a coleta de dados dos alunos e termina com a geração de materiais didáticos personalizados.
A execução dos agentes é sequencial e linear, conforme detalhado na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Coleta de Dados de Alunos (RF 1)
| Coletar dados de aprendizado e estilo de ensino de cada aluno. |
Agente de Geração de Materiais Didáticos (RF 2)
| Gerar materiais didáticos personalizados com base nos dados coletados. |
Agente de Atualização de Conteúdo (RF 3)
| Atualizar materiais didáticos conforme mudanças no currículo e diretrizes. |
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 e alunos receberão. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Coleta de Dados de Alunos
1.1 Tarefa do Agente
Coletar dados de aprendizado e estilo de ensino de cada aluno para personalizar o material didático.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo solicitações de educadores para coletar dados de aprendizado e estilo de ensino de alunos. # 2. Objetivo Coletar informações sobre o nível de aprendizado, estilo de ensino preferido e dificuldades específicas de aprendizado de cada aluno. # 3. Regras que você deve seguir para gerar sua resposta - Realize perguntas diretas aos educadores ou alunos sobre o nível de aprendizado atual, estilo de ensino preferido e dificuldades enfrentadas. - Registre todas as respostas de forma estruturada para uso em agentes subsequentes. # 4. Exemplo de Output que você deve produzir Nível de aprendizado: Intermediário Estilo de ensino preferido: Visual Dificuldades: Matemática avançada
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 personalizaçã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 na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um conjunto de dados textuais sobre o aluno ou turma.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv,.json. - 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**, contendo as informações coletadas e estruturadas para uso posterior.
-
Exemplo de Estrutura de Output:
Nível de aprendizado: Intermediário Estilo de ensino preferido: Visual Dificuldades: Matemática avançada
- Número de caracteres esperado: O texto final deve ser conciso, com um tamanho estimado em torno de 500 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
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 Geração de Materiais Didáticos (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Geração de Materiais Didáticos (RF 2).
RF 2. Agente de Geração de Materiais Didáticos
2.1 Tarefa do Agente
Gerar materiais didáticos personalizados com base nos dados coletados sobre os alunos.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados estruturados sobre o nível de aprendizado, estilo de ensino e dificuldades dos alunos. # 2. Objetivo Gerar materiais didáticos que se adaptem às necessidades e preferências de aprendizado de cada aluno. # 3. Regras que você deve seguir para gerar sua resposta - Use os dados recebidos para personalizar o conteúdo dos materiais didáticos. - Inclua sugestões de materiais complementares que possam enriquecer o aprendizado. # 4. Exemplo de Output que você deve produzir Material Didático: Matemática Avançada - Estilo Visual Sugestões: Vídeos explicativos, Infográficos
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 aos dados coletados sobre os alunos.
-
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é 2.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**, contendo o material didático personalizado e sugestões de materiais complementares.
-
Exemplo de Estrutura de Output:
Material Didático: Matemática Avançada - Estilo Visual Sugestões: Vídeos explicativos, Infográficos
- Número de caracteres esperado: O texto final deve ser claro e direto, com um tamanho estimado em torno de 1.000 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
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 deve ser visível para o Agente de Atualização de Conteúdo (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 Conteúdo (RF 3).
RF 3. Agente de Atualização de Conteúdo
3.1 Tarefa do Agente
Atualizar materiais didáticos conforme mudanças no currículo e diretrizes educacionais.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo materiais didáticos que precisam ser atualizados conforme as novas diretrizes educacionais. # 2. Objetivo Garantir que os materiais didáticos estejam sempre alinhados com as diretrizes e currículo mais recentes. # 3. Regras que você deve seguir para gerar sua resposta - Verifique as atualizações mais recentes nas diretrizes educacionais. - Atualize o conteúdo dos materiais didáticos para refletir essas mudanças. # 4. Exemplo de Output que você deve produzir Material Atualizado: Matemática Avançada - Inclui novas diretrizes de cálculo
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 do agente anterior (RF 2).
- Tipo do input: Este agente deve ser apto a receber como input materiais didáticos em formato Markdown, que precisam ser atualizados.
-
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é 3.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em **Markdown**, contendo os materiais didáticos atualizados.
-
Exemplo de Estrutura de Output:
Material Atualizado: Matemática Avançada - Inclui novas diretrizes de cálculo
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 1.500 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.3.4 Ferramentas do Agente
- Documentos: Consulta o documento "Diretrizes Educacionais Atualizadas" para verificar as mudanças necessárias.
- 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 resultado 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, garantindo que os materiais didáticos estejam atualizados e prontos para uso.