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.

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-k 2026-05-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 for .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.

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.

Ha a szemantikai konfiguráció nem kötelező

Important

Ezek a funkciók és funkciók a 2026-05-01-preview REST API részét képezik. A 2026-05-01-preview az Ön Azure-előfizetésének részeként van licencelve az Ön számára, és a Microsoft-termékfeltételek „Előzetes verziók” részére vonatkozó feltételeinek, a Microsoft-termékekre és -szolgáltatásokra vonatkozó adatvédelmi kiegészítésnek („DPA”), valamint a Microsoft Azure előzetes verzióira vonatkozó kiegészítő használati feltételeknek a hatálya alá tartozik.

A 2026-05-01 előzetes verzió támogatja a más Microsoft-szolgáltatások és külső szolgáltatásokhoz való kapcsolódást. Ezeknek a szolgáltatásoknak a használatára a vonatkozó feltételek vonatkoznak, és a Azure megfelelőségi határán kívüli adatfeldolgozást vagy tárolást, valamint a Azure megfelelőségi határba történő adatáramlást eredményezhetnek.

Az Ön felelőssége annak kezelése, hogy az adatok a szervezet megfelelőségi és földrajzi határain kívülre áramlanak-e, valamint hogy a megfelelő engedélyek, határok és jóváhagyások ki vannak-e építve.

Ön a felelős azért, hogy gondosan áttekintse és tesztelje azokat az alkalmazásokat, amelyeket az adott használati esetek kontextusában hoz létre, és minden megfelelő döntést és testreszabást meghoz. Ez magában foglalja a saját, felelős mesterségesintelligencia-csökkentő megoldások, például metapromptok, tartalomszűrők vagy egyéb biztonsági rendszerek implementálását, valamint annak biztosítását, hogy az alkalmazások megfeleljenek a megfelelő minőségi, megbízhatósági, biztonsági és megbízhatósági szabványoknak. További információ: Azure AI Keresés Átláthatósági megjegyzés.

A(z) 2026-05-01-preview API-ban a támogatott agentikus visszakeresési folyamatok használhatják az Azure AI Keresés rangsorolási viselkedését anélkül, hogy a mögöttes indexben explicit módon megadott szemantikai konfigurációra lenne szükség. Ez az előnézeti viselkedés segít a csapatoknak a tudásbázis lekérésével kezdeni anélkül, hogy blokkolni kéne a szemantikai konfigurációk készítését.

Ez a módosítás nem távolítja el a klasszikus szemantikai rangsorolási konfigurációt. Továbbra is definiáljon szemantikai konfigurációt a klasszikus szemantikai keresési lekérdezésekhez, a régebbi API-verziókhoz és számítási feladatokhoz, amelyek explicit vezérlést igényelnek a cím, a tartalom és a kulcsszómezők felett.

A keresési index tudásforrásai esetében a(z) semanticConfigurationName továbbra is támogatott tulajdonság marad. Állítsa be, ha azt szeretné, hogy a tudásbázis egy adott szemantikai konfigurációt használjon. A támogatott 2026-05-01-preview ügynöki lekérési folyamatokban kihagyhatja azt, ha azt szeretné, hogy a szolgáltatás olyan előzetes viselkedést használjon, amely nem igényel explicit szemantikai konfigurációt az alapul szolgáló indexen.

A szemantikai konfiguráció csak a 2026-05-01-preview API-t használó támogatott, ügynöki lekéréshez tartozó tudásbázis-lekérési folyamatok esetében opcionális. A szemantikai rangsorolás használatakor a klasszikus szemantikai keresési lekérdezések és a régebbi API-verziók továbbra is szemantikai konfigurációt igényelnek. Ha az előnézeti folyamat szemantikai konfigurációja nélkül hoz létre indexet, ne feltételezze, hogy ugyanazt az indexet változatlanul használhatja ga vagy régebbi előzetes verziójú szemantikai rangsorolási API-k használatával.

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

A prerelease szemantikai rangsorolási modellekre való választás

Megjegyzés

Ez a funkció jelenleg előzetes verzióban érhető el. Ez az előzetes verzió szolgáltatásszintű szerződés nélkül érhető el, és éles számítási feladatokhoz nem ajánlott. Előfordulhat, hogy bizonyos funkciók nem támogatottak, vagy korlátozott képességekkel rendelkeznek. További információ: Supplemental Terms of Use for Microsoft Azure Previews.

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-05-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?

Last updated on 2026-06-03

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

Előfeltételek

Ügyfél kiválasztása

Szemantikai konfiguráció hozzáadása

Ha a szemantikai konfiguráció nem kötelező

A prerelease szemantikai rangsorolási modellekre való választás

Következő lépések

Visszajelzés

További források