OpenSearch:Pencarian Teratas dan Petunjuk Pencarian

Buat model di konsol

1. Masuk ke konsol OpenSearch. Di panel navigasi sebelah kiri, pilih Search Algorithm Center > Search Guidance, lalu klik Top Searches and Hints.

2. Klik Create.

   

3. Konfigurasikan parameter berikut:

   Parameter	Deskripsi
   Model name	Nama yang terdiri dari huruf, angka, dan garis bawah (_). Nama tidak boleh hanya terdiri dari angka dan panjangnya maksimal 30 karakter.
   Model type	Pilih Top Search Model atau Hint Model.
   Filter condition	(Opsional) Batasi kueri pencarian historis mana yang digunakan untuk pelatihan. Format: [parameter][operator][value]. Parameter yang didukung: biz_type dan user_id. Operator yang didukung: <, >, <=, >=, =, !=. Pisahkan beberapa kondisi dengan koma — semua kondisi diterapkan dengan logika AND. Contoh: user_id=1,biz_type=1.

   

4. Temukan model dengan status Pending Training dan klik Train di kolom Actions.

   

5. Setelah pelatihan selesai, pratinjau hasilnya:

   • Pratinjau pencarian teratas: Klik Preview Effects untuk melihat hingga 10 rekomendasi pencarian teratas per halaman, hingga maksimal 20 halaman.

   • Pratinjau petunjuk: Klik Preview Effects untuk melihat hingga 30 rekomendasi petunjuk, satu per halaman.

Buat model menggunakan API atau SDK

Saat Anda membuat model menggunakan API, sistem segera memulai pelatihan model setelah menerima permintaan pembuatan.

Tambahkan Management and Control SDK ke proyek Anda:

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-opensearch</artifactId>
    <version>0.7.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.0</version>
</dependency>

Contoh berikut membuat model pencarian teratas. Atur type ke "hot" untuk model pencarian teratas atau "hint" untuk model petunjuk.

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.opensearch.model.v20171225.*;
import com.aliyuncs.profile.DefaultProfile;

public class CreateModel {
    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-beijing",
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        );
        IAcsClient client = new DefaultAcsClient(profile);

        CreateModelRequest request = new CreateModelRequest();
        request.setAppGroupIdentity("app_name");  // Ganti dengan nama aplikasi Anda

        // type: "hot" = model pencarian teratas, "hint" = model petunjuk
        // name: hanya huruf, angka, dan garis bawah; maksimal 30 karakter
        String content = "{\"type\": \"hot\", \"name\": \"model_name\"}";
        request.setHttpContent(content.getBytes(), "UTF-8", FormatType.JSON);

        try {
            HttpResponse response = client.doAction(request);
            System.out.println(response.getHttpContentString());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

Daftar model

Halaman Top Searches and Hints mencantumkan semua model beserta nama, jenis, waktu pembuatan, status, waktu mulai pelatihan terakhir, dan status versi terbaru. Tetapkan satu model sebagai default — ketika tidak ada model_name yang ditentukan dalam permintaan, model default akan digunakan.

Detail model

Klik nama model untuk membuka halaman detailnya. Bagian Basic Information menampilkan status model saat ini dan cap waktu pelatihan. Bagian Training History mencantumkan setiap proses pelatihan beserta versi, status, waktu mulai, dan waktu selesai.

Atasi kegagalan pelatihan

Di halaman detail model, arahkan kursor ke Exception Report untuk melihat alasan kegagalan. Arahkan kursor ke View Conditions for Integrity Level Upgrade untuk melihat kriteria yang harus dipenuhi model agar mencapai tingkat integritas yang lebih tinggi.

Konfigurasi daftar hitam dan daftar putih

Di bagian Configuration Information, klik Configure untuk mengatur daftar hitam atau daftar putih untuk model tersebut. Untuk detail selengkapnya, lihat Blacklists and whitelists.

Atur ukuran daftar pencarian teratas

Secara default, daftar pencarian teratas menampilkan hingga 10.000 entri. Tetapkan batas khusus (minimum: 100) sesuai kebutuhan bisnis Anda.

Hubungkan data perilaku pengguna

Pencarian teratas dan petunjuk yang dihasilkan dari log pencarian mentah merupakan titik awal yang baik, tetapi menghubungkan data perilaku pengguna meningkatkan kualitas rekomendasi seiring waktu.

Sertakan parameter berikut dalam permintaan pencarian untuk mengaktifkan pelacakan perilaku:

• from_request_id — Atur nilai ini ke request_id yang dikembalikan saat pengguna mengklik pencarian teratas atau petunjuk. Ini menghubungkan pencarian berikutnya dengan rekomendasi yang memicunya.

• user_id — Memungkinkan metrik pengunjung unik (UV) dalam laporan operasi bisnis.

Cara kerja end-to-end:

1. Pengguna melihat daftar pencarian teratas yang dikembalikan oleh API. Respons mencakup request_id.

2. Pengguna mengklik pencarian teratas, memicu permintaan pencarian baru.

3. Atur from_request_id dalam permintaan pencarian tersebut ke request_id dari langkah 1.

4. Jika pengguna menelusuri halaman hasil, atur juga from_request_id dalam setiap permintaan pergantian halaman — setiap tampilan halaman dihitung sebagai tampilan halaman (PV) independen.

Dengan data ini terhubung, laporan operasi bisnis akan menampilkan:

• Tampilan halaman (PV) dan pengunjung unik (UV) dari pencarian yang dipandu oleh pencarian teratas dan petunjuk

• Laju hasil nol untuk pencarian terpandu

• Laju klik pada rekomendasi

• Tren minat pengguna untuk perencanaan operasional