Menggunakan profil penilaian dengan peringkat semantik di Pencarian Azure AI

Anda dapat menerapkan profil penilaian melalui hasil pencarian berperingkat semantik, di mana profil penilaian diproses terakhir.

Untuk memastikan profil penilaian memberikan skor penentu, peringkat semantik menambahkan bidang respons, @search.rerankerBoostedScore, yang menerapkan logika profil penilaian pada hasil yang diberi peringkat semantik. Dalam hasil pencarian yang mencakup @search.score dari peringkat tingkat 1, @search.rerankerScore dari ranker semantik, dan @search.rerankerBoostedScore, hasil diurutkan menurut @search.rerankerBoostedScore.

Prasyarat

• Pencarian Azure AI dalam wilayah manapun yang menyediakan peringkat semantik.

• Indeks pencarian dengan konfigurasi semantik yang menentukan "rankingOrder": "boostedRerankerScore" dan profil penilaian yang menentukan fungsi.

Keterbatasan

Peningkatan hasil yang diberi peringkat secara semantik hanya berlaku untuk fungsi profil penilaian skor. Tidak ada peningkatan skor jika profil penilaian skor hanya terdiri dari bidang teks dengan bobot.

Perilaku ini berlaku untuk kueri semantik yang Anda kirim langsung ke indeks, seperti /docs/search. Pengambilan agentik tidak menerapkan profil penilaian pada indeks, termasuk defaultScoringProfile pada indeks yang mendasarinya, dan respons pengambilan tidak menampilkan @search.rerankerBoostedScore. Untuk informasi selengkapnya, lihat Membuat sumber pengetahuan indeks pencarian dan Mengkueri pangkalan pengetahuan.

Bagaimana cara kerja konfigurasi semantik dengan profil penilaian?

Saat Anda menjalankan kueri semantik yang terkait dengan profil penilaian, skor pencarian ketiga, @search.rerankerBoostedScore nilai, dihasilkan untuk setiap dokumen dalam hasil pencarian Anda. Skor yang ditingkatkan ini, dihitung dengan menerapkan profil penilaian ke skor reranker yang ada, tidak memiliki rentang yang dijamin (0–4) seperti skor reranker normal, dan skor dapat naik jauh lebih tinggi dari 4.

Hasil semantik diurutkan @search.rerankerBoostedScore secara default jika ada profil penilaian. rankingOrder Jika properti tidak ditentukan, maka BoostedRerankerScore adalah nilai default dalam konfigurasi semantik.

Dalam skenario ini, profil penilaian digunakan dua kali.

1. Pertama, profil penilaian yang ditentukan dalam indeks Anda digunakan selama fase peringkat L1 awal, meningkatkan hasil dari:

   • Kueri berbasis teks (BM25 atau RRF)
   • Bagian teks kueri vektor
   • Kueri hibrid yang menggabungkan kedua jenis

2. Selanjutnya, peringkat semantik menilai ulang 50 hasil teratas, mempromosikan kecocokan yang lebih relevan secara semantik ke puncak. Langkah ini dapat menghapus manfaat profil penilaian. Misalnya, jika Anda meningkatkan berdasarkan kesegaran, maka pengurutan ulang semantik menggantikan peningkatan itu dengan logikanya sendiri tentang apa yang paling relevan.

3. Akhirnya, profil penilaian diterapkan lagi, setelah reranking, memulihkan pengaruh peningkatan atas urutan akhir hasil. Jika Anda mengoptimalkan berdasarkan kesegaran, hasil yang berperingkat semantik akan diberi skor ulang berdasarkan kesegaran.

Mengaktifkan profil penilaian dalam konfigurasi semantik

Untuk mengaktifkan profil penilaian untuk hasil yang diberi peringkat semantik, perbarui indeks dengan mengatur rankingOrder properti konfigurasi semantiknya. Gunakan metode PUT untuk memperbarui indeks dengan revisi Anda. Tidak diperlukan pembangunan ulang indeks.

PUT https://{service-name}.search.windows.com/indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "boostedRerankerScore"
      }
    ]
  }
}

Menonaktifkan profil penilaian dalam konfigurasi semantik

Untuk memilih keluar dari pengurutan menurut reranker semantik dengan skor yang ditingkatkan, atur nilai rankingOrder ke reRankerScore dalam konfigurasi semantik.

PUT /indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "reRankerScore"
      }
    ]
  }
}

Bahkan jika Anda memilih keluar dari pengurutan menurut @search.rerankerBoostedScore, boostedRerankerScore bidang masih diproduksi dalam respons, tetapi tidak lagi digunakan untuk mengurutkan hasil.

Contoh kueri dan respons

Mulailah dengan kueri semantik yang menentukan profil penilaian. Kueri ini menargetkan indeks pencarian yang memiliki rankingOrder yang diatur menjadi boostedRerankerScore.

POST /indexes/{index-name}/docs/search?api-version=2026-04-01
{
  "search": "my query to be boosted",
  "scoringProfile": "myScoringProfile",
  "queryType": "semantic"
}

Responsnya mencakup yang baru rerankerBoostedScore, bersama L1 @search.score dan L2 @search.rerankerScore. Hasil diurutkan berdasarkan @search.rerankerBoostedScore.

{
  "value": [
    {
      "@search.score": 0.63,
      "@search.rerankerScore": 2.98,
      "@search.rerankerBoostedScore": 7.68,
      "content": "boosted content 2"
    },
    {
      "@search.score": 1.12,
      "@search.rerankerScore": 3.12,
      "@search.rerankerBoostedScore": 5.61,
      "content": "boosted content 1"
    }
  ]
}