Ringkasan penelusuran

Cloud Talent Solution memungkinkan pengguna menelusuri lowongan 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 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 biasa digunakan (opsional)

• JobQuery: Objek JobQuery terdiri dari dua komponen, string query dan filter yang diterapkan ke string tersebut. Fitur ini memungkinkan pengguna Anda melakukan penelusuran pada 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. Lowongan yang paling relevan ditampilkan kepada pengguna dalam urutan relevansi dengan kueri penelusuran.
  • FEATURED_JOB_SEARCH: Hanya menelusuri objek Lowongan dengan promotionValue lebih besar dari 0. Hasil diurutkan berdasarkan promotionValue tertinggi terlebih dahulu; jika hasil seri, relevansi digunakan untuk menentukan posisi. Lihat Tugas Unggulan untuk mengetahui 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 pengurutan untuk Tugas yang ditampilkan. Lihat dokumentasi referensi untuk mengetahui nilai yang diizinkan. Secara default, pengurutan dilakukan 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 yang mendasarinya secara bersamaan untuk meningkatkan relevansi penelusuran. CTS memastikan bahwa pencari kerja (diidentifikasi oleh userId, sessionId, dan domain) memiliki pengalaman yang konsisten. Kolom ini harus di-obfuscate.

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

Menggunakan operator penelusuran

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

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 baik 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 diapit 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 requisition:	Menampilkan tugas dengan ID permintaan yang ditentukan. Contoh, req:1234 menampilkan tugas dengan ID permintaan 1234.

Kueri pencari kerja

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

Catatan: Sangat penting untuk menentukan jenis pekerjaan untuk setiap objek Lowongan. Jika tidak, pengalaman pencari kerja akan terpengaruh secara negatif.

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 sangat penting dalam memecahkan masalah terkait penelusuran atau permintaan CRUD tertentu, dan harus dicatat ke 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, permintaan penelusuran, permintaan 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 Lowongan dan perusahaan di konsol CTS untuk mendiagnosis masalah seputar data lowongan. Jika 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 menyampaikan jumlah hasil penelusuran kepada pencari pekerjaan. Hal ini tidak selalu sesuai dengan hasil histogram atau jumlah tugas yang sebenarnya ditampilkan. Penelusuran Lowongan menampilkan maksimum 5.000 lowongan.

Pengelompokan 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 ini 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 tugas yang ditampilkan di bagian atas halaman tertentu dan 1 (Tugas yang paling relevan ditampilkan). Misalnya, pengguna melakukan penelusuran dan pageSize ditetapkan ke 10. Halaman pertama menampilkan pekerjaan #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 mengarah 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 membuka halaman dalam urutan berurutan. Atau, Anda dapat menggunakan pageSize dengan offset untuk secara langsung menentukan hasil bernomor yang muncul di bagian atas setiap halaman. Menggunakan offset, bukan nextPageToken, memungkinkan Anda melompat ke titik mana pun dalam set hasil.

Sebaiknya tetapkan ukuran halaman ke 20 hasil atau kurang untuk menghindari masalah latensi. Sebagai praktik terbaik, buat panggilan penelusuran terpisah per halaman yang dirender kepada pencari kerja. Alternatifnya, satu panggilan penelusuran untuk menampilkan sejumlah besar tugas dan membuat penomoran halaman di sisi klien, akan menghambat kemampuan model machine learning untuk belajar 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 menjadi tidak konsisten.

Pemeriksaan ejaan

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