Agente de IA para Criação de Relatórios de Impacto de Estágios

18 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que compila dados sobre o impacto dos programas de estágio em estudantes e empresas.

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 "Criação de Relatórios de Impacto de Estágios", uma solução de automação projetada para compilar dados e gerar relatórios detalhados sobre o impacto dos programas de estágio em estudantes e empresas. 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 brutos em relatórios detalhados que possam ser utilizados para avaliar e melhorar os programas de estágio.

2. Contexto e Problema

Cenário Atual

As empresas e instituições educacionais enfrentam dificuldades em medir e relatar o impacto dos programas de estágio em estudantes e empresas. A necessidade de gerar relatórios detalhados é crucial para a melhoria contínua desses programas.

Atualmente, o processo de avaliação do impacto dos estágios é manual e sujeito a erros, o que compromete a qualidade das análises e das decisões baseadas nesses dados.


Problemas Identificados

  • Dificuldade de Medição: Falta de mecanismos eficazes para medir o impacto real dos programas de estágio.
  • Relatórios Inconsistentes: A ausência de relatórios padronizados dificulta a comparação e a avaliação dos resultados.
  • Falta de Sugestões de Melhoria: Os dados coletados não são utilizados de forma eficaz para sugerir melhorias nos programas.

3. Impactos Esperados

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

  • Melhorar a precisão e a consistência dos relatórios de impacto.
  • Aumentar a eficiência na coleta e análise de dados sobre programas de estágio.
  • Fornecer insights acionáveis para otimizar programas de estágio.

4. Visão Geral da Solução

O agente de IA para criação de relatórios de impacto de estágios compila dados brutos de estudantes e empresas, analisa esses dados e gera relatórios detalhados que podem ser utilizados para melhorar os programas de estágio. 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 geração de relatórios de impacto que seguem as especificidades da sua organização.

A solução consiste em um fluxo de automação composto por 4 agentes de IA. O processo inicia com a padronização e consolidação de dados e termina com a geração de recomendações de melhoria para os programas de estágio.

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

Agentes Função Principal
Agente de Padronização e Consolidação de Dados de Impacto de Estágios (RF 1) Receber respostas brutas de estudantes e empresas e produzir um dataset único, limpo e padronizado para análise.
Agente de Cálculo de KPIs e Análise de Impacto (RF 2) Gerar indicadores, segmentações e achados estatísticos a partir do dataset padronizado.
Agente de Geração do Relatório de Impacto (RF 3) Produzir um relatório completo, consistente e reutilizável a partir dos KPIs e achados.
Agente de Recomendações de Melhoria do Programa de Estágio (RF 4) Derivar recomendações priorizadas e acionáveis baseadas nos relatórios e KPIs.

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 Padronização e Consolidação de Dados de Impacto de Estágios

1.1 Tarefa do Agente

Receber respostas brutas de estudantes e empresas e produzir um dataset único, limpo e padronizado para análise.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados brutos de estudantes e empresas que participaram de programas de estágio. Estes dados contêm respostas em formatos variados e precisam ser consolidados em um formato uniforme para análise.

# 2. Objetivo
Padronizar e consolidar os dados recebidos, transformando-os em um único dataset estruturado, limpo e pronto para análise.

# 3. Regras que você deve seguir para gerar sua resposta
- Mapear e normalizar escalas de satisfação para 0-10.
- Uniformizar datas para o formato YYYY-MM-DD.
- Calcular a duração dos estágios em meses completos.
- Deduplicar registros mantendo o mais completo.
- Normalizar categorias usando um dicionário de sinônimos.
- Inferir booleanos a partir de texto.
- Calcular tempo até a contratação se os dados permitirem.
- Descartar registros incompletos ou inválidos.
- Preencher metadados com informações relevantes.

# 4. Exemplo de Output que você deve produzir
{
  "dados_estudantes": [
    {
      "id_registro": "string",
      "id_estudante": "string",
      "coorte": "YYYY-S1|S2|custom",
      "curso_ou_area": "string",
      "empresa": "string",
      "departamento": "string",
      "modalidade": "presencial|remoto|hibrido",
      "localidade": "string",
      "data_inicio": "YYYY-MM-DD",
      "data_fim": "YYYY-MM-DD|null",
      "duracao_meses": number,
      "satisfacao": number (0-10),
      "nps_nota": number (0-10|null),
      "habilidades_desenvolvidas": ["string"],
      "desafios": ["string"],
      "oferta_emprego": "sim|nao|nao_informado",
      "contratado_pos_estagio": true|false|null,
      "tempo_ate_contratacao_dias": number|null,
      "retencao_6m": true|false|null,
      "retencao_12m": true|false|null,
      "carga_horaria_semanal": number|null,
      "bolsa_mensal": number|null,
      "qualidade_dado": {"completude": number (0-1), "campos_ausentes": ["string"]}
    }
  ],
  "dados_empresas": [
    {
      "id_registro": "string",
      "empresa": "string",
      "porte": "micro|pequena|media|grande",
      "setor": "string",
      "departamento": "string",
      "coorte": "YYYY-S1|S2|custom",
      "supervisor": "string|null",
      "satisfacao_empresa": number (0-10),
      "nps_nota": number (0-10|null),
      "beneficios_observados": ["string"],
      "desafios_observados": ["string"],
      "produtividade_delta_percent": number|null,
      "custo_programa": number|null,
      "vagas_estagio": number|null,
      "vagas_convertidas": number|null,
      "politicas_diversidade": true|false|null,
      "qualidade_dado": {"completude": number (0-1), "campos_ausentes": ["string"]}
    }
  ],
  "metadados": {"versao_esquema": "v1", "moeda": "BRL", "escala_padrao_satisfacao": "0-10"},
  "resumo_qualidade": {"registros_estudantes": number, "registros_empresas": number, "taxa_completude_media": number (0-1), "registros_descartados": number}
} 
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 brutos de estudantes e empresas 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 de um arquivo na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo dados brutos de estudantes e empresas.
  • Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo JSON contendo o dataset padronizado e consolidado com dados de estudantes e empresas.
  • Exemplo de Estrutura de Output:
     {
      "dados_estudantes": [...],
      "dados_empresas": [...],
      "metadados": {...},
      "resumo_qualidade": {...}
    } 
  • Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 50.000 caracteres, podendo variar conforme a quantidade de dados processados.

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 Cálculo de KPIs e Análise de Impacto (RF 2).

RF 2. Agente de Cálculo de KPIs e Análise de Impacto

2.1 Tarefa do Agente

Gerar indicadores, segmentações e achados estatísticos a partir do dataset padronizado.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um dataset padronizado contendo dados de estudantes e empresas que participaram de programas de estágio.

# 2. Objetivo
Analisar o dataset para gerar indicadores chave de desempenho (KPIs), segmentações e achados estatísticos relevantes.

# 3. Regras que você deve seguir para gerar sua resposta
- Calcular KPIs gerais como satisfação média, taxa de conversão de contratação, entre outros.
- Segmentar dados por categorias como coorte, curso, porte da empresa, etc.
- Identificar habilidades desenvolvidas e desafios enfrentados pelos estudantes.
- Preparar dados para visualizações futuras.

# 4. Exemplo de Output que você deve produzir
{
  "kpis_gerais": {
    "satisfacao_media_estudantes": number,
    "satisfacao_media_empresas": number,
    "taxa_conversao_contratacao": number (0-1),
    "tempo_medio_ate_contratacao_dias": number|null,
    "retencao_6m": number (0-1)|null,
    "retencao_12m": number (0-1)|null,
    "nps_estudantes": number|null,
    "nps_empresas": number|null,
    "roi_medio_empresas": number|null
  },
  "kpis_por_segmento": {
    "coorte": {"YYYY-S1": {...}},
    "curso_ou_area": {"Engenharia": {...}},
    "empresa_porte": {"pequena": {...}},
    "departamento": {"TI": {...}},
    "modalidade": {"remoto": {...}},
    "localidade": {"SP": {...}}
  },
  "habilidades_top": [{"habilidade": "Comunicação", "indice_ganho": number, "evidencias": ["string"]}],
  "desafios_top": [{"tema": "Gestão de tempo", "prevalencia": number (0-1)}],
  "achados_chave": ["string"],
  "limitações_e_sesgos": ["string"],
  "dados_para_visualizacoes": {
    "series_temporais": [...],
    "distribuicoes": [...],
    "segmentacoes": [...]
  }
} 
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 dataset padronizado em formato JSON.
  • 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 texto com até 50.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo JSON contendo KPIs, segmentações e dados preparados para visualizações.
  • Exemplo de Estrutura de Output:
     {
      "kpis_gerais": {...},
      "kpis_por_segmento": {...},
      "habilidades_top": [...],
      "desafios_top": [...],
      "achados_chave": [...],
      "limitações_e_sesgos": [...],
      "dados_para_visualizacoes": {...}
    } 
  • Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 30.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 documentos externos.
  • Calculadora: Utiliza lógica interna para cálculos estatísticos e de KPIs.
  • 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 deve ser visível para o Agente de Geração do Relatório de Impacto (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração do Relatório de Impacto (RF 3).

RF 3. Agente de Geração do Relatório de Impacto

3.1 Tarefa do Agente

Produzir um relatório completo, consistente e reutilizável a partir dos KPIs e achados.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo KPIs, segmentações e achados estatísticos derivados do dataset padronizado de programas de estágio.

# 2. Objetivo
Produzir um relatório detalhado que compile os KPIs e achados de forma estruturada e informativa.

# 3. Regras que você deve seguir para gerar sua resposta
- Incluir um sumário executivo com métricas principais e destaques de segmentos.
- Detalhar a metodologia aplicada na coleta e análise de dados.
- Apresentar os resultados com valores absolutos e relativos.
- Listar limitações e implicações dos achados.
- Anexar um dicionário de dados com definições dos campos utilizados.

# 4. Exemplo de Output que você deve produzir
{
  "relatorio": {
    "titulo": "Impacto dos Programas de Estágio - {coorte/periodo}",
    "sumario_executivo": "string",
    "metodologia": {
      "fontes_de_dados": ["string"],
      "regras_de_limpeza": ["string"],
      "definicoes_kpi": ["string"]
    },
    "resultados": {
      "kpis_gerais": {...},
      "kpis_por_segmento": {...},
      "habilidades_top": [...],
      "desafios_top": [...],
      "achados_chave": [...]
    },
    "limitacoes": ["string"],
    "implicacoes": ["string"],
    "anexos": {
      "dicionario_de_dados": [
        {"campo": "string", "descricao": "string", "tipo": "string"}
      ],
      "series_e_tabelas": {"series_temporais": [...], "distribuicoes": [...], "segmentacoes": [...]} 
    },
    "report_markdown": "string"
  }
} 
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: Este agente deve ser apto a receber como input um arquivo JSON contendo KPIs, segmentações e achados.
  • 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 texto com até 30.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output final deve ser um arquivo JSON contendo o relatório completo com seções detalhadas e anexos.
  • Exemplo de Estrutura de Output:
     {
      "relatorio": {
        "titulo": "Impacto dos Programas de Estágio - {coorte/periodo}",
        "sumario_executivo": "string",
        "metodologia": {...},
        "resultados": {...},
        "limitacoes": [...],
        "implicacoes": [...],
        "anexos": {...},
        "report_markdown": "string"
      }
    } 
  • Número de caracteres esperado: O JSON gerado será extenso, com um tamanho mínimo esperado de 40.000 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 documentos externos.
  • Calculadora: Utiliza lógica interna para consolidar e formatar dados no relatório.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

3.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Melhoria do Programa de Estágio (RF 4).

RF 4. Agente de Recomendações de Melhoria do Programa de Estágio

4.1 Tarefa do Agente

Derivar recomendações priorizadas e acionáveis baseadas nos relatórios e KPIs.

4.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um relatório completo e KPIs que detalham o impacto dos programas de estágio.

# 2. Objetivo
Gerar recomendações de melhoria para os programas de estágio, baseadas nos dados e achados apresentados no relatório.

# 3. Regras que você deve seguir para gerar sua resposta
- Ancorar cada recomendação em um achado-chave ou KPI específico.
- Destacar quick wins e iniciativas de longo prazo.
- Priorizar recomendações com base em impacto e esforço.
- Garantir diversidade de frentes nas recomendações.

# 4. Exemplo de Output que você deve produzir
{
  "recomendacoes": {
    "quick_wins": [
      {
        "acao": "string",
        "problema_enderecado": "string",
        "segmento_alvo": "string|geral",
        "owner_role": "RH|Gestor|Universidade|Mentor",
        "esforco": "baixo|medio|alto",
        "impacto_esperado": "baixo|medio|alto",
        "kpi_associado": "string",
        "meta": {"baseline": number|null, "target": number, "horizonte": "3m|6m|12m"},
        "pre_requisitos": ["string"]
      }
    ],
    "roadmap": [
      {
        "iniciativa": "string",
        "hipotese": "string",
        "metricas_sucesso": ["string"],
        "responsavel": "string",
        "prazo": "data ou periodo",
        "efeito_esperado_pp": number|null,
        "riscos": ["string"],
        "dependencias": ["string"]
      }
    ],
    "priorizacao": [
      {
        "item": "string",
        "score_esforco_impacto": number (0-100),
        "criterios": {"impacto": number, "esforco": number, "alcance": number, "certeza": number}
      }
    ]
  }
} 
4.3 Configurações do Agente

4.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 3).
  • Tipo do input: Este agente deve ser apto a receber como input um relatório completo em formato JSON.
  • 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 texto com até 40.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo JSON contendo recomendações de melhoria priorizadas e detalhadas.
  • Exemplo de Estrutura de Output:
     {
      "recomendacoes": {
        "quick_wins": [...],
        "roadmap": [...],
        "priorizacao": [...]
      }
    } 
  • Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 20.000 caracteres.

4.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

4.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Utiliza lógica interna para priorização e análise de recomendações.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

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

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

A execução deste agente finaliza o fluxo. As recomendações geradas são o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.