Noções básicas de pesquisa (v3)

O Cloud Talent Solution permite que os usuários pesquisem as vagas que você armazenou no índice dele. Neste documento, orientamos você pelas várias opções de pesquisa e ofertas relacionadas da Cloud Talent Solution.

Solicitações de pesquisa

Para fazer uma solicitação de pesquisa de vaga, envie uma solicitação POST para o endpoint jobs:search, passando os dados da pesquisa no corpo.

Campos obrigatórios

O seguinte campo é obrigatório:

  • searchMode: especifica o tipo da pesquisa de vagas a aplicar. As opções são:

    • JOB_SEARCH: este é o modo de pesquisa padrão e recomendado. Todas as vagas são pesquisadas. As vagas mais relevantes são retornadas na ordem de relevância para a consulta de pesquisa.
    • FEATURED_JOB_SEARCH: pesquisa apenas vagas com promotionValue maior do que 0. Os resultados são ordenados do promotionValue mais alto para o mais baixo. No caso de empate, a relevância é usada para decidir a posição. Consulte Vagas em destaque para saber mais informações.

Campos mais usados

  • JobQuery: especifique os critérios da vaga para correspondência. Dentre eles, estão incluídos local, categorias de vaga, tipos de emprego, consultas de texto, empresas etc. Consulte Filtros de pesquisa para saber mais informações.

  • requestMetadata: contém informações de usuário e sessão para essa solicitação de pesquisa. Consulte RequestMetadata para mais detalhes.

  • jobView: define o número de campos retornados para cada vaga correspondente. Pode ser JOB_VIEW_SMALL (o padrão), JOB_VIEW_MINIMAL ou JOB_VIEW_FULL. As descrições de cada opção estão na referência JobView.

  • orderBy: a ordem de classificação das vagas retornadas. Consulte a referência dos valores permitidos. O padrão é classificar por relevância, (RELEVANCE_DESC) decrescente.

Limite de relevância e ampliação de local/categoria

Para retornar um número maior de vagas para as pesquisas, estes dois campos reduzem as restrições de relevância:

  • enableBroadening: definir isso como true afrouxa as restrições de localização e categoria de trabalho da solicitação de pesquisa, retornando mais resultados. Por exemplo, se uma solicitação de pesquisa especifica vagas dentro de um raio de 3,2 quilômetros de Anytown, WA, definir essa sinalização como true também poderá retornar vagas de uma cidade próxima, no mesmo estado.

  • disableKeywordMatch: essa sinalização é falso por padrão. Isso permite que a Cloud Talent Solution anexe as vagas relevantes a esta consulta de pesquisa com vagas que também correspondem à string de consulta exata no título ou na descrição.

RequestMetadata

Cada solicitação de pesquisa e histograma precisa incluir um objeto RequestMetadata. Esse objeto contém informações sobre o usuário que iniciou a pesquisa.

Existem alguns motivos para esse objeto ser importante:

  • Consistência do usuário. A Cloud Talent Solution executa várias versões dos modelos subjacentes ao mesmo tempo, em uma tentativa de melhorar a relevância da pesquisa. Preencha esse campo para garantir que um candidato tenha uma experiência consistente. O Cloud Talent Solution garante que um candidato (identificado por userId, sessionId e domain) tenha uma experiência consistente. Observação: esses campos precisam ser ofuscados.

  • Melhorias na pesquisa: os algoritmos de ajuste têm como base as informações fornecidas nos campos RequestMetadata e os dados dos candidatos fornecidos por você. Isso melhora a relevância do resultado da pesquisa.

Operadores de pesquisa

Operador Descrição
( ) Agrupa uma ou mais palavras-chave.
AND Procura resultados relevantes para as palavras-chave ou os grupos de palavras-chave em ambos os lados do operador.
OR Procura resultados relevantes para a palavra-chave ou o grupo de palavras-chave em ambos os lados do operador.
NOT Exclui resultados relevantes para a palavra-chave ou o grupo de palavras-chave, entre parênteses, logo depois do operador.
- Exclui resultados relevantes para a palavra-chave ou o grupo de palavras-chave anexadas ao operador.

Exemplo:

  • "software OR java" retorna vagas com "software" ou "java" nos metadados.

  • "software" -java retorna vagas relevantes para "software", mas exclui vagas relevantes para "java".

  • "(software OR java) AND (marketing)" retorna vagas relevantes para "software" e "marketing" e vagas relevantes para "java" e "marketing".

Consulta de candidato

Os termos de pesquisa também podem ser detectados como entidades relacionadas à vaga real. Por exemplo, se a consulta fosse "intern" (estagiário), o Cloud Talent Solution trataria isso como o tipo de emprego "INTERN" e filtraria as vagas que tinham apenas EMPLOYMENT_TYPE - INTERN. Portanto, mesmo que a palavra "intern" (estagiário) estivesse necessariamente na descrição da vaga, ela não seria retornada se o tipo de vaga estivesse definido como outra coisa.

Resolver problemas

Cada solicitação de pesquisa gera um requestID de pesquisa exclusivo no sistema, usado para rastrear os parâmetros da pesquisa e a resposta. Isso é crucial na solução de problemas relacionados à pesquisa específica, solicitações CRUD e precisam ser registrados corretamente. O requestId é retornado no campo ResponseMetadata no corpo da resposta da pesquisa ou no objeto de resposta de chamada CRUD associado.

Para problemas de suporte relacionados à relevância, consultas de pesquisa, consultas de indexação etc., registre um tíquete com a equipe de suporte e inclua os códigos das solicitações relevantes ou as próprias solicitações.

Contagens de resultados

A contagem de resultados é usada para informar o número de resultados da pesquisa ao candidato. Isso nem sempre corresponde aos resultados do histograma ou ao número real de vagas retornadas. A Pesquisa de vagas retorna no máximo 5000 vagas.

Paginação

Por padrão, a Pesquisa de vagas retorna 100 resultados por página (ou menos, se o número total de resultados for menor que 100). É possível implementar a paginação usando os campos associados a esse recurso:

  • pageSize: o número de resultados retornados por página.
  • nextPageToken: token exclusivo retornado com cada página dos resultados da pesquisa para especificar a posição inicial da próxima página de resultados. Este campo ficará vazio se não houver mais resultados.
  • offset: especifica a diferença entre a classificação de relevância da vaga retornada no topo de uma determinada página e 1 (a vaga mais relevante retornada). Como exemplo, um usuário realiza uma pesquisa e pageSize é definido como 10. A primeira página retorna a vaga nº 1 na parte superior. Portanto, o valor de offset para esta página é zero. A próxima página retorna a vaga nº 11 na parte superior. O offset para esta página é 10.

Defina o tamanho da página com 20 resultados ou menos para evitar problemas de latência. Recomenda-se emitir uma chamada de pesquisa separada para cada página processada para o candidato. Usar uma única chamada de pesquisa para retornar um número maior de vagas e paginar no lado do cliente impede que o modelo de aprendizado de máquina aprenda com precisão por meio do Jobs Analytics Framework.

Verificação ortográfica

A verificação ortográfica é um recurso da solicitação de pesquisa do Cloud Talent Solution que leva em consideração termos de pesquisa com possíveis erros de digitação, corrige-os e retorna resultados com base na consulta corrigida. Por exemplo, quando a verificação ortográfica está ativada, caso um candidato procure "gerene", em vez de "gerente", o Cloud Talent Solution retorna vagas para "gerente". A verificação ortográfica pode ser ativada/desativada configurando o campo disableSpellCheck do JobQuery. Se a verificação ortográfica estiver ativada, a consulta corrigida poderá ser encontrada na resposta da pesquisa, no campo spellResult.