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

Receber arquivos de frequência, validar a estrutura e conteúdo, normalizar formatos e produzir um dataset padronizado e confiável para cálculo de indicadores.

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 arquivos de frequência escolar 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 arquivo de frequência escolar, que é processado para gerar um dataset padronizado.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .csv, .json, .xlsx.
• 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 objeto JSON contendo o dataset normalizado, erros e avisos de validação.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": [
      {"aluno_id": "001", "nome_aluno": "João Silva", "turma_id": "3A", "data": "2025-11-01", "status_presenca": "P"}
    ],
    "schema_valid": true,
    "erros_bloqueantes": [],
    "avisos_nao_bloqueantes": [
      {"tipo": "status_desconhecido", "detalhe": "3 ocorrências", "turma_id": "3A"}
    ],
    "totais_processados": {"turma_3A": 30}
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 5.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Consolidação e Cálculo de Indicadores de Frequência (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Cálculo de Indicadores de Frequência (RF 2).

Consolidar o dataset normalizado por aluno/turma/período e calcular indicadores-chave de presença, ausência e alertas.

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 o dataset normalizado de frequência escolar.
• 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 JSON com indicadores de frequência por aluno e turma.
• Exemplo de Estrutura de Output:

   {
    "indicadores_por_aluno": [
      {"aluno_id": "001", "nome_aluno": "João Silva", "turma_id": "3A", "frequencia_percentual": 92.5, "alerta_baixa_frequencia": false}
    ],
    "indicadores_por_turma": [
      {"turma_id": "3A", "media_frequencia": 90.0}
    ],
    "datas_sem_dado": ["2025-11-01"],
    "parametros_utilizados": {"limiar_alerta_frequencia": 75}
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para cálculo de indicadores.
• 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 para Pais e Responsáveis (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 para Pais e Responsáveis (RF 3).

Produzir relatórios claros e acessíveis para cada aluno, com linguagem simples, resumos, detalhes por dia e orientações quando há alertas.

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 com indicadores de frequência por aluno e turma.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório formatado em Markdown/HTML para cada aluno.
• Exemplo de Estrutura de Output:

   {
    "cabecalho": {"nome_aluno": "João Silva", "turma": "3A", "periodo": "01/11/2025 a 30/11/2025", "frequencia_percentual": 92.5},
    "resumo": {"presencas": 18, "faltas": 2, "faltas_justificadas": 1, "atrasos": 1},
    "calendario_resumido": [
      {"data": "01/11/2025", "status": "P"}
    ],
    "alertas": ["Frequência abaixo do limiar"],
    "orientacoes": "Recomenda-se reforçar o acompanhamento da frequência escolar.",
    "formato_renderizado": "html",
    "json_compacto": {"aluno_id": "001", "frequencia_percentual": 92.5}
  } 

• Número de caracteres esperado: O relatório terá um tamanho aproximado de 2.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

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 Execução de Chamada à API (RF 4).

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

Enviar o relatório final de cada aluno para a plataforma dos responsáveis por meio de endpoint previamente configurado.

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 como input o relatório final de frequência escolar de cada aluno.
• 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 objeto JSON contendo o resultado da chamada à API.
• Exemplo de Estrutura de Output:

   {
    "status_code": 200,
    "id_externo": "https://escola.edu.br/relatorios/001",
    "body_resposta": "Relatório enviado com sucesso."
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 500 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o relatório para a API externa configurada e retornar o status recebido como resposta.

4.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 (resultado da chamada à API) é 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 status da chamada à API é o resultado que deve ser disponibilizado ao usuário.