Agente de IA para Monitoramento de Progresso Educacional

Receber a configuração de fontes de dados e produzir parâmetros padronizados para coleta via API e/ou consulta a documentos, além de definir o período de análise e chaves de unificação.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio da configuração das fontes de dados 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 de um arquivo 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 a configuração das fontes de dados.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os parâmetros padronizados para coleta de dados.
• Exemplo de Estrutura de Output:

   {
    "coleta_via_api": true,
    "coleta_via_documento": false,
    "parametros_api": { ... },
    "parametros_documento": { ... },
    "padroes_unificacao": { "chave_aluno": "aluno_id", "chave_data": "data" },
    "periodo_analisado": { "inicio": "YYYY-MM-DD", "fim": "YYYY-MM-DD" }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Realizar chamadas às APIs configuradas para obter dados de avaliações, frequências e tarefas no período informado.

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 os parâmetros configurados para as chamadas às APIs.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados obtidos das APIs.
• Exemplo de Estrutura de Output:

   {
    "dados_api": { "avaliacoes": [ ... ], "frequencias": [ ... ], "tarefas": [ ... ] }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho variável, dependendo da quantidade de dados retornados pelas APIs.

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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá se conectar às APIs configuradas para obter os dados necessários.

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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Realizar consulta a documentos (CSV/XLSX) informados para obter dados de avaliações, frequências e tarefas.

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 1).
• Tipo do input: Este agente deve ser apto a receber como input os parâmetros configurados para as consultas a documentos.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo os dados obtidos das consultas a documentos.
• Exemplo de Estrutura de Output:

   {
    "dados_documento": { "avaliacoes": [ ... ], "frequencias": [ ... ], "tarefas": [ ... ] }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho variável, dependendo da quantidade de dados retornados pelas consultas.

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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá acessar os documentos configurados para obter os dados necessários.

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 próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Ingerir dados acadêmicos de múltiplas fontes e períodos, padronizar escalas, tratar ausências e consolidar métricas por aluno, disciplina e período temporal.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão dos agentes de coleta de dados (RF 2 e RF 3).
• Tipo do input: Este agente deve ser apto a receber como input os dados acadêmicos brutos coletados pelos agentes anteriores.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON consolidado contendo as métricas padronizadas por aluno e disciplina.
• Exemplo de Estrutura de Output:

   {
    "periodo_analisado": {"inicio": "YYYY-MM-DD", "fim": "YYYY-MM-DD"},
    "consolidado": [{"aluno_id": "A123", "aluno_referencia": "iniciais_ou_id", "turma": "8A", "disciplinas": [{...}], "indicadores_gerais": {...}, "metadados": {...}}]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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 documentos externos.
• Calculadora: Utiliza lógica interna para cálculos de normalização e consolidação.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 gerada por este agente deve ser visível para o próximo agente no fluxo.

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

Ao concluir sua execução, esse agente aciona o próximo agente no fluxo.

Produzir relatórios em markdown, claros e acionáveis, destacando avanços, áreas que necessitam atenção e recomendações específicas para professores e para pais/responsáveis.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber como input o objeto JSON consolidado com os dados acadêmicos padronizados.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório em formato Markdown, destacando avanços, áreas que necessitam atenção e recomendações.
• Exemplo de Estrutura de Output:

   # Relatório de Progresso Educacional
  
  Período analisado: YYYY-MM-DD a YYYY-MM-DD
  Turma: 8A
  Aluno (referência): iniciais_ou_id
  
  ## Destaques de Avanço
  - Matemática: melhoria consistente nas últimas 6 semanas (tendência 30 dias: +0.18); média atual 7.9.
  
  ## Áreas que necessitam atenção
  - Matemática: queda leve recente (tendência 30 dias: -0.12) com lacuna em frações avançadas; 1 tarefa em atraso; frequência 92.5% (OK, acima de 85%).
  
  ## Recomendações para Professores
  - Foco em revisão dirigida de frações avançadas com exercícios graduais (3 encontros); aplicar miniavaliação diagnóstica ao final.
  - Monitorar tarefas: reduzir carga de itens longos; reforçar prazos com lembretes estruturados.
  
  ## Recomendações para Pais/Responsáveis
  - Estabelecer rotina de 20 minutos, 3x por semana, para prática guiada de frações (usar lista sugerida pelo professor).
  - Verificar agenda de entregas e apoiar cumprimento dos prazos na próxima quinzena.
  
  ## Indicadores Gerais do Aluno
  - Nota média global: 7.2
  - Frequência global: 95.1%
  - Tendência global (30d): estável
  
  ## Observações de Qualidade de Dados
  - 2 registros sem escala_max foram normalizados via regra padrão; 1 avaliação duplicada removida.
  
  ---
  
  # Versão para Equipe Docente (Síntese por Disciplina)
  - Matemática: média 7.9; lacunas: frações avançadas; ações: revisão dirigida, miniavaliação em 2 semanas.
  - Português: média 7.1; estabilidade; sem lacunas críticas.
  
  # Versão para Pais/Responsáveis (Linguagem Acessível)
  - Seu(a) filho(a) manteve bom desempenho geral e precisa reforçar frações avançadas em matemática. Recomendamos sessões curtas 3x/semana e atenção aos prazos das tarefas.
   

• Número de caracteres esperado: O relatório em Markdown terá um tamanho aproximado de 3.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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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

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.