סקירה כללית לגבי חיפוש

‫Cloud Talent Solution מאפשר למשתמשים לחפש משרות שאתם מאחסנים באינדקס החיפוש של חיפוש המשרות. הכלי 'חיפוש משרות' ניתן להתאמה אישית, ואפשר לשנות אותו כך שיתאים לצרכים העסקיים שלכם. בדף הזה מובאת סקירה כללית של פונקציות החיפוש שזמינות ב-CTS Job Search.

שליחת בקשות חיפוש

כדי לשלוח בקשה לחיפוש משרות, שולחים בקשת POST לנקודת הקצה jobs:search ומעבירים את נתוני החיפוש בגוף הבקשה.

שדות בשימוש נפוץ (אופציונלי)

  • ‫JobQuery: האובייקט JobQuery מורכב משני רכיבים: מחרוזת query ומסננים שמוחלים על המחרוזת הזו. התכונה הזו מאפשרת למשתמשים לחפש מחרוזת שאילתה (למשל, "עוזר תקשורת") באמצעות מסנן אחד או יותר (מיקום, זמן נסיעה, פיצוי וכו'). מידע נוסף ורשימה של אפשרויות הסינון הזמינות מופיעים במאמר בנושא מסנני חיפוש.

  • ‫searchMode: מציין את סוג החיפוש שרוצים להחיל. האפשרויות הן:

    • ‫JOB_SEARCH (מומלץ): זהו מצב החיפוש שמוגדר כברירת מחדל, שבו החיפוש מתבצע בכל אובייקטי המשרה. התוצאות הרלוונטיות ביותר מוצגות למשתמש לפי סדר הרלוונטיות לשאילתת החיפוש.
    • ‫FEATURED_JOB_SEARCH: חיפוש רק של אובייקטים מסוג Job עם ערך של promotionValue שגדול מ-0. התוצאות מסודרות לפי הדירוג הגבוה ביותר promotionValue. במקרה של שוויון, הרלוונטיות קובעת את המיקום. מידע נוסף זמין במאמר בנושא משרות מומלצות.

  • ‫jobView: מגדיר את מספר השדות שמוחזרים לכל אובייקט Job תואם. יכול להיות JOB_VIEW_SMALL (ברירת מחדל), JOB_VIEW_MINIMAL או JOB_VIEW_FULL. תיאורים של כל אפשרות זמינים במסמכי העזר של JobView.

  • ‫orderBy: סדר המיון של המשרות שמוחזרות. במאמרי העזרה בנושא הפניות מפורטים הערכים המותרים. ברירת המחדל היא מיון לפי רלוונטיות, בסדר יורד (RELEVANCE_DESC).

שדות חובה

חובה למלא את השדה הבא:

  • ‫requestMetadata: מכיל מידע על המשתמש והסשן של בקשת החיפוש הזו.

RequestMetadata

כל בקשה לחיפוש או להיסטוגרמה חייבת לכלול אובייקט RequestMetadata. האובייקט הזה מכיל מידע על המשתמש שיזם את החיפוש. יש לכך שתי סיבות עיקריות:

  • עקביות המשתמשים: כדי לשפר את הרלוונטיות של החיפוש, Cloud Talent Solution מפעיל כמה גרסאות של המודלים הבסיסיים בו-זמנית. מערכת CTS מוודאת שלמחפשי עבודה (שמזוהים באמצעות userId,‏ sessionId ו-domain) תהיה חוויה עקבית. צריך להסתיר את השדות האלה.

  • שיפורים בחיפוש: האלגוריתמים להתאמת המשרות מבוססים על המידע שמופיע בשדות RequestMetadata ועל הנתונים של מחפשי העבודה שאתם מספקים. כך משפרים את הרלוונטיות של תוצאות החיפוש.

שימוש באופרטורים של חיפוש

אפשר להשתמש באופרטורים לחיפוש שמופיעים בטבלה שלמטה לבד או בשילוב.

אופרטור תיאור
( ) מקבץ מילת מפתח אחת או יותר.
או החיפוש יתבצע אחר תוצאות שרלוונטיות למילות המפתח או לקבוצות של מילות מפתח משני צידי האופרטור. דוגמה: "software OR java" מחזירה משרות עם גם 'software' וגם 'java' במטא-נתונים שלהן.
וגם חיפוש תוצאות שרלוונטיות למילות המפתח או לקבוצות של מילות מפתח משני הצדדים של האופרטור. דוגמה: "(software OR java) AND (marketing)" מחזירה משרות שרלוונטיות גם ל'תוכנה' וגם ל'שיווק', או משרות שרלוונטיות גם ל'ג'אווה' וגם ל'שיווק'.
NOT התוצאות הרלוונטיות למילת המפתח או לקבוצת מילות המפתח שמופיעות מיד אחרי האופרטור לא יוצגו. מילת המפתח או קבוצת מילות המפתח צריכות להיות בתוך סוגריים.
- התוצאות הרלוונטיות למילת המפתח או לקבוצת מילות המפתח אחרי האופרטור לא נכללות. דוגמה: "software -java" מחזירה משרות שרלוונטיות ל'תוכנה', אבל לא מחזירה משרות שרלוונטיות ל'ג'אווה'.
בקשה או דרישה: מחזירה משרות עם מזהה בקשת ההעסקה שצוין. לדוגמה, req:1234 מחזירה משרות עם מזהה בקשת העסקה 1234.

שאילתות של מחפשי עבודה

מערכת החיפוש יכולה גם לזהות מונחי חיפוש כישויות שקשורות למשרות. לדוגמה, אם משתמש מחפש 'מתמחה', Cloud Talent Solution מתייחס לזה כאל סוג ההעסקה INTERN ומסנן את המשרות לפי הייעוד EMPLOYMENT_TYPE - INTERN. לכן, גם אם באובייקט Job מופיעה המילה intern (מתמחה) בתיאור, הוא לא יוחזר אם השדה EMPLOYMENT_TYPE של אותו אובייקט Job הוגדר למשהו אחר.

פתרון בעיות

כל בקשת חיפוש יוצרת חיפוש ייחודי requestID במערכת חיפוש המשרות. הערך הזה משמש למעקב אחרי הפרמטרים של החיפוש הזה וגם אחרי התגובה. הרישום הזה חשוב מאוד לפתרון בעיות שקשורות לחיפושים ספציפיים או לבקשות CRUD, ולכן צריך לרשום אותו בצורה מתאימה. הערך של requestID מוחזר בשדה ResponseMetadata בגוף התגובה של החיפוש או באובייקט התגובה של קריאת ה-CRUD המשויכת.

לגבי בעיות שקשורות לרלוונטיות, לשאילתות חיפוש, לאינדקסציה וכו', אפשר לשלוח כרטיס תמיכה לצוות התמיכה שלנו ולכלול צילומי מסך רלוונטיים או את הבקשות עצמן.requestID

אבחון בעיות בנתונים באמצעות המסוף

בדף משרות וחברות במסוף CTS אפשר לאבחן בעיות שקשורות לנתוני משרות. אם אתם צריכים לפתור בעיות בנתונים, אתם יכולים לראות את נתוני המשרות, לחפש מטא-נתונים של משרות ספציפיות ולייצא נתונים לפי משרה, חברה או דייר. בקטע התיעוד נתונים על משרות וחברות מוסבר איך להשתמש בכלים האלה.

מספר התוצאות

מספר התוצאות משמש להצגת מספר תוצאות החיפוש למועמדים. המספר הזה לא תמיד תואם לתוצאות ההיסטוגרמה או למספר המשרות שמוחזרות בפועל. בחיפוש משרות מוצגות עד 5,000 משרות.

עימוד (אופציונלי)

כברירת מחדל, חיפוש המשרות מחזיר 100 תוצאות בקריאה אחת (או פחות, אם המספר הכולל של התוצאות קטן מ-100). כדי לראות יותר מ-100 תוצאות, אפשר להטמיע חלוקה לדפים. אם המספר הכולל של התוצאות חורג מהמקסימום של 5,000, כל הדפים אחרי הדף שמכיל את התוצאה ה-5,000 יהיו ריקים. השדות שבהמשך קובעים את העימוד:

  • ‫pageSize: מספר התוצאות שהוחזרו.
  • ‫nextPageToken: אסימון ייחודי שמוחזר עם התוצאות של כל דף בתוצאות החיפוש, שמציין את מיקום ההתחלה של דף התוצאות הבא. אם אין תוצאות נוספות, השדה הזה נשאר ריק.
  • ‫offset: מציין את ההפרש בין דירוג הרלוונטיות של המשרה שמוחזרת בראש דף נתון לבין 1 (המשרה הרלוונטית ביותר שמוחזרת). לדוגמה, משתמש מבצע חיפוש והערך של pageSize מוגדר כ-10. בדף הראשון מוצגת המשרה מספר 1 בראש הדף, ולכן הערך offset בדף הזה הוא 0. בדף הבא, מופיעה משימה מספר 11 בחלק העליון. offset בדף הזה הוא 10.

יש שתי דרכים עיקריות להטמיע חלוקה לדפים. אפשר להשתמש בפרמטרים pageSize ו-nextPageToken כדי להפנות ישירות לדף התוצאות הבא (לכל דף יש ערך חדש של nextPageToken שמפנה לדף הבא). אם משתמשים בשיטה הזו, תמיד מתחילים בראש התוצאות ועוברים בין הדפים בסדר רציף. אפשר גם להשתמש בתווים pageSize עם offset כדי לציין ישירות איזו תוצאה ממוספרת תופיע בראש כל דף. שימוש ב-offset במקום ב-nextPageToken מאפשר לכם לקפוץ לכל נקודה במערך התוצאות.

מומלץ להגדיר את גודל הדף ל-20 תוצאות או פחות כדי למנוע בעיות של זמן אחזור. השיטה המומלצת היא להפעיל קריאה נפרדת לחיפוש לכל דף שמוצג למחפשי העבודה. האפשרות השנייה היא לבצע קריאה אחת לחיפוש כדי להחזיר מספר גדול יותר של משרות, ולבצע חלוקה לדפים בצד הלקוח. האפשרות הזו פוגעת ביכולת של מודל למידת המכונה ללמוד בצורה מדויקת באמצעות מסגרת הניתוח של נתוני המשרות.

אם משתמשים בעימוד, כל השדות בבקשה מלבד pageSize, nextPageToken ו-offset צריכים להישאר ללא שינוי. אם השדות האלה לא זהים, סדר המשרות שמוחזרות בתוצאות יכול להיות לא עקבי.

בדיקת איות

בבקשת חיפוש של CTS אפשר להשתמש בתכונה אופציונלית של בדיקת איות. התכונה הזו מתחשבת במונחי חיפוש שאולי יש בהם שגיאות איות, מתקנת אותם ומחזירה תוצאות על סמך השאילתה המתוקנת. לדוגמה, אם בודק האיות מופעל, ואם מחפש עבודה מחפש "manaer" במקום "manager",‏ CTS מחזיר משרות של "manager". אפשר להפעיל או להשבית את בדיקת האיות על ידי הגדרת השדה disableSpellCheck של בקשת החיפוש. אם בדיקת האיות מופעלת, אפשר למצוא את השאילתה המתוקנת בתגובה לחיפוש, בשדה spellResult.