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

Receber dados de desempenho acadêmico e comportamental em formatos diversos, higienizar e padronizar o conjunto para análise consistente.

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 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 de um csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Dados estruturados em formato JSON com registros brutos por 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é 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON normalizado por aluno, contendo dados padronizados e organizados para análise.
• Exemplo de Estrutura de Output:

   {
    "schema_unificado": {"aluno_id": "123", "turma_id": "456", "serie": "7"},
    "avaliacoes_norm": [{"disciplina": "Matemática", "data": "2025-12-01", "escala_padronizada_0a10": 8.5, "peso": 1, "fonte": "sistema_escolar"}],
    "frequencia_norm": {"taxa_presenca": 0.95, "faltas_nao_justificadas_30d": 1, "faltas_totais_janela": 3},
    "comportamento_norm": [{"categoria": "atenção", "data": "2025-12-01", "gravidade_1a5": 2}],
    "observacoes_tokenizadas": "Participativo em sala.",
    "janela_analise": {"inicio": "2025-09-01", "fim": "2025-12-15"},
    "qualidade_dados": {"completude_por_campo": 0.98, "inconsistencias_detectadas": [], "registros_duplicados_removidos": 2, "campos_imputados": [], "suficiencia_minima": true, "motivos_suficiencia": []}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme a quantidade de dados por aluno.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular taxas e padronizações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Sinais de Necessidades Educacionais Especiais (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 Sinais de Necessidades Educacionais Especiais (RF 2).

Analisar o conjunto padronizado por aluno para identificar sinais e padrões consistentes com possíveis necessidades de apoio educacional especializado.

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: JSON normalizado por aluno proveniente do Agente de Padronização e Qualidade dos Dados 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é 3.000 caracteres por aluno.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com sinais detectados e escores de risco por domínio.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "sinais_detectados": [{"dominio": "academico", "indicador": "desempenho abaixo da média", "evidencias": [{"fonte": "avaliacao", "data": "2025-12-01", "valor": "5"}]}],
    "escores_risco_por_dominio": {"academico": 80, "comportamental": 50},
    "nivel_risco_global": "moderado",
    "confianca_0a1": 0.7,
    "motivos_chave": ["desempenho acadêmico consistentemente baixo"],
    "vieses_verificados": {"uso_atributos_sensiveis": false, "impacto_ausencias_considerado": true},
    "requisitos_dados_adicionais": [],
    "pode_prosseguir_para_plano": true
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.000 caracteres por aluno.

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: Utiliza lógica interna para calcular escores e detectar padrões.
• 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 Priorização e Plano de Ação Pedagógico (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Priorização e Plano de Ação Pedagógico (RF 3).

Converter sinais e níveis de risco em um plano de ação pedagógico inicial, com intervenções proporcionais, prazos, responsáveis e critérios de acompanhamento.

3.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 2).
• Tipo do input: JSON de saída do Agente de Detecção de Sinais, incluindo sinais_detectados, escores_risco_por_dominio, nivel_risco_global.
• 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é 2.000 caracteres por aluno.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o plano de ação pedagógico inicial.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "prioridade": "alta",
    "objetivos_aprendizagem_especificos": ["Melhorar a média de leitura para 7,0 em 8 semanas"],
    "intervencoes_recomendadas": [{"dominio": "academico", "tipo_intervencao": "reforço", "descricao": "Aulas de reforço em matemática", "duracao_semanas": 8, "frequencia": "2x por semana", "responsavel": "professor"}],
    "criterios_sucesso": [{"indicador": "média de leitura", "meta_quantitativa": "7,0", "prazo_semana": 8}],
    "agenda_acompanhamento": [{"data_sugerida": "2025-12-30", "foco": "avaliação de progresso"}],
    "exigencias_formais": [{"item": "consentimento dos pais", "necessario": true}],
    "observacoes_eticas_e_de_linguagem": []
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 caracteres por aluno.

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: Utiliza lógica interna para definir metas e prazos.
• 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 Redator de Comunicação para Educadores e Famílias (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Redator de Comunicação para Educadores e Famílias (RF 4).

Gerar comunicações distintas e adequadas ao público sobre os sinais observados e o plano proposto, usando linguagem clara e não estigmatizante.

4.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 3).
• Tipo do input: JSON do Agente de Priorização e Plano de Ação Pedagógico.
• 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é 2.500 caracteres por aluno.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com comunicações para educadores e famílias.
• Exemplo de Estrutura de Output:

   {
    "comunicacao_para_educadores": {"assunto": "Plano de Ação Pedagógico", "resumo_objetivo": "Identificamos sinais que requerem atenção.", "pontos_chave": ["Desempenho abaixo da média em Matemática"], "plano_sintetico": "Intervenções de reforço serão iniciadas.", "pedidos_acoes_imediatas": ["Aplicar estratégia X 3x/semana"], "tom": "colaborativo"},
    "comunicacao_para_familias": {"assunto": "Progresso e Próximos Passos", "mensagem_clara": "Identificamos algumas áreas que necessitam de atenção.", "progresso_atual": "Intervenções foram planejadas.", "como_a_familia_pode_ajudar": ["Incentivar a leitura diária"], "convite_reuniao": {"sugerir_datas": ["2025-12-20", "2025-12-21"], "canal": "online"}},
    "linguagem_inclusiva_checks": {"sem_rotulos": true, "leitura_facilitada": true}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres por aluno.

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 deve ser visível para o Agente de Sumário Executivo para Equipe Multidisciplinar (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Sumário Executivo para Equipe Multidisciplinar (RF 5).

Produzir um sumário estruturado dos achados, intervenções propostas e próximos passos, para subsidiar discussão de equipe escolar/multidisciplinar.

5.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 4).
• Tipo do input: JSON combinando saídas dos agentes de Detecção e de Plano.
• 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é 3.000 caracteres por aluno.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o sumário executivo.
• Exemplo de Estrutura de Output:

   {
    "sumario_executivo": {
      "aluno_id": "123",
      "nivel_risco_global": "alto",
      "confianca": 0.85,
      "dominios_afetados": ["academico", "comportamental"],
      "principais_evidencias": ["Desempenho consistentemente baixo em Matemática"],
      "plano_resumido": ["Intervenções de reforço em andamento"],
      "pendencias_de_dados": [],
      "recomendacao_reuniao_equipa": true,
      "urgencia": "alta"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 caracteres por aluno.

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: Utiliza lógica interna para definir urgência e priorização.
• 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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O sumário gerado é o resultado que deve ser disponibilizado à equipe multidisciplinar.