1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para um agente de IA destinado à análise de evolução acadêmica. 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 é criar um agente que analise o progresso acadêmico dos alunos ao longo do tempo, identificando tendências de melhoria ou declínio e gerando relatórios detalhados para a secretaria acadêmica.
2. Contexto e Problema
Cenário Atual
As instituições de ensino enfrentam dificuldades significativas para acompanhar o progresso acadêmico dos alunos ao longo do tempo. A avaliação manual dos dados históricos de desempenho é um processo demorado e sujeito a erros, o que pode resultar em decisões inadequadas sobre intervenções educacionais.
Problemas Identificados
- Dificuldade de Acompanhamento: Acompanhar o progresso acadêmico dos alunos ao longo do tempo é uma tarefa complexa devido ao grande volume de dados.
- Identificação de Tendências: Há uma necessidade crítica de identificar tendências de melhoria ou declínio no desempenho acadêmico dos alunos de forma rápida e precisa.
- Geração de Relatórios: A geração de relatórios detalhados e compreensíveis para a secretaria acadêmica é essencial para a tomada de decisões informadas.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Automatização da Análise: Automatizar a análise dos dados acadêmicos, reduzindo o tempo e esforço necessários para identificar padrões e tendências.
- Precisão na Identificação de Tendências: Aumentar a precisão na identificação de tendências de desempenho acadêmico, permitindo intervenções educacionais mais eficazes.
- Relatórios Detalhados: Fornecer relatórios detalhados e visuais que auxiliem a secretaria acadêmica na tomada de decisões.
4. Visão Geral da Solução
O agente de IA para análise de evolução acadêmica processa dados históricos de desempenho acadêmico, aplica regras para identificar padrões e tendências, e gera relatórios detalhados para a secretaria acadêmica. 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 análise de evolução acadêmica.
A solução consiste em um agente de IA que recebe dados históricos de desempenho acadêmico em formato CSV ou planilha, analisa esses dados para identificar tendências de melhoria ou declínio no desempenho dos alunos, e gera relatórios detalhados em formato markdown, incluindo gráficos e tabelas.
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram o fluxo de trabalho do agente e os resultados finais que a secretaria acadêmica receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Evolução Acadêmica
1.1 Tarefa do Agente
Analisar o progresso acadêmico dos alunos ao longo do tempo, identificando tendências de melhoria ou declínio e gerando relatórios detalhados para a secretaria acadêmica.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados históricos de desempenho acadêmico em formato CSV ou planilha. Estes dados incluem colunas como 'ano', 'semestre', 'aluno' e 'nota'. # 2. Objetivo Analisar os dados para identificar padrões e tendências no desempenho acadêmico dos alunos, gerando relatórios detalhados para a secretaria acadêmica. # 3. Regras que você deve seguir para gerar sua resposta - Analise os dados históricos de desempenho acadêmico, calculando médias de notas, variações de semestre para semestre e identificando padrões de desempenho ao longo dos anos. - Identifique tendências significativas de melhoria ou declínio no desempenho acadêmico, considerando variáveis como mudanças curriculares ou eventos externos que possam ter influenciado os resultados. - Incorpore gráficos e tabelas que ilustrem claramente as tendências identificadas, garantindo que a visualização dos dados seja acessível e compreensível para a secretaria acadêmica. - Forneça insights acionáveis no relatório que possam auxiliar a secretaria acadêmica na tomada de decisões, como identificar intervenções necessárias ou propor ajustes curriculares específicos. - Antes de iniciar a análise, verifique se os dados estão completos e precisos, eliminando registros duplicados ou inconsistentes para garantir a precisão das conclusões.
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 históricos de desempenho acadêmico 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 CSV na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo de dados estruturados, que após ser processado, resulta em insights acadêmicos.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csve.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 relatório detalhado em formato **Markdown**, incluindo gráficos e tabelas que ilustram as tendências identificadas.
-
Exemplo de Estrutura de Output:
**Relatório de Evolução Acadêmica** ### Tendências Identificadas 1. Aumento consistente nas notas de matemática no último ano. 2. Declínio nas notas de ciências no semestre atual. ### Gráficos e Tabelas - Gráfico 1: Evolução das Notas de Matemática - Tabela 1: Variação Semestral de Notas de Ciências
- Número de caracteres esperado: O relatório final deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados analisados.
1.3.3 Parâmetros de Geração
- Modelo: Gemini 2.5 Pro
- Temperatura: 0.6
1.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Utiliza lógica interna para cálculos estatísticos e geração de gráficos.
- 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 é o entregável final e não é passada para outros agentes internos.
1.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 à secretaria acadêmica.