Agente de IA para Relatórios de Incidentes em Escolas

Coletar dados de incidentes ocorridos durante atividades escolares de forma sistemática e contínua, gerando um registro bruto estruturado imediatamente após a ocorrência.

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 relatos de incidentes 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 relato livre ou formulário preenchido por professores, equipe ou alunos com descrição do incidente e contexto.
• Formatos Suportados: Esse agente deve ser capaz de receber relatos nos formatos: .txt, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo todos os dados coletados, incluindo id_coleta, timestamp_captura, relato_bruto, metadados_coleta e campos_informados.
• Exemplo de Estrutura de Output:

   {"id_coleta":"uuid-gerado","timestamp_captura":"2025-12-14T07:21:00Z","relato_bruto":"Texto original do relato","metadados_coleta":{"origem":"form_web|app|email|voz","autor_relato_role":"docente|discente|coordenação|funcionário|responsável","consentimento_registro":true},"campos_informados":{"data_evento":"2025-12-13","hora_evento":"09:35","local_informado":"Sala 3A","tipo_informado":"bullying","pessoas_mencionadas":["Aluno A","Aluno B"],"gravidade_informada":"média"}} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 2.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 Padronização, Validação e Anonimização de Incidentes (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização, Validação e Anonimização de Incidentes (RF 2).

Transformar registros brutos em eventos padronizados, validados, anonimizados e deduplicados, prontos para análise.

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 os registros brutos coletados pelo agente anterior, incluindo relato_bruto, metadados_coleta e campos_informados.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON padronizado contendo o registro do incidente anonimizados e validados, prontos para análise.
• Exemplo de Estrutura de Output:

   {"id_incidente":"uuid-estável","fonte_id_coleta":"","data_hora_evento":"2025-12-13T09:35:00-03:00","local_categoria":"sala_de_aula|pátio|corredor|quadra|banheiro|refeitório|transporte|área_externa|online|outro","local_detalhe":"Sala 3A","tipo_incidente":"bullying|agressao_fisica|agressao_verbal|acidente|dano_patrimonial|posse_substancias|cyberbullying|discriminacao|assedio|autolesao|ameaca|outro","descricao_normalizada":"Resumo objetivo de até 400 caracteres sem PII","gravidade_nivel":1,"periodo":"aula|intervalo|entrada|saida|atividade_externa","pessoas_env_hash":["h_92af..","h_b1c3.."],"duplicado_de":null,"status_validacao":"valido|incompleto|duplicado","erros_validacao":[],"observacoes":""} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com 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 Análise de Padrões de Incidentes (RF 3).

2.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 de Incidentes (RF 3).

Identificar padrões, tendências e possíveis causas com base nos incidentes válidos e não duplicados.

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 uma lista de incidentes padronizados, validados e anonimizados.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a análise de padrões, tendências e possíveis causas dos incidentes.
• Exemplo de Estrutura de Output:

   {"janela_analise_dias":90,"kpis":{"total":120,"taxa_por_100_alunos":8.4,"media_semanal":9.6,"gravidade_media":2.7},"tendencias":{"ultimas_4_semanas":{"direcao":"alta|estavel|queda","variacao_percentual":35}},"picos":{"por_local":[{"local_categoria":"pátio","participacao":0.32}],"por_periodo":[{"periodo":"intervalo","participacao":0.45}]},"padroes_identificados":[{"descricao":"Aumento de bullying no intervalo","criterio":"+30% vs média 8 semanas","evidencia":{"freq_atual":18,"media_ref":13},"confianca":"alta"}],"causas_hipoteticas":["Falta de supervisão no intervalo","Conflitos entre turmas"],"segmentacoes_criticas":[{"tipo_incidente":"agressao_fisica","gravidade_media":3.6}]} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 4.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 Proposição de Medidas Preventivas (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Proposição de Medidas Preventivas (RF 4).

Sugerir ações preventivas específicas, priorizadas por impacto, evidência e custo, alinhadas aos padrões identificados.

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 padrões, picos, tendências e causas hipotéticas identificadas a partir dos incidentes escolares.
• 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é 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as medidas preventivas sugeridas, priorizadas por impacto, evidência e custo.
• Exemplo de Estrutura de Output:

   {"medidas_preventivas":[{"referencia_padrao":"Aumento de bullying no intervalo","acao":"Aumentar supervisão no pátio durante o intervalo de 09:30–10:30","responsavel_sugerido":"Coordenação disciplinar","prazo_implantacao_dias":14,"custo_relativo":"baixo|medio|alto","impacto_esperado":"reduzir incidentes de bullying em 20% em 6 semanas","indicador_sucesso":"freq_bullying_intervalo","precondicoes":["Escala de inspetores definida"],"score_prioridade":0.78}]} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 3.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 Geração de Relatório e KPIs (RF 5).

4.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 e KPIs (RF 5).

Compilar um relatório executivo e técnico com KPIs, padrões, recomendações e plano de ação monitorável.

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 como input as saídas dos agentes de Análise de Padrões e de Proposição de Medidas Preventivas.
• 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é 20.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório executivo e técnico completo, pronto para persistência e apresentação.
• Exemplo de Estrutura de Output:

   {"relatorio":{"resumo_executivo":"Síntese clara de principais achados e ações prioritárias","kpis":{"periodo":"últimos 90 dias","total":120,"taxa_por_100_alunos":8.4,"tendencia":"alta","top_locais":["pátio","corredor"]},"insights_chave":["Bullying concentrado no intervalo","Gravidade média estável"],"plano_acao":[{"acao":"Aumentar supervisão no pátio","responsavel":"Coordenação","prazo":"14 dias","indicador":"freq_bullying_intervalo","score_prioridade":0.78}],"anexos_dados":{"picos":[],"padroes_identificados":[],"series_temporais":[{"semana":"2025-W46","total":10}]},"conformidade":{"pii_removida":true,"base_dados_atualizada":"2025-12-14T07:21:00Z"}}} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 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 é 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.