Agente de IA para Suporte em Feedback de Atividades

09 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que coleta e analisa feedback dos alunos sobre atividades extracurriculares.

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 e consulta a documentos para o Fluxo de Agentes "Suporte em Feedback de Atividades", uma solução de automação projetada para coletar e analisar feedback dos alunos sobre atividades extracurriculares. 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 feedback dos alunos em insights acionáveis que ajudem na melhoria contínua das atividades oferecidas.

2. Contexto e Problema

Cenário Atual

Atualmente, as instituições educacionais oferecem uma variedade de atividades extracurriculares, mas enfrentam desafios para obter feedback estruturado e analisado sobre essas atividades. Isso resulta em dificuldades para identificar áreas de melhoria e adaptar as atividades às necessidades dos alunos.


Problemas Identificados

  • Falta de feedback estruturado: As instituições não possuem um mecanismo eficaz para coletar e estruturar o feedback dos alunos sobre as atividades oferecidas.
  • Análise de feedback ineficiente: A análise manual de feedbacks é demorada e propensa a erros, dificultando a identificação de padrões e tendências.
  • Falta de insights acionáveis: Sem uma análise adequada, as instituições não conseguem gerar insights que possam ser usados para melhorar as atividades.

3. Impactos Esperados

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

  • Estruturar feedbacks de forma contínua, garantindo que todas as opiniões dos alunos sejam capturadas e organizadas.
  • Melhorar a qualidade das atividades extracurriculares com base nos insights gerados a partir dos feedbacks analisados.
  • Reduzir o tempo de análise de feedbacks em pelo menos 70%, liberando recursos para outras atividades estratégicas.
  • Aumentar a satisfação dos alunos ao adaptar as atividades às suas necessidades e preferências.

4. Visão Geral da Solução

O agente de IA para suporte em feedback de atividades processa feedbacks dos alunos em texto livre, estrutura esses dados em categorias predefinidas e gera insights acionáveis para a melhoria contínua das atividades. 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 coleta e análise de feedbacks.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a coleta contínua de feedbacks dos alunos e termina com a geração de insights estruturados em formato Markdown.

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

Agentes Função Principal
Agente de Coleta de Feedback de Atividades Extracurriculares (RF 1) Coletar feedback de forma contínua e estruturada dos alunos sobre as atividades extracurriculares.
Agente de Análise de Feedback de Atividades Extracurriculares (RF 2) Analisar feedback estruturado para gerar insights que ajudem na melhoria das atividades oferecidas.

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.

6. Requisitos Funcionais

RF 1. Agente de Coleta de Feedback de Atividades Extracurriculares

1.1 Tarefa do Agente

Coletar feedback de forma contínua e estruturada dos alunos sobre as atividades extracurriculares.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo feedbacks dos alunos em texto livre sobre as atividades extracurriculares. Este texto é a opinião dos alunos sobre as atividades que participaram.

# 2. Objetivo
Coletar e estruturar o feedback dos alunos em categorias pré-definidas, como 'satisfação', 'dificuldades', 'sugestões'.

# 3. Regras que você deve seguir para gerar sua resposta
- Estruture o feedback recebido em categorias pré-definidas.
- Identifique palavras-chave e sentimentos expressos no feedback.
- Assegure que todos os feedbacks sejam capturados em tempo real.
- Valide a completude dos feedbacks e solicite informações adicionais quando necessário.
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 feedbacks dos alunos em texto livre 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 na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo é um texto livre contendo feedbacks dos alunos.
  • Formatos Suportados: Esse agente deve ser capaz de receber feedbacks nos formatos: .txt, .md.
  • 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 arquivo no formato JSON contendo os feedbacks estruturados em categorias pré-definidas.
  • Exemplo de Estrutura de Output:
     {
      "feedbacks": [
        {
          "categoria": "satisfação",
          "conteúdo": "Os alunos estão satisfeitos com as atividades oferecidas."
        },
        {
          "categoria": "dificuldades",
          "conteúdo": "Alguns alunos apontaram dificuldades em acessar os materiais complementares."
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 2.000 caracteres.

1.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Feedback de Atividades Extracurriculares (RF 2).

RF 2. Agente de Análise de Feedback de Atividades Extracurriculares

2.1 Tarefa do Agente

Analisar feedback estruturado para gerar insights que ajudem na melhoria das atividades oferecidas.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo feedbacks estruturados em formato JSON, que foram coletados e categorizados por um agente anterior.

# 2. Objetivo
Analisar os feedbacks estruturados para gerar insights que ajudem na melhoria contínua das atividades oferecidas.

# 3. Regras que você deve seguir para gerar sua resposta
- Analisar tendências e padrões nos feedbacks, identificando áreas comuns de satisfação e insatisfação.
- Priorizar insights com base na frequência e na intensidade dos feedbacks coletados.
- Sugerir ações específicas e práticas para melhoria das atividades, incluindo recomendações detalhadas.
- Gerar relatórios comparativos periódicos que mostrem evolução ou regressão nas percepções dos alunos ao longo do tempo.
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 do agente anterior (RF 1).
  • Tipo do input: Este agente deve ser apto a receber como input um arquivo JSON contendo feedbacks estruturados.
  • 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é 5.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo no formato Markdown contendo insights sobre melhorias das atividades.
  • Exemplo de Estrutura de Output:
     ### Insights para Melhoria das Atividades
    - **Satisfação Geral:** A maioria dos alunos está satisfeita com as atividades oferecidas.
    - **Dificuldades Apontadas:** Alguns alunos relataram dificuldades em acessar os materiais.
    - **Sugestões de Melhoria:**
      1. Melhorar o acesso aos materiais complementares.
      2. Aumentar a diversidade de atividades oferecidas.
    
  • Número de caracteres esperado: O Markdown gerado deve ter um tamanho aproximado de 2.000 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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

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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. Os insights gerados são o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.