Konfigurace sémantického rankeru a vrácení titulků ve výsledcích hledání

Sémantické řazení iteruje nad počáteční sadou výsledků a používá metodologii řazení L2, která podporuje nejvíce sémanticky relevantních výsledků na začátek zásobníku. Můžete také získat sémantické titulky s nejdůležitějšími termíny a frázemi a sémantické odpovědi.

Tento článek vysvětluje, jak nakonfigurovat index vyhledávání pro sémantické reranking.

Požadavky

• Azure AI Vyhledávač v libovolné oblasti , která poskytuje sémantické řazení.

• Existující index vyhledávání s bohatým textovým obsahem. Sémantické řazení se aplikuje na řetězcová pole (nevěktorová) a funguje nejlépe ve obsahu, který je informativní nebo popisný.

• Oprávnění k vytváření a používání objektů ve službě Azure AI Vyhledávač Doporučujeme přístup na základě role, ale pokud přiřazení role není možné, můžete použít klíče rozhraní API . Další informace najdete v tématu Připojení k vyhledávací službě.

• Verze 2026-08-01-preview rozhraní REST API vyhledávací služby.

Volba klienta

Sémantickou konfiguraci můžete zadat u nových nebo existujících indexů pomocí některého z následujících nástrojů a sad SDK pro přidání sémantické konfigurace:

• Azure portal pomocí návrháře indexu přidejte sémantickou konfiguraci.
• Visual Studio Code pomocí klienta REST a rozhraní API Create nebo Update Index (REST) API.
• Azure SDK pro .NET
• Azure SDK pro Python
• Azure SDK pro Java
• Azure SDK pro JavaScript

Přidání sémantické konfigurace

Některé úlohy vytvářejí sémantickou konfiguraci automaticky. Pokud používáte agentické načítání a knowledge source, který indexuje obsah na Azure AI Vyhledávač, vygenerovaný index už má sémantickou konfiguraci, která funguje pro váš obsah.

Pro jiné úlohy můžete nastavit sémantickou konfiguraci sami. Sémantická konfigurace je oddíl v indexu, který určuje vstupy polí používané pro sémantické řazení. Sémantickou konfiguraci můžete kdykoli přidat nebo aktualizovat bez nutnosti opětovného sestavení. Pokud vytváříte více konfigurací, můžete zadat výchozí nastavení. V době dotazu zadejte pro požadavek dotazu sémantickou konfiguraci nebo ponechte prázdnou hodnotu, aby se použila výchozí hodnota.

V jednom indexu můžete vytvořit až 100 sémantických konfigurací.

Sémantická konfigurace má název a následující vlastnosti:

Můžete zadat pouze jedno pole názvu, ale můžete mít tolik polí obsahu a klíčových slov, kolik chcete. U polí obsahu a klíčových slov vypište pole v pořadí priority, protože pole s nižší prioritou se můžou zkrátit.

Ve všech sémantických vlastnostech konfigurace musí být pole, která přiřadíte, následující:

• Přiřazeno jako searchable a retrievable
• Řetězce typu Edm.String, Collection(Edm.String), podpole řetězců Edm.ComplexType

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

Přihlaste se k modelům sémantického hodnocení v předběžné verzi (Preview)

Pomocí rozhraní REST API ve verzi Preview a sad Azure SDK ve verzi Preview, které tuto vlastnost poskytují, můžete volitelně nakonfigurovat index tak, aby používal předběžné modely sémantického řazení, pokud je ve vaší oblasti takový model nasazen. Neexistuje žádný mechanismus, který by věděl, jestli je k dispozici předběžná verze nebo jestli byl použit pro konkrétní dotaz. Z tohoto důvodu doporučujeme použít tuto vlastnost v testovacích prostředích a pouze v případě, že chcete vyzkoušet nejnovější sémantické modely řazení.

Vlastnost konfigurace je "flightingOptIn": truea je nastavena v sémantické konfigurační části indexu. Ve výchozím nastavení je vlastnost null nebo false. U požadavku na vytvoření nebo aktualizaci můžete kdykoli nastavit hodnotu true a má vliv na sémantické dotazy, které se posunou vpřed, za předpokladu, že dotaz stanoví sémantickou konfiguraci, která tuto vlastnost obsahuje.

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

Další kroky

Otestujte sémantickou konfiguraci spuštěním sémantického dotazu.