Agente de IA para Avaliação de Desempenho de Alunos

Consolidar e analisar dados de provas e atividades para cada aluno, produzindo um diagnóstico padronizado por habilidade/competência, progresso temporal e comparativos por turma/disciplina.

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 desempenho dos alunos em formato CSV, planilha ou JSON via API. Na fase de testes, os dados serão enviados diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Dados estruturados de desempenho dos alunos.
• Formatos Suportados: .csv, .xlsx, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON normalizado por aluno contendo um resumo geral, progresso, competências, comparativos, riscos e qualidade dos dados.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "resumo_geral": {
      "media_ponderada_0_100": 85.0,
      "mediana_0_100": 82.0,
      "percentil_turma": 90,
      "zscore_turma": 1.5
    },
    "progresso": {
      "tendencia_recente": "estável",
      "variacao_ultimas_avaliacoes": 2.0,
      "estabilidade": "alta"
    },
    "competencias": [
      {
        "competencia": "Matemática",
        "score_0_100": 88.0,
        "dominio": "alto",
        "evidencias": ["Prova 1", "Prova 2"]
      }
    ],
    "riscos": {
      "classificacao": "baixo",
      "motivos": []
    },
    "qualidade_dados": {
      "campos_faltantes": [],
      "outliers_detectados": false,
      "registros_ausentes": 0,
      "taxa_completude": 100
    }
  } 

• Número de caracteres esperado: O JSON de output deve ter um tamanho aproximado de 3.000 caracteres por aluno.

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: Utiliza lógica interna para cálculos estatísticos e normalização de notas.
• 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 Geração de Relatórios Personalizados (RF 2).

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

Produzir, para cada aluno, um relatório claro e acionável com insights sobre progresso, pontos fortes, lacunas por competência e um plano de estudo personalizado.

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: JSON analítico por aluno gerado pelo agente anterior.
• Formatos Suportados: .json
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 3.000 caracteres por aluno.

2.3.2 Especificação do Output

• Formato de output: Relatórios personalizados por aluno em formato Markdown ou JSON-text, contendo resumo executivo, destaques, progresso e plano de estudo.
• Exemplo de Estrutura de Output:

   # Relatório de Desempenho
  
  **Nome do Aluno:** João Silva
  **Turma:** 3A
  **Data de Geração:** 05/12/2025
  
  ## Resumo Executivo
  - João tem um desempenho consistente em Matemática, com uma média ponderada de 85.
  - Necessita melhorar em Ciências, onde apresenta um score de 58.
  
  ## Destaques
  ### Forças
  - Matemática: Score de 88, com bom domínio de álgebra.
  
  ### Oportunidades
  - Ciências: Score de 58, com dificuldades em conceitos básicos de física.
  
  ## Progresso
  - Tendência recente: Estável.
  - Percentil na turma: 75.
  
  ## Plano de Estudo (2-4 semanas)
  - **Metas SMART:** Atingir >=70 em Ciências em 4 semanas.
  - **Estratégias:** Revisão semanal de conceitos básicos com exercícios práticos.
  

• Número de caracteres esperado: O relatório gerado deve ter um tamanho aproximado de 1.500 a 2.500 caracteres por aluno.

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 representa o resultado final do fluxo e é entregue diretamente ao usuário.

2.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.