Agente de IA para Análise de Compatibilidade de Estágios

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

Como criar um agente de IA que analisa as competências dos estudantes e sugere estágios compatíveis

1. Propósito e Escopo

Este documento define todos os prompts e detalhes de requisitos para o desenvolvimento de um agente de IA para Análise de Compatibilidade de 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 é analisar o perfil de competências e interesses dos estudantes para sugerir estágios que melhor se alinham com suas habilidades e interesses, resolvendo a dificuldade em combinar as competências dos estudantes com as oportunidades de estágio disponíveis.

2. Contexto e Problema

Problemas Identificados

  • Dificuldade no Alinhamento de Competências: Os estudantes frequentemente enfrentam desafios em encontrar estágios que correspondam às suas competências e áreas de interesse.
  • Necessidade de Personalização: Há uma demanda crescente por sugestões de estágio personalizadas que considerem as habilidades e interesses únicos de cada estudante.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

  • Aumentar a taxa de sucesso na colocação de estudantes em estágios adequados.
  • Reduzir o tempo de busca por estágios compatíveis para os estudantes.
  • Oferecer recomendações personalizadas que respeitem os interesses e competências individuais dos estudantes.

4. Visão Geral da Solução

O agente de IA para Análise de Compatibilidade de Estágios processa perfis de estudantes para identificar competências e interesses, compara com os requisitos das oportunidades de estágio e sugere as melhores opções. 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 orientação dos estudantes para estágios adequados.

A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a análise do perfil do estudante e termina com a sugestão de estágios personalizados.

Agentes Função Principal
Agente de Análise de Perfil de Estudante (RF 1) Analisar o perfil de competências e interesses dos estudantes.
Agente de Comparação de Competências (RF 2) Comparar as competências dos estudantes com os requisitos das oportunidades de estágio.
Agente de Sugestão de Estágios (RF 3) Sugerir estágios que melhor se alinham com o perfil 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 estudante receberá. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente de Análise de Perfil de Estudante

1.1 Tarefa do Agente

Analisar o perfil de competências e interesses dos estudantes.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o perfil de um estudante em formato JSON, contendo campos como 'competencias' e 'interesses'.

# 2. Objetivo
Analisar o perfil para identificar habilidades principais e secundárias, bem como interesses primários do estudante.

# 3. Regras que você deve seguir para gerar sua resposta
- Analise o campo 'competencias' para identificar habilidades principais e secundárias.
- Identifique os interesses principais do estudante a partir do campo 'interesses'.
- Relacione como os interesses se conectam com as competências identificadas.

# 4. Exemplo de Output que você deve produzir
{
  "analise_competencias": "O estudante possui habilidades principais em programação e análise de dados, com competências secundárias em design gráfico.",
  "analise_interesses": "Interesses principais incluem desenvolvimento de software e projetos de ciência de dados."
} 
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 do perfil do estudante 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 JSON na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo é um perfil de estudante em formato JSON.
  • Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON com a análise detalhada das competências e interesses do estudante.
  • Exemplo de Estrutura de Output:
     {
      "analise_competencias": "O estudante possui habilidades principais em programação e análise de dados, com competências secundárias em design gráfico.",
      "analise_interesses": "Interesses principais incluem desenvolvimento de software e projetos de ciência de dados."
    } 
  • Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 1.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

  • 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 Comparação de Competências (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Comparação de Competências (RF 2).

RF 2. Agente de Comparação de Competências

2.1 Tarefa do Agente

Comparar as competências dos estudantes com os requisitos das oportunidades de estágio.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com a análise de competências e interesses do estudante, além de uma lista de oportunidades de estágio com seus requisitos.

# 2. Objetivo
Comparar as competências do estudante com os requisitos de cada oportunidade de estágio e gerar uma lista de oportunidades de estágio que se alinham com as competências do estudante.

# 3. Regras que você deve seguir para gerar sua resposta
- Compare as competências do estudante com os requisitos de cada oportunidade de estágio.
- Registre a compatibilidade de cada competência com uma pontuação.
- Classifique as oportunidades de estágio em ordem de compatibilidade com o perfil do estudante, destacando aquelas que atendem a pelo menos 80% dos requisitos.

# 4. Exemplo de Output que você deve produzir
{
  "oportunidades_compativeis": [
    {
      "estagio_id": 12345,
      "pontuacao_compatibilidade": 85,
      "descricao": "Estágio em Desenvolvimento de Software"
    }
  ]
} 
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 JSON com a análise de competências e interesses do estudante e uma lista de oportunidades de estágio.
  • 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é 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON com uma lista de oportunidades de estágio que se alinham com as competências do estudante, classificadas por pontuação de compatibilidade.
  • Exemplo de Estrutura de Output:
     {
      "oportunidades_compativeis": [
        {
          "estagio_id": 12345,
          "pontuacao_compatibilidade": 85,
          "descricao": "Estágio em Desenvolvimento de Software"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado 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.
  • Calculadora: Utiliza lógica interna para calcular a pontuação de compatibilidade.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

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 Sugestão de Estágios (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Estágios (RF 3).

RF 3. Agente de Sugestão de Estágios

3.1 Tarefa do Agente

Sugerir estágios que melhor se alinham com o perfil dos estudantes.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com uma lista de oportunidades de estágio classificadas por compatibilidade.

# 2. Objetivo
Selecionar as oportunidades de estágio mais compatíveis para sugerir ao estudante, personalizando as sugestões com base nos interesses do estudante.

# 3. Regras que você deve seguir para gerar sua resposta
- Selecione as oportunidades de estágio mais compatíveis, priorizando aquelas com a maior pontuação de compatibilidade.
- Personalize as sugestões com base nos interesses do estudante, incluindo recomendações adicionais que possam expandir as áreas de interesse.

# 4. Exemplo de Output que você deve produzir
{
  "sugestoes_estagio": [
    {
      "estagio_id": 12345,
      "descricao": "Estágio em Desenvolvimento de Software",
      "recomendacao": "Este estágio é altamente recomendado devido ao seu alinhamento com suas competências em programação e interesse em desenvolvimento de software."
    }
  ]
} 
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 do agente anterior (RF 2).
  • Tipo do input: Este agente deve ser apto a receber como input um JSON com uma lista de oportunidades de estágio classificadas por compatibilidade.
  • 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é 5.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON com uma lista de sugestões de estágio, incluindo recomendações personalizadas.
  • Exemplo de Estrutura de Output:
     {
      "sugestoes_estagio": [
        {
          "estagio_id": 12345,
          "descricao": "Estágio em Desenvolvimento de Software",
          "recomendacao": "Este estágio é altamente recomendado devido ao seu alinhamento com suas competências em programação e interesse em desenvolvimento de software."
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 caracteres.

3.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.5

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 gerada por este agente é 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. As sugestões de estágio geradas são o resultado que deve ser disponibilizado ao estudante.

© 2025 prototipe.ai. Todos os direitos reservados.