Descripción general de la Búsqueda (v4beta1)

Cloud Talent Solution permite a los usuarios buscar trabajos que almacenas en el índice de Búsqueda de empleo. La búsqueda de trabajo está diseñada para ser personalizable y puede modificarse para satisfacer las necesidades de tu negocio. Esta página es una descripción general de las funciones de búsqueda disponibles en CTS Job Search.

Realiza solicitudes de búsqueda

Para realizar una solicitud de búsqueda de empleo, pasa los datos de búsqueda en el cuerpo a fin de enviar una solicitud POST al extremo jobs:search.

Campos de uso común (opcional)

  • JobQuery: El objeto JobQuery consta de dos componentes, una string query y los filtros aplicados a esa string. Esta característica le permite a los usuarios buscar en una cadena de consulta (como "asistente de comunicaciones") mediante uno o más filtros (ubicación, tiempo de viaje, compensación, etcétera). Consulta Filtros de búsqueda para obtener más información y una lista de opciones de filtro disponibles.

  • searchMode: Especifica el tipo de búsqueda por aplicar. Se incluyen las siguientes opciones:

    • JOB_SEARCH (recomendado): Este es el modo de búsqueda predeterminado, que busca en todos los objetos de trabajo. Los trabajos más relevantes se muestran al usuario en el orden de relevancia para la consulta de búsqueda.
    • FEATURED_JOB_SEARCH: Busca solo objetos de trabajo con un promotionValue mayor que 0. Los resultados se ordenan por el más alto promotionValue primero. En caso de empate, la relevancia se usa para decidir la posición. Consulta Trabajos destacados para obtener más información.
  • jobView: Define el número de campos que se muestran para cada objeto de trabajo coincidente. Puede ser JOB_VIEW_SMALL (predeterminado), JOB_VIEW_MINIMAL o JOB_VIEW_FULL. Las descripciones para cada opción se pueden encontrar en la documentación de referencia de JobView.

  • orderBy: El orden de clasificación para los trabajos que se muestran. Consulta la documentación de referencia para conocer los valores permitidos. La configuración predeterminada es el orden descendente según relevancia (RELEVANCE_DESC).

Campos obligatorios

El siguiente campo es obligatorio:

  • requestMetadata: Contiene información de usuario y sesión para esta solicitud de búsqueda.

RequestMetadata

Cada solicitud de búsqueda e histograma debe incluir un objeto RequestMetadata. Este objeto contiene información sobre el usuario que inicia la búsqueda. Es importante por dos razones principales:

  • Consistencia del usuario: Cloud Talent Solution ejecuta varias versiones de los modelos subyacentes simultáneamente para mejorar la relevancia de la búsqueda. CTS garantiza que un buscador de trabajo (identificado por userId, sessionId y domain) tenga una experiencia coherente. Estos campos deben estar ofuscados.

  • Mejoras de búsqueda: Los algoritmos de ajuste se basan en la información proporcionada en los campos RequestMetadata junto con los datos de los solicitantes de empleo que proporcionas. Esto mejora la relevancia de los resultados de la búsqueda.

Usa operadores de búsqueda

Los operadores de búsqueda en la tabla que se encuentra a continuación se pueden usar solos o en combinación.

Operador Descripción
( ) Agrupa una o más palabras clave.
O Busca resultados relevantes para las palabras clave o grupos de palabras clave a cada lado del operador. Ejemplo: "software OR java" muestra trabajos ya sea con "software" o "java" en sus metadatos.
Y Busca los resultados que son relevantes para las palabras clave o grupos de ellas ubicados en ambos lados del operador. Ejemplo: "(software OR java) AND (marketing)" muestra trabajos que son tanto relevantes para ambos "software" y "marketing", o trabajos que son relevantes para ambos "java" y "marketing".
NOT Excluye resultados relevantes para la palabra clave o grupo de palabras clave inmediatamente después del operador. La palabra clave o grupo de palabras clave debe estar entre paréntesis.
- Excluye resultados relevantes para la palabra clave o grupo de palabras clave después del operador. Ejemplo: "software -java" muestra trabajos relevantes para "software" pero excluye trabajos que son relevantes para "java".
req o solicitud: Muestra trabajos con el ID de solicitud especificada. Por ejemplo, req:1234 muestra trabajos con el ID de solicitud 1234.

Consultas de búsqueda de empleo

Los términos de búsqueda también se pueden detectar como entidades reales relacionadas con el trabajo. Por ejemplo, si un usuario pregunta por "pasante", Cloud Talent Solution trata esto como el tipo de empleo INTERN y filtra los trabajos con la designación EMPLOYMENT_TYPE - INTERN. Por lo tanto, incluso un objeto de trabajo con "interno" en su descripción no se mostraría si el campo EMPLOYMENT_TYPE para ese trabajo se configurara como otra cosa.

Soluciona problemas

Cada solicitud de búsqueda genera una búsqueda única requestID en el sistema de búsqueda de empleo. Este valor se usa para hacer un seguimiento de los parámetros de esa búsqueda, así como de la respuesta. Esto es crucial en la resolución de problemas relacionados con búsquedas específicas o solicitudes CRUD, y debe registrarse adecuadamente. El requestID se muestra dentro del campo ResponseMetadata en el cuerpo de la respuesta de búsqueda o en el objeto de respuesta de llamada CRUD asociado.

En el caso de los problemas de asistencia relacionados con la relevancia, consultas de búsqueda, consultas de indexación, etc., presenta un ticket con nuestro equipo de asistencia e incluye requestID relevantes o las solicitudes.

Recuento de resultados

El recuento de resultados se usa para comunicar la cantidad de resultados de la búsqueda al usuario. Este número no siempre coincide con los resultados del histograma o con la cantidad real de trabajos que se muestran. La búsqueda de empleo muestra un máximo de 5000 trabajos.

Paginación (opcional)

De forma predeterminada, la Búsqueda de trabajo muestra 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 después de la página que contiene el resultado número 5000 estarán en blanco. Los siguientes campos controlan la paginación:

  • pageSize: El número de resultados que se muestran.
  • nextPageToken: Un token único, que se muestra con los resultados de cada página de resultados de búsqueda, que especifica la posición inicial para 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 trabajo que se muestra en la parte superior de una página determinada y 1 (el trabajo más relevante que se muestra). Como ejemplo, un usuario realiza una búsqueda y pageSize se establece en 10. La primera página devuelve el trabajo n.º 1 en la parte superior, por lo tanto, el valor offset para esta página es 0. La página siguiente muestra el trabajo n.º 11 en la parte superior; offset para esta página es 10.

Hay dos formas principales de implementar la paginación. Puedes usar pageSize y nextPageToken para apuntar 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 comenzarás en la parte superior de los resultados y pasarás las páginas en orden secuencial. Alternativamente, puedes usar pageSize con offset para especificar directamente qué resultado numerado aparece en la parte superior de cada página. Usar offset en lugar de nextPageToken te permite saltar a cualquier punto del conjunto de resultados.

Recomendamos que establezcas 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 separada por página procesada al buscador de trabajo. La alternativa, una sola llamada de búsqueda para mostrar un mayor número de trabajos y paginar en el lado del cliente, impide la capacidad del modelo de aprendizaje automático de aprender con precisión a través del framework de estadísticas de trabajo.

Corrección ortográfica

El corrector ortográfico es una característica opcional de una solicitud de búsqueda de CTS. Cuenta con términos de búsqueda potencialmente mal escritos, los corrige y muestra resultados basados en la consulta corregida. Por ejemplo, cuando el corrector ortográfico está habilitado, si un buscador de trabajo busca "administradr" en lugar de "administrador", CTS muestra los trabajos para "administrador". El corrector ortográfico se puede habilitar o deshabilitar si estableces 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.