Présentation de la recherche

Cloud Talent Solution permet aux utilisateurs de rechercher des emplois que vous stockez dans l'index Job Search. Job Search est conçu pour être personnalisé. Vous pouvez donc en ajuster les paramètres pour répondre aux besoins de votre entreprise. Cette page donne un aperçu des fonctionnalités de recherche disponibles dans CTS Job Search.

Effectuer des requêtes de recherche

Pour effectuer une demande de recherche d'emploi, envoyez une requête POST au point de terminaison jobs:search, en transmettant les données de recherche dans le corps de la requête.

Champs couramment utilisés (facultatif)

  • JobQuery : l'objet JobQuery est constitué de deux composants, une chaîne query et le ou les filtres appliqués à cette chaîne. Cette fonctionnalité permet à vos utilisateurs de lancer une recherche sur une chaîne de requête (telle que "assistant de communication") à l'aide d'un ou plusieurs filtres (lieu, temps de trajet, rémunération, etc.). Consultez la section Filtres de recherche pour en savoir plus et obtenir une liste des options de filtre disponibles.

  • searchMode : indique le type de recherche à appliquer. Les options sont les suivantes :

    • JOB_SEARCH (recommandé) : il s'agit du mode de recherche par défaut, qui recherche tous les objets Job. Les offres d'emploi les plus pertinentes sont renvoyées à l'utilisateur dans l'ordre de pertinence défini par la requête de recherche.
    • FEATURED_JOB_SEARCH : ne recherche que les objets Job dont la valeur promotionValue est supérieure à 0. Les résultats sont classés en premier par valeur promotionValue la plus élevée. En cas d'égalité, la pertinence détermine la position. Pour en savoir plus, consultez la section Sélection d'emplois.
  • jobView : définit le nombre de champs renvoyés pour chaque objet Job correspondant. Peut être JOB_VIEW_SMALL (par défaut), JOB_VIEW_MINIMAL ou JOB_VIEW_FULL. Les descriptions de chaque option sont fournies dans la documentation de référence JobView.

  • orderBy : ordre de tri des offres d'emploi affichées. Consultez la documentation de référence pour connaître les valeurs autorisées. Le fonctionnement par défaut consiste à trier par pertinence, dans l'ordre décroissant (RELEVANCE_DESC).

Champs obligatoires

Le champ suivant est obligatoire :

  • requestMetadata : contient les informations sur l'utilisateur et la session pour cette requête de recherche.

RequestMetadata

Chaque requête de recherche et d'histogramme doit inclure un objet RequestMetadata. Cet objet contient des informations sur l'utilisateur qui est à l'origine de la recherche. Il est important pour deux raisons principales :

  • Cohérence utilisateur : Cloud Talent Solution exécute simultanément plusieurs versions des modèles sous-jacents pour améliorer la pertinence de la recherche. CTS s'assure qu'un demandeur d'emploi (identifié par userId, sessionId et domaine) a une expérience cohérente. Ces champs doivent être obscurcis.

  • Améliorations de la recherche : les algorithmes de réglage sont basés sur les informations fournies dans les champs RequestMetadata, ainsi que sur les données des demandeurs d'emploi que vous fournissez. Cela permet d'améliorer la pertinence des résultats de recherche.

Utilisation des opérateurs de recherche

Les opérateurs de recherche du tableau ci-dessous peuvent être utilisés seuls ou en combinaison.

Opérateur Description
( ) Regroupe un ou plusieurs mots clés.
OR Recherche des résultats pertinents correspondant aux mots clés ou aux groupes de mots clés de chaque côté de l'opérateur. Exemple : "software OR java" affiche les offres d'emploi dont les métadonnées contiennent soit le terme "software", soit le terme "java".
ET Recherche les résultats correspondant aux mots clés ou aux groupes de mots clés de chaque côté de l'opérateur. Exemple : "(software OR java) AND (marketing)" affiche les offres d'emploi correspondant soit aux termes "logiciels" et "marketing", soit aux termes "java" et "marketing".
NOT Exclut les résultats correspondant au mot clé ou au groupe de mots clés placés immédiatement après l'opérateur. Le mot clé ou le groupe de mots clés doit être entre parenthèses.
- Exclut les résultats correspondant au mot clé ou au groupe de mots clés placés après l'opérateur. Exemple : "software -java" renvoie les offres d'emploi correspondant au terme "logiciel", mais exclut celles correspondant au terme "java".
req ou réquisition : Renvoie les offres d'emploi correspondant à l'ID de requête spécifié. Exemple : req:1234 renvoie les offres dont l'ID de requête est 1234.

Requêtes du demandeur d'emploi

Les termes de recherche peuvent également être détectés en tant qu'entités liées à une offre d'emploi. Par exemple, si un utilisateur demande "stagiaire", Cloud Talent Solution traite la requête comme le type d'emploi INTERN et filtre les offres d'emploi avec la désignation EMPLOYMENT_TYPE - INTERN. Par conséquent, même un objet Job contenant le terme "intern" dans sa description ne serait pas renvoyé si le champ EMPLOYMENT_TYPE de cet objet Job était défini sur un autre terme.

Dépannage

Chaque requête de recherche génère un requestID de recherche unique dans le système de recherche d'emploi. Cette valeur permet de suivre les paramètres de cette recherche ainsi que la réponse. Elle est essentielle pour résoudre les problèmes liés à des recherches spécifiques ou aux requêtes CRUD, et doit être correctement enregistrée. Le requestID est renvoyé à l'intérieur du champ ResponseMetadata dans le corps de réponse de la recherche. ou l'objet de réponse d'appel CRUD associé.

Pour les problèmes d'assistance liés à la pertinence, aux requêtes de recherche, aux requêtes d'indexation, etc., veuillez déposer un ticket auprès de notre équipe d'assistance en y incluant les requestID pertinents ou la requête elles-même.

Diagnostiquer les problèmes de données à l'aide de la console

Utilisez la page Tâches et entreprises de la console CTS pour diagnostiquer les problèmes liés aux données sur les tâches. Si vous devez résoudre des problèmes de données, vous pouvez consulter des statistiques sur les tâches, rechercher les métadonnées de tâches spécifiques et exporter des données par tâche, entreprise ou locataire. Consultez la section de documentation Données sur les offres d'emploi et les entreprises pour en savoir plus sur l'utilisation de ces outils.

Nombre de résultats

Le nombre de résultats de la recherche est communiqué au demandeur d'emploi. Il ne correspond pas toujours aux résultats de l'histogramme ou au nombre réel d'offres d'emploi affichées. Job Search renvoie un maximum de 5 000 offres d'emploi.

Pagination (facultatif)

Par défaut, Job Search renvoie 100 résultats par page (ou moins si le nombre total de résultats est inférieur à 100). Pour afficher plus de 100 résultats, vous pouvez mettre en œuvre la pagination. Si le nombre total de résultats dépasse le maximum de 5 000, toutes les pages suivant celle contenant le 5000e résultat seront vides. Les champs ci-dessous contrôlent la pagination :

  • pageSize : nombre de résultats renvoyés.
  • nextPageToken : jeton unique, renvoyé avec les résultats de chaque page de résultats de recherche, qui spécifie la position de départ de la page de résultats suivante. Ce champ est laissé vide s'il n'y a plus de résultats.
  • offset : spécifie la valeur du décalage entre le classement de pertinence de l'offre d'emploi affichée en haut d'une page donnée et 1 (offre renvoyée la plus pertinente). Par exemple, un utilisateur effectue une recherche et la valeur pageSize est définie sur 10. La première page renvoie l'offre n° 1 en haut, donc la valeur offset pour cette page est 0. La page suivante renvoie l'offre n° 11 en haut; donc la valeur offset pour cette page est 10.

Il existe deux façons principales de mettre en œuvre la pagination. Vous pouvez utiliser pageSize et nextPageToken pour pointer directement vers la page de résultats suivante (chaque page comporte une nouvelle valeur nextPageToken qui pointe vers la page suivante). Si vous utilisez cette méthode, vous commencerez toujours en haut des résultats et parcourrez la page dans un ordre séquentiel. Vous pouvez également utiliser pageSize avec offset pour spécifier directement le résultat numéroté qui apparaît en haut de chaque page. L'utilisation de offset au lieu de nextPageToken vous permet de sauter à n'importe quel point de l'ensemble de résultats.

Nous vous conseillons de définir la taille de la page sur 20 résultats ou moins pour éviter les problèmes de latence. Il est recommandé d'émettre un appel de recherche distinct par page affichée au demandeur d'emploi (plutôt que d'utiliser un seul appel de recherche permettant d'afficher un plus grand nombre d'offres d'emploi avec une pagination du côté client), pour ne pas entraver la capacité du modèle de machine learning (apprentissage automatique) à apprendre avec précision par le biais du framework d'analyse des offres d'emploi.

Si vous utilisez la pagination, tous les champs de la requête autres que pageSize, nextPageToken et offset doivent rester identiques. Si ces champs ne sont pas identiques, l'ordre des offres d'emploi renvoyées dans les résultats peut être incohérent.

Correction orthographique

La vérification orthographique est une fonctionnalité facultative des requêtes de recherche CTS. Elle identifie les termes de recherche potentiellement mal orthographiés, les corrige et renvoie les résultats en fonction de la requête corrigée. Par exemple, lorsque la correction orthographique est activée, si un demandeur d'emploi recherche le terme "manaer" au lieu de "manager", Cloud Talent Solution affiche les offres d'emploi correspondant à "manager". La vérification orthographique peut être activée/désactivée en définissant le champ disableSpellCheck de la requête de recherche. Si la vérification orthographique est activée, la requête corrigée se trouve dans la réponse de recherche, dans le champ spellResult.