Agente de IA para Identificação de Alunos com Necessidades Especiais

Receber dados heterogêneos de desempenho e comportamento e produzir um dataset padronizado por aluno/período com variáveis derivadas e prontas para análise.

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 desempenho e comportamento dos alunos via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de dados estruturados em formato JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados padronizados em formato JSON, contendo variáveis derivadas e prontas para análise.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "periodo_referencia": "2025-12-20",
    "features": {
      "nota_media_periodo": 8.5,
      "desvio_nota": 1.2,
      "taxa_presenca": 0.95,
      "taxa_atraso": 0.05
    },
    "contexto_normativo": {
      "media_turma": 8.0,
      "desvio_turma": 1.0,
      "media_serie": 7.8,
      "desvio_serie": 1.1
    }
  } 

• Número de caracteres esperado: O conjunto de dados padronizados deverá ter um tamanho estimado em torno 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: 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 Detecção de Padrões Atípicos (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Padrões Atípicos (RF 2).

Identificar padrões atípicos e mudanças abruptas nas métricas de aprendizado e comportamento por aluno.

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 conjunto de dados padronizados em formato JSON, contendo variáveis derivadas e contexto normativo.
• 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 conjunto de dados em formato JSON, contendo as anomalias identificadas e informações de suficiência de dados.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "periodo_referencia": "2025-12-20",
    "anomalías": [
      {
        "categoria": "presenca",
        "metrica": "taxa_presenca",
        "valor": 0.6,
        "referencia": 0.95,
        "z_turma": -2.5,
        "tipo": "nivel",
        "severidade": "media"
      }
    ],
    "dados_suficientes": true
  } 

• Número de caracteres esperado: O conjunto de dados de anomalias deverá ter um tamanho estimado em torno 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: 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 Classificação de Risco e Priorização (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Risco e Priorização (RF 3).

Consolidar anomalias por aluno e calcular um score de risco com priorização e recomendação de próximo passo.

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 conjunto de dados em formato JSON, contendo anomalias identificadas e informações de suficiência de dados.
• 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é 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados em formato JSON, contendo o score de risco calculado, faixa de prioridade e recomendação de próximo passo.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "periodo_referencia": "2025-12-20",
    "risk_score": 45,
    "faixa_prioridade": "media",
    "motivos": ["baixa_presenca", "mudanca_abrupta"],
    "requer_avaliacao": true,
    "janelas_observacao": {
      "inicio": "2025-11-01",
      "fim": "2025-12-20"
    }
  } 

• Número de caracteres esperado: O conjunto de dados de risco deverá ter um tamanho estimado em torno de 2.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 Sinalização e Resumo 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 Sinalização e Resumo para Educadores (RF 4).

Gerar um alerta compreensível e acionável para educadores, sem rótulos diagnósticos, com evidências e sugestões iniciais.

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 conjunto de dados em formato JSON, contendo o score de risco calculado, faixa de prioridade e recomendação de próximo passo.
• 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é 2.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um alerta compreensível e acionável para educadores, em formato JSON, contendo título, resumo factual, evidências, contexto e sugestões iniciais.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "alerta": {
      "titulo": "Sinalização de acompanhamento — risco media",
      "prioridade": "media",
      "resumo_factual": "Queda de 1.2 pontos na média nas últimas 4 semanas e presença 18% abaixo da turma.",
      "evidencias_chave": [
        {
          "metrica": "nota_media_periodo",
          "valor": 7.0,
          "referencia": 8.5,
          "tipo": "nivel"
        }
      ],
      "possiveis_fatores_contextuais": ["semana_provas"],
      "sugestoes_iniciais": ["checagem de compreensão", "reforço de rotinas"],
      "perguntas_para_observacao": ["há necessidade de instruções segmentadas?", "distrações frequentes em atividades silenciosas?"]
    },
    "proxima_acao_sugerida": "observar",
    "canal_recomendado": "diario_de_classe"
  } 

• Número de caracteres esperado: O alerta deverá ter um tamanho estimado em torno de 1.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 deve ser visível para o Agente de Consolidação de Feedback do Educador (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação de Feedback do Educador (RF 5).

Estruturar o feedback do educador após a sinalização e atualizar o status do caso para continuidade do fluxo.

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 4).
• Tipo do input: Este agente deve ser apto a receber como input um conjunto de dados em formato JSON, contendo feedback do educador e informações de classificação e ações realizadas.
• 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é 1.500 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados estruturados em formato JSON, contendo confirmação de padrões, barreiras, adaptações em teste, status do fluxo e trigger de recomendações.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "periodo_referencia": "2025-12-20",
    "feedback_estruturado": {
      "confirmacao_padroes": true,
      "barreiras_identificadas": ["falta de material", "dificuldade de instrução"],
      "adaptacoes_em_teste": ["uso de material visual", "tempo adicional"]
    },
    "status_fluxo": "planejar_intervencao",
    "trigger_recomendacoes": true
  } 

• Número de caracteres esperado: O conjunto de dados estruturados deverá ter um tamanho estimado em torno de 1.200 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Recomendações de Estratégias de Ensino Personalizadas (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Estratégias de Ensino Personalizadas (RF 6).

Sugerir estratégias pedagógicas e plano de acompanhamento alinhados às necessidades observadas e ao feedback do educador.

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 um conjunto de dados estruturados em formato JSON, contendo feedback do educador e informações de status do fluxo.
• 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é 1.200 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados em formato JSON, contendo recomendações de estratégias pedagógicas e plano de acompanhamento.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "recomendacoes": {
      "objetivos_smart": ["Aumentar a presença em 10% nas próximas 6 semanas"],
      "estrategias_em_sala": ["instruções em passos", "tempo adicional"],
      "acomodacoes_avaliativas": ["tempo adicional em provas"],
      "suporte_extra": ["orientação educacional com carga de 2 horas semanais"],
      "plano_monitoramento": {
        "metricas_alvo": ["taxa_presenca", "nota_media_periodo"],
        "frequencia": "semanal",
        "criterio_reavaliacao": {
          "janela": "6 semanas",
          "condicao": "ausência de novas anomalias e melhora >=0.5 ponto na nota"
        }
      }
    },
    "consideracoes_privacidade": ["orientar comunicação adequada com responsáveis"]
  } 

• Número de caracteres esperado: O conjunto de dados de recomendações deverá ter um tamanho estimado em torno de 1.800 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 entregável 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. As recomendações geradas devem ser disponibilizadas ao educador responsável.