Scoreprofielen toevoegen aan een zoekindex

Voor zoekquery's in volledige tekst berekent de zoekmachine een zoekscore voor elk overeenkomend document, waardoor resultaten kunnen worden gerangschikt van hoog naar laag. Azure Cognitive Search maakt gebruik van een standaardscorealgoritme om een initiële score te berekenen, maar u kunt de berekening aanpassen via een scoreprofiel.

Scoreprofielen worden ingesloten in indexdefinities en bevatten eigenschappen voor het verhogen van de score van overeenkomsten, waarbij aanvullende criteria in het profiel de boostlogica bieden. U kunt bijvoorbeeld overeenkomsten verbeteren op basis van hun omzetmogelijkheden, nieuwere items promoveren of items die te lang in de voorraad staan, verbeteren.

Bent u niet bekend met relevantieconcepten? In het volgende videosegment wordt snel doorgestuurd naar de manier waarop scoreprofielen werken in Azure Cognitive Search, maar de video bevat ook basisconcepten. Mogelijk wilt u ook de rangschikking van overeenkomsten en scoren bekijken voor meer achtergrondinformatie.

Wat is een scoreprofiel?

Een scoreprofiel maakt deel uit van de indexdefinitie en bestaat uit gewogen velden, functies en parameters. Het doel van een scoreprofiel is het verbeteren of versterken van overeenkomende documenten op basis van criteria die u op geeft.

In de volgende definitie ziet u een eenvoudig profiel met de naam 'geo'. Dit is een boost voor de resultaten met de zoekterm in het veld hotelName. Ook wordt de functie gebruikt om de voorkeur te geven aan resultaten die distance zich binnen tien kilometer van de huidige locatie bevinden. Als iemand zoekt op de term 'inn' en 'inn' deel uitmaakt van de hotelnaam, worden documenten met hotels met 'inn' binnen een straal van 10 KM van de huidige locatie hoger weergegeven in de zoekresultaten.

"scoringProfiles": [
  {  
    "name":"geo",
    "text": {  
      "weights": {  
        "hotelName": 5
      }                              
    },
    "functions": [
      {  
        "type": "distance",
        "boost": 5,
        "fieldName": "location",
        "interpolation": "logarithmic",
        "distance": {
          "referencePointParameter": "currentLocation",
          "boostingDistance": 10
        }                        
      }                                      
    ]                     
  }            
]

Als u dit scoreprofiel wilt gebruiken, wordt uw query geformuleerd om de parameter scoringProfile in de aanvraag op te geven.

POST /indexes/hotels/docs&api-version=2020-06-30
{
    "search": "inn",
    "scoringProfile": "geo",
    "scoringParameter": currentLocation--122.123,44.77233
}

Deze query zoekt naar de term 'inn' en geeft de huidige locatie door. U ziet dat deze query andere parameters bevat, zoals scoringParameter. Queryparameters worden beschreven in Documenten zoeken (REST API).

Zie het uitgebreide voorbeeld om een gedetailleerder voorbeeld van een scoreprofiel te bekijken.

Hoe scores worden berekend

Scores worden berekend voor zoekopdrachten in volledige tekst om de meest relevante overeenkomsten te rangschikken en deze bovenaan het antwoord te retourneren. De algehele score voor elk document is een aggregatie van de afzonderlijke scores voor elk veld, waarbij de afzonderlijke score van elk veld wordt berekend op basis van de term frequentie en documentfrequentie van de gezochte termen in dat veld (ook wel TF-IDF of term frequency-inverse documentfrequentie genoemd).

Wanneer moet ik scoring-logica toevoegen?

U moet een of meer scoreprofielen maken wanneer het standaardrangschikkingsgedrag niet ver genoeg gaat om te voldoen aan uw bedrijfsdoelstellingen. U kunt bijvoorbeeld besluiten dat de zoekrelevantie de voorkeur moet geven aan nieuw toegevoegde items. Op dezelfde manier hebt u mogelijk een veld met winstmarge of een ander veld dat de omzetmogelijkheden aangeeft. Het stimuleren van resultaten die zinvoller zijn voor uw gebruikers of het bedrijf, is vaak de belangrijkste factor bij de acceptatie van scoreprofielen.

Volgorde op basis van relevantie op een zoekpagina wordt ook geïmplementeerd via scoreprofielen. Denk aan pagina's met zoekresultaten die u in het verleden hebt gebruikt, waarmee u kunt sorteren op prijs, datum, classificatie of relevantie. In Azure Cognitive Search kunnen scoreprofielen worden gebruikt om de optie 'relevantie' te bepalen. De definitie van relevantie wordt bepaald door u, gebaseerd op bedrijfsdoelstellingen en het type zoekervaring dat u wilt leveren.

Uitgebreid voorbeeld

In het volgende voorbeeld ziet u het schema van een index met twee scoreprofielen ( boostGenre , newAndHighlyRated ). Elke query op deze index die een profiel als een queryparameter bevat, gebruikt het profiel om de resultatenset te scoren.

Het profiel maakt gebruik van gewogen tekstvelden, boosting matches die te vinden zijn in de velden boostGenre profilerenTitle, genre en artistName. De velden worden respectievelijk 1,5, 5 en 2 boosted. Waarom is het genre zo veel hoger dan de andere? Als er wordt gezocht op gegevens die enigszins homogen zijn (zoals het geval is bij 'genre' in de musicstoreindex), hebt u mogelijk een grotere afwijking in de relatieve gewichten nodig. In de musicstoreindex wordt 'rock' bijvoorbeeld weergegeven als zowel een genre als in identieke genrebeschrijvingen. Als u wilt dat genre opweegt tegen de genrebeschrijving, heeft het genreveld een veel hoger relatief gewicht nodig.

{  
  "name": "musicstoreindex",  
  "fields": [  
    { "name": "key", "type": "Edm.String", "key": true },  
    { "name": "albumTitle", "type": "Edm.String" },  
    { "name": "albumUrl", "type": "Edm.String", "filterable": false },  
    { "name": "genre", "type": "Edm.String" },  
    { "name": "genreDescription", "type": "Edm.String", "filterable": false },  
    { "name": "artistName", "type": "Edm.String" },  
    { "name": "orderableOnline", "type": "Edm.Boolean" },  
    { "name": "rating", "type": "Edm.Int32" },  
    { "name": "tags", "type": "Collection(Edm.String)" },  
    { "name": "price", "type": "Edm.Double", "filterable": false },  
    { "name": "margin", "type": "Edm.Int32", "retrievable": false },  
    { "name": "inventory", "type": "Edm.Int32" },  
    { "name": "lastUpdated", "type": "Edm.DateTimeOffset" }  
  ],  
  "scoringProfiles": [  
    {  
      "name": "boostGenre",  
      "text": {  
        "weights": {  
          "albumTitle": 1.5,  
          "genre": 5,  
          "artistName": 2  
        }  
      }  
    },  
    {  
      "name": "newAndHighlyRated",  
      "functions": [  
        {  
          "type": "freshness",  
          "fieldName": "lastUpdated",  
          "boost": 10,  
          "interpolation": "quadratic",  
          "freshness": {  
            "boostingDuration": "P365D"  
          }  
        },  
        {
          "type": "magnitude",  
          "fieldName": "rating",  
          "boost": 10,  
          "interpolation": "linear",  
          "magnitude": {  
            "boostingRangeStart": 1,  
            "boostingRangeEnd": 5,  
            "constantBoostBeyondRange": false  
          }  
        }  
      ]  
    }  
  ],  
  "suggesters": [  
    {  
      "name": "sg",  
      "searchMode": "analyzingInfixMatching",  
      "sourceFields": [ "albumTitle", "artistName" ]  
    }  
  ]   
}  

Stappen voor het toevoegen van een scoreprofiel

Als u aangepast scoregedrag wilt implementeren, voegt u een scoreprofiel toe aan het schema dat de index definieert. U kunt maximaal 100 scoreprofielen binnen een index hebben (zie Servicelimieten), maar u kunt slechts één profiel tegelijk opgeven in een bepaalde query.

1. Begin met een indexdefinitie. U kunt scoreprofielen aan een bestaande index toevoegen en bijwerken zonder dat u deze opnieuw moet bouwen. Gebruik een update-indexaanvraag om uw revisie te posten.

2. Plak de sjabloon in dit onderwerp.

3. Geef een naam op. Scoreprofielen zijn optioneel, maar als u er een toevoegt, is de naam vereist. Zorg ervoor dat u Cognitive Search voor velden volgt (begint met een letter, vermijdt speciale tekens en gereserveerde woorden).

4. Geef boostingcriteria op. Eén profiel kan gewogen velden, functiesof beide bevatten.

U moet iteratief werken met behulp van een gegevensset die u helpt om de slechtheid van een bepaald profiel te bewijzen of weer te geven.

Scoreprofielen kunnen worden gedefinieerd in Azure Portal zoals wordt weergegeven in de volgende schermopname, of programmatisch via REST API's of in Azure SDK's, zoals de klasse ScoringProfile in de Azure SDK voor .NET.

Gewogen velden gebruiken

Gebruik gewogen velden wanneer veldcontext belangrijk is en query's zoeken in volledige tekst (ook wel vrije tekst zoeken genoemd). Als een query bijvoorbeeld de term 'luchthaven' bevat, wilt u mogelijk dat 'luchthaven' in het veld Beschrijving meer gewicht heeft dan in hotelnaam.

Gewogen velden bestaan uit een doorzoekbaar veld en een positief getal dat wordt gebruikt als vermenigvuldiger. Als de oorspronkelijke veldscore van HotelName 3 is, wordt de boosted score voor dat veld 6, wat bijdraagt aan een hogere algemene score voor het bovenliggende document zelf.

"scoringProfiles": [  
{  
  "name": "boostKeywords",  
  "text": {  
    "weights": {  
      "HotelName": 2,  
      "Description": 5 
    }  
  }  
}

Functies gebruiken

Gebruik functies wanneer eenvoudige relatieve gewichten onvoldoende zijn of niet van toepassing zijn, zoals bij afstand en nieuwheid. Dit zijn berekeningen van numerieke gegevens. U kunt meerdere functies per scoreprofiel opgeven.

Regels voor het gebruik van functies

• Functies kunnen alleen worden toegepast op velden die zijn toegewezen als filterbaar.
• Functietype ('nieuwheid', 'magnitude', 'afstand', 'tag') moet in kleine gevallen zijn.
• Functies kunnen geen null- of lege waarden bevatten.

Sjabloon

In deze sectie ziet u de syntaxis en sjabloon voor scoreprofielen. Raadpleeg Naslaginformatie over eigenschappen in de volgende sectie voor beschrijvingen van de kenmerken van het scoreprofiel.

"scoringProfiles": [  
  {   
    "name": "name of scoring profile",   
    "text": (optional, only applies to searchable fields) {   
      "weights": {   
        "searchable_field_name": relative_weight_value (positive #'s),   
        ...   
      }   
    },   
    "functions": (optional) [  
      {   
        "type": "magnitude | freshness | distance | tag",   
        "boost": # (positive number used as multiplier for raw score != 1),   
        "fieldName": "(...)",   
        "interpolation": "constant | linear (default) | quadratic | logarithmic",   

        "magnitude": {
          "boostingRangeStart": #,   
          "boostingRangeEnd": #,   
          "constantBoostBeyondRange": true | false (default)
        }  

        // ( - or -)  

        "freshness": {
          "boostingDuration": "..." (value representing timespan over which boosting occurs)   
        }  

        // ( - or -)  

        "distance": {
          "referencePointParameter": "...", (parameter to be passed in queries to use as reference location)   
          "boostingDistance": # (the distance in kilometers from the reference location where the boosting range ends)   
        }   

        // ( - or -)  

        "tag": {
          "tagsParameter":  "..."(parameter to be passed in queries to specify a list of tags to compare against target field)   
        }
      }
    ],   
    "functionAggregation": (optional, applies only when functions are specified) "sum (default) | average | minimum | maximum | firstMatching"   
  }   
],   
"defaultScoringProfile": (optional) "...", 

Verwijzing naar eigenschappen

Interpolaties instellen

Met interpolaties kunt u de vorm instellen van de helling die wordt gebruikt voor scoren. Omdat scoren van hoog naar laag is, neemt de helling altijd af, maar de interpolatie bepaalt de curve van de omlaage helling. De volgende interpolaties kunnen worden gebruikt:

BoostingDuration instellen

boostingDuration is een kenmerk van de freshness functie . U gebruikt dit om een verloopperiode in te stellen waarna het boosten voor een bepaald document stopt. Als u bijvoorbeeld een productlijn of merk wilt boosten voor een actieperiode van 10 dagen, geeft u de periode van 10 dagen op als 'P10D' voor deze documenten.

boostingDuration moet worden opgemaakt als een XSD-waarde 'dayTimeDuration' (een beperkte subset van een ISO 8601-duurwaarde). Het patroon hiervoor is: "P[nD][T[nH][nM][nS]]".

De volgende tabel bevat verschillende voorbeelden.

Zie XML Schema: Datatypes (W3.org website) voor meer voorbeelden.

Zie ook

• Rangschikking van overeenkomsten en scoren in Azure Cognitive Search
• REST API referentie
• Index-API maken
• Azure Cognitive Search .NET SDK
• Wat zijn scoreprofielen?