Panoramica della ricerca

Cloud Talent Solution consente agli utenti di eseguire ricerche tra le offerte di lavoro che memorizzi nell'indice Job Search. Ricerca lavoro è progettato per essere personalizzabile e può essere modificato per soddisfare le esigenze della tua attività. Questa pagina offre una panoramica delle funzioni di ricerca disponibili in CTS Job Search.

Esecuzione di richieste di ricerca

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

(Facoltativo) Campi utilizzati di frequente

  • JobQuery: l'oggetto JobQuery è composto da due componenti: una stringa query e i filtri applicati a questa stringa. Questa funzionalità consente agli utenti di eseguire ricerche su una stringa di query (ad esempio "assistente alle comunicazioni") utilizzando uno o più filtri (posizione, tempo di percorrenza, retribuzione e così via). Consulta Filtri di ricerca per maggiori informazioni e 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 la ricerca in tutti gli oggetti Job. I lavori più pertinenti vengono restituiti all'utente in ordine di pertinenza rispetto alla query di ricerca.
    • FEATURED_JOB_SEARCH: esegue la ricerca solo di oggetti Lavoro con un promotionValue maggiore di 0. I risultati sono ordinati in base al valore promotionValue più alto; in caso di parità, la pertinenza viene utilizzata per decidere la posizione. Per ulteriori informazioni, consulta la sezione Offerte di lavoro in evidenza.

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

  • orderBy: L'ordine di ordinamento per i lavori restituiti. Consulta la documentazione di riferimento per i valori consentiti. Per impostazione predefinita, i risultati vengono ordinati in base alla pertinenza, in ordine decrescente (RELEVANCE_DESC).

Campi obbligatori

Il seguente campo è obbligatorio:

  • requestMetadata: contiene informazioni sull'utente e sulla sessione per 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 contemporaneamente diverse versioni dei modelli sottostanti per migliorare la pertinenza della ricerca. CTS garantisce che un candidato (identificato da userId, sessionId e domain) abbia un'esperienza coerente. Questi campi devono essere offuscati.

  • Miglioramenti alla ricerca: gli algoritmi di ottimizzazione si basano sulle informazioni fornite nei campi RequestMetadata e sui dati dei candidati che fornisci. In questo modo, la pertinenza dei risultati di ricerca migliora.

Utilizzo degli operatori di ricerca

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

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

Query di persone in cerca di lavoro

I termini di ricerca possono essere rilevati anche come entità effettive correlate al lavoro. Ad esempio, se un utente esegue una query per "tirocinante", Cloud Talent Solution lo considera come tipo di impiego INTERN e filtra i lavori con la designazione EMPLOYMENT_TYPE - INTERN. Pertanto, anche un oggetto Job con "intern" nella descrizione non verrà restituito se il campo EMPLOYMENT_TYPE per quel job è impostato su un altro valore.

Risoluzione dei problemi

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

Per problemi di assistenza relativi a pertinenza, query di ricerca, richieste di indicizzazione e così via, apri un ticket con il nostro team di assistenza e includi requestID pertinenti o le richieste stesse.

Diagnosticare i problemi relativi ai dati utilizzando la console

Utilizza la pagina Offerte di lavoro e aziende nella console CTS per diagnosticare i problemi relativi ai dati delle offerte di lavoro. Se devi risolvere i problemi relativi ai dati, puoi visualizzare le statistiche dei job, cercare i metadati di job specifici ed esportare i dati per job, azienda o tenant. Per saperne di più su come utilizzare questi strumenti, consulta la sezione della documentazione Dati su aziende e offerte di lavoro.

Conteggi dei risultati

Il conteggio dei risultati viene utilizzato per comunicare il numero di risultati di ricerca al candidato. Questo valore non corrisponde sempre ai risultati dell'istogramma o al numero effettivo di lavori restituiti. La ricerca di lavoro restituisce un massimo di 5000 job.

Impaginazione (facoltativo)

Per impostazione predefinita, Job Search 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 la paginazione. 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 la paginazione:

  • 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 successiva dei risultati. 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 pageSize è impostato su 10. La prima pagina restituisce l'offerta di lavoro n. 1 in alto, pertanto il valore offset per questa pagina è 0. La pagina successiva restituisce il job n. 11 in alto; offset per questa pagina è 10.

Esistono due modi principali per implementare la paginazione. 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 sfoglierai le pagine in ordine sequenziale. In alternativa, puoi utilizzare pageSize con offset per specificare direttamente quale risultato numerato viene visualizzato nella parte superiore di ogni pagina. L'utilizzo di offset anziché nextPageToken ti consente di passare a qualsiasi punto del set di risultati.

Ti consigliamo di impostare la dimensione della pagina su 20 risultati o meno per evitare problemi di latenza. Come best practice, emetti una chiamata di ricerca separata per ogni pagina visualizzata dal candidato. L'alternativa, una singola chiamata di ricerca per restituire un numero maggiore di job e la paginazione lato client, impedisce al modello di machine learning di apprendere con precisione tramite il framework Jobs Analytics.

Se utilizzi la paginazione, tutti i campi della richiesta, ad eccezione di pageSize, nextPageToken e offset, devono rimanere invariati. Se questi campi non sono uguali, l'ordine dei lavori restituiti nei risultati può essere incoerente.

Controllo ortografico

Il controllo ortografico è una funzionalità facoltativa di una richiesta di ricerca CTS. Prende in considerazione i termini di ricerca potenzialmente errati, li corregge e restituisce i risultati in base alla query corretta. Ad esempio, se il controllo ortografico è attivato, se un candidato cerca "manaer" anziché "manager", CTS restituisce offerte di lavoro 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 si trova nella risposta della ricerca, nel campo spellResult.