Agente de IA para Identificação de Necessidades de Aprendizagem

Padronizar e validar os dados de avaliações, calculando métricas-base por aluno e por disciplina para suportar o diagnóstico.

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 uma lista JSON de resultados de 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é uma lista JSON de resultados de avaliações.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com registros normalizados, agregações por aluno-disciplina, baseline da turma por disciplina e um relatório de validação.
• Exemplo de Estrutura de Output:

   {
    "registros_normalizados": [ {"aluno_id": "123", "disciplina": "Matemática", "score_normalizado": 0.85, ...} ],
    "agregacoes": [ {"aluno_id": "123", "disciplina": "Matemática", "media_ponderada_0a1": 0.75, ...} ],
    "baseline_turma": [ {"disciplina": "Matemática", "media_turma_0a1": 0.7, ...} ],
    "relatorio_validacao": {"itens_descartados": 5, "motivos": ["max_nota_ausente", "valor_nao_numerico"], ...} }
  

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 5.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 documentos externos.
• Calculadora: Utiliza lógica interna para cálculos estatísticos.
• 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 Diagnóstico de Necessidades de Aprendizagem (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Diagnóstico de Necessidades de Aprendizagem (RF 2).

Identificar lacunas de aprendizagem por aluno, disciplina e habilidade, classificando a severidade e priorização das intervenções.

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 JSON estruturado contendo agregações por aluno-disciplina, baseline de turma e itens normalizados.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON por aluno com necessidades identificadas, incluindo disciplina, severidade, prioridade, indicadores e recomendações.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "necessidades": [
      {"disciplina": "Matemática", "severidade": "alta", "prioridade": 1, "indicadores": {"media_ponderada_0a1": 0.5, "zscore_medio": -1.2, ...}, "recomendacao": "reforco_basico" }
    ],
    "sumarios_por_turma": {"top_disciplinas": ["Matemática", "Ciências"], "distribuicao_severidade": {"alta": 10, "media": 5, "baixa": 2} }
  }

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado 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 cálculos de severidade e prioridade.
• 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 Recomendação de Apoios e Recursos (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendação de Apoios e Recursos (RF 3).

Sugerir recursos e estratégias instrucionais alinhados às necessidades identificadas, respeitando tempo disponível e preferências do educador.

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 contendo necessidades identificadas por aluno e disciplina.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON por aluno com plano_de_apoio detalhado, incluindo recursos sugeridos, estratégias docentes e indicadores de sucesso.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "plano_de_apoio": {
      "metas_SMART": "Aumentar a média em Matemática para 0.8 em 4 semanas",
      "intervencoes": [
        {"disciplina": "Matemática", "recursos_sugeridos": [ {"recurso_id": "001", "titulo": "Exercícios de Frações", "tipo": "lista_exercicios", ...} ], "estrategias_docentes": [ {"descricao_curta": "Reensino de frações", ...} ], "carga_total_min": 120, "janela_semanas": 4, "indicadores_sucesso": [ {"indicador": "miniavaliação", "alvo": ">= 80%", "prazo_semanas": 2} ] }
      ],
      "require_teacher_review": true
    }
  }

• Número de caracteres esperado: O JSON de output 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 documentos externos.
• Calculadora: Utiliza lógica interna para cálculos de tempo e carga horária.
• 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 Educadores (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 Educadores (RF 4).

Consolidar um resumo acionável por turma e por aluno, destacando prioridades e próximos passos claros.

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 planos de apoio por aluno e sumarios_por_turma em JSON.
• 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é 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com resumo_turma e resumos_alunos, incluindo acoes_rapidas e proxima_acao_1_semana.
• Exemplo de Estrutura de Output:

   {
    "resumo_turma": {"top_dor_disciplina": ["Matemática"], "acoes_rapidas": ["Minilição de frações 10 min + 5 exercícios diagnósticos"], "calendario_sugerido": "Próxima revisão em 2 semanas"},
    "resumos_alunos": [
      {"aluno_id": "123", "top3_necessidades": ["Matemática"], "proxima_acao_1_semana": "Revisar frações", "checagem_rapida_sugerida": "Ticket de saída"}
    ]
  }

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 2.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 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 é 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 resumo gerado é o resultado que deve ser disponibilizado ao usuário.