Agente de IA para Análise de Participação em Atividades Escolares

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

Como criar um agente de IA que analisa dados de participação dos alunos em atividades escolares e identifica correlações com o desempenho acadêmico.

1. Propósito e Escopo

Este documento define todos os prompts e detalhes de requisitos para o Fluxo de Agentes "Análise de Participação em Atividades Escolares", uma solução de automação projetada para analisar a participação dos alunos em atividades escolares e identificar correlações com o desempenho acadêmico. 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 dados de participação em insights acionáveis que possam melhorar o desempenho acadêmico dos alunos, fornecendo recomendações baseadas em correlações identificadas.

2. Contexto e Problema

Cenário Atual

As escolas enfrentam dificuldades para correlacionar a participação dos alunos em atividades extracurriculares com o desempenho acadêmico. Faltam insights claros sobre o impacto dessas atividades no aprendizado, o que impede a elaboração de estratégias eficazes para melhorar o engajamento e o desempenho dos alunos.


Problemas Identificados

  • Dificuldade em correlacionar participação e desempenho: Há uma falta de ferramentas eficazes para análise e identificação de correlações entre participação em atividades e desempenho acadêmico.
  • Falta de insights sobre impacto: As escolas não possuem dados suficientes para entender como as atividades extracurriculares influenciam o aprendizado e o desempenho dos alunos.

3. Impactos Esperados

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

  • Identificação de correlações significativas entre participação em atividades e desempenho acadêmico.
  • Fornecimento de insights acionáveis para melhorar o engajamento dos alunos em atividades que impactam positivamente seu desempenho.
  • Apoio à tomada de decisão das escolas na elaboração de estratégias de engajamento baseadas em dados concretos.

4. Visão Geral da Solução

O agente de IA para análise de participação em atividades escolares coleta e analisa dados de participação dos alunos, identifica correlações com o desempenho acadêmico e fornece insights sobre o impacto das atividades extracurriculares no aprendizado. 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 e melhoria do desempenho acadêmico dos alunos.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a coleta e análise dos dados de participação e termina com a geração de insights acionáveis.

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

Agentes Função Principal
Agente de Coleta e Análise de Dados de Participação (RF 1) Coletar e analisar dados de participação dos alunos em atividades escolares.
Agente de Identificação de Correlações (RF 2) Identificar correlações entre a participação em atividades escolares e o desempenho acadêmico.
Agente de Geração de Insights (RF 3) Fornecer insights sobre o impacto das atividades extracurriculares no aprendizado.

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 e Análise de Dados de Participação

1.1 Tarefa do Agente

Coletar e analisar dados de participação dos alunos em atividades escolares.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de participação dos alunos em atividades escolares em formato CSV ou planilha. Estes dados incluem informações como data, tipo de atividade, duração, frequência e presença dos alunos.

# 2. Objetivo
Coletar e analisar os dados de participação para preparar as informações necessárias para identificar correlações com o desempenho acadêmico.

# 3. Regras que você deve seguir para gerar sua resposta
- Colete dados de participação em todas as atividades escolares disponíveis.
- Inclua informações como data, tipo de atividade, duração, frequência e presença dos alunos.
- Analise a frequência e o tipo de participação dos alunos em cada atividade.
- Classifique se a participação é voluntária ou obrigatória e registre padrões de engajamento dos alunos.

# 4. Exemplo de Output que você deve produzir
{
  "dados_participacao_analisados": true,
  "detalhes": {
    "atividade": "Futebol",
    "data": "2025-11-15",
    "participacao": "Voluntária",
    "frequencia": "Semanal",
    "presenca": 30
  }
} 
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 dados de participação dos 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 de um arquivo CSV na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo é um arquivo CSV ou planilha contendo dados de participação dos alunos em atividades escolares.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .xlsx.
  • 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 JSON estruturado com dados de participação analisados e preparados para correlação.
  • Exemplo de Estrutura de Output:
     {
      "dados_participacao_analisados": true,
      "detalhes": {
        "atividade": "Futebol",
        "data": "2025-11-15",
        "participacao": "Voluntária",
        "frequencia": "Semanal",
        "presenca": 30
      }
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.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 Identificação de Correlações (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação de Correlações (RF 2).

RF 2. Agente de Identificação de Correlações

2.1 Tarefa do Agente

Identificar correlações entre a participação em atividades escolares e o desempenho acadêmico.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de participação analisados em formato JSON. Este JSON contém informações detalhadas sobre a frequência e o tipo de participação dos alunos em atividades escolares.

# 2. Objetivo
Identificar correlações estatisticamente significativas entre a participação em atividades escolares e o desempenho acadêmico dos alunos.

# 3. Regras que você deve seguir para gerar sua resposta
- Identifique correlações estatisticamente significativas entre participação e desempenho acadêmico, aplicando métodos de análise de correlação como Pearson ou Spearman.
- Considere variáveis como tipo de atividade, frequência de participação e notas dos alunos.
- Ajuste por variáveis de confusão como idade e gênero quando necessário.

# 4. Exemplo de Output que você deve produzir
{
  "correlacoes_identificadas": true,
  "detalhes": {
    "atividade": "Futebol",
    "correlacao": 0.65,
    "significancia": "p < 0.05"
  }
} 
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 com dados de participação analisados.
  • 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é 1.500 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo as correlações identificadas entre participação e desempenho acadêmico.
  • Exemplo de Estrutura de Output:
     {
      "correlacoes_identificadas": true,
      "detalhes": {
        "atividade": "Futebol",
        "correlacao": 0.65,
        "significancia": "p < 0.05"
      }
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.200 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.
  • Calculadora: Utiliza lógica interna para cálculos estatísticos.
  • 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 Insights (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 Insights (RF 3).

RF 3. Agente de Geração de Insights

3.1 Tarefa do Agente

Fornecer insights sobre o impacto das atividades extracurriculares no aprendizado.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de correlações identificadas em formato JSON. Este JSON contém informações sobre as correlações significativas entre a participação em atividades escolares e o desempenho acadêmico dos alunos.

# 2. Objetivo
Gerar insights claros e acionáveis com base nas correlações identificadas, fornecendo um relatório que destaque atividades com maior impacto positivo no desempenho acadêmico.

# 3. Regras que você deve seguir para gerar sua resposta
- Gere insights claros e acionáveis com base nas correlações identificadas.
- Inclua gráficos e tabelas para ilustrar os principais achados.
- Destaque atividades que possuem maior impacto positivo no desempenho acadêmico.
- Sugira recomendações para aumentar a participação nas atividades mais benéficas.

# 4. Exemplo de Output que você deve produzir
**Relatório de Insights - Impacto das Atividades Extracurriculares no Aprendizado**

- **Atividade:** Futebol
- **Correlação com Desempenho:** 0.65
- **Significância:** p < 0.05

### Insights
O futebol demonstrou uma correlação positiva significativa com o desempenho acadêmico dos alunos. Recomenda-se aumentar a participação dos alunos nesta atividade para potencializar seus benefícios educacionais.
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 JSON contendo as correlações identificadas.
  • 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é 1.200 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório em markdown com insights sobre o impacto das atividades extracurriculares no aprendizado.
  • Exemplo de Estrutura de Output:
     **Relatório de Insights - Impacto das Atividades Extracurriculares no Aprendizado**
    
    - **Atividade:** Futebol
    - **Correlação com Desempenho:** 0.65
    - **Significância:** p < 0.05
    
    ### Insights
    O futebol demonstrou uma correlação positiva significativa com o desempenho acadêmico dos alunos. Recomenda-se aumentar a participação dos alunos nesta atividade para potencializar seus benefícios educacionais.
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em torno de 2.000 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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 (relatório de insights) é 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 ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.