Agente de IA para Avaliação de Satisfação Escolar

16 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que coleta e analisa feedback de alunos e pais sobre a experiência escolar.

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 Satisfação Escolar", uma solução de automação projetada para coletar e analisar feedbacks de alunos e pais sobre a experiência escolar, gerando relatórios de satisfação e sugestões de melhoria. 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 input de feedbacks em relatórios detalhados que possam guiar melhorias na experiência escolar, garantindo uma análise contínua e confidencial dos dados coletados.

2. Contexto e Problema

Cenário Atual

As instituições escolares enfrentam desafios significativos na coleta e análise de feedbacks de alunos e pais. Atualmente, o processo é manual e ineficiente, dificultando a obtenção de insights acionáveis. Alguns dos problemas específicos incluem:

  • Dificuldade em coletar e analisar feedbacks de forma eficiente e estruturada.
  • Falta de relatórios detalhados sobre a satisfação escolar que possam guiar melhorias.

Problemas Identificados

  • Incapacidade de coleta contínua: A coleta de feedbacks não é contínua, resultando em dados desatualizados.
  • Confidencialidade comprometida: A falta de um sistema seguro para coleta e armazenamento de dados compromete a confidencialidade dos feedbacks.
  • Análise de dados limitada: A análise manual limita a capacidade de identificar padrões e tendências significativos.
  • Falta de relatórios acionáveis: Os relatórios atuais não oferecem sugestões de melhorias específicas e acionáveis.

3. Impactos Esperados

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

  • Melhorar a coleta de feedbacks de forma contínua e estruturada.
  • Assegurar a confidencialidade dos dados coletados.
  • Aumentar a precisão e a profundidade da análise de feedbacks para identificar áreas de melhoria e pontos fortes.
  • Gerar relatórios detalhados e acionáveis que guiem melhorias na experiência escolar.

4. Visão Geral da Solução

O agente de IA para avaliação de satisfação escolar coleta e analisa feedbacks de alunos e pais, transformando-os em relatórios detalhados e sugestões de melhoria para a instituição escolar. 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 avaliação da satisfação escolar.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a coleta de feedbacks e termina com a geração de relatórios de satisfação escolar.

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

Agentes Função Principal
Agente de Coleta de Feedback (RF 1) Coletar feedbacks de alunos e pais de maneira contínua e confidencial.
Agente de Análise de Feedback (RF 2) Analisar os dados coletados para identificar áreas de melhoria e pontos fortes.
Agente de Geração de Relatórios (RF 3) Gerar relatórios detalhados com sugestões de melhorias baseadas nos feedbacks recebidos.

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

6. Requisitos Funcionais

RF 1. Agente de Coleta de Feedback

1.1 Tarefa do Agente

Coletar feedbacks de alunos e pais de maneira contínua e confidencial.

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 e pais. Estes formulários contêm informações sobre a experiência escolar e sugestões de melhoria.

# 2. Objetivo
Coletar feedbacks de maneira contínua e confidencial, garantindo a segurança e integridade dos dados coletados.

# 3. Regras que você deve seguir para gerar sua resposta
- Coletar feedbacks de forma contínua, garantindo a confidencialidade dos dados.
- Armazenar os dados de forma segura para posterior análise.
- Validar a completude dos formulários antes de armazenar os dados, rejeitando aqueles que não cumpram os requisitos mínimos.
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 e pais 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 dos formulários na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: Formulários de feedback preenchidos por alunos e pais.
  • Formatos Suportados: Esse agente deve ser capaz de receber formulários nos formatos: .pdf, .docx, .xlsx.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres por formulário.

1.3.2 Especificação do Output

  • Formato de output: Dados estruturados dos feedbacks coletados em formato JSON.
  • Exemplo de Estrutura de Output:
     {
      "feedback_id": "12345",
      "student_name": "João Silva",
      "feedback_text": "A escola poderia melhorar a infraestrutura das salas de aula.",
      "suggestions": ["Melhorar infraestrutura", "Aumentar atividades extracurriculares"]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.000 caracteres por feedback.

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 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 Feedback (RF 2).

RF 2. Agente de Análise de Feedback

2.1 Tarefa do Agente

Analisar os dados coletados para identificar áreas de melhoria e pontos fortes.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados dos feedbacks coletados. Estes dados contêm informações sobre a experiência escolar e sugestões de melhoria.

# 2. Objetivo
Analisar os dados coletados para identificar áreas de melhoria e pontos fortes.

# 3. Regras que você deve seguir para gerar sua resposta
- Identificar padrões e tendências nos feedbacks através de análise estatística e de texto.
- Destacar áreas de melhoria e pontos fortes com base nos dados analisados, usando métricas claras.
- Priorizar feedbacks mais recorrentes para definição de ações, garantindo que os temas mais citados sejam abordados primeiro.
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: Dados estruturados dos feedbacks coletados.
  • 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é 50.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: Análise detalhada das áreas de melhoria e pontos fortes em formato JSON.
  • Exemplo de Estrutura de Output:
     {
      "analysis_id": "67890",
      "key_strengths": ["Ambiente acolhedor", "Professores qualificados"],
      "areas_for_improvement": ["Melhorar infraestrutura", "Aumentar atividades extracurriculares"],
      "top_suggestions": ["Melhorar infraestrutura"]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.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: 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 gerada por este agente deve ser visível para o Agente de Geração de Relatórios (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios (RF 3).

RF 3. Agente de Geração de Relatórios

3.1 Tarefa do Agente

Gerar relatórios detalhados com sugestões de melhorias baseadas nos feedbacks recebidos.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo uma análise detalhada das áreas de melhoria e pontos fortes. Esta análise foi gerada a partir dos feedbacks coletados.

# 2. Objetivo
Gerar relatórios detalhados com sugestões de melhorias baseadas nos feedbacks recebidos.

# 3. Regras que você deve seguir para gerar sua resposta
- Estruturar o relatório com base nas análises realizadas, incluindo sugestões de melhoria específicas e acionáveis.
- Garantir que o relatório seja compreensível e útil para guiar melhorias escolares, utilizando linguagem clara e acessível.
- Incluir gráficos e tabelas para melhor visualização dos dados, assegurando que as representações visuais sejam precisas e relevantes.
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: Análise detalhada das áreas de melhoria e pontos fortes.
  • 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é 50.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: Relatórios de satisfação escolar em formato Markdown.
  • Exemplo de Estrutura de Output:
     **Relatório de Satisfação Escolar**
    
    **Áreas de Melhoria:**
    
    1. Melhorar infraestrutura
    2. Aumentar atividades extracurriculares
    
    **Pontos Fortes:**
    
    - Ambiente acolhedor
    - Professores qualificados
    
    **Sugestões de Melhoria:**
    
    - Investir na renovação das instalações escolares
    - Expandir o número de clubes e atividades extracurriculares 
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 5.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. O relatório gerado é o resultado que deve ser disponibilizado à instituição escolar.

© 2025 prototipe.ai. Todos os direitos reservados.