Agente de IA para Análise de Frequência Escolar

Realizar chamada à API do Sistema de Gestão Escolar (SGE) para obter registros de frequência dos alunos dentro de um intervalo de datas.

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 de execução contendo: endpoint_base, credenciais/token já válidos, parâmetros de filtro (data_inicial, data_final, escola_id, turma_id opcional), e campos desejados. 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: Payload pronto para execução.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um payload de até 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: Dados brutos recuperados da API em JSON com registros de frequência por dia/aluno.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "data": "2025-12-13",
    "status_presenca": "presente",
    "turma_id": "678",
    "escola_id": "001",
    "motivo_ausencia": null
  } 

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

1.3.3 Parâmetros de Geração

N/A

1.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá realizar chamadas à API do SGE.

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 e Validação de Dados 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 Padronização e Validação de Dados de Frequência (RF 2).

Padronizar o dataset de frequência, validar consistência e preparar base única para análise.

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: JSON bruto retornado pela API contendo registros de frequência por aluno e dia.
• Formatos Suportados: 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: JSON padronizado com: schema unificado (aluno_id, data, presente: boolean, turma_id, escola_id, motivo_ausencia, origem_registro), registros deduplicados e validados, além de um bloco de metadados de qualidade.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "data": "2025-12-13",
    "presente": true,
    "turma_id": "678",
    "escola_id": "001",
    "motivo_ausencia": null
  } 

• 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

N/A

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• 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 Análise de Padrões de Frequência e Absenteísmo (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 Frequência e Absenteísmo (RF 3).

Calcular métricas de frequência por aluno/turma/período e identificar padrões de absenteísmo e riscos.

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: JSON padronizado de frequência contendo campos (aluno_id, data, presente, turma_id, escola_id, ausencia_justificada).
• Formatos Suportados: 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: JSON com: métricas por aluno e turma, séries por período, flags de risco e um bloco de recomendações de ação por caso.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "12345",
    "frequencia_%": 85.0,
    "dias_presentes": 17,
    "dias_ausentes_justificados": 2,
    "dias_ausentes_injustificados": 1,
    "frequencia_abaixo_limiar": false,
    "ausencia_mensal_acima_limiar": false,
    "sequencias_ausencia>=3": false,
    "queda_sustentada": false,
    "recomendacoes": "Acompanhamento padrão."
  } 

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

3.3.3 Parâmetros de Geração

N/A

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• 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 Geração de Relatórios de Frequência e Absenteísmo (RF 4).

3.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 e Absenteísmo (RF 4).

Transformar a análise em relatórios executivos e operacionais para suporte à decisão.

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: JSON de análise contendo métricas, consolidações e flags de risco por aluno/turma/escola, além dos parâmetros utilizados.
• Formatos Suportados: JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: Relatório em JSON estruturado com: 1) capa e sumário executivo; 2) indicadores-chave (KPI) globais e por turma; 3) lista priorizada de alunos em risco com justificativas; 4) tendências e datas críticas; 5) recomendações acionáveis; 6) anexo técnico com parâmetros, definições e notas de qualidade dos dados.
• Exemplo de Estrutura de Output:

   {
    "relatorio_humano": "Texto organizado por seções...",
    "relatorio_estruturado": {
      "capa": "...",
      "sumario_executivo": "...",
      "kpis": "...",
      "alunos_em_risco": "...",
      "tendencias": "...",
      "recomendacoes": "...",
      "anexo_tecnico": "..."
    }
  } 

• 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

N/A

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Após a geração, o relatório pode ser enviado ao SGE ou outra ferramenta de BI. Esse envio deve ser configurado manualmente na interface do fluxo na plataforma da Prototipe AI, no item 'Envio da Resposta do Agente'.

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