Agente de IA para Avaliação de Desempenho Acadêmico de Alunos

Coletar e analisar dados de avaliações, trabalhos e participação dos alunos para identificar padrões de desempenho e áreas de melhoria.

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 acadêmicos em formato CSV ou planilha 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 do arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo são dados acadêmicos em formato CSV ou planilha.
• 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 até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo a análise preliminar dos dados coletados, incluindo padrões de desempenho e áreas de melhoria identificadas.
• Exemplo de Estrutura de Output:

   {
    "analise_preliminar": {
      "padroes_desempenho": [
        {
          "aluno_id": "123",
          "desempenho_geral": "acima da média",
          "areas_melhoria": ["matemática", "ciências"]
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, podendo variar conforme a quantidade de dados analisados.

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: Utiliza lógica interna para cálculos de métricas.
• 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 de Desempenho (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 de Desempenho (RF 2).

Gerar relatórios detalhados e personalizados sobre o desempenho acadêmico dos alunos, com base na análise preliminar dos dados.

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 JSON estruturado com a análise preliminar dos dados dos alunos.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de relatórios de desempenho acadêmico detalhados em formato Markdown, incluindo insights e sugestões de melhoria para cada aluno.
• Exemplo de Estrutura de Output:

   **Relatório de Desempenho Acadêmico**
  
  **Aluno:** João Silva
  
  **Desempenho Geral:** Acima da média
  
  **Áreas de Melhoria:** Matemática, Ciências
  
  **Sugestões de Melhoria:**
  - Reforçar conceitos de álgebra básica
  - Participar de grupos de estudo em ciências
  
  **Visualizações:**
  - Gráficos de desempenho por matéria
  - Tabelas de frequência de participação 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 7.000 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 documentos externos.
• Calculadora: Utiliza lógica interna para gerar visualizações de dados.
• 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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. Os relatórios gerados são o resultado que deve ser disponibilizado ao usuário.