Cloud Talent Solution permite a los usuarios buscar entre los empleos que almacenas en el índice de búsqueda de empleo. Búsqueda de trabajo se ha diseñado para que sea personalizable y se pueda modificar para satisfacer las necesidades de tu empresa. En esta página se ofrece una descripción general de las funciones de búsqueda disponibles en la búsqueda de empleo de CTS.
Crear solicitudes de búsqueda
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 de uso habitual (opcional)
JobQuery
: el objetoJobQuery
consta de dos componentes: una cadenaquery
y los filtros aplicados a esa cadena. Esta función permite a los usuarios buscar en una cadena de consulta (como "asistente de comunicaciones") mediante uno o varios filtros (ubicación, tiempo de desplazamiento, remuneración, etc.). Consulte Filtros de búsqueda para obtener más información y una lista de las opciones de filtro disponibles.searchMode
: especifica el tipo de búsqueda que se va a aplicar. Las opciones son las siguientes:JOB_SEARCH
(recomendado): es el modo de búsqueda predeterminado, que busca en todos los objetos Job. Los empleos más relevantes se devuelven al usuario en orden de relevancia para la consulta de búsqueda.FEATURED_JOB_SEARCH
: busca solo objetos Job con unpromotionValue
mayor que 0. Los resultados se ordenan de mayor a menor según el valor depromotionValue
. En caso de empate, se utiliza la relevancia para decidir la posición. Consulta la sección Empleos destacados para obtener más información.
jobView
: define el número de campos que se devuelven para cada objeto Job coincidente. Puede serJOB_VIEW_SMALL
(valor predeterminado),JOB_VIEW_MINIMAL
oJOB_VIEW_FULL
. Puedes consultar la descripción de cada opción en la documentación de referencia deJobView
.orderBy
: El orden de clasificación de los trabajos devueltos. Consulta la documentación de referencia para ver los valores permitidos. De forma predeterminada, se ordena por relevancia, de forma descendente (RELEVANCE_DESC
).
Campos obligatorios
El siguiente campo es obligatorio:
requestMetadata
: contiene información sobre el usuario y la sesión de esta solicitud de búsqueda.
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.
Es importante por dos motivos principales:
Coherencia de los usuarios: Cloud Talent Solution ejecuta varias versiones de los modelos subyacentes simultáneamente para mejorar la relevancia de las búsquedas. CTS se asegura de que un candidato (identificado por userId, sessionId y domain) tenga una experiencia coherente. 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.
Cómo usar los operadores de búsqueda
Los operadores de búsqueda de la tabla siguiente se pueden usar solos o combinados.
Operador | Descripción |
---|---|
( ) | Agrupa una o varias palabras clave. |
O | Busca resultados relevantes para las palabras clave o los grupos de palabras clave que se encuentran a ambos lados del operador. Ejemplo: "software OR java" devuelve las tareas que tienen "software" o "java" en sus metadatos. |
Y | Busca resultados relevantes para las palabras clave o los grupos de palabras clave que se encuentran a ambos lados del operador. Ejemplo: "(software OR java) AND (marketing)" devuelve los trabajos que son relevantes para "software" y "marketing" o los que son relevantes para "java" y "marketing". |
NOT | Excluye los resultados relevantes para la palabra clave o el grupo de palabras clave que siguen inmediatamente al operador. La palabra clave o el grupo de palabras clave deben estar entre paréntesis. |
- | Excluye los resultados relevantes para la palabra clave o el grupo de palabras clave que se encuentran después del operador. Ejemplo: "software -java" devuelve empleos relacionados con "software", pero excluye los empleos relacionados con "java". |
req o requisition: | Devuelve los trabajos con el ID de solicitud especificado. Por ejemplo, req:1234 devuelve los empleos con el ID de solicitud 1234. |
Consultas de usuarios que buscan empleo
Los términos de búsqueda también se pueden detectar como entidades relacionadas con el empleo. Por ejemplo, si un usuario busca "becario", Cloud Talent Solution lo trata como el tipo de empleo INTERN
y filtra los empleos con la designación EMPLOYMENT_TYPE - INTERN
. Por lo tanto, aunque un objeto Job tenga el valor "intern" en su descripción, no se devolvería si el campo EMPLOYMENT_TYPE
de ese objeto Job tuviera otro valor.
Solución de problemas
Cada solicitud de búsqueda genera un requestID
de búsqueda único en el sistema de búsqueda de empleo. Este valor 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 o 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 relacionados con la relevancia, las consultas de búsqueda, las consultas de indexación, etc., abre una incidencia con nuestro equipo de Asistencia e incluye los requestID
s pertinentes o las propias solicitudes.
Diagnosticar problemas con los datos mediante la consola
Usa la página Empleos y empresas de la consola de CTS para diagnosticar problemas relacionados con los datos de empleo. Si necesitas solucionar problemas con los datos, puedes ver las estadísticas de las tareas, buscar los metadatos de tareas específicas y exportar datos por tarea, empresa o inquilino. Consulta la sección de documentación Datos de empleos y empresas para obtener más información sobre cómo usar estas herramientas.
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 (opcional)
De forma predeterminada, Job Search devuelve 100 resultados en una sola llamada (o menos, si el número total de resultados es inferior a 100). Para ver más de 100 resultados, puedes implementar la paginación. Si el número total de resultados supera el máximo de 5000, todas las páginas posteriores a la que contiene el resultado número 5000 estarán en blanco. Los campos siguientes controlan la paginación:
pageSize
: número de resultados devueltos.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 ypageSize
se define como 10. La primera página devuelve el trabajo número 1 en la parte superior, por lo que el valor deoffset
de esta página es 0. En la página siguiente, se muestra el trabajo número 11 en la parte superior. Eloffset
de esta página es 10.
Hay dos formas principales de implementar la paginación. Puede usar pageSize
y nextPageToken
para ir directamente a la siguiente página de resultados (cada página tiene un nuevo valor nextPageToken
que apunta a la página siguiente). Si usas este método, siempre empezarás por la parte superior de los resultados y pasarás por las páginas en orden secuencial. También puedes usar pageSize
con offset
para especificar directamente qué resultado numerado aparece en la parte superior de cada página. Si usas offset
en lugar de nextPageToken
, puedes ir a cualquier punto del conjunto de resultados.
Te recomendamos que definas 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.
Si usas la paginación, todos los campos de la solicitud, excepto pageSize
,
nextPageToken
y offset
, deben seguir siendo los mismos. Si estos campos no son iguales, el orden de los trabajos devueltos en los resultados puede ser incoherente.
Corrección ortográfica
La corrección ortográfica es una función opcional de una solicitud de búsqueda de CTS. 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", el CTS devuelve ofertas de empleo para "manager". La corrección ortográfica se puede habilitar o inhabilitar configurando el campo disableSpellCheck
de la solicitud de búsqueda.
Si la corrección ortográfica está habilitada, la consulta corregida se puede encontrar en la respuesta de búsqueda, en el campo spellResult
.