Szemantikai rangsoroló konfigurálása és feliratok visszaadása a keresési eredményekben

A szemantikai rangsor egy kezdeti eredményhalmazon keresztül iterál, és egy L2 rangsorolási módszertant alkalmaz, amely a legszembetűnőbb eredményeket segíti elő a verem tetejére. Szemantikai feliratokat is kaphat, kiemelve a legrelevánsabb kifejezéseket és kifejezéseket, valamint szemantikai válaszokat.

Ez a cikk bemutatja, hogyan konfigurálhat keresési indexet szemantikai újrarankáláshoz.

Előfeltételek

• Keresési szolgáltatás alapszintű vagy magasabb szinten, a régió elérhetőségének függvényében.

• A szemantikai rangsoroló engedélyezve van a keresési szolgáltatásban.

• Meglévő keresési index rich text tartalommal. A szemantikai rangsorolás sztringek (nem adatmegjelenítő) mezőkre vonatkozik, és az információs vagy leíró tartalomon működik a legjobban.

Ügyfél kiválasztása

A szemantikai konfiguráció hozzáadásához az alábbi eszközök és szoftverfejlesztői készletek (SDK-k) bármelyikét használhatja:

• Az Azure Portalon az indextervezővel adhat hozzá szemantikai konfigurációt.
• Visual Studio Code a REST-ügyféllel
• Azure SDK for .NET
• Pythonhoz készült Azure SDK
• Javához készült Azure SDK
• Azure SDK for JavaScript

Szemantikai konfiguráció hozzáadása

A szemantikai konfiguráció az index azon szakasza, amely mezőbemeneteket hoz létre a szemantikai rangsoroláshoz. Bármikor hozzáadhat vagy frissíthet szemantikai konfigurációt, nincs szükség újraépítésre. Ha több konfigurációt hoz létre, megadhat egy alapértelmezett beállítást. Lekérdezéskor adjon meg egy szemantikai konfigurációt egy lekérdezési kérelemben, vagy hagyja üresen az alapértelmezett beállítás használatához.

A szemantikai konfiguráció neve és a következő tulajdonságok:

Tulajdonság	Jellemzők
A Cím mező	Egy rövid sztring, ideális esetben 25 szó alatt. Ez a mező lehet egy dokumentum címe, egy termék neve vagy egy egyedi azonosító. Ha nem rendelkezik megfelelő mezővel, hagyja üresen.
Tartalommezők	Hosszabb szöveges adattömbök természetes nyelvi formában, a gépi tanulási modellek maximális tokenbeviteli korlátainak függvényében. Gyakori példák például a dokumentum törzse, egy termék leírása vagy más szabad formátumú szöveg.
Kulcsszómezők	Kulcsszavak listája, például egy dokumentum címkéi vagy egy leíró kifejezés, például egy elem kategóriája.

Csak egy címmezőt adhat meg, de tetszőleges számú tartalom- és kulcsszómezővel rendelkezhet. Tartalom- és kulcsszómezők esetén a mezők prioritási sorrendben jelennek meg, mert az alacsonyabb prioritású mezők csonkoltak lehetnek.

Az összes szemantikai konfigurációs tulajdonságban a hozzárendelt mezőknek a következőknek kell lenniük:

• Attribútumként searchable és retrievable
• Típussztringek Edm.String, Collection(Edm.String)sztring almezők Edm.ComplexType

Azure Portalra

1. Jelentkezzen be az Azure Portalra, és keresse meg a szemantikai rangsorolást engedélyező keresési szolgáltatást.

2. A bal oldali navigációs panel indexei között válasszon ki egy indexet.

3. Válassza a Szemantikai konfigurációk lehetőséget, majd válassza a Szemantikai konfiguráció hozzáadása lehetőséget.

   

4. Az Új szemantikai konfiguráció lapon adja meg a szemantikai konfiguráció nevét, és jelölje ki a szemantikai konfigurációban használni kívánt mezőket. Csak kereshető és lekérhető sztringmezők jogosultak. Ügyeljen arra, hogy a tartalommezők és a kulcsszómezők prioritási sorrendben legyenek felsorolva.

   

5. A konfigurációs beállítások mentéséhez válassza a Mentés lehetőséget.

6. Az indexlapon ismét a Mentés gombra kattintva mentheti a szemantikai konfigurációt az indexben.

REST API

1. Index létrehozására vagy frissítésére vonatkozó kérés létrehozása.

2. Adjon hozzá szemantikai konfigurációt az indexdefinícióhoz, esetleg utána vagy suggestersutánscoringProfiles. Az alapértelmezett beállítás megadása nem kötelező, de akkor hasznos, ha több konfigurációval rendelkezik.

   "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"
                       }
                   ]
               }
           }
       ]
   }
   

.NET SDK

Használja a SzemanticConfiguration osztályt az Azure SDK for .NET-ben.

Az alábbi példa az Azure SDK csapata által készített szemantikai rangsorolási mintából származik.

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")
                }
            })
        }
    }
};

Migrálás előzetes verzióról

Ha a szemantikai rangsorolási kód előzetes verziójú API-kat használ, ez a szakasz bemutatja, hogyan migrálhat stabil verziókra. A változásnaplókban ellenőrizheti az általános rendelkezésre állást:

• 2024-07-01 (REST)
• Az Azure SDK for .NET (11.5) változásnaplója
• Azure SDK for Python (11.4) változásnaplója
• Azure SDK for Java (11.6) változásnapló
• Azure SDK for JavaScript (12.0) változásnapló

queryLanguage a szemantikai rangsorolóhoz

2023. július 14-től a szemantikai rangsoroló nyelvfüggetlen. Többnyelvű tartalomból álló eredményeket képes rerankálni, és nincs elfogultság egy adott nyelv felé. Az előzetes verziókban a szemantikai rangsorolás a mezőelemző által megadott nyelvtől eltérő eredményeket deprioritizálna.

Ne használja queryLanguage a kódot, ha szemantikai rangsorolásra használta. A queryLanguage tulajdonság továbbra is alkalmazható olyan funkciókra, mint a helyesírás-javítás, de a szemantikai rangsorolásra nem.

searchFields for szemantic ranker

A REST API és az összes SDK-csomag esetében, amely a verziót és újabb verziót 2021-04-30-Preview célozza, a searchFields tulajdonság már nem használatos a szemantikai rangsoroláshoz.

Ehelyett használja a semanticConfiguration tulajdonságot (keresési indexben) annak meghatározására, hogy mely keresési mezőket használják a szemantikai rangsorolásban. A mező rangsorolásának megadásához adjon hozzá egy semanticConfiguration indexsémát a jelen cikk utasításait követve.

A lekérdezési kérelmeket megtarthatja searchFields , ha a teljes szöveges keresést a névvel ellátott mezők listájára korlátozza.

Következő lépések

Szemantikai lekérdezés futtatásával tesztelje a szemantikai konfigurációt.

Szemantikai lekérdezés létrehozása