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

Megjegyzés

Azure AI Keresés a Azure portálon, REST API-kon és Azure SDK-k keresztül érhető el. Emellett a Foundry IQ-t is támogatja, amely a vállalati tartalmakat újrafelhasználható, engedélytudatos tudásbázisokká alakítja át az Microsoft Foundry portálon található ügynökök számára.

Important

Az (előzetes verzióban) megjelölt funkciókra, képességekre vagy tulajdonságokra nem vonatkozik szolgáltatási szintű szerződés, nem ajánlott éles számítási feladatokhoz, és az általános elérhetővé válásuk előtt változhatnak vagy korlátozhatók. Az Azure AI Keresés előzetes verziójú kifejezések az összes előzetes verziós funkcióra vonatkoznak, függetlenül attól, hogy önálló vagy egy általánosan elérhető funkció része.

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.

Megjegyzés

Ha már rendelkezik olyan kóddal, amely előzetes verziót vagy korábbi API-verziókat hív meg, a kód módosításával kapcsolatos segítségért tekintse meg a szemantikai rangsorolási kód migrálása című témakört.

Előfeltételek

Azure AI Keresés minden olyan régióban, amely szemantikai rangsort biztosít.
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.
Engedélyek objektumok létrehozásához és használatához az Azure AI Keresés szolgáltatásban. A szerepköralapú hozzáférést javasoljuk, de api-kulcsokat is használhat, ha egy szerepkör-hozzárendelés nem valósítható meg. További információ: Csatlakozás keresési szolgáltatáshoz.
A Search Service REST API 2026-08-01 előzetes verziója .

Ügyfél kiválasztása

Szemantikai konfigurációt adhat meg új vagy meglévő indexeken az alábbi eszközök és szoftverfejlesztői készletek (SDK-k) használatával szemantikai konfiguráció hozzáadásához:

Azure portál az indextervezővel szemantikai konfigurációt adhat hozzá.
Visual Studio Code a REST klienssel és egy Index létrehozása vagy frissítése (REST) API-val.
Azure SDK .NET
Azure SDK Python
Azure SDK Java
Azure JavaScript SDK

Szemantikai konfiguráció hozzáadása

Egyes számítási feladatok automatikusan létrehoznak szemantikai konfigurációt. Ha agentic retrievalt használ, és egy tudásforrást, amely a tartalmat indexeli az Azure AI Keresés-en, a létrehozott index már rendelkezik a tartalomhoz megfelelő szemantikai konfigurációval.

Jótanács

A 2026-05-01-preview API-verziótól kezdve a támogatott ügynöki visszakeresési tudásbázis-folyamatok nem igényelnek explicit szemantikai konfigurációt. Ez a kivétel nem vonatkozik a klasszikus szemantikai rangsorolási lekérdezésekre vagy a régebbi API-verziókra. További információ: Keresési index tudásbázisának létrehozása.

Más számítási feladatokhoz saját maga is beállíthat szemantikai konfigurációt. A szemantikai konfiguráció az index egy szakasza, amely létrehozza a szemantikai rangsoroláshoz használt mezőbemeneteket. 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.

Egyetlen indexben legfeljebb 100 szemantikai konfiguráció hozható létre.

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

Tulajdonság	Jellemzők
Cím mező	Egy rövid karakterlánc, 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, például Edm.String, Collection(Edm.String) és sztring almezők Edm.ComplexType

Nyissa meg a keresőszolgáltatást a Azure portálon.
A bal oldali navigációs panel indexei között válasszon ki egy indexet.
Válassza a Szemantikai konfigurációk lehetőséget, majd válassza a Szemantikai konfiguráció hozzáadása lehetőséget.
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ő karakterláncmezők lehetőséggel bírnak. Ügyeljen arra, hogy a tartalommezők és a kulcsszómezők prioritási sorrendben legyenek felsorolva.
A konfigurációs beállítások mentéséhez válassza a Mentés lehetőséget.
Az indexlapon ismét a Mentés gombra kattintva mentheti a szemantikai konfigurációt az indexben.

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

Adjon hozzá szemantikai konfigurációt az indexdefinícióhoz, esetleg scoringProfiles vagy suggesters után. 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"
                    }
                ]
            }
        }
    ]
}

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

A következő példa a semantikus rangsorolási mintából származik, amelyet a Azure SDK csapata készített.

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

Jelentkezzen be a kiadás előtti szemantikai rangsorolási modellek használatára (előzetes verzió)

A tulajdonságot biztosító preview REST API-k és előzetes verziójú Azure SDK-k használatával igény szerint konfigurálhat egy indexet a prerelease szemantikai rangsorolási modellek használatára, ha a régióban van üzembe helyezve. Nincs mechanizmus annak eldöntésére, hogy rendelkezésre áll-e előzetes lekérdezés, vagy adott lekérdezésben használták-e. Ezért azt javasoljuk, hogy ezt a tulajdonságot tesztkörnyezetekben használja, és csak akkor, ha szeretné kipróbálni a legújabb szemantikai rangsorolási modelleket.

A konfigurációs tulajdonság az "flightingOptIn": trueindex szemantikai konfigurációs szakaszában van beállítva. A tulajdonság alapértelmezés szerint null vagy hamis. Egy létrehozási vagy frissítési kérelem esetén bármikor igaz értéket állíthat be, és ez hatással van a szemantikai lekérdezésekre, feltéve, hogy a lekérdezés olyan szemantikai konfigurációt ír elő, amely tartalmazza a tulajdonságot.

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": {  }
}

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

Visszajelzés

Hasznosnak találta ezt az oldalt?

Utolsó frissítés időpontja: 2026-09-17