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.

Notitie

Als u bestaande code hebt die preview- of vorige API-versies aanroept, raadpleegt u Semantische classificatiecode migreren voor hulp bij het wijzigen van uw code.

Vereisten

• Een zoekservice op een Basic-laag of hoger, afhankelijk van beschikbaarheid van regio's.

• Semantische rangschikking ingeschakeld voor uw zoekservice.

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

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 REST-API (Create or Update Index).
• Azure-SDK voor .NET
• Azure-SDK voor Python
• Azure SDK voor Java
• Azure SDK voor JavaScript

Een semantische configuratie toevoegen

Een semantische configuratie is een sectie in uw index waarmee veldinvoer voor semantische classificatie wordt vastgesteld. 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.

Een semantische configuratie heeft een naam en de volgende eigenschappen:

Eigenschappen	Kenmerken
Het veld Titel	Een korte tekenreeks, idealiter minder dan 25 woorden. Dit veld kan de titel zijn van een document, naam van een product of een unieke id. Als u geen geschikt veld hebt, laat u het veld leeg.
Inhoudsvelden	Langere stukken tekst in natuurlijke taalvorm, afhankelijk van de maximale invoerlimieten voor tokens voor de machine learning-modellen. Veelvoorkomende voorbeelden zijn de hoofdtekst van een document, beschrijving van een product of andere vrije tekst.
Trefwoordvelden	Een lijst met trefwoorden, zoals de tags in een document of een beschrijvende term, zoals de categorie van een item.

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)tekenreekssubvelden van Edm.ComplexType

Azure-portal

1. Meld u aan bij Azure Portal en navigeer naar een zoekservice waarvoor semantische classificatie is ingeschakeld.

2. Selecteer een index in indexen in het linkernavigatiedeelvenster.

3. Selecteer Semantische configuraties en selecteer vervolgens Semantische configuratie toevoegen.

   

4. Voer op de pagina Nieuwe semantische configuratie een semantische configuratienaam in en selecteer de velden die u wilt gebruiken in de semantische configuratie. Alleen doorzoekbare en ophaalbare tekenreeksvelden komen in aanmerking. Zorg ervoor dat u inhoudsvelden en trefwoordvelden in volgorde van prioriteit weer wilt geven.

   

5. Selecteer Opslaan om de configuratie-instellingen op te slaan.

6. Selecteer Opnieuw opslaan op de indexpagina om de semantische configuratie in de index op te slaan.

REST API

1. Formuleer een aanvraag voor een index maken of bijwerken .

2. Voeg een semantische configuratie toe aan de indexdefinitie, mogelijk na scoringProfiles of suggesters. Het opgeven van een standaardwaarde is optioneel, maar handig als u meer dan één configuratie hebt.

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

.NET SDK

Gebruik de SemanticConfiguration-klasse in de Azure SDK voor .NET.

Het volgende voorbeeld is afkomstig uit het semantische classificatievoorbeeld dat is geschreven door het Azure SDK-team.

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

Volgende stappen

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

Een semantische query maken