PrototipeAI | Agente de IA para Avaliação de Desempenho de Estagiários

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 Fluxo de Agentes "Avaliação de Desempenho de Estagiários", uma solução de automação projetada para consolidar informações de desempenho de múltiplas fontes e gerar avaliações coesas e objetivas. 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 relatórios de supervisores e feedbacks dos estagiários em relatórios detalhados que destacam pontos fortes e áreas de melhoria, fornecendo feedback contínuo e automatizado para o desenvolvimento dos estagiários.

2. Contexto e Problema

Cenário Atual

As avaliações de desempenho de estagiários enfrentam diversos desafios, incluindo:

Dificuldade em consolidar informações de desempenho de diferentes fontes para uma avaliação coesa.
Subjetividade e inconsistência nas avaliações realizadas manualmente por diferentes supervisores.
Falta de feedback contínuo e em tempo real para estagiários, prejudicando seu desenvolvimento.

Atualmente, o processo de avaliação é manual, sujeito a diferentes interpretações e falta de padronização, o que resulta em avaliações inconsistentes e pouco objetivas.

3. Impactos Esperados

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

Padronizar a qualidade e a consistência das avaliações de desempenho.
Fornecer feedback contínuo e em tempo real para os estagiários, ajudando no seu desenvolvimento profissional.
Reduzir a subjetividade nas avaliações, aplicando critérios padronizados e algoritmos de análise.
Facilitar o processo de consolidação de informações de múltiplas fontes, economizando tempo e recursos.

4. Visão Geral da Solução

O agente de IA para avaliação de desempenho de estagiários analisa relatórios de supervisores e feedbacks dos estagiários, aplica critérios padronizados e gera relatórios personalizados destacando pontos fortes e áreas de melhoria. 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 avaliação de desempenho de estagiários.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a coleta de dados de múltiplas fontes e termina com a geração de relatórios personalizados para cada estagiário.

Agentes	Função Principal
`Agente de Coleta de Dados de Avaliação` (RF 1)	Coletar e consolidar dados de desempenho de estagiários a partir de relatórios de supervisores e feedbacks dos próprios estagiários.
`Agente de Análise de Desempenho de Estagiários` (RF 2)	Analisar dados consolidados para gerar avaliações de desempenho detalhadas e personalizadas.

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.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Coleta de Dados de Avaliação

1.1 Tarefa do Agente

Coletar e consolidar dados de desempenho de estagiários a partir de relatórios de supervisores e feedbacks dos próprios estagiários.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo relatórios de supervisores e feedbacks dos estagiários em formato de texto. Estes documentos contêm informações sobre o desempenho dos estagiários em suas funções.

# 2. Objetivo
Coletar dados de múltiplas fontes e consolidar em um único formato JSON, padronizando os dados coletados para garantir consistência e objetividade.

# 3. Regras que você deve seguir para gerar sua resposta
- Coletar dados de múltiplas fontes, como relatórios de supervisores e feedbacks dos estagiários, e consolidar em um único formato JSON.
- Padronizar os dados coletados utilizando critérios pré-definidos para garantir consistência e objetividade.
- Verificar a completude dos dados, assegurando que todos os campos necessários estão preenchidos antes de consolidar as informações.

# 4. Exemplo de Output que você deve produzir
{
  "estagiario_id": "12345",
  "nome": "João Silva",
  "pontos_fortes": ["Comunicação", "Trabalho em equipe"],
  "areas_melhoria": ["Gestão de tempo", "Conhecimento técnico"]
}

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 relatórios de supervisores e feedbacks dos estagiários 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 dos documentos na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo é composto por textos provenientes de relatórios e feedbacks.
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 objeto JSON consolidado contendo informações de desempenho, incluindo pontos fortes e áreas de melhoria.

Exemplo de Estrutura de Output:

 {
  "estagiario_id": "12345",
  "nome": "João Silva",
  "pontos_fortes": ["Comunicação", "Trabalho em equipe"],
  "areas_melhoria": ["Gestão de tempo", "Conhecimento técnico"]
}

Número de caracteres esperado: O JSON gerado deve ser claro e direto, 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

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 o Agente de Análise de Desempenho de Estagiários (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Desempenho de Estagiários (RF 2).

RF 2. Agente de Análise de Desempenho de Estagiários

2.1 Tarefa do Agente

Analisar dados consolidados para gerar avaliações de desempenho detalhadas e personalizadas.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados consolidados de desempenho de estagiários em formato JSON, contendo informações sobre pontos fortes e áreas de melhoria.

# 2. Objetivo
Analisar os dados recebidos e gerar relatórios detalhados e personalizados em formato markdown, destacando pontos fortes e áreas de melhoria para cada estagiário.

# 3. Regras que você deve seguir para gerar sua resposta
- Aplicar algoritmos de análise para identificar padrões de desempenho e áreas de melhoria específicas.
- Gerar relatórios que destaquem tanto os pontos fortes quanto as áreas de melhoria, utilizando linguagem clara e objetiva.
- Fornecer feedback contínuo e automatizado, registrando sugestões de melhoria em tempo real para os estagiários, ajudando-os a ajustarem suas práticas em tempo real.

# 4. Exemplo de Output que você deve produzir
**Estagiário:** João Silva

**Pontos Fortes:**
- Comunicação
- Trabalho em equipe

**Áreas de Melhoria:**
- Gestão de tempo
- Conhecimento técnico

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: Este agente deve ser apto a receber como input um objeto JSON consolidado contendo informações de desempenho dos estagiários.
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um relatório detalhado em formato markdown, destacando pontos fortes e áreas de melhoria para cada estagiário.