Agente de IA para Avaliação de Clima Escolar

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

Como criar um agente de IA que analisa feedbacks de alunos e professores sobre o ambiente 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 Clima Escolar", uma solução de automação projetada para coletar e analisar feedbacks de alunos e professores sobre o ambiente escolar, gerando relatórios detalhados e propondo melhorias. 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 compreensíveis que auxiliem na tomada de decisões para promover um ambiente escolar mais positivo.

2. Contexto e Problema

Cenário Atual

As escolas enfrentam dificuldades em avaliar e melhorar o clima escolar de forma contínua. A necessidade de um sistema que colete e analise feedbacks de forma eficiente é evidente. Os principais desafios incluem:

  • Dificuldade em obter feedbacks honestos e anônimos de alunos e professores.
  • Falta de um processo estruturado para analisar os dados coletados e gerar insights acionáveis.
  • Necessidade de propostas de melhorias baseadas em dados concretos para promover um ambiente escolar mais positivo.

3. Impactos Esperados

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

  • Melhorar a coleta de feedbacks de alunos e professores, garantindo anonimato e honestidade.
  • Gerar relatórios detalhados e compreensíveis sobre o clima escolar.
  • Propor melhorias específicas e acionáveis para promover um ambiente escolar mais positivo.
  • Facilitar a tomada de decisões com base em dados concretos e bem analisados.

4. Visão Geral da Solução

O agente de IA para avaliação de clima escolar processa feedbacks de alunos e professores, aplica análises detalhadas e gera relatórios compreensíveis e propostas de melhorias. 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 do clima 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 proposição de melhorias.

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

Agentes Função Principal
Agente de Coleta de Feedbacks Escolares (RF 1) Coletar feedbacks de alunos e professores sobre o ambiente escolar.
Agente de Análise de Clima Escolar (RF 2) Analisar os dados coletados para gerar relatórios detalhados sobre o clima escolar.
Agente de Proposição de Melhorias (RF 3) Propor melhorias com base nos dados analisados para promover um ambiente escolar mais positivo.

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

6. Requisitos Funcionais

RF 1. Agente de Coleta de Feedbacks Escolares

1.1 Tarefa do Agente

Coletar feedbacks de alunos e professores sobre o ambiente escolar.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo formulários de feedback de alunos e professores. Este texto é o registro bruto das percepções dos participantes sobre o ambiente escolar.

# 2. Objetivo
Coletar feedbacks de alunos e professores sobre o ambiente escolar.

# 3. Regras que você deve seguir para gerar sua resposta
- Identifique e categorize os diferentes tipos de feedbacks recebidos (positivos, negativos, sugestões).
- Assegure que todos os feedbacks sejam anonimizados para proteger a identidade dos participantes.
- Verifique a completude dos formulários, mas não preencha lacunas sem dados adicionais confiáveis.
- Consolide os feedbacks em um formato estruturado que permita fácil análise subsequente.
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 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 de alunos e professores.
  • Formatos Suportados: Esse agente deve ser capaz de receber formulários nos formatos: .pdf, .docx.
  • 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 uma estrutura de dados JSON que organiza os feedbacks de forma estruturada, categorizando-os em positivos, negativos e sugestões.
  • Exemplo de Estrutura de Output:
     {
      "feedbacks": {
        "positivos": ["Ambiente acolhedor e seguro.", "Professores atenciosos."],
        "negativos": ["Salas de aula muito quentes.", "Falta de materiais didáticos."],
        "sugestoes": ["Incluir mais atividades extracurriculares.", "Melhorar a ventilação nas salas."]
      }
    } 
  • Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 nenhum agente subsequente.
  • Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Clima Escolar (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 Clima Escolar (RF 2).

RF 2. Agente de Análise de Clima Escolar

2.1 Tarefa do Agente

Analisar os dados coletados para gerar relatórios detalhados sobre o clima escolar.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados de feedbacks coletados de alunos e professores.

# 2. Objetivo
Analisar os dados coletados para gerar relatórios detalhados sobre o clima escolar.

# 3. Regras que você deve seguir para gerar sua resposta
- Realize uma análise quantitativa e qualitativa dos feedbacks para identificar tendências e padrões.
- Compare os dados atuais com benchmarks anteriores para avaliar mudanças no clima escolar.
- Identifique áreas críticas que necessitam de atenção imediata e destaque-as no relatório.
- Utilize visualizações de dados para facilitar a compreensão dos resultados por parte dos stakeholders.
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 de feedbacks coletados.
  • 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 texto com até 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório detalhado em formato Markdown que descreve o clima escolar, incluindo visualizações de dados e áreas críticas de melhoria.
  • Exemplo de Estrutura de Output:
     **Relatório de Clima Escolar**
    
    **Tendências Identificadas:**
    - Aumento no feedback positivo sobre a segurança escolar.
    - Necessidade urgente de melhorar as condições das salas de aula.
    
    **Visualizações:**
    ![Gráfico de Tendências](url_para_grafico)
    
    **Áreas Críticas:**
    1. Ventilação inadequada nas salas de aula.
    2. Falta de materiais didáticos adequados.
    
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 4.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 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 Proposição de Melhorias (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 (RF 3).

RF 3. Agente de Proposição de Melhorias

3.1 Tarefa do Agente

Propor melhorias com base nos dados analisados para promover um ambiente escolar mais positivo.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo relatórios detalhados sobre o clima escolar.

# 2. Objetivo
Propor melhorias com base nos dados analisados para promover um ambiente escolar mais positivo.

# 3. Regras que você deve seguir para gerar sua resposta
- Desenvolva propostas de melhorias específicas e acionáveis baseadas nas áreas críticas identificadas.
- Priorize as propostas de acordo com o impacto potencial e a viabilidade de implementação.
- Inclua recomendações para monitoramento contínuo das melhorias implementadas.
- Considere feedbacks adicionais de stakeholders para refinar e ajustar as propostas de melhorias.
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: Relatórios detalhados sobre o clima escolar.
  • 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 documento em formato Markdown contendo propostas de melhorias para o ambiente escolar.
  • Exemplo de Estrutura de Output:
     **Propostas de Melhorias para o Clima Escolar**
    
    **Melhorias Sugeridas:**
    1. Instalação de ventiladores em todas as salas de aula para melhorar a ventilação.
    2. Aquisição de novos materiais didáticos para todas as disciplinas.
    
    **Recomendações de Monitoramento:**
    - Revisar o clima escolar trimestralmente para avaliar a eficácia das melhorias implementadas.
    
  • Número de caracteres esperado: O documento gerado deve ter um tamanho estimado em 3.500 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 documentos externos.
  • 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 documento gerado deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.