Agente de IA para Conversão de Notas e Avaliações

Interpretar os dados de notas e avaliações recebidos em formatos heterogêneos e normalizar para um esquema intermediário unificado.

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 notas e avaliações 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 de notas e avaliações em formato texto, tabular ou JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .txt, .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 normalizado de nível intermediário com o esquema definido.
• Exemplo de Estrutura de Output:

   {
    "institution_id": "123",
    "course_id": "456",
    "term_id": "789",
    "student_id": "001",
    "student_name": "João Silva",
    "assessment_id": "A1",
    "assessment_name": "Prova Final",
    "assessment_type": "prova",
    "date": "2025-12-10",
    "raw_score": 8.5,
    "max_score": 10,
    "scale_type": "0_10",
    "scale_detail": "",
    "weight": 0.3,
    "attempt": 1,
    "status": "completo",
    "approval_threshold": null,
    "source_metadata": {"weight_source": "ausente"}
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres por item, podendo variar conforme a complexidade dos dados.

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 Mapeamento de Escalas e Conversão (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Mapeamento de Escalas e Conversão (RF 2).

Converter todas as notas do esquema intermediário para o padrão de saída definido (score_padrao em 0–100 com 2 casas decimais) e preparar cálculo de médias ponderadas quando aplicável.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON intermediário normalizado contendo raw_score, max_score, scale_type, scale_detail, approval_threshold, weight e metadados.
• 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com os mesmos registros acrescidos de: score_padrao (0–100), conversao_utilizada, arredondamento_aplicado, flags de perda_de_informacao e transformation_log por item.
• Exemplo de Estrutura de Output:

   {
    "institution_id": "123",
    "course_id": "456",
    "term_id": "789",
    "student_id": "001",
    "score_padrao": 85.00,
    "conversao_utilizada": "proporcional_0_10_para_0_100",
    "arredondamento_aplicado": "2_casas",
    "perda_de_informacao": false,
    "transformation_log": {"reason": ""}
  } 

• Número de caracteres esperado: O JSON final deve ser claro e direto, com um tamanho estimado em torno de 6.000 caracteres por item.

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 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 Validação e Consistência de Dados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação e Consistência de Dados (RF 3).

Aplicar checagens de integridade, consistência e regras acadêmicas para sinalizar erros e determinar se a conversão está apta para uso.

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 JSON com score_padrao por item, pesos, tipos de avaliação e metadados de transformaçã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é 60.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório de validação por turma/estudante com detalhes sobre a integridade e consistência dos dados.
• Exemplo de Estrutura de Output:

   {
    "conversion_success": true,
    "needs_human_review": false,
    "issues": [],
    "estatisticas": {
      "itens_validos": 50,
      "itens_com_alerta": 5,
      "itens_com_erro": 0
    },
    "criterios_aplicados": []
  } 

• Número de caracteres esperado: O relatório deve ser conciso e informativo, com um tamanho estimado em torno de 4.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 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 do Output Padronizado (RF 4) e o Agente de Tratamento de Exceções e Preparação para Revisão Humana (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração do Output Padronizado (RF 4) se conversion_success=true e needs_human_review=false; caso contrário, aciona o Agente de Tratamento de Exceções e Preparação para Revisão Humana (RF 5).

Produzir o dataset final padronizado para análise e comparação, com schema consistente e metadados de rastreabilidade.

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) se conversion_success=true e needs_human_review=false.
• Tipo do input: Este agente deve ser apto a receber como input um JSON validado com scores convertidos e relatório 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 texto com até 70.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON final com header, data e audit, conforme especificado.
• Exemplo de Estrutura de Output:

   {
    "header": {
      "schema_version": "1.0",
      "generated_at": "2025-12-21T07:39:00Z",
      "owner": "Cheila Portela"
    },
    "data": [
      {
        "student_id": "001",
        "course_id": "456",
        "term_id": "789",
        "assessment_id": "A1",
        "assessment_type": "prova",
        "score_padrao": 85.00,
        "weight": 0.3,
        "status": "completo",
        "aprovado": true,
        "nota_final_estudante": 85.00
      }
    ],
    "audit": {
      "transformations": {"proporcional_0_10_para_0_100": 1},
      "criterios_validacao": ["score_padrao entre 0 e 100", "pesos somando 100±0.5"]
    }
  } 

• Número de caracteres esperado: O JSON final deve ser denso, com um tamanho mínimo esperado de 10.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 deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente é o resultado 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 gerado é o resultado que deve ser disponibilizado ao usuário.

Consolidar ambiguidades e erros em um pacote de revisão com perguntas objetivas para decisão humana.

5.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) se needs_human_review=true.
• Tipo do input: Este agente deve ser apto a receber como input um relatório de validação com needs_human_review=true e dados intermediários/convertidos associados.
• 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é 60.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote de revisão com resumo_de_problemas, itens_afetados, perguntas_ao_humano, opções de resolução padronizadas e impacto previsto em cada escolha.
• Exemplo de Estrutura de Output:

   {
    "resumo_de_problemas": "Pesos inconsistentes detectados",
    "itens_afetados": ["001", "002"],
    "perguntas_ao_humano": ["Confirmar que a escala é 0-20?"],
    "opcoes_resolucao": {"Sim": "Recalcular score_padrao", "Não": "Manter como nulo", "Informar outra": "Rejeitar item"},
    "impacto_previsto": {"Sim": "Score recalculado", "Não": "Sem alteração", "Informar outra": "Item rejeitado"}
  } 

• Número de caracteres esperado: O pacote de revisão deve ser informativo, com um tamanho estimado em torno de 5.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

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

5.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 Reprocessamento pós-Resposta Humana (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Reprocessamento pós-Resposta Humana (RF 6).

Aplicar instruções recebidas do revisor humano ao conjunto de dados, reexecutar conversões afetadas e revalidar para emitir saída final.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber como input dados intermediários/convertidos mais respostas_humanas estruturadas do pacote de revisã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é 70.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON final padronizado equivalente ao produzido pelo Agente de Geração do Output Padronizado, ou novo relatório de validação se persistirem erros críticos.
• Exemplo de Estrutura de Output:

   {
    "header": {
      "schema_version": "1.0",
      "generated_at": "2025-12-21T07:39:00Z",
      "owner": "Cheila Portela"
    },
    "data": [
      {
        "student_id": "001",
        "course_id": "456",
        "term_id": "789",
        "assessment_id": "A1",
        "assessment_type": "prova",
        "score_padrao": 85.00,
        "weight": 0.3,
        "status": "completo",
        "aprovado": true,
        "nota_final_estudante": 85.00
      }
    ],
    "audit": {
      "transformations": {"proporcional_0_10_para_0_100": 1},
      "criterios_validacao": ["score_padrao entre 0 e 100", "pesos somando 100±0.5"]
    }
  } 

• Número de caracteres esperado: O JSON final deve ser denso, com um tamanho mínimo esperado de 10.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

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

6.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 resultado final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O JSON gerado é o resultado que deve ser disponibilizado ao usuário.