Agente de IA para Relatórios de Comportamento em Recreação

Definir taxonomia de comportamentos, janelas de recreio, áreas monitoradas e preparar o payload para coleta automática (sensores) e o modelo de ficha de observação manual.

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 contextuais da escola 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 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 contextuais, que incluem horários de recreio, mapa de áreas, lista de turmas/séries e políticas de privacidade.
• 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 dados com até 15.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado, contendo os parâmetros de coleta definidos, incluindo taxonomia de comportamentos e janelas de recreio.
• Exemplo de Estrutura de Output:

   {
    "coleta_janelas": [{"inicio":"10:00","fim":"10:30","areas":["quadra","pátio coberto"]}],
    "taxonomia_comportamentos": ["jogo cooperativo","jogo competitivo","isolamento","conflito verbal","conflito físico leve","fila","espera","mediação"],
    "api_payload_sensores": {"endpoint":"/sensores/recreio","params": {"areas":["quadra","pátio coberto"],"janela_inicio":"2025-12-21T10:00:00Z","janela_fim":"2025-12-21T10:30:00Z","campos":["timestamp","sensor_id","aluno_hash","posicao","evento","intensidade"]}},
    "ficha_observacao": {"campos":["timestamp","area","aluno_alias","atividade","interacoes","evento","intensidade","duracao_seg","observador_id"],"granularidade_seg":300,"instrucoes":"Registrar em blocos de 5 minutos, um registro por aluno por bloco; usar aluno_alias sem nome civil."},
    "politicas_privacidade": {"anonimizacao": true, "chave_hash_salt_ref":"salt_rotativo_diario"}
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.500 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 Execução de Chamada à API (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

Realizar chamada à API do sistema de sensores para obter dados brutos de comportamento no recreio.

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 um JSON contendo o payload para chamada à API do sistema de sensores.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos obtidos da API do sistema de sensores.
• Exemplo de Estrutura de Output:

   {
    "dados_sensores_brutos": [
      {"timestamp":"2025-12-21T10:05:02Z","sensor_id":"cam_q1","aluno_hash":"a1f...","area":"quadra","evento":"corrida","intensidade":0.42}
    ]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deve se conectar ao sistema de sensores para realizar a chamada à API e obter os dados brutos.

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 Consolidação, Qualidade e Padronização de Dados (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação, Qualidade e Padronização de Dados (RF 3).

Unificar sensores e observações manuais, anonimizar, deduplicar e estruturar dados em um esquema único pronto para análise.

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 dois conjuntos de dados: dados brutos de sensores e observações manuais.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado, pronto para análise, contendo os dados unificados e anonimizados.
• Exemplo de Estrutura de Output:

   {
    "dataset_estruturado": [
      {"aluno_pseudo_id":"p_123","timestamp_bloco":"2025-12-21T10:05:00Z","area":"quadra","atividade":"jogo competitivo","interacoes_qtd":3,"evento_chave":"corrida","intensidade_media":0.4,"duracao_bloco_seg":300,"fontes":["sensor","observacao"],"qualidade_sinal":0.87}
    ],
    "qualidade_resumo": {"registros_recebidos":1240,"registros_validos":1120,"taxa_perda":0.0968,"atraso_mediana_seg":45},
    "dados_validos": true
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.500 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.
• Calculadora: Não utiliza.
• 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 Análise de Padrões e Tendências de Comportamento (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Padrões e Tendências de Comportamento (RF 4).

Identificar padrões relevantes, tendências temporais e desvios no comportamento durante o recreio.

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 o dataset estruturado e o resumo de qualidade dos dados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .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 contendo métricas chave, padrões identificados, tendências, sazonalidades e outliers.
• Exemplo de Estrutura de Output:

   {
    "metricas_chave": {"taxa_isolamento_global":0.18,"densidade_media_por_area":{"quadra":0.72,"pátio coberto":0.55},"freq_conflitos_por_100_alunos":4.2},
    "padroes_identificados": [
      {"tipo":"isolamento","criterio":"aluno sozinho >70% do tempo em >=3 recreios consecutivos","alunos_afetados":["p_123","p_987"],"evidencias":[{"data":"2025-12-20","percentual_tempo":0.78}],"locais_prevalentes":["pátio coberto"],"confianca":0.82}
    ],
    "tendencias": [
      {"indicador":"interacao_em_grupo","direcao":"alta","var_semana":0.12}
    ],
    "sazonalidades": [
      {"padrao":"quartil_final_do_recreio","efeito":"aumento de conflitos","lift":1.6}
    ],
    "outliers": [
      {"evento":"conflito_fisico","area":"quadra","z_score":3.1}
    ],
    "padroes_significativos": true
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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.
• 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 Sugestão de Intervenções (RF 5).

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

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

Propor intervenções práticas e contextualizadas para mitigar problemas e potencializar comportamentos positivos identificados.

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 padrões identificados, métricas chave, sazonalidades e outliers.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 4.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as intervenções sugeridas.
• Exemplo de Estrutura de Output:

   {
    "intervencoes_sugeridas": [
      {"titulo":"Rodas cooperativas no pátio coberto","objetivo":"Reduzir isolamento em 30% em 4 semanas","hipotese":"Atividades mediadas elevam interação de alunos isolados","publico_alvo":"alunos com alto isolamento","area":"pátio coberto","recursos":["cones","cartas de missão cooperativa"],"responsaveis":["monitor_recreio","professor apoio"],"frequencia":"2x por recreio (meio e fim)","duracao_min":10,"custo_estimado":"baixo","riscos_e_mitigacoes":["exposição indevida -> uso de convites abertos a todos"],"indicadores": {"leading":["participação nas rodas","tempo em interação"],"lagging":["taxa_isolamento_global"]},"linha_de_base":{"taxa_isolamento_global":0.18},"criterio_sucesso":{"delta_relativo_min":-0.3,"janela_avaliacao_recreios":8}}
    ],
    "intervencoes_geradas": true
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.500 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.
• Calculadora: Não utiliza.
• 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 deve ser visível para o Agente de Geração de Relatório de Comportamento no Recreio (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório de Comportamento no Recreio (RF 6).

Compilar um relatório claro e acionável para gestão e equipe escolar, com evidências, métricas e plano de intervenção/monitoramento.

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 métricas chave, padrões identificados, tendências, sazonalidades, outliers, intervenções sugeridas e resumo de qualidade dos dados.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 6.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório estruturado e uma versão narrativa contínua em português.
• Exemplo de Estrutura de Output:

   {
    "relatorio": {
      "cabecalho": {"periodo_analisado":"2025-12-15 a 2025-12-21","unidade_escolar":"(nome)","responsavel":"Cheila Portela"},
      "sumario_executivo": "...",
      "dados_e_metodologia": {"granularidade":"5 min","fontes":["sensores","observações"],"qualidade": {"taxa_perda":0.0968}},
      "achados_principais": ["isolamento em pátio coberto...","pico de conflitos no final do recreio"],
      "analises": {"metricas_chave": {"taxa_isolamento_global":0.18}, "padrões": [...], "tendências": [...], "sazonalidades": [...]},
      "plano_de_acao": {"intervencoes": [...], "monitoramento_quando_sem_intervencoes": "..."},
      "indicadores_e_avaliacao": {"leading":["participação"],"lagging":["taxa_isolamento"]},
      "anexos": {"esquema_dados":"...","glossario":"..."}
    },
    "formato_texto": "string do relatório narrativo pronta para comunicação"
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

6.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• 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. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.