Ringkasan penelusuran (v4beta1)

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

Membuat permintaan penelusuran

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

Kolom yang umum digunakan (opsional)

• JobQuery: Objek JobQuery terdiri dari dua komponen, string query dan filter yang diterapkan ke string tersebut. Fitur ini memungkinkan pengguna menelusuri string kueri (seperti "asisten komunikasi") menggunakan satu atau beberapa filter (lokasi, waktu perjalanan, kompensasi, dan sebagainya). Lihat Filter Penelusuran untuk mengetahui 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 Tugas. Tugas yang paling relevan akan ditampilkan kepada pengguna sesuai urutan relevansi dengan kueri penelusuran.
  • FEATURED_JOB_SEARCH: Hanya menelusuri objek Tugas dengan promotionValue yang lebih besar dari 0. Hasil diurutkan berdasarkan promotionValue tertinggi terlebih dahulu; dalam kasus seri, relevansi digunakan untuk menentukan posisi. Lihat Tugas Unggulan untuk informasi selengkapnya.

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

• orderBy: Urutan penyortiran untuk Tugas yang ditampilkan. Lihat dokumentasi referensi untuk mengetahui nilai yang diizinkan. Defaultnya adalah mengurutkan berdasarkan relevansi, secara 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 dasar secara bersamaan untuk meningkatkan relevansi penelusuran. CTS memastikan bahwa pencari kerja (yang diidentifikasi oleh userId, sessionId, dan domain) memiliki pengalaman yang konsisten. Kolom ini harus di-obfuscate.

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

Menggunakan operator penelusuran

Operator penelusuran pada tabel di bawah dapat digunakan sendiri atau dalam kombinasi.

Operator	Deskripsi
( )	Kelompokkan satu atau beberapa kata kunci bersama-sama.
ATAU	Menelusuri hasil yang relevan dengan kata kunci atau grup kata kunci di kedua sisi operator. Contoh: "software OR java" menampilkan tugas dengan baik "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 lowongan yang baik relevan dengan pekerjaan "software" dan "pemasaran", atau pekerjaan yang relevan dengan pekerjaan "java" dan "pemasaran".
NOT	Mengecualikan hasil yang relevan dengan kata kunci atau grup kata kunci tepat setelah operator. Kata kunci atau grup kata kunci harus ditulis 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".
permintaan:	Menampilkan tugas dengan ID permintaan yang ditentukan. Contoh, req:1234 akan menampilkan tugas dengan ID permintaan 1234.

Kueri pencari kerja

Istilah penelusuran juga dapat dideteksi sebagai entitas terkait Pekerjaan yang sebenarnya. Misalnya, jika seorang pengguna membuat kueri untuk "magang", Cloud Talent Solution akan memperlakukan ini sebagai jenis lowongan INTERN dan memfilter Lowongan dengan pengelompokan EMPLOYMENT_TYPE - INTERN. Oleh karena itu, bahkan objek Pekerjaan dengan kata "magang" dalam deskripsinya pun tidak akan ditampilkan jika kolom EMPLOYMENT_TYPE untuk Tugas tersebut ditetapkan ke hal lain.

Catatan: Sangat penting untuk menentukan jenis pekerjaan untuk setiap objek Pekerjaan. Tidak melakukannya 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 respons. Hal ini sangat penting dalam memecahkan masalah yang terkait dengan penelusuran tertentu atau permintaan CRUD, dan harus dicatat dalam log 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, pertanyaan penelusuran, pertanyaan pengindeksan, dan sebagainya, harap ajukan tiket kepada tim dukungan kami dan sertakan requestID atau permintaan itu sendiri yang relevan.

Jumlah hasil

Jumlah hasil digunakan untuk mengomunikasikan jumlah hasil penelusuran kepada pencari pekerjaan. Ini tidak selalu sesuai dengan hasil histogram atau jumlah tugas sebenarnya yang ditampilkan. Penelusuran Lowongan menampilkan maksimum 5.000 tugas.

Penomoran halaman (opsional)

Secara default, Penelusuran Lowongan menampilkan 100 hasil dalam satu panggilan (atau kurang, 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 beserta hasil setiap halaman hasil penelusuran, yang menentukan posisi awal untuk halaman hasil berikutnya. Kolom ini dibiarkan kosong jika tidak ada hasil lainnya.
• offset: Menentukan offset antara peringkat relevansi dari tugas yang ditampilkan di bagian atas halaman tertentu dan 1 (Tugas yang paling relevan yang ditampilkan). Sebagai contoh, pengguna melakukan penelusuran dan pageSize ditetapkan ke 10. Halaman pertama menampilkan tugas #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 mengarah ke halaman berikutnya). Jika menggunakan metode ini, Anda akan selalu memulai dari bagian atas hasil dan memulai halaman secara berurutan. Atau, Anda dapat menggunakan pageSize dengan offset untuk secara langsung menentukan hasil bernomor mana yang muncul di bagian atas setiap halaman. Penggunaan offset, bukan nextPageToken, memungkinkan Anda 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, panggilan penelusuran tunggal untuk menampilkan lebih banyak tugas dan pemberian nomor halaman di sisi klien, menghambat kemampuan model machine learning untuk belajar secara akurat melalui Framework Analytics Tugas.

Pemeriksaan ejaan

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