PrototipeAI | Agente de IA para Relatórios de Progresso Escolar

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos, busca online, consulta a documentos e demais requisitos funcionais para o Fluxo de Agentes "Relatórios de Progresso Escolar", uma solução de automação projetada para gerar relatórios de progresso claros e compreensíveis a partir de dados de desempenho acadêmico e comportamental dos alunos. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é transformar dados brutos em relatórios que destaquem áreas de sucesso e as que precisam de atenção, reduzindo significativamente o tempo e esforço necessários para criação manual desses relatórios.

2. Contexto e Problema

Cenário Atual

Educadores enfrentam um desafio significativo ao criar relatórios de progresso escolar que sejam detalhados e compreensíveis. A necessidade de sintetizar dados de desempenho acadêmico e comportamental em relatórios claros para pais e educadores requer tempo e esforço consideráveis.

Tempo e esforço significativos necessários para criar relatórios de progresso escolar detalhados.
Necessidade de fornecer relatórios claros e compreensíveis para pais e educadores.

Problemas Identificados

Consumo de tempo: A elaboração manual de relatórios consome um tempo valioso que poderia ser utilizado em atividades de ensino e planejamento.
Clareza e compreensão: A dificuldade em apresentar dados de forma clara pode levar a mal-entendidos sobre o progresso do aluno.
Consistência: A falta de padronização nos relatórios pode resultar em diferentes interpretações e expectativas.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

Reduzir o tempo de elaboração de relatórios em pelo menos 70%.
Padronizar a qualidade e o formato de todos os relatórios de progresso escolar.
Aumentar a clareza das informações apresentadas nos relatórios.
Fornecer recomendações práticas para melhorias com base nos dados analisados.

4. Visão Geral da Solução

O agente de IA para relatórios de progresso escolar processa dados de desempenho acadêmico e comportamental dos alunos, aplica regras para gerar relatórios claros e compreensíveis, destacando áreas de sucesso e aquelas que precisam de atenção. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na elaboração de relatórios de progresso escolar que atendam às necessidades específicas de pais e educadores.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a coleta e síntese de dados acadêmicos e comportamentais e termina com a geração de relatórios de progresso escolar.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes	Função Principal
`Agente de Coleta e Síntese de Dados Acadêmicos` (RF 1)	Coletar e sintetizar dados de desempenho acadêmico e comportamental dos alunos.
`Agente de Geração de Relatórios de Progresso Escolar` (RF 2)	Gerar relatórios de progresso claros e compreensíveis para pais e educadores.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Coleta e Síntese de Dados Acadêmicos

1.1 Tarefa do Agente

Coletar e sintetizar dados de desempenho acadêmico e comportamental dos alunos.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados brutos de desempenho acadêmico e comportamental dos alunos em formato CSV ou planilha. Estes dados incluem notas, participação em classe, e incidentes comportamentais.

# 2. Objetivo
Coletar e sintetizar esses dados para criar um registro único para cada aluno, destacando padrões e anomalias que possam exigir atenção especial.

# 3. Regras que você deve seguir para gerar sua resposta
- Estruture e consolide os dados de forma que cada aluno tenha um registro único, assegurando que não haja campos em branco ou valores inconsistentes.
- Identifique padrões de comportamento e desempenho, sinalizando automaticamente dados que exijam atenção especial ou que estejam fora dos padrões esperados.
- Gere alertas para quaisquer anomalias ou dados ausentes que possam comprometer a análise dos relatórios.

# 4. Exemplo de Output que você deve produzir
{
  "aluno": "João Silva",
  "desempenho_academico": {
    "matematica": "A",
    "portugues": "B"
  },
  "comportamento": {
    "participacao": "Boa",
    "disciplina": "Regular"
  }
}

1.3 Configurações do Agente

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 dados brutos de desempenho acadêmico e comportamental dos alunos 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 CSV na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: Dados brutos de desempenho acadêmico e comportamental dos alunos em formato CSV ou planilha.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .xlsx.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um objeto JSON contendo os dados sintetizados de cada aluno, com informações sobre desempenho acadêmico e comportamento.

Exemplo de Estrutura de Output:

 {
  "aluno": "João Silva",
  "desempenho_academico": {
    "matematica": "A",
    "portugues": "B"
  },
  "comportamento": {
    "participacao": "Boa",
    "disciplina": "Regular"
  }
}

Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 caracteres por aluno.

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 Geração de Relatórios de Progresso Escolar (RF 2).

1.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 Progresso Escolar (RF 2).

RF 2. Agente de Geração de Relatórios de Progresso Escolar

2.1 Tarefa do Agente

Gerar relatórios de progresso claros e compreensíveis para pais e educadores.

2.2 Prompt ou Instruções do Agente

# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados sintetizados de desempenho acadêmico e comportamental dos alunos. Estes dados foram organizados para fornecer uma visão clara do progresso de cada aluno.

# 2. Objetivo
Gerar relatórios de progresso que sejam claros, precisos e fáceis de entender, destacando as áreas de sucesso e as que precisam de atenção.

# 3. Regras que você deve seguir para gerar sua resposta
- Criar seções distintas para cada área de desempenho e comportamento, assegurando clareza e organização no relatório.
- Usar linguagem acessível e direta, evitando jargões técnicos para facilitar a compreensão por parte de pais e educadores.
- Incorporar gráficos ou tabelas simples para ilustrar o progresso e comparações, quando necessário, assegurando que os dados visuais complementem as informações textuais.
- Destacar as áreas de sucesso e as que precisam de atenção, fornecendo recomendações práticas para melhorias.

# 4. Exemplo de Output que você deve produzir
# Relatório de Progresso Escolar

**Aluno:** João Silva

## Desempenho Acadêmico
- **Matemática:** A
- **Português:** B

## Comportamento
- **Participação:** Boa
- **Disciplina:** Regular

### Áreas de Sucesso
- Excelente desempenho em Matemática.

### Áreas que Precisam de Atenção
- Disciplina regular, recomenda-se maior foco em comportamentos positivos.

### Recomendações
- Incentivar a participação em atividades extracurriculares para melhorar a disciplina.

2.3 Configurações do Agente

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: Dados sintetizados de desempenho acadêmico e comportamental dos alunos.
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 relatório de progresso em formato markdown, destacando áreas de sucesso e as que precisam de atenção.