Agente de IA para Geração de Relatórios de Frequência Escolar

Padronizar e validar os registros de presença antes da análise, assegurando consistência de campos, datas e status de frequê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 um arquivo de dados de presença 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: Dados brutos de presença em formatos CSV/TSV/XLSX/JSON.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .tsv, .xlsx, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de dados com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo registros normalizados, total de dias letivos e inconsistências.
• Exemplo de Estrutura de Output:

   {
    "registros_normalizados": [
      {"aluno_id": "123", "data": "2025-10-01", "status": "P"}
    ],
    "total_dias_letivos": 180,
    "inconsistencias": []
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.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 Cálculo de Frequência por Aluno (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 Frequência por Aluno (RF 2).

Consolidar métricas de frequência por aluno e calcular percentuais conforme políticas definidas.

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: JSON com registros normalizados, total de dias letivos e parâmetros de cálculo.
• 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 com resumo por aluno, média geral percentual e alunos em alerta.
• Exemplo de Estrutura de Output:

   {
    "resumo_por_aluno": [
      {"aluno_id": "123", "percentual_frequencia": 95.5}
    ],
    "media_geral_percentual": 90.0,
    "alunos_em_alerta": []
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 2.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 Geração de Relatórios de Frequência Escolar (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 Relatórios de Frequência Escolar (RF 3).

Produzir relatório padronizado e detalhado de frequência para acompanhamento por escola/turma e 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: JSON com resumo por aluno, média geral percentual e alunos em alerta.
• 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.

3.3.2 Especificação do Output

• Formato de output: Relatório em texto estruturado (markdown-friendly) e um anexo JSON com o mesmo conteúdo tabular.
• Exemplo de Estrutura de Output:

  Relatório:
  **Cabeçalho**
  - Escola: XYZ
  - Turma: 10A
  - Período: 2025-01-01 a 2025-12-31
  
  **Sumário Executivo**
  - Média Geral: 90.00%
  - Total de Alunos: 30
  - Alunos em Alerta: 3 (10%)
  
  **Tabela por Aluno**
  - 123 (José Silva): 95.50% [ALERTA]
  
  **Destaques**
  - Top 5 Menor Frequência: 123, 456, 789
  
  **Observações de Cálculo**
  - Política de Justificadas: desconta_do_denominador
  - Parâmetro de Atraso: 0.5
  
  Anexo JSON:
  {
    "cabecalho": {...},
    "sumario_executivo": {...},
    "tabela_alunos": [...],
    "destaques": {...},
    "observacoes_calculo": {...}
  } 

• Número de caracteres esperado: O relatório completo e o anexo JSON devem ter um tamanho estimado em 5.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 é 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 relatório gerado é o resultado que deve ser disponibilizado ao usuário.