Agente de IA para Análise de Dados de Participação Estudantil

Ler a planilha de participação estudantil recebida e preparar um script de consolidação (Python/pandas) e parâmetros de agregação para cálculo de métricas de engajamento.

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 um arquivo de dados de participação estudantil 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 arquivo .csv ou .xlsx.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .xlsx.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com o script de consolidação e parâmetros necessários.
• Exemplo de Estrutura de Output:

   {"analysis_type": "consolidacao_participacao_estudantil","period_reference": {"inicio": "2025-01-01","fim": "2025-12-31"},"keys_unicas": ["aluno_id", "data", "atividade"],"dimensoes": ["serie", "turma", "atividade", "tipo_atividade", "turno", "canal"],"metricas": {"freq_presenca": "mean(presenca)","soma_presencas": "sum(presenca)","participacoes_unicas": "nunique(atividade)","tempo_total_min": "sum(duracao_min)"},"janelas_tempo": {"semanal": true, "mensal": true, "trimestre": true},"limpeza": {"deduplicar_por": ["aluno_id","data","atividade"],"normalizar_datas": true, "corrigir_tipo_numerico": ["presenca","duracao_min"], "descartar_registros_sem_aluno_id": true},"regras_faltantes": {"presenca_nula_tratar_com": 0, "duracao_min_nula_tratar_com": 0},"python_script": "# Script pandas: ler df, padronizar tipos, deduplicar e gerar agregados por janelas; retornar dict com tabelas agregadas e kpis globais"} 

• Número de caracteres esperado: O JSON gerado deve ter 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 Execução de Consolidação em Python (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consolidação em Python (RF 2).

Executar, em ambiente Python externo, o script e parâmetros preparados para consolidar os dados de participação estudantil e retornar métricas agregadas.

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 um objeto JSON com o script e parâmetros de consolidação, acompanhado do arquivo de dados original.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json, .csv, .xlsx.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 100.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com as métricas agregadas de participação estudantil.
• Exemplo de Estrutura de Output:

   {"kpis_globais": {"alunos_total": 0, "taxa_presenca_media": 0.0, "participacoes_totais": 0, "tempo_total_min": 0}, "tabelas": {"por_turma": [{"turma": "A", "taxa_presenca_media": 0.87, "participacoes_totais": 320, "tempo_total_min": 14500}], "por_serie": [], "por_atividade": [], "series_temporais_mensal": []}, "qualidade_dados": {"linhas_descartadas_sem_aluno_id": 0, "registros_fora_periodo": 0, "colunas_criticas_ausentes": []}} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa script em ambiente Python externo.

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 Análise e Recomendações de Engajamento Estudantil (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise e Recomendações de Engajamento Estudantil (RF 3).

Interpretar os dados consolidados de participação, identificar padrões e áreas de baixa participação e produzir um relatório com insights e recomendações práticas para aumentar o engajamento.

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 um objeto JSON com as métricas consolidadas de participação estudantil.
• 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 até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório formatado em Markdown, contendo sumário executivo, KPIs globais, padrões e tendências, áreas de baixa participação, drivers e hipóteses, recomendações priorizadas, plano 30-60-90 dias e anexos sobre qualidade de dados.
• Exemplo de Estrutura de Output:

   # Relatório de Participação Estudantil
  
  ## Sumário Executivo
  - Principais achados em até 5 bullets.
  
  ## KPIs Globais
  - Alunos totais: X
  - Taxa média de presença: Y%
  - Participações totais: Z
  - Tempo total acumulado: T min
  
  ## Padrões e Tendências
  - Destaques por série, turma, tipo de atividade e canal.
  
  ## Áreas de Baixa Participação (Risco)
  - Listas priorizadas de turmas/séries/atividades abaixo de limiares.
  
  ## Drivers e Hipóteses
  - Fatores correlacionados.
  
  ## Recomendações Priorizadas (Impacto x Esforço)
  - Tabela com ação, racional, impacto esperado, esforço, responsável sugerido, prazo.
  
  ## Plano 30-60-90 dias
  - Ações rápidas, ajustes estruturais e consolidação.
  
  ## Anexos
  - Notas sobre qualidade de dados e limitações.
  
   

• Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 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 documentos externos.
• 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 ao usuário.