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 "Revisão de Conteúdo de Avaliações", uma solução projetada para garantir a clareza das questões e a adequação ao nível de ensino. 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 o input de texto de avaliações em um relatório de revisão que sugere melhorias e ajustes, garantindo a qualidade e a clareza das avaliações educacionais.
2. Contexto e Problema
Problemas Específicos
O agente de IA foi projetado para resolver problemas específicos já conhecidos no contexto de avaliações educacionais:
- Questões de avaliação que não são claras ou não estão adequadas ao nível de ensino.
- Necessidade de revisão constante de conteúdo para garantir a qualidade das avaliações.
A falta de clareza nas questões pode levar à interpretação errada por parte dos alunos, enquanto a inadequação ao nível de ensino pode resultar em avaliações que não refletem o aprendizado esperado.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Melhorar a clareza das questões de avaliação, garantindo que a linguagem utilizada seja objetiva e livre de ambiguidades.
- Assegurar a adequação das questões ao nível de ensino, considerando vocabulário, conceitos e habilidades exigidas.
- Facilitar a comunicação entre educadores para alinhar expectativas e práticas de avaliação.
- Reduzir o tempo necessário para revisões manuais, automatizando a análise e sugestão de melhorias nas questões.
4. Visão Geral da Solução
O agente de IA para revisão de conteúdo de avaliações analisa o texto das avaliações, sugere melhorias para garantir a clareza das questões e a adequação ao nível de ensino. 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 revisão de conteúdo de avaliações.
A solução consiste em um agente de IA que recebe avaliações em formato de texto e gera um relatório de revisão com sugestões de melhorias em formato markdown.
| Agente | Função Principal |
|---|---|
Agente de Revisão de Conteúdo de Avaliações (RF 1)
| Revisar o conteúdo de avaliações garantindo clareza e adequação ao nível de ensino. |
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 do agente quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Revisão de Conteúdo de Avaliações
1.1 Tarefa do Agente
Revisar o conteúdo de avaliações garantindo clareza e adequação ao nível de ensino.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo avaliações em formato de texto. Este texto contém questões de avaliação que precisam ser revistas para garantir clareza e adequação ao nível de ensino. # 2. Objetivo Analisar o conteúdo das avaliações para garantir clareza e adequação, sugerindo melhorias e ajustes nas questões para aprimorar a qualidade das avaliações. # 3. Regras que você deve seguir para gerar sua resposta - Identificar questões de avaliação que não sejam claras, verificando se a linguagem utilizada é objetiva e livre de ambiguidades. Em caso de identificação de linguagem ambígua, proponha reformulações específicas. - Avaliar a adequação das questões ao nível de ensino, considerando a complexidade do vocabulário, conceitos abordados e habilidades exigidas. Se a questão não estiver adequada, sugira ajustes claros e específicos. - Sugerir reformulações nas questões que apresentem problemas de clareza ou adequação, propondo alternativas mais claras ou ajustadas ao nível de ensino. Forneça exemplos concretos de reformulações quando possível. - Priorizar a revisão de questões que já apresentaram problemas em avaliações anteriores ou que são frequentemente mal interpretadas pelos alunos. Identifique padrões de erro e sugira correções direcionadas. - Facilitar a comunicação e troca de feedback entre educadores, criando um canal para discussão sobre as sugestões de melhorias propostas no relatório de revisão. Estabeleça um processo formal para coleta e implementação de feedback.
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 avaliações em formato de texto 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 texto na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um texto contendo questões de avaliação.
-
Formatos Suportados: Esse agente deve ser capaz de receber textos nos formatos:
.txt,.docx,.pdf. - 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 de revisão formatado em **Markdown**. A estrutura deve incluir sugestões de melhorias e ajustes nas questões, apresentados de forma clara e objetiva.
-
Exemplo de Estrutura de Output:
**Sugestões de Melhoria:** 1. Reformular a questão 3 para maior clareza: "Explique o conceito de fotossíntese...". 2. Ajustar a questão 5 para o nível de ensino: "Descreva o processo de mitose em células vegetais".
- Número de caracteres esperado: O relatório final deve ser claro e conciso, com um tamanho estimado em torno de 4.000 caracteres, podendo variar conforme a complexidade das avaliações revisadas.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.7
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.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para educadores responsáveis pela avaliação.
1.3.6 Regras de Orquestração e Transição
Este agente finaliza o fluxo ao gerar o relatório de revisão, que deve ser disponibilizado aos educadores para implementação das melhorias sugeridas.