Agente de IA para Análise de Participação em Sala de Aula

Padronizar logs de participação provenientes de diferentes fontes em um esquema único e consistente por sessão e por aluno.

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 uma lista de eventos brutos de participação 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 é uma lista de eventos brutos de participação dos alunos.
• Formatos Suportados: Esse agente deve ser capaz de receber eventos no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um array de eventos normalizados no formato JSON. A estrutura deve conter campos como `evento_id`, `aluno_id`, `sessao_id`, `timestamp_iso`, `tipo_interacao`, `canal`, `tokens_aprox`, `destinatario`, `referencias_citadas`, `conteudo_resumo`, `valido`, `motivo_invalidacao_opcional`, `dedupe_key`.
• Exemplo de Estrutura de Output:

   [{
    "evento_id": "evt_001",
    "aluno_id": "12345",
    "sessao_id": "sessao_20251219_01",
    "timestamp_iso": "2025-12-19T07:08:00Z",
    "tipo_interacao": "fala",
    "canal": "oral",
    "tokens_aprox": 10,
    "destinatario": "",
    "referencias_citadas": ["Conceito X", "@colega"],
    "conteudo_resumo": "Discussão sobre o Conceito X",
    "valido": true,
    "motivo_invalidacao_opcional": "",
    "dedupe_key": "hash123"
  }] 

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

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

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 Cálculo de Métricas de Participação (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Métricas de Participação (RF 2).

Calcular métricas quantitativas de frequência e regularidade de participação por aluno, por sessão e por período.

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 array de eventos normalizados válidos em formato JSON.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com chaves por aluno_id contendo as métricas calculadas. A estrutura deve incluir campos como `total_interacoes`, `interacoes_por_tipo`, `sessoes_participadas`, `percentual_sessoes_participadas`, `interacoes_por_sessao_media`, `minutos_fala_estimados`, `distribuicao_temporal`, `participacao_relativa_percentil`, `tendencia_ultimas_4_semanas` e um sumário da turma.
• Exemplo de Estrutura de Output:

   {
    "12345": {
      "total_interacoes": 50,
      "interacoes_por_tipo": {
        "fala": 20,
        "pergunta": 10,
        "resposta": 10,
        "reacao": 5,
        "outro": 5
      },
      "sessoes_participadas": 8,
      "percentual_sessoes_participadas": 80,
      "interacoes_por_sessao_media": 6.25,
      "minutos_fala_estimados": 2.7,
      "distribuicao_temporal": [{"semana_iso": "2025-W51", "total_interacoes": 25}],
      "participacao_relativa_percentil": 75,
      "tendencia_ultimas_4_semanas": {"var_percentual": 0.10}
    },
    "resumo_turma": {
      "n_alunos": 30,
      "media_interacoes_por_aluno": 40,
      "mediana_interacoes_por_aluno": 35,
      "p25": 20,
      "p75": 50
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 10.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular métricas de participação.
• 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 Avaliação de Qualidade e Índice de Engajamento (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Avaliação de Qualidade e Índice de Engajamento (RF 3).

Avaliar a qualidade das interações e compor um índice de engajamento consolidado por aluno.

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 eventos normalizados válidos e métricas calculadas em formato JSON.
• 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é 60.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os índices de engajamento por aluno. A estrutura deve incluir campos como `subscores_qualidade`, `qualidade_media`, `engajamento_indice`, `classe_engajamento`, `justificativa_curta`, `exemplos_interacoes_representativas`.
• Exemplo de Estrutura de Output:

   {
    "12345": {
      "subscores_qualidade": {
        "relevancia": 0.9,
        "profundidade": 0.8,
        "iniciativa": 0.7,
        "colaboracao": 0.6,
        "respeito_turno": 0.5
      },
      "qualidade_media": 0.7,
      "engajamento_indice": 85,
      "classe_engajamento": "alto",
      "justificativa_curta": "Alta relevância e frequência acima do p75",
      "exemplos_interacoes_representativas": ["evt_001", "evt_002", "evt_003"]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 8.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular índices de engajamento.
• 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 Identificação de Desengajamento e Geração de Relatórios (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Identificação de Desengajamento e Geração de Relatórios (RF 4).

Detectar alunos potencialmente desengajados e produzir relatórios acionáveis para educadores.

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 índices de engajamento e métricas de participação em formato JSON.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo alertas e relatórios acionáveis. A estrutura deve incluir campos como `alertas`, `relatorio_turma`, `top5_engajamento`, `bottom5_engajamento`, `heatmap_sessoes`, `tendencias_semanais`.
• Exemplo de Estrutura de Output:

   {
    "alertas": [
      {
        "aluno_id": "12345",
        "severidade": "alta",
        "motivos": ["baixa frequência", "queda recente"],
        "recomendacoes": ["Convidar a liderar breve síntese", "Contato 1:1 para entender barreiras"]
      }
    ],
    "relatorio_turma": {
      "resumo_geral": {
        "n_alunos": 30,
        "distribuicao_classes": {
          "alto": 10,
          "medio": 15,
          "baixo": 5
        }
      },
      "top5_engajamento": [
        {"aluno_id": "12345", "engajamento_indice": 85}
      ],
      "bottom5_engajamento": [
        {"aluno_id": "67890", "engajamento_indice": 15}
      ],
      "heatmap_sessoes": [
        {"sessao_id": "sessao_20251219_01", "data_iso": "2025-12-19", "alunos_ativos": 25, "interacoes_totais": 100, "picos_horarios_textual": "10:00-10:10 pico de perguntas"}
      ],
      "tendencias_semanais": [
        {"semana_iso": "2025-W51", "media_indice": 60.5, "variacao_percentual": -0.05}
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 15.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.7

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular alertas e relatórios.
• 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 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.

4.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 educador.