Agente de IA para Identificação de Necessidades Educacionais Especiais

Padronizar, validar e enriquecer registros acadêmicos e comportamentais, preparando dados consistentes por aluno 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 um arquivo JSON contendo registros acadêmicos e comportamentais dos alunos 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 arquivo JSON contendo dados acadêmicos e comportamentais dos alunos.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .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 estruturado contendo dados padronizados e validados por aluno, prontos para análise subsequente.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "serie": "5º Ano",
        "dados_normalizados": {
          "notas_por_componente": {
            "Matemática": [{"periodo": "1º Bimestre", "nota": 7.5}]
          },
          "media_geral_ponderada_0_10": 7.0,
          "tendencia_notas_slope_ultimos_4_periodos": -0.2,
          "frequencia_global": {
            "taxa_presenca": 0.95,
            "dias_presentes": 95,
            "dias_totais": 100
          },
          "incidentes": {
            "total": 3,
            "por_gravidade": {
              "baixa": 1,
              "media": 2,
              "alta": 0
            }
          },
          "atrasos_qtd_90d": 2,
          "faltas_injustificadas_qtd_90d": 1,
          "tarefas_nao_entregues_qtd_90d": 0,
          "keywords_observacoes": ["dificuldade de leitura", "inatenção"]
        },
        "qualidade_dado": {
          "completude_0_100": 85,
          "inconsistencias": [],
          "campos_faltantes": []
        },
        "pode_prosseguir": true
      }
    ]
  } 

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

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 Identificação de Risco de Necessidades Educacionais (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação de Risco de Necessidades Educacionais (RF 2).

Identificar sinais e calcular escore de risco educacional por aluno com base em indicadores acadêmicos e comportamentais.

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 com dados padronizados e validados, prontos para análise de risco educacional.
• 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 contendo o escore de risco educacional e as categorias sinalizadas para cada aluno.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "risco_identificado": true,
        "escore_risco_0_100": 80,
        "nivel_risco": "alto",
        "categorias_sinalizadas": ["academico", "comportamental"],
        "evidencias": [
          {"indicador": "media_geral_ponderada", "valor": 5.5, "justificativa": "Média abaixo de 6.0"},
          {"indicador": "taxa_presenca", "valor": 0.84, "justificativa": "Presença abaixo de 85%"}
        ],
        "limites_aplicados": {"descricao": ["Média geral ponderada", "Taxa de presença"]}
      }
    ]
  } 

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

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 Recomendações de Intervenção Educacional (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Intervenção Educacional (RF 3).

Sugerir intervenções pedagógicas e de suporte, estruturadas em plano com objetivos, responsáveis, frequência e métricas.

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 os escores de risco educacional e as categorias sinalizadas para cada 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é 30.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo planos de intervenção educacional para cada aluno com risco identificado.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "plano_intervencao": {
          "objetivos_smart": ["Aumentar taxa de presença para 90% em 60 dias"],
          "estrategias": [
            {"nome": "Reforço de leitura", "categoria": "academico", "descricao_curta": "Sessões de leitura guiada semanal"}
          ],
          "acomodacoes_sala": ["Tempo adicional para tarefas"],
          "recursos_adicionais": ["Sala de apoio"],
          "frequencia": {"semanal": 3, "duracao_sessao_min": 30},
          "responsaveis": [
            {"papel": "Professor regente"},
            {"papel": "Professor de apoio"}
          ],
          "metricas_sucesso": [
            {"indicador": "taxa_presenca", "baseline": 0.82, "alvo": 0.90, "prazo_dias": 60}
          ],
          "revisao_em_dias": 30
        },
        "justificativa_plano": ["Baseado em evidências de baixa presença e dificuldades acadêmicas"]
      }
    ]
  } 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 20.000 caracteres, podendo variar conforme a quantidade de alunos e complexidade dos planos de intervenção propostos.

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 Conformidade e Confidencialidade (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Conformidade e Confidencialidade (RF 4).

Garantir precisão mínima, anonimização adequada, minimização de dados e conformidade com confidencialidade antes da saída final.

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 JSON contendo avaliações de risco e planos de intervenção para cada 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é 40.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output final deve ser um JSON sanitizado contendo apenas os dados necessários para a entrega final, assegurando a conformidade com confidencialidade e precisão.
• Exemplo de Estrutura de Output:

   {
    "alunos": [
      {
        "aluno_id": "12345",
        "confidencialidade_assegurada": true,
        "anonimizado": true,
        "campos_pii_removidos": ["nome", "endereço"],
        "precisao_validada": true,
        "motivos_precisao_invalida": [],
        "resumo_auditoria": {
          "itens_verificados": ["anonimização", "ausência_diagnostico", "consistencia_risco", "evidencias_minimas", "minimizacao_dados"],
          "carimbos": {"data_processo_iso8601": "2025-12-22T10:22:00Z"}
        },
        "saida_sanitizada": {
          "avaliacao_risco": {
            "risco_identificado": true,
            "escore_risco_0_100": 80,
            "nivel_risco": "alto"
          },
          "plano_intervencao": {
            "objetivos_smart": ["Aumentar taxa de presença para 90% em 60 dias"],
            "estrategias": [
              {"nome": "Reforço de leitura", "categoria": "academico", "descricao_curta": "Sessões de leitura guiada semanal"}
            ],
            "acomodacoes_sala": ["Tempo adicional para tarefas"],
            "recursos_adicionais": ["Sala de apoio"],
            "frequencia": {"semanal": 3, "duracao_sessao_min": 30},
            "responsaveis": [
              {"papel": "Professor regente"},
              {"papel": "Professor de apoio"}
            ],
            "metricas_sucesso": [
              {"indicador": "taxa_presenca", "baseline": 0.82, "alvo": 0.90, "prazo_dias": 60}
            ],
            "revisao_em_dias": 30
          }
        }
      }
    ]
  } 

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

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 (JSON sanitizado) é 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 gerado é o resultado que deve ser disponibilizado ao usuário.