Konfigurera semantisk rankning och returnera bildtexter i sökresultat

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.

Förutsättningar

• Azure AI-sökning i alla regioner som erbjuder semantisk rangordning.

• 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.

• Behörighet att skapa och använda objekt i Azure AI-sökning. Vi rekommenderar rollbaserad åtkomst, men du kan använda API-nycklar om en rolltilldelning inte är möjlig. Mer information finns i Ansluta till en söktjänst.

• Versionen 2026-08-01-preview av REST-API:t för söktjänsten.

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:

• Azure portal med hjälp av indexdesignern för att lägga till en semantisk konfiguration.
• Visual Studio Code med REST-klienten och ett Skapa eller uppdatera index (REST) API.
• Azure SDKs för .NET
• Azure SDKs för Python
• Azure SDKs för Java
• Azure SDKs för JavaScript

Lägga till en semantisk konfiguration

Vissa arbetsbelastningar skapar en semantisk konfiguration automatiskt. Om du använder agentisk hämtning och en knowledge-källa som indexerar innehåll på Azure AI-sökning, har ditt genererade index redan en semantisk konfiguration som fungerar för ditt innehåll.

För andra arbetsbelastningar kan du konfigurera en semantisk konfiguration själv. En semantisk konfiguration är ett avsnitt i ditt index som upprättar fältindata som används 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:

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

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 modeller för semantisk rangordning (förhandsversion)

Med hjälp av förhandsversion av REST-API:er och förhandsversion Azure-SDK:er som tillhandahåller egenskapen, kan du välja att konfigurera ett index för att använda fördefinierade semantiska rankningsmodeller om en har distribuerats 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=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": {  }
}

Nästa steg

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