Agente de IA para Monitoramento de Progresso em Estágios

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

Como criar um agente de IA que acompanha o progresso dos estudantes durante o estágio.

1. Propósito e Escopo

Este documento define todos os prompts e detalhes de requisitos para o Fluxo de Agentes "Monitoramento de Progresso em Estágios", uma solução de automação projetada para acompanhar o progresso dos estudantes durante seus estágios. 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 dados de progresso dos estudantes em relatórios periódicos e alertas para coordenadores, assegurando um acompanhamento contínuo e estruturado.

2. Contexto e Problema

Cenário Atual

Atualmente, o acompanhamento do progresso dos estudantes durante os estágios carece de um monitoramento contínuo e estruturado, o que dificulta a atualização regular e precisa para os coordenadores.


Problemas Identificados

  • Falta de monitoramento contínuo: A ausência de um sistema estruturado para monitorar o progresso dos estudantes em estágio resulta em dados dispersos e inconsistentes.
  • Atualizações irregulares: A dificuldade em fornecer atualizações regulares e precisas atrapalha a coordenação e intervenção oportuna dos coordenadores.

3. Impactos Esperados

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

  • Monitoramento contínuo e estruturado do progresso dos estudantes.
  • Atualizações regulares e precisas para coordenadores, melhorando a capacidade de intervenção e suporte.
  • Redução de desvios significativos no progresso dos estudantes através de alertas oportunos.

4. Visão Geral da Solução

O agente de IA para monitoramento de progresso em estágios coleta dados de progresso dos estudantes em intervalos regulares, gera relatórios periódicos e envia alertas para coordenadores em caso de problemas. 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 no acompanhamento do progresso dos estudantes durante seus estágios.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a coleta de dados de progresso e termina com o envio de alertas para coordenadores.

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

Agentes Função Principal
Agente de Coleta de Dados de Progresso (RF 1) Coletar dados de progresso dos estudantes em estágio em intervalos regulares.
Agente de Geração de Relatórios de Progresso (RF 2) Gerar relatórios periódicos de progresso para coordenadores e estudantes.
Agente de Envio de Alertas (RF 3) Enviar alertas para coordenadores em caso de problemas ou desvios significativos no progresso dos estudantes.

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 Dados de Progresso

1.1 Tarefa do Agente

Coletar dados de progresso dos estudantes em estágio em intervalos regulares.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de progresso dos estudantes em estágio. Estes dados são fornecidos em intervalos regulares para monitoramento contínuo.

# 2. Objetivo
Coletar dados de progresso dos estudantes em estágio, assegurando precisão e completude das informações para posterior análise e geração de relatórios.

# 3. Regras que você deve seguir para gerar sua resposta
- Definir intervalos específicos para a coleta de dados, considerando a duração do estágio e a frequência necessária para monitoramento eficaz.
- Assegurar que os dados coletados sejam completos e precisos, eliminando lacunas e corrigindo erros significativos antes do armazenamento.
- Armazenar os dados de forma segura e organizada, garantindo acesso fácil e análise posterior eficiente. 
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 de progresso dos estudantes via API em intervalos regulares. Na fase de testes, os dados 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 estruturados de progresso dos estudantes.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser dados estruturados de progresso em formato JSON.
  • Exemplo de Estrutura de Output:
     {
      "student_id": "12345",
      "progress_data": [
        {
          "date": "2025-11-07",
          "progress_notes": "Estágio em andamento conforme esperado."
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 1.000 caracteres.

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

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

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

2.1 Tarefa do Agente

Gerar relatórios periódicos de progresso para coordenadores e estudantes.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados de progresso dos estudantes em estágio. Estes dados são utilizados para gerar relatórios periódicos que destacam métricas de progresso e áreas de melhoria.

# 2. Objetivo
Gerar relatórios de progresso que atendam as expectativas dos coordenadores e estudantes, integrando visualizações de dados para facilitar a interpretação.

# 3. Regras que você deve seguir para gerar sua resposta
- Desenvolver um modelo de relatório que destaque métricas de progresso e áreas de melhoria críticas.
- Garantir a geração de relatórios em intervalos que atendam as expectativas dos coordenadores e estudantes, conforme definido.
- Integrar visualizações de dados, como gráficos e tabelas, para facilitar a interpretação do progresso. 
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 estruturados de progresso dos estudantes em formato JSON.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados 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 relatórios de progresso em formato markdown.
  • Exemplo de Estrutura de Output:
     # Relatório de Progresso
    
    **Estudante:** João Silva
    
    **Data:** 07/11/2025
    
    ## Progresso Atual
    - Estágio em andamento conforme esperado.
    
    ## Áreas de Melhoria
    - Aumentar a interação com o supervisor.
  • Número de caracteres esperado: O relatório gerado deve ser claro e direto, com um tamanho estimado em 2.000 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

2.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

2.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Envio de Alertas (RF 3).

RF 3. Agente de Envio de Alertas

3.1 Tarefa do Agente

Enviar alertas para coordenadores em caso de problemas ou desvios significativos no progresso dos estudantes.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo relatórios de progresso que destacam problemas ou desvios significativos no progresso dos estudantes.

# 2. Objetivo
Enviar alertas para coordenadores através de canais de comunicação preferidos, como e-mail ou mensagens instantâneas, incluindo informações detalhadas e recomendações de ação.

# 3. Regras que você deve seguir para gerar sua resposta
- Definir critérios específicos para identificar problemas ou desvios que exijam atenção imediata.
- Implementar um sistema de alerta que notifique os coordenadores através de canais de comunicação preferidos, como e-mail ou mensagens instantâneas.
- Incluir informações detalhadas e recomendações de ação nos alertas para facilitar a intervenção dos coordenadores de maneira eficaz. 
3.3 Configurações do Agente

3.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 2).
  • Tipo do input: Relatórios de progresso em formato markdown.
  • Formatos Suportados: Esse agente deve ser capaz de receber relatórios no formato: .md.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser alertas enviados para coordenadores.
  • Exemplo de Estrutura de Output:
     **Alerta de Progresso**
    
    Estudante: João Silva
    
    Problema Identificado: Baixa interação com o supervisor.
    
    Recomendação: Agendar reunião de acompanhamento.
  • Número de caracteres esperado: O alerta gerado será conciso, com um tamanho estimado em torno de 500 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

3.3.4 Ferramentas do Agente

  • Documentos: Não consulta.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

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

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

A execução deste agente finaliza o fluxo. Os alertas gerados são o resultado que deve ser disponibilizado aos coordenadores.

© 2025 prototipe.ai. Todos os direitos reservados.