Agente de IA para Relatórios de Progresso de Alunos

Preparar os parâmetros e payloads padronizados de consulta para fontes acadêmicas e comportamentais, garantindo escopo, período e identificadores corretos 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 um objeto JSON com as informações necessárias via API. Na fase de testes, os dados serão enviados 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 objeto JSON contendo informações sobre o aluno e o período de referência.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (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 objeto JSON contendo os payloads preparados para consulta nas fontes de dados acadêmicas e comportamentais.
• Exemplo de Estrutura de Output:

   {
    "payload_academico": {...},
    "payload_comportamental": {...},
    "versao_payload": "1.0",
    "id_de_lote": "abc123"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 1.200 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 Execução de Chamada à API - Acadêmico (RF 2) e o Agente de Execução de Chamada à API - Comportamental (RF 3).

1.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 - Acadêmico (RF 2) e o Agente de Execução de Chamada à API - Comportamental (RF 3).

Realizar chamada à API do Sistema Acadêmico para obter notas, frequência e tarefas no período solicitado.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do Agente Orquestrador de Parâmetros de Coleta (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um payload JSON preparado pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados acadêmicos brutos recuperados.
• Exemplo de Estrutura de Output:

   {
    "avaliacoes": [...],
    "notas_por_disciplina": [...],
    "frequencia": [...],
    "faltas": [...],
    "tarefas": [...]
  } 

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

2.3.3 Parâmetros de Geração

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

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa do Sistema Acadêmico e retornar os dados recebidos como resposta.

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 Consolidação e Qualidade de Dados (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Qualidade de Dados (RF 4).

Realizar chamada à API do Sistema Comportamental para obter registros de ocorrências, elogios e medidas disciplinares.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do Agente Orquestrador de Parâmetros de Coleta (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um payload JSON preparado pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados comportamentais brutos recuperados.
• Exemplo de Estrutura de Output:

   {
    "eventos": [...],
    "elogios": [...],
    "advertencias": [...],
    "suspensoes": [...]
  } 

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

3.3.3 Parâmetros de Geração

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

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa do Sistema Comportamental e retornar os dados recebidos como resposta.

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 deve ser visível para o Agente de Consolidação e Qualidade de Dados (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Qualidade de Dados (RF 4).

Unificar, normalizar e calcular indicadores a partir dos dados acadêmicos e comportamentais, produzindo um dataset único por aluno para geração de relatório.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes Agente de Execução de Chamada à API - Acadêmico (RF 2) e Agente de Execução de Chamada à API - Comportamental (RF 3).
• Tipo do input: Este agente deve ser apto a receber dados brutos acadêmicos e comportamentais como input.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input combinado de até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON estruturado por aluno, contendo métricas por disciplina, métricas globais, eventos comportamentais agregados e série temporal resumida.
• Exemplo de Estrutura de Output:

   {
    "aluno_id": "123",
    "periodo": "2025-01",
    "disciplinas": [...],
    "globais": {...},
    "comportamento": {...},
    "associacoes": [...],
    "completude_percent": 95,
    "observacoes_qualidade": [...],
    "id_de_lote": "abc123"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 4.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para cálculos de indicadores.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 gerada por este agente deve ser visível para o Agente de Geração de Relatórios Personalizados (RF 5).

4.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 Personalizados (RF 5).

Produzir relatório claro e acessível para reuniões com professores e pais, destacando pontos fortes, áreas de melhoria e recomendações acionáveis por aluno.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do Agente de Consolidação e Qualidade de Dados (RF 4).
• Tipo do input: Este agente deve ser apto a receber um dataset consolidado por aluno como input.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 6.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório personalizado por aluno em texto estruturado (markdown permitido) e um JSON auxiliar com indicadores e recomendações.
• Exemplo de Estrutura de Output:

   **Aluno:** João Silva
  **Período:** 2025-01
  **Resumo Executivo:** João apresentou melhorias significativas em Matemática, mas precisa focar em Ciências.
  
  ### Desempenho Acadêmico
  - **Matemática:** Média 7.8, tendência subindo.
  - **Ciências:** Média 5.9, tendência caindo.
  
  ### Comportamento
  - Eventos críticos: 2 advertências em Ciências.
  
  ### Principais Forças
  - Matemática: Excelente progresso.
  - Frequência: 98% em todas as disciplinas.
  
  ### Áreas de Melhoria
  - Ciências: Melhorar notas e comportamento.
  - Português: Aumentar participação.
  
  ### Recomendações SMART
  - **Matemática:** Elevar média de 5.8 para 6.5 em 8 semanas, com apoio de monitoria.
  
  ### Alertas de Qualidade de Dados
  - Dados de frequência incompletos em História.
  
  JSON auxiliar:
  {
    "aluno_id": "123",
    "periodo": "2025-01",
    "highlights": [...],
    "melhorias": [...],
    "recomendacoes": [...],
    "caso_prioritario": false,
    "links_secoes": {...}
  } 

• Número de caracteres esperado: O relatório final deve ter um tamanho aproximado de 5.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Após realizar o processamento, o agente enviará sua resposta para o sistema de gestão escolar para registro e consulta futura.

5.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 (relatório e JSON auxiliar) é o entregável final e não é passada para outros agentes internos.

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