Grundlegendes zur Suche (v3)

Cloud Talent Solution ermöglicht es Nutzern, nach Jobs zu suchen, die Sie im Cloud Talent Solution-Index gespeichert haben. Dieses Dokument stellt die verschiedenen Suchfunktionen und zugehörigen Angebote von Cloud Talent Solution vor.

Suchanfragen

Um eine Jobsucheanforderung zu stellen, senden Sie eine POST-Anforderung an den Endpunkt jobs:search und übergeben Sie die Suchdaten im Hauptteil.

Pflichtfelder

Folgendes Feld ist erforderlich:

  • searchMode: Gibt die Art der anzuwendenden Jobsuche an. Optionen sind:

    • JOB_SEARCH: Dies ist der empfohlene Standardsuchmodus. Dabei werden alle Jobs durchsucht. Die relevantesten Jobs werden in der Reihenfolge ihrer Relevanz an die Suchanfrage zurückgegeben.
    • FEATURED_JOB_SEARCH: Sucht nur nach Jobs mit einem promotionValue größer als 0. Die Ergebnisse werden nach dem höchsten promotionValue zuerst geordnet. Im Falle eines Unentschieden wird die Relevanz verwendet, um die Position zu bestimmen. Weitere Informationen finden Sie unter Hervorgehobene Jobs.

Häufig verwendete Felder

  • JobQuery: Geben Sie die Jobkriterien an, mit denen abgeglichen werden soll. Dazu gehören Standorte, Jobkategorien, Beschäftigungstypen, Texteingaben, Unternehmen usw. Weitere Informationen finden Sie unter Suchfilter.

  • requestMetadata: Enthält Nutzer- und Sitzungsinformationen für diese Suchanforderung. Weitere Informationen finden Sie unter RequestMetadata.

  • jobView: Definiert die Anzahl der Felder, die für jeden übereinstimmenden Job zurückgegeben werden. Kann JOB_VIEW_SMALL (Standardeinstellung), JOB_VIEW_MINIMAL oder JOB_VIEW_FULL sein. Beschreibungen für jede Option finden Sie in der Referenz JobView.

  • orderBy: Die Sortierreihenfolge für zurückgegebene Jobs. Die zulässigen Werte finden Sie in der Referenz. Standardmäßig wird absteigend nach Relevanz sortiert (RELEVANCE_DESC).

Relevanzschwellenwerte und Standort-/Kategorieerweiterung

Mit den folgenden beiden Feldern können Sie die Relevanzeinschränkungen lockern, um die Anzahl der von Ihren Suchen zurückgegebenen Jobs zu erhöhen:

  • enableBroadening: Wenn Sie dies auf true setzen, werden die Einschränkungen für Standort und Jobkategorie der Suchanforderung aufgehoben, um weitere Ergebnisse zurückzugeben. Wenn in einer Suchanforderung beispielsweise Jobs innerhalb eines Radius von 3 km um Anytown, WA angegeben wurden, kann das Setzen dieses Flags auf true auch Jobs von NextTownOver, WA zurückgeben.

  • disableKeywordMatch: Dieses Flag ist standardmäßig falsch. Wenn dieses Flag auf "false" gesetzt ist, kann Cloud Talent Solution neben den für diese Suchabfrage relevanten Jobs auch solche Jobs anfügen, die mit dem Abfragestring im Titel oder der Beschreibung exakt übereinstimmen.

RequestMetadata

Jede Such- und Histogrammanforderung sollte ein RequestMetadata -Objekt enthalten. Dieses Objekt enthält Informationen zum Nutzer, von dem die Suche ausgeht.

Es gibt verschiedene Gründe, warum dieses Objekt wichtig ist:

  • Nutzerkonsistenz. Cloud Talent Solution führt mehrere Versionen der zugrunde liegenden Modelle gleichzeitig aus, um die Suchrelevanz zu verbessern. Füllen Sie dieses Feld aus, damit sich dem Jobsuchenden ein einheitliches Bild bietet. Cloud Talent Solution gewährleistet dies dann für den Jobsuchenden, der durch die userId, sessionId und Domain identifiziert wird. Hinweis: Diese Felder sollten verschleiert werden.

  • Suchverbesserungen.Die Optimierungsalgorithmen basieren auf den Informationen in den Feldern RequestMetadata sowie den von Ihnen angegebenen Daten der Arbeitssuchenden. Damit können relevantere Suchergebnisse geliefert werden.

Suchoperatoren

Operator Beschreibung
( ) Gruppiert einen oder mehrere Suchbegriffe.
AND Sucht nach Ergebnissen, die für die Suchbegriffe oder Gruppen von Suchbegriffen auf beiden Seiten des Operators relevant sind.
OR Sucht nach Ergebnissen, die für den Suchbegriff oder die Gruppe von Suchbegriffen auf einer der Seiten des Operators relevant sind.
NOT Schließt Ergebnisse aus, die für den Suchbegriff oder die Gruppe von Suchbegriffen in Klammern direkt nach dem Operator relevant sind.
- Schließt Ergebnisse aus, die für den Suchbegriff oder die Gruppe von Suchbegriffen relevant sind, die an den Operator angefügt sind.

Beispiel:

  • "software OR java" gibt Jobs mit entweder "Software" oder "Java" in ihren Metadaten zurück.

  • "software" -java gibt Jobs zurück, die für "Software" relevant sind, schließt jedoch Jobs aus, die für "Java" relevant sind.

  • "(software OR java) AND (marketing)" gibt Jobs zurück, die sowohl für "Software" als auch für "Marketing" relevant sind, sowie Jobs, die sowohl für "Java" als auch für "Marketing" relevant sind.

Abfrage des Jobsuchenden

Suchbegriffe können auch als tatsächliche jobbezogene Entitäten erkannt werden. Wenn die Abfrage beispielsweise "Praktikant" war, würde Cloud Talent Solution dies als Beschäftigungstyp "INTERN" behandeln und nach Jobs filtern, die nur EMPLOYMENT_TYPE - INTERN hatten. Selbst wenn der Praktikant unbedingt in der Stellenbeschreibung enthalten wäre, würde er nicht zurückgegeben, wenn die Beschäftigungsart für diese Stelle auf etwas anderes festgelegt wäre.

Fehlerbehebung

Jede Suchanforderung generiert eine eindeutige Suche requestID in unserem System, mit der die Parameter dieser Suche sowie die Antwort verfolgt werden. Dies ist für die Fehlerbehebung in Zusammenhang mit bestimmten CRUD-Suchanfragen wichtig und sollte entsprechend protokolliert werden. Die requestId wird im Feld ResponseMetadata im Suchantworttext zurückgegeben. oder das zugehörige CRUD-Anrufantwortobjekt.

Bei Supportfällen, die sich auf die Relevanz, Suchanfragen, Indexierungsanfragen usw. beziehen, reichen Sie bitte ein Ticket bei unserem Supportteam ein und fügen die entsprechenden Anfrage-IDs oder die Anfragen selbst hinzu.

Ergebniszahlen

Die Ergebniszahl wird verwendet, um dem Jobsuchenden die Anzahl der Suchergebnisse mitzuteilen. Sie entspricht nicht immer den Histogrammergebnissen oder der tatsächlichen Anzahl gelieferter Jobs. Die Jobsuche gibt maximal 5000 Jobs zurück.

Paginierung

Standardmäßig gibt die Jobsuche 100 Ergebnisse pro Seite zurück (oder weniger, wenn die Gesamtzahl der Ergebnisse weniger als 100 beträgt). Mithilfe der mit dieser Funktion verknüpften Felder können Sie eine Paginierung implementieren:

  • pageSize: Die Anzahl der pro Seite zurückgegebenen Ergebnisse.
  • nextPageToken: Ein eindeutiges Token, das mit den Ergebnissen jeder Seite der Suchergebnisse zurückgegeben wird und die Startposition für die nächste Ergebnisseite angibt. Dieses Feld ist leer, wenn keine weiteren Ergebnisse vorhanden sind.
  • offset: Gibt den Versatz zwischen dem Relevanzranking des oben auf einer bestimmten Seite zurückgegebenen Jobs und 1 (dem relevantesten zurückgegebenen Job) an. Als Beispiel führt ein Nutzer eine Suche durch und pageSize wird auf 10 gesetzt. Die erste Seite gibt den Job Nr. 1 oben zurück, daher ist der Wert offset für diese Seite 0. Auf der nächsten Seite wird Job Nr. 11 oben zurückgegeben. offset für diese Seite ist 10.

Legen Sie die Seitengröße auf maximal 20 Ergebnisse fest, um Latenzprobleme zu vermeiden. Führen Sie als Best Practice einen separaten Suchaufruf pro Seite aus, die für den Jobsuchenden gerendert wird. Die Alternative, eine große Anzahl von Jobs mithilfe eines einzigen Suchaufrufs zu liefern und die Paginierung auf der Clientseite auszuführen, beeinträchtigt die Lernfähigkeit des Modells für maschinelles Lernen über das Jobs Analytics Framework.

Rechtschreibprüfung

Die Rechtschreibprüfung ist eine Funktion der Cloud Talent Solution-Suchanfrage, mit der potenziell falsch geschriebene Suchbegriffe ermittelt, korrigiert und Ergebnisse auf Basis der korrigierten Abfrage zurückgegeben werden. Wenn die Rechtschreibprüfung aktiviert ist und ein Jobsuchender beispielsweise nach "Manaer" statt "Manager" sucht, gibt Cloud Talent Solution Jobs für "Manager" zurück. Die Rechtschreibprüfung kann aktiviert/deaktiviert werden, indem das Feld disableSpellCheck der JobQuery festgelegt wird. Wenn die Rechtschreibprüfung aktiviert ist, finden Sie die korrigierte Abfrage in der Suchantwort im Feld spellResult.