Agente de IA para Elaboração de Relatórios de Desempenho Estudantil

Receber dados de avaliações contínuas em formatos variados e produzir um conjunto padronizado, consistente e pronto para análise por aluno e por competência.

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 contínuas 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 de um arquivo na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de registros em CSV/JSON com dados de avaliações.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .json.
• 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 JSON com dados normalizados e metadados de validação.
• Exemplo de Estrutura de Output:

   {
    "dados_normalizados": [
      {
        "aluno_id": "123",
        "avaliacao_id": "456",
        "data": "2023-12-24",
        "nota_normalizada": 85,
        "peso": 1,
        "competencia_id": "789",
        "competencia_nome": "Matemática",
        "disciplina_id": "101",
        "turma_id": "202",
        "tentativa": 1,
        "modalidade": "regular",
        "flag_falta": false,
        "origem_escala": "fornecida"
      }
    ],
    "metadados_validacao": {
      "registros_recebidos": 1000,
      "registros_validos": 950,
      "registros_descartados": 50,
      "motivos_descartes": [
        {
          "avaliacao_id": "789",
          "motivo": "Data inválida"
        }
      ],
      "regras_aplicadas": ["normalizacao_nota", "tratamento_faltas"]
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a quantidade de registros processados.

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 Cálculo de Indicadores e Diagnóstico 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 Cálculo de Indicadores e Diagnóstico de Desempenho (RF 2).

Calcular indicadores por aluno e por competência, identificar forças e lacunas, e classificar o status de domínio por competência.

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 dados normalizados e metadados de validação.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com indicadores gerais e por competência para cada aluno.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "indicadores_gerais": {
      "media_ponderada_geral": 85.0,
      "n_avaliacoes_validas": 10,
      "recencia_aplicada": true
    },
    "por_competencia": [
      {
        "competencia_id": "789",
        "competencia_nome": "Matemática",
        "media_ponderada": 90.0,
        "n_avaliacoes": 5,
        "status_dominio": "atingida",
        "tendencia_ultimas_avaliacoes": {
          "janela": 5,
          "inclinacao": 5.0,
          "variacao": 2.0
        },
        "dispersao": {
          "desvio_padrao": 10.0
        }
      }
    ],
    "forcas_top3": ["Matemática"],
    "oportunidades_top3": ["Ciências"],
    "flags_risco": {
      "baixo_engajamento": false,
      "queda_recente": false,
      "poucos_dados": false
    },
    "parametros_utilizados": {
      "limiar_dominio": 70,
      "janela_tendencia": 5,
      "min_avaliacoes_por_competencia": 3
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 caracteres, podendo variar conforme a quantidade de dados analisados.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculo de indicadores e tendências.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Gerador de Relatórios Individualizados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente Gerador de Relatórios Individualizados (RF 3).

Produzir relatório por aluno com síntese executiva, competências atingidas, áreas de melhoria e recomendações objetivas, pronto para entrega a responsáveis e equipe pedagógica.

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: Este agente deve ser apto a receber indicadores de desempenho por aluno e por competência.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON por aluno com resumo executivo, competências atingidas, áreas de melhoria e recomendações.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "resumo_executivo": "O aluno apresentou um excelente desempenho em Matemática, mas precisa focar mais em Ciências.",
    "competencias_atingidas": ["Matemática", "Inglês"],
    "areas_de_melhoria": ["Ciências"],
    "recomendacoes_priorizadas": [
      "Realizar 3 exercícios de frações equivalentes por semana por 4 semanas",
      "Participar de grupos de estudo em Ciências"
    ],
    "proxima_meta_smart": {
      "competencia_alvo": "Ciências",
      "valor_meta": 70,
      "prazo_dias": 30,
      "criterio_sucesso": "média ponderada >= 70 com n_avaliacoes>=3"
    },
    "evidencias_chave": [
      {
        "competencia_id": "789",
        "notas_recentesserie": [
          {"data": "2023-12-01", "nota_normalizada": 60.0},
          {"data": "2023-12-15", "nota_normalizada": 65.0}
        ]
      }
    ],
    "comparativos_opcionais": {
      "media_aluno": 75.0,
      "media_turma": 70.0
    },
    "anexos_graficos": {
      "serie_geral": "...",
      "series_por_competencia": "..."
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.500 caracteres, podendo variar conforme os dados de cada aluno.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculo de metas e recomendações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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.