Agente de IA para Análise de Eficácia de Métodos de Ensino

Validar, higienizar e padronizar o conjunto de dados de desempenho dos alunos e métodos de ensino, garantindo consistência mínima para análises comparativas.

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 tabular (CSV ou JSON) contendo dados de desempenho dos alunos e métodos de ensino. 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 tabular contendo dados educacionais.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 150.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com dados padronizados, métricas de qualidade, e indicadores de validação.
• Exemplo de Estrutura de Output:

   {
    "dados_padronizados": [...],
    "relatorio_qualidade": {
      "linhas_totais": 1000,
      "linhas_validas": 950,
      "duplicidades": 5,
      "valores_ausentes_por_campo": {...},
      "outliers_detectados_por_regra": {...},
      "amplitude_notas": "0-100",
      "escala_detectada": 100
    },
    "dicionario_de_dados": {...},
    "mapeamento_metodos": {...},
    "indicadores_validacao": {
      "aprovado_para_analise": true,
      "motivos_reprovação": [],
      "qualidade_score": 85
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados.

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 Eficácia e Correlação de Métodos (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 Eficácia e Correlação de Métodos (RF 2).

Estimar a eficácia relativa dos métodos de ensino e correlacioná-los com o desempenho dos alunos, produzindo métricas comparativas e evidências de robustez.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo dados padronizados e aprovados para análise.
• 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é 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON analítico contendo estatísticas por método, comparações, ranking, análises estratificadas, sinais de sesgo e confounding, limitações estatísticas e recomendações preliminares.
• Exemplo de Estrutura de Output:

   {
    "estatisticas_por_metodo": {
      "metodo_a": {
        "n": 50,
        "media": 75.4,
        "mediana": 78,
        "p25": 70,
        "p75": 80,
        "desvio_padrao_aprox": 5.6,
        "proporcao_top10": 0.2,
        "proporcao_aprovacao": 0.85
      }
    },
    "comparacoes_pares": [...],
    "ranking_metodos": [...],
    "analises_estratificadas": [...],
    "sinais_de_sesgo_e_confounding": [...],
    "limitacoes_estatisticas": [...],
    "recomendacoes_preliminares": [...]
  } 

• Número de caracteres esperado: O JSON gerado deve ser informativo e detalhado, com um tamanho estimado em torno de 10.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: Utiliza lógica interna para cálculos estatísticos.
• 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 Síntese e Recomendações Pedagógicas (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese e Recomendações Pedagógicas (RF 3).

Gerar um relatório executivo e técnico que traduza os achados estatísticos em decisões pedagógicas acionáveis, com limitações e próximos passos claros.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber como input um JSON analítico e um relatório de qualidade.
• 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é 25.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em markdown estruturado com sumário executivo, achados por método, comparações, robustez e limitações, recomendações pedagógicas, métricas a monitorar e apêndice de metodologia.
• Exemplo de Estrutura de Output:

   # Relatório de Análise de Métodos de Ensino
  
  ## Sumário Executivo
  - Método A mostrou maior eficácia geral.
  - Recomendações incluem aumento de carga horária para método B.
  
  ## Principais Achados
  | Método | Média | Mediana | Desvio Padrão |
  |--------|-------|---------|---------------|
  | A      | 75.4  | 78      | 5.6           |
  
  ## Comparações
  - Método A vs B: +6,5 pontos na média.
  
  ## Robustez e Limitações
  - Amostra pequena para Método C.
  
  ## Recomendações Pedagógicas
  - Método A recomendado para turmas grandes.
  
  ## Apêndice
  - Metodologia: cálculo de médias, mediana, um-versus-rest.
  

• Número de caracteres esperado: O relatório gerado deve ser detalhado e abrangente, com um tamanho estimado em torno de 15.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 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 (relatório em markdown) é 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.