Cloud Talent Solution מאפשר למשתמשים לחפש משרות ששמרתם באינדקס של Cloud Talent Solution. במסמך הזה מוסבר על מגוון השירותים שקשורים לחיפוש ב-Cloud Talent Solution.
בקשות חיפוש
כדי לשלוח בקשה לחיפוש משרה, שולחים בקשת POST לנקודת הקצה jobs:search ומעבירים את נתוני החיפוש בגוף הבקשה.
שדות חובה
חובה למלא את השדה הבא:
searchMode: מציין את סוג חיפוש המשרות שרוצים להחיל. האפשרויות הן:-
JOB_SEARCH: זוהי ברירת המחדל, והיא מומלצת. כל המשרות נכללות בחיפוש. המשרות הכי רלוונטיות מוחזרות לפי סדר הרלוונטיות שלהן לשאילתת החיפוש. -
FEATURED_JOB_SEARCH: חיפוש רק של משרות עםpromotionValueגדול מ-0. התוצאות מסודרות לפי הדירוג הגבוה ביותרpromotionValueקודם. אם יש כמה תוצאות עם אותו דירוג, הרלוונטיות קובעת את המיקום. מידע נוסף זמין במאמר בנושא משרות מומלצות.
-
שדות בשימוש נפוץ
JobQuery: מציינים את קריטריוני המשרה שרוצים להתאים להם. הם כוללים מיקום, קטגוריות של משרות, סוגי העסקה, שאילתות טקסט, חברות וכו'. מידע נוסף זמין במאמר בנושא מסנני חיפוש.
requestMetadata: מכיל מידע על המשתמש והסשן של בקשת החיפוש הזו. פרטים נוספים מופיעים במאמר בנושא RequestMetadata.
jobView: הגדרה של מספר השדות שמוחזרים לכל משרה תואמת. יכול להיותJOB_VIEW_SMALL(ברירת המחדל),JOB_VIEW_MINIMALאוJOB_VIEW_FULL. תיאורים של כל אפשרות מופיעים במאמר בנושאJobView.
orderBy: סדר המיון של המשימות שמוחזרות. במאמר בנושא הפניה מפורטים הערכים המותרים. ברירת המחדל היא מיון לפי רלוונטיות, בסדר יורד (RELEVANCE_DESC).
הגדרת סף רלוונטיות והרחבת המיקום או הקטגוריה
כדי לקבל מספר גדול יותר של משרות בחיפושים, בשני השדות הבאים ההגבלות על הרלוונטיות פחות מחמירות:
enableBroadening: אם מגדירים את הערך הזה ל-true, ההגבלות על המיקום ועל קטגוריית המשרה בבקשת החיפוש מוקלות כדי להחזיר יותר תוצאות. לדוגמה, אם בבקשת חיפוש צוינו משרות ברדיוס של 3 ק"מ מ-Anytown, WA, הגדרת הדגל הזה לערךtrueעשויה להחזיר גם משרות מ-NextTownOver, WA.
disableKeywordMatch: כברירת מחדל, הדגל הזה מסומן כ-False. הגדרת הדגל הזה ל-false מאפשרת ל-Cloud Talent Solution לצרף למשרות שרלוונטיות לשאילתת החיפוש הזו משרות שתואמות גם למחרוזת השאילתה המדויקת בכותרת או בתיאור.
RequestMetadata
כל בקשה לחיפוש או להיסטוגרמה צריכה לכלול אובייקט RequestMetadata. האובייקט הזה מכיל מידע על המשתמש שיזם את החיפוש.
יש כמה סיבות לכך שהאובייקט הזה חשוב:
עקביות המשתמשים. ב-Cloud Talent Solution מופעלות כמה גרסאות של המודלים הבסיסיים בו-זמנית, במטרה לשפר את הרלוונטיות של החיפוש. כדי להבטיח חוויה עקבית למועמדים לעבודה, צריך למלא את השדה הזה. Cloud Talent Solution מוודא שלמחפשי עבודה (שמזוהים באמצעות userId, sessionId ו-domain) תהיה חוויה עקבית. הערה: צריך להסתיר את השדות האלה.
שיפורים בחיפוש.האלגוריתמים להתאמה מבוססים על המידע שמופיע בשדות
RequestMetadataועל נתוני מחפשי העבודה שאתם מספקים. כך משפרים את הרלוונטיות של תוצאות החיפוש.
אופרטורים של חיפוש
| אופרטור | תיאור |
|---|---|
| ( ) | מקבץ מילת מפתח אחת או יותר. |
| וגם | חיפוש תוצאות שרלוונטיות למילות המפתח או לקבוצות של מילות מפתח משני הצדדים של האופרטור. |
| או | חיפוש תוצאות שרלוונטיות למילת המפתח או לקבוצת מילות המפתח בכל אחד מהצדדים של האופרטור. |
| NOT | התוצאות הרלוונטיות למילת המפתח או לקבוצת מילות המפתח, בסוגריים, מיד אחרי האופרטור. |
| - | התוצאות הרלוונטיות למילת המפתח או לקבוצת מילות המפתח שמצורפות לאופרטור לא נכללות. |
לדוגמה:
"software OR java"מחזירה משרות עם software או java במטא-נתונים שלהן.
"software" -javaמחזירה משרות שרלוונטיות ל'תוכנה' אבל לא כוללת משרות שרלוונטיות ל'ג'אווה'.
"(software OR java) AND (marketing)"מחזירה משרות שרלוונטיות גם ל'תוכנה' וגם ל'שיווק', ומשרות שרלוונטיות גם ל'ג'אווה' וגם ל'שיווק'.
שאילתה של מחפש עבודה
המערכת יכולה גם לזהות מונחי חיפוש כישויות שקשורות למשרה בפועל. לדוגמה, אם השאילתה הייתה 'מתמחה', Cloud Talent Solution יתייחס לזה כסוג ההעסקה 'מתמחה' ויסנן את המשרות שבהן סוג ההעסקה הוא 'מתמחה'. לכן, גם אם המילה 'מתמחה' מופיעה בתיאור המשרה, היא לא תופיע בתוצאות אם סוג ההעסקה של המשרה הזו הוגדר אחרת.
פתרון בעיות
כל בקשת חיפוש יוצרת חיפוש ייחודי requestID במערכת שלנו, שמשמש למעקב אחרי הפרמטרים של החיפוש הזה וגם אחרי התשובה. זה חשוב במיוחד לפתרון בעיות שקשורות לחיפוש ספציפי, לבקשות CRUD, וצריך לתעד את זה בצורה מתאימה. ה-requestId מוחזר בתוך השדה ResponseMetadata בגוף התגובה של החיפוש או באובייקט התגובה של קריאת ה-CRUD המשויכת.
לגבי בעיות שקשורות לרלוונטיות, לשאילתות חיפוש, לאינדקסציה וכו', צריך לפתוח כרטיס תמיכה ולכלול בו את מזהי הבקשות הרלוונטיים או את הבקשות עצמן.
מספר התוצאות
מספר התוצאות משמש להצגת מספר תוצאות החיפוש למועמדים. המספר הזה לא תמיד תואם לתוצאות ההיסטוגרמה או למספר המשרות שמוחזרות בפועל. בחיפוש משרות מוצגות עד 5,000 משרות.
עימוד
כברירת מחדל, בחיפוש משרות מוצגות 100 תוצאות בכל דף (או פחות, אם המספר הכולל של התוצאות קטן מ-100). אפשר להטמיע חלוקה לדפים באמצעות השדות שמשויכים לתכונה הזו.
-
pageSize: מספר התוצאות שמוחזרות בכל דף. -
nextPageToken: אסימון ייחודי שמוחזר עם התוצאות של כל דף בתוצאות החיפוש, שמציין את מיקום ההתחלה של דף התוצאות הבא. אם אין תוצאות נוספות, השדה הזה נשאר ריק. -
offset: מציין את ההפרש בין דירוג הרלוונטיות של המשרה שמוחזרת בראש דף נתון לבין 1 (המשרה הרלוונטית ביותר שמוחזרת). לדוגמה, משתמש מבצע חיפוש והערך שלpageSizeמוגדר כ-10. בדף הראשון מוצגת המשרה מספר 1 בראש הדף, ולכן הערךoffsetבדף הזה הוא 0. בדף הבא, מופיעה משימה מספר 11 בחלק העליון.offsetבדף הזה הוא 10.
כדי למנוע בעיות של זמן אחזור, מגדירים את גודל הדף ל-20 תוצאות או פחות. השיטה המומלצת היא להפעיל קריאה נפרדת לחיפוש לכל דף שמוצג למחפשי העבודה. האפשרות השנייה היא לבצע קריאה אחת לחיפוש כדי להחזיר מספר גדול יותר של משרות, ולבצע חלוקה לדפים בצד הלקוח. האפשרות הזו פוגעת ביכולת של מודל למידת המכונה ללמוד בצורה מדויקת באמצעות מסגרת הניתוח של נתוני המשרות.
בדיקת איות
במסגרת בקשת החיפוש של Cloud Talent Solution, יש תכונה של בדיקת איות שמתחשבת במונחי חיפוש שאולי נכתבו עם שגיאות איות, מתקנת אותם ומחזירה תוצאות על סמך השאילתה המתוקנת. לדוגמה, אם בדיקת האיות מופעלת, ומועמד מחפש את המילה manaer במקום manager, Cloud Talent Solution מחזיר משרות שכוללות את המילה manager. כדי להפעיל או להשבית את בדיקת האיות, מגדירים את השדה disableSpellCheck של JobQuery. אם בדיקת האיות מופעלת, אפשר למצוא את השאילתה המתוקנת בתשובת החיפוש בשדה spellResult.