Aspectos básicos de la búsqueda (v3)

Cloud Talent Solution permite a los usuarios buscar entre los empleos que hayas almacenado en el índice de Cloud Talent Solution. En este documento se describen las distintas ofertas de búsqueda y relacionadas de Cloud Talent Solution.

Buscar solicitudes

Para hacer una solicitud de búsqueda de empleo, envía una solicitud POST al endpoint jobs:search y pasa los datos de búsqueda en el cuerpo.

Campos obligatorios

El siguiente campo es obligatorio:

• searchMode: especifica el tipo de búsqueda de empleo que se va a aplicar. Las opciones son las siguientes:

  • JOB_SEARCH: este es el modo de búsqueda predeterminado y recomendado. Se buscará en todos los trabajos. Los empleos más relevantes se devuelven en orden de relevancia con respecto a la consulta de búsqueda.
  • FEATURED_JOB_SEARCH: busca solo trabajos con una promotionValue mayor que 0. Los resultados se ordenan por el promotionValue más alto. En caso de empate, se usa la relevancia para decidir la posición. Consulta la sección Empleos destacados para obtener más información.

Campos de uso habitual

• JobQuery: especifica los criterios de los trabajos con los que se compararán. Entre ellos, se incluyen la ubicación, las categorías de empleo, los tipos de empleo, las consultas de texto y las empresas, entre otros. Consulta Filtros de búsqueda para obtener más información.

• requestMetadata: contiene información sobre el usuario y la sesión de esta solicitud de búsqueda. Consulta los detalles en RequestMetadata.

• jobView: define el número de campos que se devuelven para cada trabajo coincidente. Puede ser JOB_VIEW_SMALL (valor predeterminado), JOB_VIEW_MINIMAL o JOB_VIEW_FULL. Las descripciones de cada opción se encuentran en la referencia de JobView.

• orderBy: el orden de clasificación de los trabajos devueltos. Consulta la referencia para ver los valores permitidos. De forma predeterminada, se ordenan por relevancia en orden descendente (RELEVANCE_DESC).

Umbral de relevancia y ampliación de la ubicación o la categoría

Para que tus búsquedas devuelvan un mayor número de empleos, los dos campos siguientes reducen las restricciones de relevancia:

• enableBroadening: si se define como true, se flexibilizan las restricciones de ubicación y categoría de empleo de la solicitud de búsqueda para devolver más resultados. Por ejemplo, si una solicitud de búsqueda especificaba empleos en un radio de 3,2 km de Anytown, Washington, al definir esta marca en true, también se pueden devolver empleos de NextTownOver, Washington.

• disableKeywordMatch: esta marca es falsa de forma predeterminada. Si se asigna el valor "false" a esta marca, Cloud Talent Solution puede añadir a los empleos relevantes para esta consulta de búsqueda otros empleos que también coincidan con la cadena de consulta exacta en el título o la descripción.

RequestMetadata

Todas las solicitudes de búsqueda y de histograma deben incluir un objeto RequestMetadata. Este objeto contiene información sobre el usuario que inicia la búsqueda.

Este objeto es importante por varios motivos:

• Coherencia de los usuarios. Cloud Talent Solution ejecuta varias versiones de los modelos subyacentes simultáneamente para mejorar la relevancia de las búsquedas. Rellena este campo para asegurarte de que los candidatos disfruten de una experiencia coherente. Cloud Talent Solution se asegura de que un candidato (identificado por userId, sessionId y domain) tenga una experiencia coherente. Nota: Estos campos deben ofuscarse.

• Mejoras en la búsqueda: los algoritmos de ajuste se basan en la información proporcionada en los campos RequestMetadata, así como en los datos de los candidatos que proporciones. De esta forma, se mejora la relevancia de los resultados de búsqueda.

Operadores de búsqueda

Operador	Descripción
( )	Agrupa una o varias palabras clave.
Y	Busca resultados relevantes para las palabras clave o los grupos de palabras clave que se encuentran a ambos lados del operador.
O	Busca resultados relevantes para la palabra clave o el grupo de palabras clave que se encuentran a ambos lados del operador.
NOT	Excluye los resultados relevantes para la palabra clave o el grupo de palabras clave entre paréntesis que sigue inmediatamente al operador.
-	Excluye los resultados relevantes para la palabra clave o el grupo de palabras clave que se añadan al operador.

Por ejemplo:

• "software OR java" devuelve las tareas que tienen "software" o "java" en sus metadatos.

• "software" -java devuelve trabajos relacionados con "software", pero excluye los que están relacionados con "java".

• "(software OR java) AND (marketing)" devuelve los trabajos relevantes para "software" y "marketing", así como los trabajos relevantes para "java" y "marketing".

Consulta de búsqueda de empleo

Los términos de búsqueda también se pueden detectar como entidades relacionadas con el empleo. Por ejemplo, si la consulta fuera "becario", Cloud Talent Solution lo trataría como el tipo de empleo "INTERN" y filtraría los empleos que solo tuvieran el valor "INTERN" en el campo EMPLOYMENT_TYPE. Por lo tanto, aunque el término "becario" apareciera en la descripción del puesto, no se devolvería si el tipo de empleo de ese puesto se hubiera definido como otro.

Es muy importante especificar el tipo de empleo de cada puesto. Si no lo haces, la experiencia de los candidatos se verá afectada negativamente.

Solución de problemas

Cada solicitud de búsqueda genera una búsqueda requestID única en nuestro sistema que se usa para monitorizar los parámetros de esa búsqueda, así como la respuesta. Esto es fundamental para solucionar problemas relacionados con búsquedas específicas y solicitudes CRUD, y debe registrarse correctamente. El requestId se devuelve en el campo ResponseMetadata del cuerpo de la respuesta de búsqueda o del objeto de respuesta de la llamada CRUD asociada.

Si tienes problemas con la relevancia, las consultas de búsqueda, las consultas de indexación, etc., envía una incidencia a nuestro equipo de Asistencia e incluye los IDs de solicitud o las solicitudes pertinentes.

Número de resultados

El recuento de resultados se usa para comunicar el número de resultados de búsqueda al candidato. No siempre se corresponde con los resultados del histograma ni con el número real de trabajos devueltos. Búsqueda de empleo devuelve un máximo de 5000 empleos.

Paginación

De forma predeterminada, Búsqueda de empleo devuelve 100 resultados por página (o menos, si el número total de resultados es inferior a 100). Puedes implementar la paginación con los campos asociados a esta función.

Nota: Si el número total de resultados supera el máximo de 5000, todas las páginas posteriores a la página que contiene el resultado número 5000 estarán en blanco.

• pageSize: número de resultados devueltos por página.
• nextPageToken: token único que se devuelve con los resultados de cada página de resultados de búsqueda y que especifica la posición inicial de la siguiente página de resultados. Este campo se deja vacío si no hay más resultados.
• offset: especifica el desplazamiento entre la clasificación de relevancia del empleo devuelto en la parte superior de una página determinada y 1 (el empleo más relevante devuelto). Por ejemplo, un usuario realiza una búsqueda y pageSize se define como 10. La primera página devuelve el trabajo número 1 en la parte superior, por lo que el valor de offset de esta página es 0. En la página siguiente, se muestra el trabajo número 11 en la parte superior. El offset de esta página es 10.

Define el tamaño de página en 20 resultados o menos para evitar problemas de latencia. Como práctica recomendada, emite una llamada de búsqueda independiente por cada página renderizada al candidato. La alternativa, que consiste en hacer una sola llamada de búsqueda para devolver un mayor número de trabajos y paginar en el lado del cliente, impide que el modelo de aprendizaje automático aprenda con precisión a través del framework de analíticas de trabajos.

Corrección ortográfica

La corrección ortográfica es una función de la solicitud de búsqueda de Cloud Talent Solution que tiene en cuenta los términos de búsqueda que pueden tener errores ortográficos, los corrige y devuelve resultados basados en la consulta corregida. Por ejemplo, si la corrección ortográfica está habilitada y un candidato busca "manaer" en lugar de "manager", Cloud Talent Solution devuelve resultados de empleo para "manager". Para habilitar o inhabilitar la corrección ortográfica, se debe definir el campo disableSpellCheck de JobQuery. Si la corrección ortográfica está habilitada, la consulta corregida se puede encontrar en la respuesta de búsqueda, en el campo spellResult.