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 o Agente de IA "Análise de Dados de Pesquisa de Clima Escolar", uma solução de automação projetada para analisar dados de pesquisas sobre o clima escolar. 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 de pesquisa em insights acionáveis e relatórios personalizados que possam ser usados para melhorar o ambiente escolar, reduzindo o tempo de análise manual.
2. Contexto e Problema
Cenário Atual
As escolas frequentemente realizam pesquisas para entender o clima escolar e a percepção dos alunos. No entanto, a análise manual desses dados é demorada e pode atrasar a implementação de melhorias necessárias.
- Análise manual e demorada de dados de pesquisa sobre o clima escolar, que pode atrasar a implementação de melhorias.
- Necessidade de insights rápidos e precisos sobre a percepção dos alunos para guiar ações corretivas.
Após a coleta de dados, a administração escolar precisa de insights rápidos e precisos para guiar ações corretivas e melhorar o ambiente escolar.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de análise de dados em pelo menos 70%.
- Fornecer insights precisos e acionáveis sobre a percepção dos alunos.
- Aumentar a eficiência na implementação de melhorias no ambiente escolar.
- Gerar relatórios personalizados que atendam às necessidades específicas da administração escolar.
4. Visão Geral da Solução
O agente de IA para análise de dados de pesquisa de clima escolar processa dados de pesquisa em formato CSV, aplica regras de análise para identificar padrões e tendências, e gera relatórios personalizados com insights acionáveis. 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 dados de pesquisas escolares.
A solução consiste em um agente de IA que transforma dados de pesquisa em insights acionáveis, fornecendo relatórios personalizados para a administração escolar.
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 administração escolar receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Dados de Pesquisa de Clima Escolar
1.1 Tarefa do Agente
Analisar dados de pesquisas sobre o clima escolar para fornecer insights sobre a percepção dos alunos e áreas de melhoria.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de pesquisa sobre o clima escolar em formato CSV. Estes dados contêm informações sobre a percepção dos alunos em relação ao ambiente escolar. # 2. Objetivo Analisar os dados para fornecer insights acionáveis e gerar relatórios personalizados que possam ser usados para melhorar o ambiente escolar. # 3. Regras que você deve seguir para gerar sua resposta - Extraia e identifique padrões e tendências nos dados de pesquisa, considerando aspectos como satisfação geral, áreas de insatisfação e sugestões dos alunos. - Calcule a frequência e a distribuição das respostas para detectar questões críticas e prioritárias para intervenção. - Desenvolva insights acionáveis baseados nos dados analisados, destacando áreas que necessitam de atenção imediata e propondo recomendações práticas. - Estruture o relatório de forma clara e objetiva, evidenciando os pontos fortes e fracos do ambiente escolar conforme identificado na pesquisa, e sugira medidas específicas para melhorias. # 4. Exemplo de Output que você deve produzir **Relatório de Clima Escolar:** - **Satisfação Geral:** 85% dos alunos estão satisfeitos com o ambiente escolar. - **Áreas de Insatisfação:** Refeições, Transporte - **Recomendações:** Melhorar a qualidade das refeições e a pontualidade dos transportes.
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 um arquivo CSV com dados de pesquisa sobre o clima escolar 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 do CSV na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo CSV contendo colunas 'pergunta', 'resposta', 'aluno_id'.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um relatório formatado em **Markdown**. A estrutura deve conter seções para satisfação geral, áreas de insatisfação e recomendações, destacando insights acionáveis.
-
Exemplo de Estrutura de Output:
**Relatório de Clima Escolar:** - **Satisfação Geral:** 85% dos alunos estão satisfeitos com o ambiente escolar. - **Áreas de Insatisfação:** Refeições, Transporte - **Recomendações:** Melhorar a qualidade das refeições e a pontualidade dos transportes.
- Número de caracteres esperado: O relatório final deve ser conciso e informativo, com um tamanho estimado em torno de 3.000 caracteres, podendo variar conforme a complexidade dos dados analisados.
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 a administração escolar responsável pela implementação das melhorias.
1.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo, gerando o relatório que será utilizado pela administração escolar.