Mengonfigurasi pemeringkat semantik dan mengembalikan keterangan dalam hasil pencarian

Catatan

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Important

Fitur, kemampuan, atau properti yang ditandai (pratinjau) tidak tercakup dalam perjanjian tingkat layanan, tidak disarankan untuk beban kerja produksi, dan mungkin berubah atau dibatasi sebelum tersedia secara umum. Ketentuan pratinjau Pencarian Azure AI berlaku untuk semua fungsionalitas pratinjau, baik itu mandiri atau bagian dari fitur yang tersedia secara umum.

Peringkat semantik berulang pada kumpulan hasil awal, menerapkan metodologi peringkat L2 yang menaikkan hasil yang paling relevan secara semantik ke bagian atas tumpukan. Anda juga bisa mendapatkan keterangan semantik, dengan sorotan atas istilah dan frasa yang paling relevan, dan jawaban semantik.

Artikel ini menjelaskan cara mengonfigurasi indeks pencarian untuk reranking semantik.

Catatan

Jika Anda memiliki kode yang sudah ada yang memanggil pratinjau atau versi API sebelumnya, lihat Memigrasikan kode peringkat semantik untuk bantuan dalam memodifikasi kode Anda.

Prasyarat

Pencarian Azure AI di area mana pun yang menawarkan peringkat semantik.
Indeks pencarian yang sudah ada dengan konten teks kaya. Peringkat semantik berlaku untuk bidang string (nonvector) dan berfungsi paling baik pada konten yang bersifat informasi atau deskriptif.
Izin untuk membuat dan menggunakan objek di Pencarian Azure AI. Kami merekomendasikan akses berbasis peran, tetapi Anda dapat menggunakan kunci API jika penetapan peran tidak layak. Untuk informasi selengkapnya, lihat Menyambungkan ke layanan pencarian.
Versi 2026-08-01-preview dari API REST Layanan Pencarian.

Pilih klien

Anda dapat menentukan konfigurasi semantik pada indeks baru atau yang sudah ada, menggunakan salah satu alat dan kit pengembangan perangkat lunak (SDK) berikut untuk menambahkan konfigurasi semantik:

Azure portal, menggunakan perancang indeks untuk menambahkan konfigurasi semantik.
Visual Studio Code dengan klien REST dan Buat atau Perbarui INDEKS (REST) API.
Azure SDK untuk .NET
Azure SDK untuk Python
Azure SDK untuk Java
Azure SDK untuk JavaScript

Menambahkan konfigurasi semantik

Beberapa beban kerja membuat konfigurasi semantik secara otomatis. Jika Anda menggunakan agentic retrieval dan sumber pengetahuan yang mengindeks konten pada Pencarian Azure AI, indeks yang Anda buat sudah memiliki konfigurasi semantik yang sesuai dengan konten Anda.

Tip

Mulai dari versi API 2026-05-01-preview, alur basis pengetahuan retrieval agentik yang didukung tidak memerlukan konfigurasi semantik eksplisit. Pengecualian ini tidak berlaku untuk kueri peringkat semantik klasik atau versi API yang lebih lama. Untuk informasi selengkapnya, lihat Membuat sumber pengetahuan indeks pencarian.

Untuk beban kerja lain, Anda dapat menyiapkan konfigurasi semantik sendiri. Konfigurasi semantik adalah bagian dalam indeks Anda yang menetapkan input bidang yang digunakan untuk peringkat semantik. Anda dapat menambahkan atau memperbarui konfigurasi semantik kapan saja, tidak perlu membangun kembali. Jika Membuat beberapa konfigurasi, Anda dapat menentukan default. Pada waktu kueri, tentukan konfigurasi semantik pada permintaan kueri, atau biarkan kosong untuk menggunakan default.

Anda dapat membuat hingga 100 konfigurasi semantik dalam satu indeks.

Konfigurasi semantik memiliki nama dan properti berikut:

Properti	Karakteristik
Bidang judul	String pendek, idealnya di bawah 25 kata. Bidang ini bisa berupa judul dokumen, nama produk, atau pengidentifikasi unik. Jika Anda tidak memiliki bidang yang sesuai, biarkan bidang kosong.
Bidang konten	Potongan teks yang lebih panjang dalam bentuk bahasa alami, tunduk pada batas input token maksimum pada model pembelajaran mesin. Contoh umum termasuk isi dokumen, deskripsi produk, atau teks bentuk bebas lainnya.
Bidang kata kunci	Daftar kata kunci, seperti tag pada dokumen, atau istilah deskriptif, seperti kategori item.

Anda hanya bisa menentukan satu bidang judul, tetapi Anda bisa memiliki bidang konten dan kata kunci sebanyak yang Anda inginkan. Untuk bidang konten dan kata kunci, cantumkan bidang dalam urutan prioritas karena bidang prioritas yang lebih rendah mungkin terpotong.

Di semua properti konfigurasi semantik, bidang yang Anda tetapkan harus:

Diatribusikan sebagai searchable dan retrievable
String jenis Edm.String, Collection(Edm.String), subbidang string dari Edm.ComplexType

Buka layanan pencarian Anda di portal Azure.
Dari Indeks di panel navigasi kiri, pilih indeks.
Pilih Konfigurasi semantik lalu pilih Tambahkan konfigurasi semantik.
Pada halaman Konfigurasi semantik baru , masukkan nama konfigurasi semantik dan pilih bidang yang akan digunakan dalam konfigurasi semantik. Hanya bidang string yang dapat dicari dan dapat diambil yang memenuhi syarat. Pastikan untuk mencantumkan bidang konten dan bidang kata kunci dalam urutan prioritas.
Pilih Simpan untuk menyimpan pengaturan konfigurasi.
Pilih Simpan lagi di halaman indeks untuk menyimpan konfigurasi semantik dalam indeks.

Merumuskan permintaan Buat atau Perbarui Indeks .

Tambahkan konfigurasi semantik ke definisi indeks, mungkin setelah scoringProfiles atau suggesters. Menentukan default bersifat opsional tetapi berguna jika Anda memiliki lebih dari satu konfigurasi.

"semantic": {
    "defaultConfiguration": "my-semantic-config-default",
    "configurations": [
        {
            "name": "my-semantic-config-default",
            "prioritizedFields": {
                "titleField": {
                    "fieldName": "HotelName"
                },
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ],
                "prioritizedKeywordsFields": [
                    {
                        "fieldName": "Tags"
                    }
                ]
            }
        },
                    {
            "name": "my-semantic-config-desc-only",
            "prioritizedFields": {
                "prioritizedContentFields": [
                    {
                        "fieldName": "Description"
                    }
                ]
            }
        }
    ]
}

Gunakan kelas SemanticConfiguration di Azure SDK untuk .NET.

Contoh berikut berasal dari sampel peringkat semantik yang ditulis oleh tim Azure SDK.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Ikut serta dalam model pemeringkatan semantik prarilis (pratinjau)

Menggunakan preview REST APIs dan Azure SDK pratinjau yang menyediakan properti tersebut, Anda dapat secara opsional mengonfigurasi indeks untuk menggunakan model pemeringkatan semantik prarilis jika model tersebut telah diterapkan di wilayah Anda. Tidak ada mekanisme untuk mengetahui apakah versi prarilis tersedia, atau apakah telah digunakan pada kueri tertentu. Untuk alasan ini, kami sarankan Anda menggunakan properti ini di lingkungan pengujian, dan hanya jika Anda tertarik untuk mencoba model peringkat semantik terbaru.

Properti konfigurasi adalah "flightingOptIn": true, dan disetel pada bagian konfigurasi semantik suatu indeks. Properti null atau false secara default. Anda dapat mengaturnya menjadi benar pada permintaan buat atau perbarui kapan saja, dan ini akan memengaruhi kueri semantik ke depan, dengan asumsi bahwa kueri menetapkan konfigurasi semantik yang mencakup properti tersebut.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-08-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

Langkah berikutnya

Uji konfigurasi semantik Anda dengan menjalankan kueri semantik.

Membuat kueri semantik

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-08-31