Agente de IA para Detecção de Bullying em Interações Escolares

Realizar chamadas às APIs das plataformas escolares para recuperar interações digitais entre alunos no período e contexto definidos.

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 payload pronto para execução da coleta via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados através da interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um payload estruturado contendo parâmetros de coleta.
• 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é 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as interações digitais recuperadas, estruturadas de acordo com o modelo definido.
• Exemplo de Estrutura de Output:

   { "interacoes": [ { "msg_id": "abc123", "timestamp": "2025-12-06T09:55:00Z", "remetente_id": "aluno_001", "destinatarios_ids": ["aluno_007"], "canal": "dm", "sala_ou_turma_id": "9A", "conteudo_texto": "...", "conteudo_tipo": "texto", "idioma": "pt-BR", "transcricao_audio": null }, ... ], "periodo": {"inicio": "...", "fim": "..."} }

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 10.000 caracteres, dependendo do volume de interações.

1.3.3 Parâmetros de Geração

• Modelo: Não se aplica.
• Temperatura: Não se aplica.

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa chamadas a APIs das plataformas escolares.

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 Análise e Classificação de Bullying (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise e Classificação de Bullying (RF 2).

Analisar o conjunto de interações digitais coletadas e classificar potenciais incidentes de bullying com severidade, repetição e confiança, produzindo um payload mínimo para notificação imediata aos educadores.

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 contendo as interações digitais recuperadas.
• 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a classificação dos incidentes de bullying e o payload para notificação aos educadores.
• Exemplo de Estrutura de Output:

   {
    "incidente_detectado": true,
    "incidentes": [
      {
        "incident_id": "inc_2025-12-06_001",
        "data_incidente": "2025-12-06T09:55:00Z",
        "turma": "9A",
        "alvos_ids": ["aluno_007"],
        "agressores_ids": ["aluno_001"],
        "tipo": ["insulto_verbal", "discriminatorio"],
        "descricao_sintese": "Ataques repetidos com xingamentos direcionados ao aluno_007 no chat da turma.",
        "severidade_score": 78,
        "repeticao_contagem_7d": 4,
        "indicadores": ["linguagem_ofensiva_direcionada", "segunda_pessoa", "pile_on"],
        "evidencias": [
          {"msg_id": "abc123", "snippet_redigido": "...", "timestamp": "..."}
        ],
        "riscos_agudos": { "ameaca_fisica": false, "humilhacao_publica": true, "autoagressao_ideacao": false },
        "confianca": 0.81,
        "privacidade_conformidade": true
      }
    ],
    "requires_notification": true,
    "notification_payload": {
      "tipo_alerta": "possivel_bullying",
      "prioridade": "alta",
      "turma": "9A",
      "periodo_referencia": {"inicio": "...", "fim": "..."},
      "alvos_ids": ["aluno_007"],
      "agressores_ids": ["aluno_001"],
      "severidade_score": 78,
      "repeticao_contagem_7d": 4,
      "descricao_sintese": "Ataques repetidos com xingamentos direcionados ao aluno_007.",
      "evidencias_minimas": [ {"msg_id": "abc123", "snippet_redigido": "..."} ]
    }
  }

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 5.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: Utiliza lógica interna para calcular indicadores e escores.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

2.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 deve ser visível para o Agente de Execução de Notificação a Educadores (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Notificação a Educadores (RF 3).

Enviar notificação imediata e mínima necessária aos educadores responsáveis quando houver suspeita de bullying conforme payload preparado.

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 contendo o payload de notificação preparado.
• 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é 3.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status da entrega da notificação.
• Exemplo de Estrutura de Output:

   { "status": { "delivered": true, "notification_id": "notif_123", "timestamp": "2025-12-06T10:21:00Z", "error": null } }

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 500 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: Não se aplica.
• Temperatura: Não se aplica.

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Executa envio de notificações via API de comunicação escolar.

3.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.

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

A execução deste agente finaliza o fluxo. O status da notificação é o resultado que deve ser disponibilizado aos gestores escolares.