Konfigurera semantisk rankning och returnera bildtexter i sökresultat

2025-04-10

Semantisk rankning itererar över en inledande resultatuppsättning och tillämpar en L2-rankningsmetod som främjar de mest semantiskt relevanta resultaten högst upp i stacken. Du kan också få semantiska bildtexter, med markeringar över de mest relevanta termerna och fraserna och semantiska svar.

I den här artikeln beskrivs hur du konfigurerar ett sökindex för semantisk omrankning.

Kommentar

Om du har befintlig kod som anropar förhandsversioner eller tidigare API-versioner kan du läsa Migrera semantisk rangordningskod för hjälp med att ändra koden.

Förutsättningar

En söktjänst på en Basic-nivå eller högre, beroende på regionens tillgänglighet.
Semantisk ranker aktiverad i söktjänsten.
Ett befintligt sökindex med RTF-innehåll. Semantisk rangordning gäller för strängar (icke-bevektorfält) och fungerar bäst på innehåll som är informations- eller beskrivande.

Välj en klient

Du kan ange en semantisk konfiguration för nya eller befintliga index med något av följande verktyg och programutvecklingspaket (SDK:er) för att lägga till en semantisk konfiguration:

Med Azure Portal använder du indexdesignern för att lägga till en semantisk konfiguration.
Visual Studio Code med REST-klienten och ett REST-API (Create or Update Index).
Azure SDK för .NET
Azure SDK för Python
Azure SDK för Java
Azure SDK för JavaScript

Lägga till en semantisk konfiguration

En semantisk konfiguration är ett avsnitt i ditt index som upprättar fältindata för semantisk rangordning. Du kan lägga till eller uppdatera en semantisk konfiguration när som helst, ingen återskapande krävs. Om du skapar flera konfigurationer kan du ange ett standardvärde. Vid frågetillfället anger du en semantisk konfiguration för en frågebegäran eller lämnar den tom om du vill använda standardinställningen.

Du kan skapa upp till 100 semantiska konfigurationer i ett enda index.

En semantisk konfiguration har ett namn och följande egenskaper:

Egendom	Egenskaper
Rubrikfält	En kort sträng, helst under 25 ord. Det här fältet kan vara rubriken på ett dokument, namnet på en produkt eller en unik identifierare. Om du inte har ett lämpligt fält lämnar du det tomt.
Innehållsfält	Längre textsegment i naturlig språkform, med förbehåll för maximala tokeninmatningsgränser för maskininlärningsmodellerna. Vanliga exempel är brödtexten i ett dokument, en beskrivning av en produkt eller annan fritext.
Nyckelordsfält	En lista med nyckelord, till exempel taggarna i ett dokument eller en beskrivande term, till exempel kategorin för ett objekt.

Du kan bara ange ett rubrikfält, men du kan ha så många innehålls- och nyckelordsfält som du vill. För innehålls- och nyckelordsfält listar du fälten i prioritetsordning eftersom fält med lägre prioritet kan trunkeras.

För alla semantiska konfigurationsegenskaper måste fälten du tilldelar vara:

Tillskriven som searchable och retrievable
Strängar av typen Edm.String, Collection(Edm.String), strängunderfält för Edm.ComplexType

Logga in på Azure Portal och navigera till en söktjänst som har semantisk rangordning aktiverad.
Välj ett index från Index i det vänstra navigeringsfönstret.
Välj Semantiska konfigurationer och välj sedan Lägg till semantisk konfiguration.
På sidan Ny semantisk konfiguration anger du ett semantiskt konfigurationsnamn och väljer de fält som ska användas i den semantiska konfigurationen. Endast sökbara och hämtningsbara strängfält är berättigade. Se till att lista innehållsfält och nyckelordsfält i prioritetsordning.
Spara konfigurationsinställningarna genom att välja Spara .
Välj Spara igen på indexsidan för att spara den semantiska konfigurationen i indexet.

Formulera en begäran om att skapa eller uppdatera index .

Lägg till en semantisk konfiguration i indexdefinitionen, kanske efter scoringProfiles eller suggesters. Att ange ett standardvärde är valfritt men användbart om du har fler än en konfiguration.

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

Använd klassen SemanticConfiguration i Azure SDK för .NET.

Följande exempel är från det semantiska rangordningsexemplet som skapats av Azure SDK-teamet.

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

Anmäl dig till semantiska rankningsmodeller för förhandsversion

Kommentar

Den här funktionen är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Från 2025-03-01-preview REST API och i Azure SDK:er som tillhandahåller egenskapen kan du välja att konfigurera ett index för att använda förhandsversionssemantiska rangordningsmodeller om en sådan modell är tillgänglig i din region. Det finns ingen mekanism för att veta om en förhandsversion är tillgänglig eller om den användes för en specifik fråga. Därför rekommenderar vi att du använder den här egenskapen i testmiljöer och endast om du är intresserad av att testa de allra senaste semantiska rankningsmodellerna.

Konfigurationsegenskapen är "flightingOptIn": true, och den anges i avsnittet semantisk konfiguration i ett index. Egenskapen är null eller false som standard. Du kan ange det som sant för en begäran om att skapa eller uppdatera när som helst, och det påverkar semantiska frågor framöver, förutsatt att frågan anger en semantisk konfiguration som innehåller egenskapen.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2025-03-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": {  }
}

Nästa steg

Testa din semantiska konfiguration genom att köra en semantisk fråga.

Skapa en semantisk fråga