Agente de IA para Análise de Desempenho Estudantil

Validar, higienizar e padronizar dados de desempenho acadêmico de alunos, unificando formatos e calculando variáveis derivadas para análise.

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 CSV ou JSON com registros de desempenho acadêmico 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Arquivo CSV ou JSON contendo registros de avaliações acadêmicas.
• Formatos Suportados: .csv, .json
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: JSON padronizado com dados validados e um resumo de qualidade dos dados.
• Exemplo de Estrutura de Output:

   {
    "data_standardized": [
      {
        "student_id": "12345",
        "subject": "Mathematics",
        "score": 85,
        "max_score": 100,
        "score_pct": 85.0,
        "weighted_score": 85.0
      }
    ],
    "data_quality_summary": {
      "errors": [],
      "warnings": []
    },
    "schema_version": "1.0.0"
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 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: Utiliza lógica interna para cálculos de normalização e validação.
• 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 Desempenho Acadêmico.

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Desempenho Acadêmico.

Calcular métricas por aluno, por disciplina e de coorte, identificar tendências, pontos fortes, lacunas e riscos acadêmicos a partir dos dados padronizados.

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 padronizado contendo dados de desempenho acadêmico validados.
• Formatos Suportados: .json
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: JSON analytical_summary com métricas por aluno e por disciplina, tendências, classificações e recomendações.
• Exemplo de Estrutura de Output:

   {
    "analytical_summary": {
      "students": [
        {
          "student_id": "12345",
          "media_geral_aluno": 85.0,
          "subjects": [
            { "subject": "Mathematics", "media": 85.0, "classificacao": "Excellent" }
          ],
          "risco_aprendizagem": false
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.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 de métricas e análises.
• 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 Geração de Relatório para Pais e Educadores.

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório para Pais e Educadores.

Transformar o analytical_summary em relatórios claros, segmentados para pais e educadores, destacando sucessos, áreas de melhoria e próximos passos acionáveis.

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: JSON analytical_summary contendo métricas de desempenho acadêmico.
• Formatos Suportados: .json
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: Relatório em Markdown com seções para pais e educadores, incluindo um bloco JSON embutido com KPIs.
• Exemplo de Estrutura de Output:

   # Relatório de Desempenho Acadêmico
  ## Aluno: Nome do Aluno
  ### Panorama Geral
  - Média Geral: 85.0
  - Classificação: Excellent
  ### Disciplinas
  | Disciplina | Média | Classificação |
  |------------|-------|---------------|
  | Mathematics | 85.0 | Excellent |
  ### Recomendações
  - [Alta] study_plan — Revisar tópicos de matemática (Mathematics)
  ### Próximos Passos
  1. Semana 1: Diagnóstico e plano
  2. Semana 2-3: Prática e tutoria
  3. Semana 4: Reavaliação
  ### JSON Resumo
  {
    "student_id": "12345",
    "media_geral_aluno": 85.0,
    "classificacao_geral": "Excellent"
  } 

• Número de caracteres esperado: O relatório gerado em Markdown terá um tamanho aproximado de 6.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 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.