Een semantische query maken in Azure AI Search

In dit artikel leert u hoe u een semantische rangschikking aanroept boven een resultatenset, waardoor de meest semantisch relevante resultaten boven aan de stapel worden gepromoot. U kunt ook semantische onderschrift s krijgen, met hoogtepunten over de meest relevante termen en woordgroepen en semantische antwoorden.

Vereisten

• Een zoekservice, Basic-laag of hoger, met semantische rangschikking.

• Een bestaande zoekindex met een semantische configuratie en inhoud voor tekst met opmaak.

• Controleer de semantische rangschikking als u een inleiding tot de functie nodig hebt.

Notitie

Bijschriften en antwoorden worden letterlijk geëxtraheerd uit tekst in het zoekdocument. Het semantische subsysteem maakt gebruik van leesbegrip van machines om inhoud te herkennen die de kenmerken van een onderschrift of antwoord heeft, maar geen nieuwe zinnen of woordgroepen opstelt. Daarom werkt inhoud met uitleg of definities het beste voor semantische rangschikking. Zie Rag (Retrieval Augmented Generation) als u interactie in chatstijl met gegenereerde antwoorden wilt.

Een client kiezen

Kies een zoekclient die ondersteuning biedt voor semantische classificatie. Hieronder volgen een aantal opties:

• Azure Portal met behulp van de indexontwerper om een semantische configuratie toe te voegen.
• Visual Studio Code met een REST-client
• Azure-SDK voor .NET
• Azure-SDK voor Python
• Azure SDK voor Java
• Azure SDK voor JavaScript

Vermijd functies die relevantiescores omzeilen

Verschillende querymogelijkheden in Azure AI Search omzeilen relevantiescores of zijn anders niet compatibel met semantische classificatie. Als uw querylogica de volgende functies bevat, kunt u uw resultaten niet semantisch rangschikken:

• Een query met search=* of een lege zoekreeks, zoals een pure filterquery, werkt niet omdat er niets is om de semantische relevantie te meten. De query moet termen of woordgroepen bevatten die tijdens de verwerking kunnen worden beoordeeld.

• Een query die is samengesteld in de volledige Lucene-syntaxis (queryType=full) is niet compatibel met semantische rangschikking (queryType=semantic). Het semantische model biedt geen ondersteuning voor de volledige Lucene-syntaxis.

• Als u sorteert (orderBy-componenten) voor specifieke velden, worden zoekscores en een semantische score overschreven. Aangezien de semantische score de classificatie moet leveren, resulteert het toevoegen van een orderby-component in een HTTP 400-fout als u semantische classificatie toepast op geordende resultaten.

De query instellen

Voeg in deze stap parameters toe aan de queryaanvraag. Als u wilt slagen, moet uw query zoeken in volledige tekst (met behulp van de search parameter om een tekenreeks door te geven) en moet de index tekstvelden bevatten met uitgebreide semantische inhoud en een semantische configuratie.

Azure-portal

Search Explorer bevat opties voor semantische rangschikking.

1. Meld u aan bij het Azure-portaal.

2. Open een zoekindex en selecteer Search Explorer.

3. Selecteer Queryopties. Als u al een semantische configuratie hebt gedefinieerd, wordt deze standaard geselecteerd. Als u er nog geen hebt, maakt u een semantische configuratie voor uw index.

   

4. Voer een query in, zoals 'historisch hotel met goed eten' en selecteer Zoeken.

5. U kunt ook JSON-weergave selecteren en definities in de query-editor plakken:

   

   Hier volgt een aantal JSON-tekst die u in de weergave kunt plakken:

    {
        "queryType": "semantic",
        "search": "historic hotel with good food",
        "semanticConfiguration": "my-semantic-config",
        "answers": "extractive|count-3",
        "captions": "extractive|highlight-true",
        "highlightPreTag": "<strong>",
        "highlightPostTag": "</strong>",
        "select": "HotelId,HotelName,Description,Category",
        "count": true
    }
   

REST API

Gebruik Zoekdocumenten om de aanvraag te formuleren.

Een antwoord bevat automatisch een @search.rerankerScore . Als u onderschrift of antwoorden in het antwoord wilt, voegt u onderschrift s en antwoorden toe aan de aanvraag.

In het volgende voorbeeld in deze sectie wordt de hotels-sample-index gebruikt om semantische rangschikking te demonstreren met semantische antwoorden en onderschrift s.

1. Plak de volgende aanvraag in een webclient als sjabloon. Vervang de servicenaam en indexnaam door geldige waarden.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2023-11-01      
   {
       "queryType": "semantic",
       "search": "newer hotel near the water with a great restaurant",
       "semanticConfiguration": "my-semantic-config",
       "answers": "extractive|count-3",
       "captions": "extractive|highlight-true",
       "highlightPreTag": "<strong>",
       "highlightPostTag": "</strong>",
       "select": "HotelId,HotelName,Description,Category",
       "count": true
   }
   

2. Stel 'queryType' in op 'semantisch'.

   In andere query's wordt het 'queryType' gebruikt om de queryparser op te geven. In semantische rangschikking wordt deze ingesteld op 'semantisch'. Voor het veld 'zoeken' kunt u query's opgeven die voldoen aan de eenvoudige syntaxis.

3. Stel 'zoeken' in op een zoekopdracht in volledige tekst op basis van de eenvoudige syntaxis. Semantische classificatie is een uitbreiding van zoeken in volledige tekst, dus hoewel deze parameter niet vereist is, krijgt u geen verwacht resultaat als deze null is.

4. Stel 'semanticConfiguration' in op een vooraf gedefinieerde semantische configuratie die is ingesloten in uw index.

5. Stel antwoorden in om op te geven of semantische antwoorden worden opgenomen in het resultaat. Momenteel is extractivede enige geldige waarde voor deze parameter. Antwoorden kunnen worden geconfigureerd om maximaal 10 te retourneren. De standaardwaarde is er een. In dit voorbeeld ziet u een telling van drie antwoorden: extractive|count-3.

   Antwoorden worden niet gegarandeerd op elke aanvraag. Als u een antwoord wilt krijgen, moet de query eruitzien als een vraag en moet de inhoud tekst bevatten die eruitziet als een antwoord.

6. Stel 'onderschrift s' in om op te geven of semantische onderschrift s zijn opgenomen in het resultaat. Momenteel is extractivede enige geldige waarde voor deze parameter. Bijschriften kunnen worden geconfigureerd om resultaten te retourneren met of zonder markeringen. De standaardwaarde is dat markeringen worden geretourneerd. In dit voorbeeld worden onderschrift s zonder markeringen geretourneerd: extractive|highlight-false.

   De basis voor onderschrift s en antwoorden zijn de velden waarnaar wordt verwezen in de 'semanticConfiguration'. Deze velden liggen onder een gecombineerde limiet in het bereik van 20.000 tokens of ongeveer 20.000 tekens. Als u verwacht dat een tokenaantal deze limiet overschrijdt, kunt u een stap voor het segmenteren van gegevens overwegen met behulp van de vaardigheid Tekst splitsen. Deze benadering introduceert een afhankelijkheid van een AI-verrijkingspijplijn en indexeerfuncties.

7. Stel 'highlightPreTag' en 'highlightPostTag' in als u de standaardopmaak voor markeringen wilt overschrijven die wordt toegepast op onderschrift s.

   Bijschriften passen markeringsopmaak toe op belangrijke passages in het document waarin het antwoord wordt samengevat. De standaardwaarde is <em>. Als u het type opmaak wilt opgeven (bijvoorbeeld gele achtergrond), kunt u de highlightPreTag en highlightPostTag instellen.

8. Stel 'select' in om op te geven welke velden worden geretourneerd in het antwoord en aantal om het aantal overeenkomsten in de index te retourneren. Deze parameters verbeteren de kwaliteit van de aanvraag en leesbaarheid van het antwoord.

9. Verzend de aanvraag om de query uit te voeren en retourneer resultaten.

.NET SDK

Gebruik QueryType of SemanticQuery om semantische classificatie aan te roepen voor een semantische query. Het volgende voorbeeld is afkomstig van het Azure SDK-team.

SearchResults<Hotel> response = await searchClient.SearchAsync<Hotel>(
    "Is there any hotel located on the main commercial artery of the city in the heart of New York?",
    new SearchOptions
    {
        SemanticSearch = new()
        {
            SemanticConfigurationName = "my-semantic-config",
            QueryCaption = new(QueryCaptionType.Extractive),
            QueryAnswer = new(QueryAnswerType.Extractive)
        },
        QueryLanguage = QueryLanguage.EnUs,
        QueryType = SearchQueryType.Semantic
    });

int count = 0;
Console.WriteLine($"Semantic Search Results:");

Console.WriteLine($"\nQuery Answer:");
foreach (QueryAnswerResult result in response.SemanticSearch.Answers)
{
    Console.WriteLine($"Answer Highlights: {result.Highlights}");
    Console.WriteLine($"Answer Text: {result.Text}");
}

await foreach (SearchResult<Hotel> result in response.GetResultsAsync())
{
    count++;
    Hotel doc = result.Document;
    Console.WriteLine($"{doc.HotelId}: {doc.HotelName}");

    if (result.SemanticSearch.Captions != null)
    {
        var caption = result.SemanticSearch.Captions.FirstOrDefault();
        if (caption.Highlights != null && caption.Highlights != "")
        {
            Console.WriteLine($"Caption Highlights: {caption.Highlights}");
        }
        else
        {
            Console.WriteLine($"Caption Text: {caption.Text}");
        }
    }
}
Console.WriteLine($"Total number of search results:{count}");

Het antwoord evalueren

Alleen de top 50 overeenkomsten uit de eerste resultaten kunnen semantisch worden gerangschikt. Net als bij alle query's bestaat een antwoord uit alle velden die zijn gemarkeerd als ophaalbaar of alleen die velden die worden vermeld in de selectieparameter. Een antwoord bevat de oorspronkelijke relevantiescore en kan ook een telling of batchresultaten bevatten, afhankelijk van de wijze waarop u de aanvraag hebt geformuleerd.

In semantische rangschikking heeft het antwoord meer elementen: een nieuwe semantisch gerangschikte relevantiescore, een optionele onderschrift in tekst zonder opmaak en met markeringen en een optioneel antwoord. Als uw resultaten deze extra elementen niet bevatten, is uw query mogelijk onjuist geconfigureerd. Als eerste stap voor het oplossen van het probleem controleert u de semantische configuratie om ervoor te zorgen dat deze is opgegeven in zowel de indexdefinitie als de query.

In een client-app kunt u de zoekpagina structuren om een onderschrift op te nemen als de beschrijving van de overeenkomst, in plaats van de volledige inhoud van een specifiek veld. Deze methode is handig wanneer afzonderlijke velden te dicht zijn voor de pagina met zoekresultaten.

Het antwoord voor de bovenstaande voorbeeldquery retourneert de volgende overeenkomst als de bovenste selectie. Bijschriften worden geretourneerd omdat de eigenschap 'onderschrift s' is ingesteld, met tekst zonder opmaak en gemarkeerde versies. Antwoorden worden weggelaten uit het voorbeeld, omdat er geen kan worden bepaald voor deze specifieke query en corpus.

"@odata.count": 35,
"@search.answers": [],
"value": [
    {
        "@search.score": 1.8810667,
        "@search.rerankerScore": 1.1446577133610845,
        "@search.captions": [
            {
                "text": "Oceanside Resort. Luxury. New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
                "highlights": "<strong>Oceanside Resort.</strong> Luxury. New Luxury Hotel. Be the first to stay.<strong> Bay</strong> views from every room, location near the pier, rooftop pool, waterfront dining & more."
            }
        ],
        "HotelName": "Oceanside Resort",
        "Description": "New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
        "Category": "Luxury"
    },
  ...
]

Volgende stappen

Semantische classificatie kan worden gebruikt in hybride query's die trefwoordzoekopdrachten en vectorzoekopdrachten combineren in één aanvraag en een uniform antwoord.

Hybride query met semantische classificatie