Agente de IA para Análise de Dados de Avaliação Escolar

Consolidar dados de avaliações escolares de forma eficiente.

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 avaliações em formato CSV via API após o término do período de avaliações. Na fase de testes, os dados serão enviados para o agente diretamente por upload do CSV na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo CSV contendo dados de avaliações escolares.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv.
• 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 consolidado, estruturado com chaves por 'turma' e 'disciplina', incluindo médias de notas e metadados.
• Exemplo de Estrutura de Output:

   {
    "turma": "3A",
    "disciplina": "Matemática",
    "media_nota": 8.5,
    "data_avaliacao": "10/11/2025",
    "total_alunos": 30
  } 

• Número de caracteres esperado: O JSON final deve ser conciso, com um tamanho estimado em torno de 2.000 caracteres, podendo variar conforme o número de turmas e disciplinas.

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 médias.
• 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 Interpretação de Dados 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 Interpretação de Dados de Desempenho (RF 2).

Interpretar dados consolidados para identificar tendências e padrões de desempenho.

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 como input um objeto JSON consolidado gerado pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 relatório em formato **Markdown** destacando tendências e padrões no desempenho escolar, incluindo visualizações gráficas simples.
• Exemplo de Estrutura de Output:

   ### Relatório de Desempenho Escolar
  
  **Tendências Identificadas:**
  - A turma 3A mostrou uma melhoria significativa nas notas de Matemática ao longo do ano.
  - A disciplina de Ciências apresentou uma variação de desempenho entre as turmas, sugerindo a necessidade de revisão curricular.
  
  **Gráficos:**
  - ![Gráfico de Tendência de Matemática](url_do_grafico)

• Número de caracteres esperado: O texto final do relatório deve ter um tamanho estimado em torno de 3.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 análise de dados e geração de gráficos.
• 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 (relatório em Markdown) é 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. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.