Ringkasan penelusuran

Cloud Talent Solution memungkinkan pengguna menelusuri pekerjaan yang Anda simpan dalam indeks Penelusuran Lowongan. Penelusuran Lowongan dirancang agar dapat disesuaikan dan dapat diubah untuk memenuhi kebutuhan bisnis Anda. Halaman ini adalah ringkasan fungsi penelusuran yang tersedia di CTS Job Search.

Membuat permintaan penelusuran

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

Kolom yang biasa digunakan (opsional)

• JobQuery: Objek JobQuery terdiri dari dua komponen, string query dan filter yang diterapkan ke string tersebut. Fitur ini memungkinkan pengguna Anda menelusuri string kueri (seperti "asisten komunikasi") menggunakan satu atau beberapa filter (lokasi, waktu perjalanan, kompensasi, dan sebagainya). Lihat Filter Penelusuran untuk informasi selengkapnya dan daftar opsi filter yang tersedia.

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

  • JOB_SEARCH (direkomendasikan): Ini adalah mode penelusuran default, yang menelusuri semua objek Job. Lowongan pekerjaan yang paling relevan ditampilkan kepada pengguna dalam urutan relevansi dengan kueri penelusuran.
  • FEATURED_JOB_SEARCH: Hanya menelusuri objek Job 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 mengetahui informasi selengkapnya.

• jobView: Menentukan jumlah kolom yang ditampilkan untuk setiap objek Job yang cocok. Dapat berupa JOB_VIEW_SMALL (default), JOB_VIEW_MINIMAL, atau JOB_VIEW_FULL. Deskripsi untuk setiap opsi dapat ditemukan di dokumentasi referensi JobView.

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

Kolom wajib diisi

Kolom berikut wajib diisi:

• requestMetadata: Berisi informasi pengguna dan sesi untuk permintaan penelusuran ini.

RequestMetadata

Setiap permintaan penelusuran dan histogram harus menyertakan objek RequestMetadata. Objek ini berisi informasi tentang pengguna yang memulai penelusuran. Hal ini penting karena dua alasan utama:

• Konsistensi pengguna: Cloud Talent Solution menjalankan beberapa versi model pokok secara bersamaan untuk meningkatkan relevansi penelusuran. CTS memastikan bahwa pencari kerja (yang diidentifikasi berdasarkan userId, sessionId, dan domain) memiliki pengalaman yang konsisten. Kolom ini harus disamarkan.

• 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.

Menggunakan operator penelusuran

Operator penelusuran dalam tabel di bawah dapat digunakan sendiri atau bersamaan.

Operator	Deskripsi
( )	Mengelompokkan satu atau beberapa kata kunci.
ATAU	Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator. Contoh: "software OR java" menampilkan tugas dengan salah satu "software" atau "java" dalam metadatanya.
DAN	Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator. Contoh: "(software OR java) AND (marketing)" menampilkan pekerjaan yang relevan dengan "software" dan "marketing", atau pekerjaan yang relevan dengan "java" dan "marketing".
NOT	Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci yang langsung mengikuti operator. Kata kunci atau grup kata kunci harus berada dalam tanda kurung.
-	Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci setelah operator. Contoh: "software -java" menampilkan tugas yang relevan dengan "software", tetapi mengecualikan tugas yang relevan dengan "java".
req atau permintaan:	Menampilkan pekerjaan dengan ID permintaan yang ditentukan. Misalnya, req:1234 akan menampilkan tugas dengan ID permintaan 1234.

Kueri pencari kerja

Istilah penelusuran juga dapat terdeteksi sebagai entitas terkait Pekerjaan yang sebenarnya. Misalnya, jika pengguna membuat kueri "intern", Cloud Talent Solution akan memperlakukan ini sebagai jenis pekerjaan INTERN dan memfilter Lowongan dengan sebutan EMPLOYMENT_TYPE - INTERN. Oleh karena itu, meskipun objek Job memiliki "intern" dalam deskripsinya, objek tersebut tidak akan ditampilkan jika kolom EMPLOYMENT_TYPE untuk Job tersebut ditetapkan ke nilai lain.

Catatan: Sangat penting untuk menentukan jenis pekerjaan untuk setiap objek Job. Jika tidak dilakukan, hal ini akan berdampak negatif pada pengalaman pencari kerja.

Pemecahan masalah

Setiap permintaan penelusuran menghasilkan requestID penelusuran unik dalam sistem Penelusuran Lowongan. Nilai ini digunakan untuk melacak parameter penelusuran tersebut serta responsnya. Hal ini penting dalam memecahkan masalah yang terkait dengan penelusuran atau permintaan CRUD tertentu, 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, dan sebagainya, ajukan tiket kepada tim dukungan kami dan sertakan requestID yang relevan atau permintaan itu sendiri.

Mendiagnosis masalah data menggunakan konsol

Gunakan halaman Tugas dan perusahaan di konsol CTS untuk mendiagnosis masalah terkait data tugas. Jika Anda perlu memecahkan masalah data, Anda dapat melihat statistik tugas, menelusuri metadata tugas tertentu, dan mengekspor data menurut tugas, perusahaan, atau tenant. Lihat bagian dokumentasi Data lowongan dan perusahaan untuk mengetahui informasi selengkapnya tentang cara menggunakan alat ini.

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 (opsional)

Secara default, Penelusuran Lowongan menampilkan 100 hasil dalam satu panggilan (atau lebih sedikit, jika jumlah total hasil kurang dari 100). Untuk melihat lebih dari 100 hasil, Anda dapat menerapkan penomoran halaman. Jika jumlah total hasil melebihi maksimum 5.000, semua halaman setelah halaman yang berisi hasil ke-5.000 akan kosong. Kolom di bawah mengontrol penomoran halaman:

• pageSize: Jumlah hasil yang ditampilkan.
• 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.

Ada dua cara utama untuk menerapkan penomoran halaman. Anda dapat menggunakan pageSize dan nextPageToken untuk langsung menunjuk ke halaman hasil berikutnya (setiap halaman memiliki nilai nextPageToken baru yang menunjuk ke halaman berikutnya). Jika menggunakan metode ini, Anda akan selalu memulai di bagian atas hasil dan melihat halaman dalam urutan berurutan. Atau, Anda dapat menggunakan pageSize dengan offset untuk menentukan secara langsung hasil bernomor yang muncul di bagian atas setiap halaman. Dengan menggunakan offset, bukan nextPageToken, Anda dapat melompat ke titik mana pun dalam kumpulan hasil.

Sebaiknya 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.

Jika Anda menggunakan penomoran halaman, semua kolom dalam permintaan selain pageSize, nextPageToken, dan offset harus tetap sama. Jika kolom ini tidak sama, urutan tugas yang ditampilkan dalam hasil dapat tidak konsisten.

Pemeriksaan ejaan

Pemeriksaan ejaan adalah fitur opsional dari permintaan penelusuran CTS Fitur ini memperhitungkan istilah penelusuran yang mungkin salah eja, mengoreksinya, dan menampilkan hasil berdasarkan kueri yang telah dikoreksi. Misalnya, jika pemeriksaan ejaan diaktifkan, jika pencari kerja menelusuri "manaer" dan bukan "manager", CTS akan menampilkan pekerjaan untuk "manager". Pemeriksaan ejaan dapat diaktifkan/dinonaktifkan dengan menyetel kolom disableSpellCheck pada permintaan penelusuran. Jika pemeriksaan ejaan diaktifkan, kueri yang dikoreksi dapat ditemukan dalam respons penelusuran, di kolom spellResult.