Agente de IA para Feedback Automatizado de Provas

Estruturar a prova, consolidar o gabarito e padronizar critérios de correção para uso pelos agentes seguintes.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio do objeto da prova e gabarito 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: O input inicial é um objeto JSON contendo a estrutura da prova e o gabarito.
• 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é 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo a prova normalizada e critérios de correção padronizados.
• Exemplo de Estrutura de Output:

   {
    "prova_normalizada": {
      "nota_maxima": 10,
      "criterios_globais": null
    },
    "questoes": [
      {
        "id": "Q1",
        "tipo": "objetiva",
        "peso": 1,
        "resposta_esperada": "A",
        "alternativas_validas": ["A"],
        "criterios_correcao": [
          {
            "criterio_id": "c1",
            "descricao": "Compreensão do conceito",
            "peso_relativo": 50,
            "observavel": true
          }
        ],
        "palavras_chave": {
          "obrigatorias": ["conceito"],
          "opcionais": []
        },
        "regras_objetivas": {
          "case_insensitive": true,
          "ignore_acentos": true,
          "aceitar_sinonimos": true
        }
      }
    ],
    "glossario_sinonimos": {}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Avaliação de Respostas por Aluno (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Avaliação de Respostas por Aluno (RF 2).

Comparar as respostas do aluno com a prova normalizada, atribuir notas por questão e produzir justificativas objetivas.

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 as respostas do aluno e a prova normalizada.
• 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é 25.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON de avaliação por aluno, detalhando notas e justificativas por questão.
• Exemplo de Estrutura de Output:

   {
    "aluno": {
      "id": "12345",
      "nome": "João Silva"
    },
    "resultado_geral": {
      "nota_total": 8.5,
      "nota_maxima": 10,
      "percentual": 85
    },
    "por_questao": [
      {
        "id": "Q1",
        "tipo": "objetiva",
        "peso": 1,
        "status": "correta",
        "nota_obtida": 1,
        "justificativa_curta": "Resposta correta conforme gabarito.",
        "evidencias": {
          "trechos_corretos": [],
          "palavras_chave_encontradas": [],
          "erros_identificados": []
        },
        "metadados": {
          "uso_sinonimos": false
        }
      }
    ],
    "agregados": {
      "pontos_fortes": [
        {
          "habilidade": "Compreensão de texto",
          "evidencias": "Questões objetivas corretas"
        }
      ],
      "oportunidades": [
        {
          "habilidade": "Interpretação de gráficos",
          "lacunas": "Dificuldade em identificar tendências"
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Feedback Personalizado ao Aluno (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Feedback Personalizado ao Aluno (RF 3).

Transformar a avaliação técnica em um feedback claro, encorajador e acionável para o aluno.

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 a avaliação do aluno como input.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um texto em Markdown, estruturado em seções conforme definido no prompt.
• Exemplo de Estrutura de Output:

   ## Resumo da sua prova
  Você obteve 8.5 de um total de 10, o que corresponde a 85% de acertos. Parabéns pelo seu esforço!
  
  ## Pontos fortes
  - Compreensão de texto (Questões objetivas corretas)
  
  ## Oportunidades de melhoria
  - Interpretação de gráficos: Dificuldade em identificar tendências.
  
  ## Recomendações práticas
  - Refazer 4 questões de frações equivalentes em 15 min e revisar erros.
  
  ## Revisão por questão
  - **Q1**: Correta. Resposta correta conforme gabarito.
  
  ## Próximos passos
  Continue praticando as áreas identificadas para melhorar ainda mais seu desempenho. 

• Número de caracteres esperado: O texto gerado terá um tamanho aproximado de 3.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Relatório Sintético para Professor (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatório Sintético para Professor (RF 4).

Consolidar múltiplas avaliações de alunos em um panorama da turma destacando padrões, itens discriminativos e prioridades de reensino.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber múltiplas avaliações de alunos como input.
• 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é 50.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado e um texto em Markdown com o panorama da turma.
• Exemplo de Estrutura de Output:

   {
    "resumo_turma": {
      "media": 7.5,
      "mediana": 7.8,
      "desvio": 1.2,
      "taxa_acerto_global": 75
    },
    "dificuldades_top": [
      {
        "topico": "Interpretação de gráficos",
        "taxa_acerto": 60,
        "questoes_relacionadas": ["Q3", "Q5"]
      }
    ],
    "itens_facilitadores": [
      {
        "id": "Q1",
        "taxa_acerto": 90
      }
    ],
    "dispersao_por_questao": [
      {
        "id": "Q1",
        "media": 8,
        "desvio": 0.5
      }
    ],
    "recomendacoes_coletivas": [
      "Revisar conceitos de interpretação de gráficos com exemplos práticos."
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 15.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O JSON consolidado e o resumo em Markdown são os resultados que devem ser disponibilizados ao professor.