Agente de IA para Monitoramento de Comportamento Escolar

Validar, higienizar e normalizar registros de comportamento escolar em um esquema único padronizado.

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 CSV ou JSON com registros de comportamento 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 é um arquivo CSV ou JSON com registros de comportamento escolar.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 90.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com lista de eventos normalizados no esquema especificado, incluindo campos como aluno_nome, turma, data_iso, comportamento_texto, entre outros.
• Exemplo de Estrutura de Output:

   {
    "eventos_normalizados": [
      {
        "aluno_nome": "João Silva",
        "turma": "5A",
        "data_iso": "2025-12-01",
        "comportamento_texto": "Agressão verbal",
        "severidade": 3,
        "valido": true
      }
    ]
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 4.500 caracteres, podendo variar conforme a quantidade de registros processados.

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 Extração de Métricas e Identificação de Padrões (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Extração de Métricas e Identificação de Padrões (RF 2).

Calcular métricas por aluno, turma e escola e identificar padrões e tendências de comportamento.

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 de eventos normalizados, que corresponde aos registros de comportamento escolar validados e normalizados pelo agente anterior.
• 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é 6.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo métricas detalhadas por aluno, turma e escola, além de padrões e tendências de comportamento identificados.
• Exemplo de Estrutura de Output:

   {
    "metricas_por_aluno": [
      {
        "aluno_nome": "João Silva",
        "incidentes_semanais": [
          {"semana_iso": "2025-W48", "total": 4},
          {"semana_iso": "2025-W49", "total": 5}
        ],
        "tendencia_4_sem": "alta",
        "horarios_criticos": ["tarde"],
        "locais_criticos": ["corredor"],
        "categoria_predominante": "agressao_verbal"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve conter aproximadamente 3.000 caracteres, variando conforme a quantidade de dados processados.

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 métricas e identificar 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 Geração de Intervenções Comportamentais Personalizadas (RF 3).

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

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

Propor intervenções claras, objetivas e adaptadas a cada aluno com base nos padrões identificados.

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: Este agente deve ser apto a receber como input um JSON de métricas e padrões comportamentais, que corresponde aos dados gerados pelo agente anterior.
• 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é 6.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo intervenções comportamentais personalizadas para cada aluno, incluindo metas SMART, estratégias, reforços positivos e ajustes ambientais.
• Exemplo de Estrutura de Output:

   {
    "interventions_por_aluno": [
      {
        "aluno_nome": "João Silva",
        "metas_SMART": "Reduzir incidentes de agressão verbal de 5 para 2 por semana em 4 semanas",
        "estrategias": [
          {"categoria_padroes_alvo": "agressao_verbal", "acao": "ensino de script de auto-regulação", "responsavel": "professor", "frequencia": "diária", "duracao": "4 semanas"}
        ],
        "reforcos_positivos": [
          {"comportamento_alvo": "interações respeitosas", "criterio_reforco": "3 dias consecutivos", "tipo_reforco": "elogio verbal"}
        ],
        "ajustes_ambientais": [
          {"contexto": "sala de aula", "ajuste": "disposição de mesas", "quando": "imediato"}
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve conter aproximadamente 4.000 caracteres, variando conforme a quantidade de intervenções propostas.

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 SMART e estratégias viáveis.
• 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 Priorização e Alertas (RF 4).

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

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

Atribuir prioridade de acompanhamento e definir alertas operacionais por aluno com base em risco e tendência.

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: Este agente deve ser apto a receber como input um JSON de intervenções comportamentais e métricas por aluno, que corresponde aos dados gerados pelos agentes anteriores.
• 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é 6.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a prioridade de acompanhamento e alertas operacionais por aluno, incluindo score de prioridade, nível de alerta e gatilhos operacionais.
• Exemplo de Estrutura de Output:

   {
    "prioridade_por_aluno": [
      {
        "aluno_nome": "João Silva",
        "score_prioridade": 75,
        "nivel_alerta": "alto",
        "criterios_acionados": ["tendencia_alta", "z-score elevado"],
        "gatilhos_alerta": [
          {"condicao": "incidentes>=3 em 7 dias", "acao_sugerida": "contato família"}
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve conter aproximadamente 2.500 caracteres, variando conforme a quantidade de dados processados.

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: Utiliza lógica interna para calcular scores de prioridade e definir gatilhos de alerta.
• 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 Montagem de Relatório Estruturado (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Montagem de Relatório Estruturado (RF 5).

Consolidar métricas, padrões, intervenções e priorização em um único relatório padronizado para uso escolar.

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: Este agente deve ser apto a receber múltiplos JSONs contendo eventos normalizados, métricas, intervenções e prioridades, que correspondem aos dados gerados pelos agentes anteriores.
• 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é 12.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo um relatório estruturado, incluindo cabeçalho, resumo executivo, visão por aluno e anexos.
• Exemplo de Estrutura de Output:

   {
    "relatorio": {
      "cabecalho": {
        "versao": "1.0",
        "generated_at": "2025-12-03T10:22:00Z",
        "periodo_analise": "2025-W48 a 2025-W49"
      },
      "resumo_executivo": {
        "top_achados": "Aumento de incidentes de agressão verbal na turma 5A",
        "alunos_prioritarios": ["João Silva"]
      },
      "visao_por_aluno": [
        {
          "aluno_nome": "João Silva",
          "principais_metricas": "Alta frequência de agressão verbal",
          "padroes_chave": "Tendência de aumento nas últimas 4 semanas",
          "intervencoes_recomendadas": "Ensino de script de auto-regulação",
          "nivel_alerta": "alto",
          "proximo_passo": "Contato com a família",
          "indicadores_monitoramento": "Reduzir incidentes em 50% nas próximas 4 semanas"
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve conter aproximadamente 5.000 caracteres, variando conforme a quantidade de dados processados.

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 consolidar dados e formatar o relatório.
• 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.