Agente de IA para Orientação Vocacional Personalizada

Validar, completar (quando possível) e padronizar o JSON de entrada do perfil do aluno, gerando flags de controle para os próximos agentes.

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 um JSON com o perfil do aluno 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 JSON contendo os dados do perfil do aluno.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
• 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 JSON estruturado com o perfil normalizado e flags de controle.
• Exemplo de Estrutura de Output:

   {"perfil_normalizado": {"idade": 17, "localidade": "SP-BR", "interesses_normalizados": ["Tecnologia", "Biociências"], "habilidades_normalizadas": [{"competencia": "Raciocinio Logico", "nivel": 2}], "historico_educacional_normalizado": [{"nivel": "Ensino Medio", "status": "Cursando"}], "preferencias": {"modalidade": ["Presencial", "Online"], "orcamento_mensal": 600}}, "flags": {"perfil_valido": true, "precisa_busca_mercado": true, "precisa_busca_cursos": true, "tem_localidade": true}} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 1.500 caracteres, podendo variar conforme a complexidade do perfil descrito.

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 Mapeamento para Áreas Ocupacionais e Lacunas 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 Mapeamento para Áreas Ocupacionais e Lacunas de Competências (RF 2).

Mapear interesses e habilidades normalizadas para famílias ocupacionais e identificar lacunas de competências para cada família.

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 estruturado com o perfil normalizado do aluno.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com o mapeamento ocupacional e lacunas de competências.
• Exemplo de Estrutura de Output:

   {"mapeamento_ocupacional": [{"familia": "Desenvolvimento de Software", "codigo_referencia": "TEC-DEV", "competencias_core": [{"competencia": "Programacao", "nivel_minimo": 2}], "aderencia": 0.72, "lacunas": [{"competencia": "Programacao", "nivel_atual": 1, "nivel_recomendado": 2}]}], "resumo_lacunas": {"total_lacunas": 3}} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno 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 deve ser visível para o Agente de Busca Online de Tendências de Mercado (RF 3) e o Agente de Consolidação de Tendências e Escore de Oportunidade (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online de Tendências de Mercado (RF 3).

Realizar busca online para coletar dados recentes de demanda, crescimento, faixa salarial e requisitos comuns por família ocupacional.

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 parâmetros de busca, incluindo famílias ocupacionais e localidade.
• 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é 2.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com os resultados da busca de mercado, incluindo dados de demanda, crescimento, faixa salarial e requisitos comuns.
• Exemplo de Estrutura de Output:

   {"resultados_busca_mercado": [{"familia": "Desenvolvimento de Software", "fontes": [{"url": "https://exemplo", "trecho": "alta demanda"}], "indicadores_brutos": {"crescimento": "+8%", "vagas": 1200, "salario_mediano": 6500}}]} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Utiliza para coleta de dados de mercado.
• Sistemas Externos: Não se conecta a sistemas externos.

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 deve ser visível para o Agente de Consolidação de Tendências e Escore de Oportunidade (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação de Tendências e Escore de Oportunidade (RF 4).

Consolidar resultados da busca de mercado e produzir indicadores comparáveis e um escore de oportunidade por família.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com os resultados da busca de mercado e o mapeamento ocupacional.
• 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é 4.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com os indicadores de mercado e escores de oportunidade por família.
• Exemplo de Estrutura de Output:

   {"indicadores_mercado": [{"familia": "Desenvolvimento de Software", "demanda_relativa": 0.85, "crescimento_anual_pct": 0.08, "salario_mediano_local": 6500, "fontes_citadas": ["https://exemplo"], "escore_oportunidade": 0.78}], "metodologia": {"pesos": {"demanda": 0.4, "crescimento": 0.3, "salario": 0.3}}} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 2.500 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

4.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular escores de oportunidade.
• 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 deve ser visível para o Agente de Busca Online de Cursos e Programas (RF 5) e o Agente de Síntese de Opções Educacionais (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online de Cursos e Programas (RF 5).

Realizar busca online de cursos, trilhas e certificações alinhados às lacunas identificadas e às preferencias do aluno.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com parâmetros de busca, incluindo competências prioritárias, modalidades e localidade.
• 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é 3.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com os resultados da busca de cursos, incluindo informações sobre carga horária, custo, modalidade e provedores.
• Exemplo de Estrutura de Output:

   {"resultados_busca_cursos": [{"competencia": "Programacao", "ofertas": [{"titulo": "Logica de Programacao", "provedor": "X", "modalidade": "Online", "carga_horaria": 40, "custo_mensal": 120, "url": "https://curso-x"}]}]} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 1.500 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

5.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Utiliza para coleta de dados de cursos e programas.
• Sistemas Externos: Não se conecta a sistemas externos.

5.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 Síntese de Opções Educacionais (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese de Opções Educacionais (RF 6).

Organizar e classificar cursos e certificações por prioridade, cobrindo lacunas com restrições de orçamento e modalidade.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com os resultados da busca de cursos e o resumo das lacunas de competências.
• 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é 3.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com as opções educacionais organizadas e classificadas por prioridade.
• Exemplo de Estrutura de Output:

   {"opcoes_educacionais": [{"competencia": "Programacao", "top_ofertas": [{"titulo": "Logica de Programacao", "ajuste_lacuna": 0.6, "custo_mensal": 120, "modalidade": "Online", "url": "https://curso-x"}]}], "cobertura_lacunas_pct": 0.75} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 1.500 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular ajuste_lacuna e cobertura_lacunas_pct.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.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 Recomendações de Carreira e Plano Educacional Personalizado (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Carreira e Plano Educacional Personalizado (RF 7).

Gerar recomendações finais de carreiras, justificativas, trilha educacional de curto/médio/longo prazo e metas mensuráveis.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber como input um JSON com o perfil normalizado, mapeamento ocupacional, indicadores de mercado e opções educacionais.
• 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é 6.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado com as recomendações de carreira e plano educacional personalizado.
• Exemplo de Estrutura de Output:

   {"sugestoes_carreira": [{"familia": "Desenvolvimento de Software", "nivel_entrada": "Junior", "justificativa": "Aderencia 0.72 e alta demanda regional", "escore_final": 0.80}], "plano_educacional": {"curto_prazo_meses": [{"acao": "Curso Logica de Programacao", "meta": "Concluir com nota >=8", "kpi": "certificado", "custo_mensal": 120}], "medio_prazo_meses": [...], "longo_prazo_meses": [...]}, "cronograma_semanal": [{"semana": 1, "horas": 6, "atividades": ["Aula 1-2", "Praticas"]}], "riscos_e_mitigacoes": ["Risco: sobrecarga escolar; Mitigacao: reduzir 2h/semana em semanas de prova"]} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 3.500 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.5

7.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para calcular escores finais e cronograma semanal.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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

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