Semantische rangschikking configureren en bijschriften retourneren in zoekresultaten

Semantische classificatie itereert over een initiële resultatenset, waarbij een L2-classificatiemethode wordt toegepast die de meest semantisch relevante resultaten aan de bovenkant van de stack bevordert. U kunt ook semantische bijschriften krijgen, met markeringen over de meest relevante termen en woordgroepen en semantische antwoorden.

In dit artikel wordt uitgelegd hoe u een zoekindex configureert voor semantische herrankering.

Voorwaarden

• Azure AI Zoeken in een regio die semantische rangschikking biedt.

• Een bestaande zoekindex met opgemaakte tekst. Semantische classificatie is van toepassing op tekenreeksvelden (nonvectorvelden) en werkt het beste voor inhoud die informatief of beschrijvend is.

• Machtiging voor het maken en gebruiken van objecten in Azure AI Zoeken. We raden op rollen gebaseerde toegang aan, maar u kunt API-sleutels gebruiken als een roltoewijzing niet haalbaar is. Zie Verbinding maken met een zoekservice voor meer informatie.

• De preview-versie 2026-08-01 van de REST API van de Search Service.

Een client kiezen

U kunt een semantische configuratie opgeven voor nieuwe of bestaande indexen, met behulp van een van de volgende hulpprogramma's en SDK's (Software Development Kits) om een semantische configuratie toe te voegen:

• Azure portal met behulp van de indexontwerper om een semantische configuratie toe te voegen.
• Visual Studio Code met de REST-client en een -API voor index maken of bijwerken.
• Azure SDK voor .NET
• Azure SDK voor Python
• Azure SDK voor Java
• Azure SDK voor JavaScript

Een semantische configuratie toevoegen

Sommige workloads maken automatisch een semantische configuratie. Als u agentisch ophalen en een kennisbron gebruikt waarmee inhoud wordt geïndexeerd op Azure AI Zoeken, heeft uw gegenereerde index al een semantische configuratie die geschikt is voor uw inhoud.

Voor andere workloads kunt u zelf een semantische configuratie instellen. Een semantische configuratie is een sectie in uw index waarmee de veldinvoer wordt vastgelegd die worden gebruikt voor semantische rangschikking. U kunt op elk gewenst moment een semantische configuratie toevoegen of bijwerken, zonder dat u deze opnieuw hoeft te bouwen. Als u meerdere configuraties maakt, kunt u een standaard opgeven. Geef tijdens query's een semantische configuratie op voor een queryaanvraag of laat deze leeg om de standaardinstelling te gebruiken.

U kunt maximaal 100 semantische configuraties maken in één index.

Een semantische configuratie heeft een naam en de volgende eigenschappen:

U kunt slechts één titelveld opgeven, maar u kunt zoveel inhouds- en trefwoordvelden hebben als u wilt. Voor inhouds- en trefwoordvelden kunt u de velden in volgorde van prioriteit weergeven, omdat velden met lagere prioriteit mogelijk worden afgekapt.

Voor alle semantische configuratie-eigenschappen moeten de velden die u toewijst het volgende zijn:

• Toegeschreven als searchable en retrievable
• Tekenreeksen van het type Edm.String, Collection(Edm.String), subvelden van tekenreeksen van 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")
                }
            })
        }
    }
};

Aanmelden voor semantische prerelease-rangschikkingsmodellen (preview-versie)

Met behulp van preview REST API's en preview-Azure-SDK's die de eigenschap bieden, kunt u desgewenst een index configureren voor het gebruik van semantische classificatiemodellen voor prerelease als er een is geïmplementeerd in uw regio. Er is geen mechanisme om te weten of er een voorlopige versie beschikbaar is of dat deze is gebruikt voor een specifieke query. Daarom raden we u aan deze eigenschap te gebruiken in testomgevingen en alleen als u geïnteresseerd bent in het uitproberen van de meest recente semantische classificatiemodellen.

De configuratie-eigenschap is "flightingOptIn": trueen wordt ingesteld in de sectie semantische configuratie van een index. De eigenschap is standaard ingesteld op null of false. U kunt deze waarde op elk gewenst moment instellen voor een aanvraag voor maken of bijwerken en dit is van invloed op semantische query's, ervan uitgaande dat de query een semantische configuratie bepaalt die de eigenschap bevat.

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

Volgende stappen

Test uw semantische configuratie door een semantische query uit te voeren.