Agente de IA para Feedback Automático sobre Avaliações

Consolidar e padronizar critérios avaliativos a partir das instruções/rubricas fornecidas ou aplicar uma rubrica padrão quando ausentes.

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 objeto JSON contendo as instruções de avaliação 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um objeto JSON com as instruções de avaliaçã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 texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON chamado rubric_estruturada que contém os critérios padronizados para avaliação.
• Exemplo de Estrutura de Output:

   {
    "criterios": [
      {
        "id": "aderencia_ao_tema",
        "nome": "Adesão ao Tema",
        "descricao": "Avalia se o trabalho está alinhado com o tema proposto.",
        "exemplos_de_evidencia_aceita": "Discussão clara sobre o tema.",
        "niveis_desempenho": {
          "atende_plenamente": "O trabalho é totalmente aderente ao tema.",
          "atende_parcialmente": "O trabalho aborda o tema, mas com desvios.",
          "nao_atende": "O trabalho não está relacionado ao tema proposto."
        },
        "obrigatorio": true
      }
    ],
    "requisitos_formatacao": [
      {
        "norma": "ABNT",
        "elementos_exigidos": ["Capa", "Sumário", "Numeração de Páginas"]
      }
    ],
    "requisitos_entrega": [
      {
        "item": "Prazo",
        "condicao": "Deve ser entregue até a data estipulada."
      }
    ],
    "observacoes_gerais": "Os critérios são baseados nas normas padrão de avaliação da instituição.",
    "versao_rubrica": "2025-12",
    "origem_rubrica": "padrao"
  } 

• Número de caracteres esperado: O JSON de output deve ser claro e estruturado, com um tamanho estimado em torno de 2.500 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: 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 Análise do Trabalho do Aluno (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise do Trabalho do Aluno (RF 2).

Comparar a submissão do aluno com a rubrica estruturada e produzir um diagnóstico criterioso, com evidências textuais direta e indiretamente observáveis.

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 contendo a submissão do aluno e a rubrica estruturada.
• 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 texto com até 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON chamado diagnostico que contém o diagnóstico criterioso da submissão do aluno.
• Exemplo de Estrutura de Output:

   {
    "resumo_geral": {
      "aderencia_ao_pedido": true,
      "principais_forcas": ["Clareza na argumentação", "Uso adequado de referências"],
      "principais_lacunas": ["Faltou conclusão"]
    },
    "por_criterio": [
      {
        "criterio_id": "aderencia_ao_tema",
        "nivel": "atende_plenamente",
        "evidencias": ["Discussão clara sobre o tema."],
        "lacunas": [],
        "sugestoes_pontuais": []
      }
    ],
    "conformidade_formatacao": {
      "itens_ok": ["Capa", "Numeração de Páginas"],
      "itens_pendentes": ["Sumário"]
    },
    "linguagem": {
      "erros_recorrentes": ["Uso incorreto de vírgulas"],
      "sugestoes_reescrita_exemplificadas": [
        {
          "antes": "O trabalho, é interessante.",
          "depois": "O trabalho é interessante.",
          "motivo": "Remoção de vírgula desnecessária."
        }
      ]
    },
    "flags": {
      "formato_inadequado": false,
      "solicitacao_de_texto_original": false,
      "possivel_texto_genérico": false
    },
    "progresso_relativo": {
      "melhorou_em": ["aderencia_ao_tema"],
      "manteve": [],
      "piorou_em": []
    }
  } 

• Número de caracteres esperado: O JSON de output deve ser claro e estruturado, com um tamanho estimado em torno de 3.500 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: Não utiliza.
• 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 Feedback Personalizado e Plano de Ação (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 e Plano de Ação (RF 3).

Transformar o diagnóstico em feedback motivador, acionável e adaptado ao progresso do aluno, sem fornecer notas.

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 como input um objeto JSON contendo o diagnóstico da submissão do aluno.
• 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 texto com até 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON chamado feedback_final que contém o feedback motivador e o plano de ação para o aluno.
• Exemplo de Estrutura de Output:

   {
    "mensagem_para_o_aluno": "Parabéns pelo excelente uso de referências e clareza na argumentação. Para melhorar ainda mais, considere incluir uma conclusão mais robusta e revisar o uso de vírgulas. Continue o ótimo trabalho!",
    "destaques_forcas": ["Clareza na argumentação", "Uso adequado de referências"],
    "prioridades_de_melhoria": [
      {
        "criterio_id": "conclusao",
        "motivo": "Conclusão ausente",
        "impacto_no_trabalho": "alto"
      }
    ],
    "passos_acionaveis_curto_prazo": ["Adicione uma conclusão clara ao trabalho."],
    "metas_qualitativas_proximas_2_semanas": ["Revisar o uso de pontuação"],
    "recursos_recomendados": [
      {
        "tipo": "guia_de_estilo",
        "tema": "Uso de vírgulas",
        "por_que_ajuda": "Melhora a clareza e a fluidez do texto."
      }
    ],
    "exemplo_reescrita_chave": {
      "antes": "O trabalho, é interessante.",
      "depois": "O trabalho é interessante.",
      "tecnica_aplicada": "Remoção de vírgula desnecessária."
    },
    "nivel_de_apoio_recomendado": "baixo",
    "detectar_dificuldades_persistentes": false
  } 

• Número de caracteres esperado: O JSON de output deve ser claro e estruturado, com um tamanho estimado em torno 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 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 deve ser visível para o Agente de Sumário para Docente e Sinalização de Intervenção (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Sumário para Docente e Sinalização de Intervenção (RF 4).

Gerar um sumário executivo para o professor e sinalizar se é recomendada intervenção humana, com base em dificuldades persistentes.

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 como input um objeto JSON contendo o feedback final e o diagnóstico do aluno.
• 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 texto com até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON chamado alerta_docente que contém o sumário executivo para o professor e a sinalização de intervenção.
• Exemplo de Estrutura de Output:

   {
    "resumo_exec_conciso": {
      "contexto": "Análise do trabalho submetido pelo aluno.",
      "status_geral": "adequado",
      "pontos_chave_forcas": ["Clareza na argumentação", "Uso adequado de referências"],
      "pontos_chave_lacunas": ["Faltou conclusão"]
    },
    "recomendacao_intervencao": {
      "necessita_intervencao": false,
      "motivo": "",
      "sugestao_de_acao_docente": []
    },
    "criterios_recorrentes_dificeis": [],
    "indicador_risco_academico": "baixo",
    "itens_para_acompanhar_em_proxima_entrega": ["Incluir uma conclusão clara."]
  } 

• Número de caracteres esperado: O JSON de output deve ser claro e estruturado, com um tamanho estimado em torno de 2.500 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

4.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 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 sumário executivo e a sinalização de intervenção são os resultados que devem ser disponibilizados ao docente.