Dasar-dasar penelusuran (v3)

Cloud Talent Solution memungkinkan pengguna menelusuri lowongan yang telah Anda simpan di indeks Cloud Talent Solution. Dokumen ini memandu Anda memahami berbagai penawaran terkait dan penelusuran Cloud Talent Solution.

Telusuri permintaan

Untuk membuat permintaan penelusuran lowongan, kirim permintaan POST ke endpoint jobs:search, dengan meneruskan data penelusuran di isi.

Kolom wajib diisi

Kolom berikut wajib diisi:

  • searchMode: Menentukan jenis penelusuran lowongan kerja yang akan diterapkan. Opsinya adalah:

    • JOB_SEARCH: Ini adalah mode penelusuran default dan yang direkomendasikan. Semua tugas akan ditelusuri. Lowongan yang paling relevan ditampilkan dalam urutan relevansi dengan kueri penelusuran.
    • FEATURED_JOB_SEARCH: Hanya menelusuri pekerjaan dengan promotionValue lebih besar dari 0. Hasil diurutkan berdasarkan promotionValue tertinggi terlebih dahulu; jika ada hasil yang sama, relevansi digunakan untuk menentukan posisi. Lihat Lowongan Unggulan untuk info selengkapnya.

Kolom yang biasa digunakan

  • JobQuery: Menentukan kriteria tugas yang akan dicocokkan. Hal ini mencakup lokasi, kategori pekerjaan, jenis pekerjaan, kueri teks, perusahaan, dll. Lihat Filter Penelusuran untuk informasi selengkapnya.

  • requestMetadata: Berisi informasi pengguna dan sesi untuk permintaan penelusuran ini. Lihat RequestMetadata untuk mengetahui detailnya.

  • jobView: Menentukan jumlah kolom yang ditampilkan untuk setiap tugas yang cocok. Dapat berupa JOB_VIEW_SMALL (default), JOB_VIEW_MINIMAL, atau JOB_VIEW_FULL. Deskripsi untuk setiap opsi ada di referensi JobView.

  • orderBy: Urutan pengurutan untuk tugas yang ditampilkan. Lihat referensi untuk nilai yang diizinkan. Defaultnya adalah mengurutkan berdasarkan relevansi, menurun (RELEVANCE_DESC).

Penentuan nilai minimum relevansi dan perluasan lokasi/kategori

Untuk menampilkan lebih banyak lowongan dalam penelusuran Anda, dua kolom berikut melonggarkan batasan relevansi:

  • enableBroadening: Menetapkan ini ke true akan melonggarkan batasan pada lokasi dan kategori pekerjaan dari permintaan penelusuran, untuk menampilkan lebih banyak hasil. Misalnya, jika permintaan penelusuran menentukan pekerjaan dalam radius 2 mil dari Anytown, WA, menyetel tanda ini ke true juga dapat menampilkan pekerjaan dari NextTownOver, WA.

  • disableKeywordMatch: Flag ini salah secara default. Jika tanda ini disetel ke salah (false), Cloud Talent Solution dapat menambahkan lowongan yang relevan dengan kueri penelusuran ini dengan lowongan yang juga cocok dengan string kueri persisnya di judul atau deskripsi.

RequestMetadata

Setiap permintaan penelusuran dan histogram harus menyertakan objek RequestMetadata. Objek ini berisi informasi tentang pengguna yang memulai penelusuran.

Ada beberapa alasan mengapa objek ini penting:

  • Konsistensi pengguna. Cloud Talent Solution menjalankan beberapa versi model pokok secara bersamaan dalam upaya meningkatkan relevansi penelusuran. Isi kolom ini untuk memastikan pencari kerja memiliki pengalaman yang konsisten. Cloud Talent Solution memastikan bahwa pencari kerja (yang diidentifikasi oleh userId, sessionId, dan domain) memiliki pengalaman yang konsisten. Catatan: Kolom ini harus di-obfuscate.

  • Peningkatan penelusuran.Algoritma penyesuaian didasarkan pada informasi yang diberikan di kolom RequestMetadata beserta data pencari kerja yang Anda berikan. Hal ini meningkatkan relevansi hasil penelusuran.

Operator penelusuran

Operator Deskripsi
( ) Mengelompokkan satu atau beberapa kata kunci.
DAN Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator.
ATAU Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator.
NOT Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci, dalam tanda kurung, segera setelah operator.
- Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci yang ditambahkan ke operator.

Contoh:

  • "software OR java" menampilkan tugas dengan salah satu "software" atau "java" dalam metadatanya.

  • "software" -java menampilkan pekerjaan yang relevan dengan "software", tetapi mengecualikan pekerjaan yang relevan dengan "java".

  • "(software OR java) AND (marketing)" menampilkan lowongan yang relevan dengan "software" dan "pemasaran", serta lowongan yang relevan dengan "java" dan "pemasaran".

Kueri pencari kerja

Istilah penelusuran juga dapat dideteksi sebagai entitas terkait pekerjaan yang sebenarnya. Misalnya, jika kuerinya adalah 'intern', Cloud Talent Solution akan memperlakukan ini sebagai jenis pekerjaan "INTERN" dan memfilter pekerjaan yang hanya memiliki EMPLOYMENT_TYPE - INTERN. Oleh karena itu, meskipun kata intern harus ada dalam deskripsi pekerjaan, kata tersebut tidak akan ditampilkan jika jenis pekerjaan untuk pekerjaan tersebut ditetapkan ke jenis lain.

Pemecahan masalah

Setiap permintaan penelusuran menghasilkan penelusuran requestID unik dalam sistem kami yang digunakan untuk melacak parameter penelusuran tersebut serta responsnya. Hal ini sangat penting dalam memecahkan masalah terkait penelusuran tertentu, permintaan CRUD, dan harus dicatat dengan tepat. requestId ditampilkan di dalam kolom ResponseMetadata di isi respons penelusuran. atau objek respons panggilan CRUD terkait.

Untuk masalah dukungan yang terkait dengan relevansi, kueri penelusuran, kueri pengindeksan, dll., ajukan tiket kepada tim dukungan kami, dan sertakan ID permintaan atau permintaan itu sendiri yang relevan.

Jumlah hasil

Jumlah hasil digunakan untuk menginformasikan jumlah hasil penelusuran kepada pencari kerja. Hal ini tidak selalu sesuai dengan hasil histogram atau jumlah tugas yang sebenarnya ditampilkan. Penelusuran Lowongan menampilkan maksimum 5.000 lowongan.

Penomoran halaman

Secara default, Penelusuran Lowongan menampilkan 100 hasil per halaman (atau lebih sedikit, jika jumlah total hasil kurang dari 100). Anda dapat menerapkan penomoran halaman menggunakan kolom yang terkait dengan fitur ini.

  • pageSize: Jumlah hasil yang ditampilkan per halaman.
  • nextPageToken: Token unik, yang ditampilkan dengan hasil setiap halaman hasil penelusuran, yang menentukan posisi awal untuk halaman hasil berikutnya. Kolom ini dibiarkan kosong jika tidak ada lagi hasil.
  • offset: Menentukan offset antara peringkat relevansi lowongan yang ditampilkan di bagian atas halaman tertentu dan 1 (Lowongan yang paling relevan yang ditampilkan). Sebagai contoh, pengguna melakukan penelusuran dan pageSize disetel ke 10. Halaman pertama menampilkan lowongan #1 di bagian atas, sehingga nilai offset untuk halaman ini adalah 0. Halaman berikutnya menampilkan tugas #11 di bagian atas; offset untuk halaman ini adalah 10.

Tetapkan ukuran halaman ke 20 hasil atau kurang untuk menghindari masalah latensi. Sebagai praktik terbaik, lakukan panggilan penelusuran terpisah per halaman yang dirender kepada pencari kerja. Alternatifnya, satu panggilan penelusuran untuk menampilkan sejumlah besar tugas dan melakukan penomoran halaman di sisi klien, menghambat kemampuan model machine learning untuk mempelajari secara akurat melalui Framework Analisis Tugas.

Pemeriksaan ejaan

Pemeriksaan ejaan adalah fitur permintaan penelusuran Cloud Talent Solution yang memperhitungkan istilah penelusuran yang berpotensi salah eja, mengoreksinya, dan menampilkan hasil berdasarkan kueri yang telah dikoreksi. Misalnya, saat pemeriksaan ejaan diaktifkan, jika pencari kerja menelusuri "manaer" dan bukan "manager", Cloud Talent Solution akan menampilkan pekerjaan untuk "manager". Pemeriksaan ejaan dapat diaktifkan/dinonaktifkan dengan menetapkan kolom disableSpellCheck JobQuery. Jika pemeriksaan ejaan diaktifkan, kueri yang dikoreksi dapat ditemukan dalam respons penelusuran, di kolom spellResult.