Panoramica della ricerca (v4beta1)

Cloud Talent Solution consente agli utenti di cercare le offerte di lavoro memorizzate nell'indice di Job Search. Ricerca lavoro è progettata per essere personalizzabile e può essere modificata in base alle esigenze aziendali. Questa pagina offre una panoramica delle funzioni di ricerca disponibili in CTS Job Search.

Effettuare richieste di ricerca

Per effettuare una richiesta Job Search, invia una richiesta POST all'endpoint jobs:search, passando i dati di ricerca nel corpo.

Campi di uso comune (facoltativi)

  • JobQuery: l'oggetto JobQuery è costituito da due componenti, una stringa query e i filtri applicati a tale stringa. Questa funzionalità consente agli utenti di eseguire ricerche in base a una stringa di query (ad esempio "assistente per le comunicazioni") utilizzando uno o più filtri (località, tempo di percorrenza del tragitto giornaliero, risarcimento e così via). Consulta Filtri di ricerca per ulteriori informazioni e per un elenco delle opzioni di filtro disponibili.

  • searchMode: specifica il tipo di ricerca da applicare. Le opzioni sono:

    • JOB_SEARCH (consigliato): questa è la modalità di ricerca predefinita, che esegue ricerche in tutti gli oggetti Job. Le offerte di lavoro più pertinenti vengono restituite all'utente in ordine di pertinenza rispetto alla query di ricerca.
    • FEATURED_JOB_SEARCH: cerca solo gli oggetti Job con promotionValue maggiore di 0. I risultati vengono ordinati in base al valore promotionValue più alto; in caso di parità, viene utilizzata la pertinenza per decidere la posizione. Consulta Offerte di lavoro in primo piano per ulteriori informazioni.

  • jobView: definisce il numero di campi restituiti per ogni oggetto Job corrispondente. Può essere JOB_VIEW_SMALL (impostazione predefinita), JOB_VIEW_MINIMAL o JOB_VIEW_FULL. Le descrizioni di ciascuna opzione sono disponibili nella documentazione di riferimento di JobView.

  • orderBy: l'ordinamento dei job restituiti. Consulta la documentazione di riferimento per i valori consentiti. L'impostazione predefinita è l'ordinamento in base alla pertinenza, in ordine decrescente (RELEVANCE_DESC).

Campi obbligatori

Il seguente campo è obbligatorio:

  • requestMetadata: contiene informazioni sull'utente e sulla sessione relative a questa richiesta di ricerca.

RequestMetadata

Ogni richiesta di ricerca e istogramma deve includere un oggetto RequestMetadata. Questo oggetto contiene informazioni sull'utente che avvia la ricerca. È importante per due motivi principali:

  • Coerenza degli utenti: Cloud Talent Solution esegue più versioni dei modelli sottostanti contemporaneamente per migliorare la pertinenza della ricerca. Il CTS garantisce che la persona in cerca di lavoro (identificata da userId, sessionId e dominio) abbia un'esperienza coerente. Questi campi devono essere offuscati.

  • Miglioramenti della ricerca: gli algoritmi di ottimizzazione si basano sulle informazioni fornite nei campi RequestMetadata e sui dati forniti dalle persone in cerca di lavoro. Ciò migliora la pertinenza dei risultati di ricerca.

Utilizzare gli operatori di ricerca

Gli operatori di ricerca nella tabella seguente possono essere utilizzati da soli o in combinazione.

Operatore Descrizione
( ) Raggruppa una o più parole chiave.
OPPURE Cerca i risultati pertinenti alle parole chiave o ai gruppi di parole chiave in entrambi i lati dell'operatore. Esempio: "software OR java" restituisce job che contengono o "software" o "java" nei metadati.
AND Cerca risultati pertinenti alle parole chiave o ai gruppi di parole chiave in entrambi i lati dell'operatore. Esempio: "(software OR java) AND (marketing)" restituisce job che sono sia rilevanti sia per "software" e "marketing", o job che sono pertinenti sia per "java" e "marketing".
NOT Esclude i risultati pertinenti alla parola chiave o al gruppo di parole chiave immediatamente dopo l'operatore. La parola chiave o il gruppo di parole chiave deve essere riportato tra parentesi.
- Esclude i risultati pertinenti alla parola chiave o al gruppo di parole chiave successivamente all'operatore. Esempio: "software -java" restituisce i job pertinenti a "software", ma esclude i job pertinenti a "java".
o richiesta: Restituisce i lavori con l'ID richiesta specificato. Ad esempio, req:1234 restituisce i lavori con ID richiesta 1234.

Query per chi cerca lavoro

I termini di ricerca possono essere rilevati anche come vere entità correlate al lavoro. Ad esempio, se un utente esegue la query per "stagista", Cloud Talent Solution considera questo come il tipo di impiego INTERN e filtra i lavori con la designazione EMPLOYMENT_TYPE - INTERN. Di conseguenza, anche un oggetto Job con "intern" nella descrizione non verrà restituito se il campo EMPLOYMENT_TYPE per quel job era impostato su qualcos'altro.

Risoluzione dei problemi

Ogni richiesta di ricerca genera una ricerca univoca requestID nel sistema Job Search. Questo valore viene utilizzato per monitorare i parametri della ricerca e della risposta. Questo è fondamentale per la risoluzione dei problemi relativi a ricerche specifiche o richieste CRUD e deve essere registrato in modo appropriato. Il valore requestID viene restituito all'interno del campo ResponseMetadata nel corpo della risposta della ricerca o nell'oggetto di risposta della chiamata CRUD associato.

Per i problemi di assistenza relativi a pertinenza, ricerche, indicizzazione e così via, invia un ticket al nostro team di assistenza e includi requestID pertinenti o le richieste stesse.

Conteggi dei risultati

Il conteggio dei risultati viene utilizzato per comunicare il numero di risultati di ricerca alla persona in cerca di lavoro. Questo non corrisponde sempre ai risultati dell'istogramma o al numero effettivo di job restituiti. Ricerca lavoro restituisce un massimo di 5000 job.

Impaginazione (facoltativo)

Per impostazione predefinita, Ricerca lavoro restituisce 100 risultati in una singola chiamata (o meno, se il numero totale di risultati è inferiore a 100). Per visualizzare più di 100 risultati, puoi implementare l'impaginazione. Se il numero totale di risultati supera il massimo di 5000, tutte le pagine successive a quella contenente il 5000° risultato saranno vuote. I campi seguenti controllano l'impaginazione:

  • pageSize: il numero di risultati restituiti.
  • nextPageToken: un token univoco, restituito con i risultati di ogni pagina dei risultati di ricerca, che specifica la posizione iniziale della pagina dei risultati successiva. Questo campo viene lasciato vuoto se non ci sono altri risultati.
  • offset: specifica l'offset tra il ranking di pertinenza del job restituito nella parte superiore di una determinata pagina e 1 (il job più pertinente restituito). Ad esempio, un utente esegue una ricerca e il valore pageSize è impostato su 10. La prima pagina restituisce il job n. 1 nella parte superiore, pertanto il valore offset per questa pagina è 0. La pagina successiva restituisce il job n. 11 in alto; offset per questa pagina è il 10.

Esistono due modi principali per implementare l'impaginazione. Puoi utilizzare pageSize e nextPageToken per indirizzare direttamente alla pagina successiva dei risultati (ogni pagina ha un nuovo valore nextPageToken che rimanda alla pagina successiva). Se utilizzi questo metodo, inizierai sempre dalla parte superiore dei risultati e scorri in ordine sequenziale. In alternativa, puoi utilizzare pageSize con offset per specificare direttamente quale risultato numerato visualizzare nella parte superiore di ogni pagina. Se utilizzi offset anziché nextPageToken, puoi passare a qualsiasi punto del set di risultati.

Ti consigliamo di impostare le dimensioni della pagina su un massimo di 20 risultati per evitare problemi di latenza. Come best practice, esegui una chiamata di ricerca separata per ogni pagina visualizzata da chi cerca lavoro. L'alternativa, una singola chiamata di ricerca per restituire un numero maggiore di job e impaginazione sul lato client, impedisce al modello di machine learning di apprendere in modo preciso tramite il framework di analisi di Jobs.

Controllo ortografico

Il controllo ortografico è una funzionalità facoltativa di una richiesta di ricerca CTS. Prende in considerazione i termini di ricerca che potrebbero contenere errori di ortografia, li corregge e restituisce risultati basati sulla query corretta. Ad esempio, quando il controllo ortografico è abilitato, se una persona in cerca di lavoro cerca "manaer" anziché "manager", CTS restituisce i job per "manager". Il controllo ortografico può essere attivato/disattivato impostando il campo disableSpellCheck della richiesta di ricerca. Se il controllo ortografico è attivato, la query corretta può essere trovata nella risposta di ricerca, nel campo spellResult.