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 "Análise de Feedback de Alunos", uma solução de automação projetada para coletar e analisar feedback de alunos sobre disciplinas específicas. 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 feedback dos alunos em dados estruturados e analisá-los para identificar padrões e sugerir melhorias no conteúdo ou na abordagem didática.
2. Contexto e Problema
Cenário Atual
As instituições de ensino enfrentam desafios ao coletar e analisar feedback de alunos sobre disciplinas. Esses desafios incluem:
- Dificuldade em coletar e analisar feedback de alunos de forma eficiente.
- Falta de identificação de padrões comuns nas opiniões dos alunos sobre disciplinas específicas.
- Necessidade de sugerir melhorias no conteúdo ou na abordagem didática com base em dados concretos.
Atualmente, a coleta de feedback é feita manualmente, o que é demorado e sujeito a erros. A análise é limitada e muitas vezes não resulta em ações práticas para melhorias.
Problemas Identificados
- Coleta Ineficiente: O método atual de coleta de feedback é demorado e não padronizado, resultando em dados inconsistentes.
- Análise Limitada: A análise manual dos feedbacks não consegue identificar padrões e tendências significativas.
- Falta de Ação: Mesmo quando problemas são identificados, há uma falta de sugestões práticas e viáveis para melhorias.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Melhorar a coleta de feedback tornando-a contínua e estruturada.
- Identificar padrões e tendências nos feedbacks de alunos de forma mais precisa.
- Propor melhorias práticas no conteúdo e na abordagem didática com base em dados concretos.
4. Visão Geral da Solução
O agente de IA para análise de feedback de alunos processa dados de feedback de alunos, identifica padrões e sugere melhorias no conteúdo ou na abordagem didática. 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 análise de feedback de alunos.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a coleta de feedback dos alunos e termina com a proposição de melhorias didáticas.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Coleta de Feedback de Alunos (RF 1)
| Coletar feedback de alunos sobre disciplinas específicas de forma contínua e estruturada. |
Agente de Análise de Padrões de Feedback (RF 2)
| Identificar padrões e tendências nos feedbacks coletados de alunos. |
Agente de Proposição de Melhorias Didáticas (RF 3)
| Propor mudanças no conteúdo ou na metodologia de ensino com base na análise de feedback. |
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 cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Coleta de Feedback de Alunos
1.1 Tarefa do Agente
Coletar feedback de alunos sobre disciplinas específicas de forma contínua e estruturada.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo formulários de feedback preenchidos por alunos sobre disciplinas específicas.
# 2. Objetivo
Coletar e estruturar os feedbacks em um formato JSON, garantindo a anonimização dos dados pessoais dos alunos.
# 3. Regras que você deve seguir para gerar sua resposta
- Coletar feedback de forma contínua, garantindo que todos os alunos tenham oportunidades iguais de contribuir.
- Estruturar os dados coletados em um formato consistente, incluindo campos obrigatórios como 'disciplina', 'comentários' e 'data'.
- Anonimizar os dados pessoais dos alunos para proteger a privacidade.
# 4. Exemplo de Output que você deve produzir
{
"feedbacks": [
{
"disciplina": "Matemática",
"comentários": "Aulas muito teóricas, poderia ter mais exemplos práticos.",
"data": "2025-11-15"
}
]
} 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 formulários de feedback preenchidos por 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 na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo são formulários de feedback preenchidos por alunos.
-
Formatos Suportados: Esse agente deve ser capaz de receber formulários nos formatos:
.csv,.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 JSON estruturado contendo os feedbacks dos alunos.
-
Exemplo de Estrutura de Output:
{ "feedbacks": [ { "disciplina": "Matemática", "comentários": "Aulas muito teóricas, poderia ter mais exemplos práticos.", "data": "2025-11-15" } ] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 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 nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Padrões de Feedback (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise de Padrões de Feedback (RF 2).
RF 2. Agente de Análise de Padrões de Feedback
2.1 Tarefa do Agente
Identificar padrões e tendências nos feedbacks coletados de alunos.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um JSON estruturado com feedbacks coletados de alunos sobre disciplinas específicas. # 2. Objetivo Analisar os feedbacks para identificar padrões comuns e tendências significativas. # 3. Regras que você deve seguir para gerar sua resposta - Analisar os feedbacks coletados para identificar padrões comuns e recorrentes. - Identificar tendências significativas que possam indicar problemas ou pontos fortes nas disciplinas. - Aplicar técnicas estatísticas para validar a significância dos padrões identificados. # 4. Exemplo de Output que você deve produzir **Padrões Identificados:** - Muitos alunos mencionaram a falta de exemplos práticos nas aulas de Matemática. - Os alunos apreciam a abordagem prática nas aulas de Química. **Tendências Significativas:** - Aulas teóricas são geralmente menos apreciadas. - Aulas práticas são bem recebidas e consideradas mais eficazes.
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 estruturado contendo os feedbacks coletados dos alunos.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um relatório em formato Markdown contendo os padrões e tendências identificados.
-
Exemplo de Estrutura de Output:
**Padrões Identificados:** - Muitos alunos mencionaram a falta de exemplos práticos nas aulas de Matemática. - Os alunos apreciam a abordagem prática nas aulas de Química. **Tendências Significativas:** - Aulas teóricas são geralmente menos apreciadas. - Aulas práticas são bem recebidas e consideradas mais eficazes.
- Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 3.000 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.
- Calculadora: Utiliza lógica interna para validar a significância dos padrões.
- 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 gerada por este agente deve ser visível para o Agente de Proposição de Melhorias Didáticas (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Proposição de Melhorias Didáticas (RF 3).
RF 3. Agente de Proposição de Melhorias Didáticas
3.1 Tarefa do Agente
Propor mudanças no conteúdo ou na metodologia de ensino com base na análise de feedback.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um relatório em formato Markdown com padrões e tendências identificados nos feedbacks de alunos. # 2. Objetivo Propor melhorias práticas no conteúdo e na abordagem didática com base nos padrões e tendências identificados. # 3. Regras que você deve seguir para gerar sua resposta - Basear as sugestões de melhorias em dados concretos extraídos da análise de feedback. - Focar em propostas práticas e viáveis para melhorar a experiência de aprendizado dos alunos. - Priorizar sugestões que tenham maior potencial de impacto positivo conforme identificado nos padrões de feedback. # 4. Exemplo de Output que você deve produzir **Sugestões de Melhorias:** - Introduzir mais exemplos práticos nas aulas de Matemática para facilitar o entendimento dos conceitos. - Manter e expandir a abordagem prática nas aulas de Química, incorporando mais experimentos em sala de aula.
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 um relatório em formato Markdown contendo padrões e tendências identificados.
-
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 até 3.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um documento em formato Markdown contendo as sugestões de melhorias didáticas.
-
Exemplo de Estrutura de Output:
**Sugestões de Melhorias:** - Introduzir mais exemplos práticos nas aulas de Matemática para facilitar o entendimento dos conceitos. - Manter e expandir a abordagem prática nas aulas de Química, incorporando mais experimentos em sala de aula.
- Número de caracteres esperado: O documento de sugestões deve ter um tamanho estimado em torno de 2.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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. As sugestões de melhorias geradas são o resultado que deve ser disponibilizado ao usuário.