Conceptos básicos de Búsqueda (v3)

Cloud Talent Solution permite que los usuarios busquen los trabajos almacenados en su índice. En este documento, se explican las diversas funciones de búsqueda y otras funciones relacionadas de Cloud Talent Solution.

Solicitudes de búsqueda

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

Campos obligatorios

El siguiente campo es obligatorio:

  • searchMode: Especifica el tipo de búsqueda de trabajo que se debe aplicar. Se incluyen las siguientes opciones:

    • JOB_SEARCH: Este es el modo de búsqueda predeterminado y recomendado. La búsqueda se realiza en todos los trabajos. Se muestran los trabajos más relevantes en orden descendente según la búsqueda.
    • FEATURED_JOB_SEARCH: Solo busca los trabajos que tengan un valor de 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.

Campos de uso común

  • JobQuery: Especifica los criterios de búsqueda que se deben comparar. Algunos de ellos son la ubicación, las categorías de trabajo, los tipos de empleo, las consultas de texto, las empresas, etcétera. Consulta Filtros de búsqueda para obtener más información.

  • requestMetadata: Contiene información de usuario y sesión para esta solicitud de búsqueda. Consulta RequestMetadata 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 están en la referencia JobView.

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

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

Si quieres que se muestren más trabajos en tus búsquedas, puedes usar estos dos campos para disminuir la rigurosidad de las restricciones de relevancia:

  • enableBroadening Si se establece como true, se disminuyen las restricciones de ubicación y categoría de trabajo de la solicitud de búsqueda para obtener más resultados. Por ejemplo, si una solicitud de búsqueda especificó trabajos dentro de un radio de 3 kilómetros de Anytown, WA, establecer esta marca en true también puede mostrar trabajos de NextTownOver, WA.

  • disableKeywordMatch: Esta marca es falsa de forma predeterminada. Configurar esta marca como false permite que Cloud Talent Solution adjunte los trabajos relacionados con esta búsqueda a los trabajos que también coincidan con la cadena de consulta exacta en el título o la descripción.

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.

Este objeto es importante por las siguientes razones:

  • Coherencia de la experiencia del usuario. Cloud Talent Solution ejecuta varias versiones de los modelos subyacentes de manera simultánea para mejorar la relevancia de la búsqueda. Completa este campo a fin de garantizar que el usuario tenga experiencias coherentes. Cloud Talent Solution garantiza que un usuario (que se identifica mediante los campos userId, sessionId y domain) tenga una experiencia coherente. Nota: Estos campos se deben ofuscar.

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

Operadores de búsqueda

Operador Descripción
( ) Agrupa una o más palabras clave.
AND Busca los resultados que son relevantes para las palabras clave o grupos de ellas ubicados en ambos lados del operador.
OR Busca los resultados que son relevantes para las palabras clave o grupos de ellas ubicados en cualquiera de los dos lados del operador.
NOT Excluye los resultados que son relevantes para las palabras clave o grupos de ellas, escritos entre paréntesis, ubicados inmediatamente después del operador.
- Excluye los resultados que son relevantes para las palabras clave o grupos de ellas adjuntos al operador.

Por ejemplo:

  • "software OR java" muestra trabajos con ya sea "software" o "java" en sus metadatos.

  • "software" -java muestra trabajos relevantes para "software" pero excluye trabajos que son relevantes para "java".

  • "(software OR java) AND (marketing)" muestra trabajos relevantes tanto para "software" como para "marketing", y trabajos que son relevantes tanto para "java" como para "marketing".

Consulta del usuario

Los términos de búsqueda también se pueden detectar como entidades reales relacionadas con el trabajo. Por ejemplo, si la consulta era para 'pasante', Cloud Talent Solution trataría esto como el tipo de empleo "INTERN" y filtraría los trabajos que solo tenían el EMPLOYMENT_TYPE - INTERN. Por lo tanto, incluso si el pasante estuviera necesariamente en la descripción del trabajo, no se mostraría si el tipo de empleo para ese trabajo se establece de otra forma.

Soluciona problemas

Cada solicitud de búsqueda genera una búsqueda única requestID en nuestro sistema que se usa para hacer un seguimiento de los parámetros de esa búsqueda, así como de la respuesta. Esto es fundamental para la solución de problemas relacionados con la búsqueda específica y las solicitudes CRUD, por lo que se debe registrar de manera adecuada. El requestId se muestra dentro del campo ResponseMetadata en el cuerpo de la respuesta de búsqueda o en el objeto de la respuesta de la llamada CRUD asociado.

En el caso de los problemas de asistencia relacionados con la relevancia, las preguntas sobre las búsquedas o la indexación, etc., envía una solicitud a nuestro equipo de asistencia y no olvides incluir los ID de solicitud relevantes o las propias 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

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

  • pageSize: El número de resultados que se muestran por página.
  • 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.

Establece el tamaño de la 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

La corrección ortográfica es una función de la solicitud de búsqueda de Cloud Talent Solution que detecta términos de búsqueda posiblemente 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", Cloud Talent Solution muestra los trabajos para "administrador". La revisión ortográfica se puede habilitar o deshabilitar si configuras 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.