Dela via

Lägga till semantisk rangordning i frågor i Azure AI Search

  • Artikel

Du kan använda semantisk rangordning för textfrågor, hybridfrågor och vektorfrågor om dina sökdokument innehåller strängfält och vektorfrågan har en textrepresentation i sökdokumentet.

Den här artikeln beskriver hur du anropar den semantiska rankern i frågor.

Förutsättningar

Kommentar

Bildtexter och svar extraheras ordagrant från text i sökdokumentet. Det semantiska undersystemet använder maskinläsningsförståelse för att identifiera innehåll som har egenskaperna för en bildtext eller ett svar, men skriver inte nya meningar eller fraser. Därför fungerar innehåll som innehåller förklaringar eller definitioner bäst för semantisk rangordning. Om du vill ha chattliknande interaktion med genererade svar kan du läsa Hämtning av utökad generation (RAG).

Välj en klient

Du kan använda något av följande verktyg och SDK:er för att skapa en fråga som använder semantisk rangordning:

Undvik funktioner som kringgår relevansbedömning

Några frågefunktioner kringgår relevansbedömning, vilket gör dem inkompatibla med semantisk rangordning. Om din frågelogik innehåller följande funktioner kan du inte semantiskt rangordna dina resultat:

  • En fråga med search=* eller en tom söksträng, till exempel ren filterfråga, fungerar inte eftersom det inte finns något att mäta semantisk relevans mot och därför är sökpoängen noll. Frågan måste ange termer eller fraser som kan utvärderas under bearbetningen.

  • Sortering (orderBy-satser) på specifika fält åsidosätter sökresultat och en semantisk poäng. Med tanke på att den semantiska poängen ska tillhandahålla rangordningen resulterar det i ett HTTP 400-fel om du tillämpar semantisk rangordning över ordnade resultat genom att lägga till en orderby-sats.

Konfigurera frågan

Som standard använder frågor inte semantisk rangordning. Om du vill använda semantisk rangordning kan två olika parametrar användas. Varje parameter stöder en annan uppsättning scenarier.

Semantiska frågor, oavsett om de anges via search plus queryTypeeller via semanticQuery, måste vara oformaterad text och de får inte vara tomma. Tomma frågor resulterar i att ingen semantisk rangordning tillämpas på resultaten.

Semantisk rankerparameter Oformaterad textsökning Syntax för enkel textsökning Syntax för fulltextsökning Vektorsökning Hybridsökning Semantiska svar och bildtexter
queryType-semantic1 ✅ ❌ ❌ ❌ ✅ ✅
semanticQuery="<your plain text query>"2 ✅ ✅ ✅ ✅ ✅ ✅

1 queryType=semantic kan inte stödja explicita simple värden eller full värden eftersom parametern queryType används för semantic. De effektiva frågebeteendena är standardinställningarna för den enkla parsern.

2 Parametern semanticQuery kan användas för alla frågetyper. Det stöds dock inte i portalen Search Explorer.

Oavsett vilken parameter som valts ska indexet innehålla textfält med omfattande semantiskt innehåll och en semantisk konfiguration.

Sökutforskaren innehåller alternativ för semantisk rangordning. Kom ihåg att du inte kan ange parametern semanticQuery i Azure Portal.

  1. Logga in på Azure-portalen.

  2. Öppna ett sökindex och välj Sökutforskaren.

  3. Välj Frågealternativ. Om du redan har definierat en semantisk konfiguration är den markerad som standard. Om du inte har någon skapar du en semantisk konfiguration för ditt index.

    Skärmbild som visar frågealternativ i Sökutforskaren.

  4. Ange en fråga, till exempel "historiskt hotell med god mat", och välj Sök.

  5. Du kan också välja JSON-vy och klistra in definitioner i frågeredigeraren. Azure Portal stöder inte användning av semanticQuery, så inställningen queryType krävs"semantic":

    Skärmbild som visar JSON-frågesyntax i Azure Portal.

    JSON-exempel för att ange frågetyp till semantisk som du kan klistra in i vyn:

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

Utvärdera svaret

Endast de 50 bästa matchningarna från de första resultaten kan rangordnas semantiskt. Precis som med alla frågor består ett svar av alla fält som markerats som hämtningsbara, eller bara de fält som anges i parametern select . Ett svar innehåller den ursprungliga relevanspoängen och kan även innehålla ett antal eller batchbaserade resultat, beroende på hur du formulerade begäran.

I semantisk rangordning har svaret fler element: en ny semantiskt rangordnad relevanspoäng, en valfri bildtext i oformaterad text och med markeringar och ett valfritt svar. Om dina resultat inte innehåller dessa extra element kan frågan vara felkonfigurerad. Som ett första steg mot att felsöka problemet kontrollerar du den semantiska konfigurationen för att se till att den anges i både indexdefinitionen och frågan.

I en klientapp kan du strukturera söksidan så att den innehåller en beskrivning som matchningsbeskrivning i stället för hela innehållet i ett visst fält. Den här metoden är användbar när enskilda fält är för kompakta för sökresultatsidan.

Svaret på ovanstående exempelfråga ("intressant hotell med restaurang på plats och mysig lobby eller delat område") returnerar tre svar ("answers": "extractive|count-e"). Bildtexter returneras eftersom egenskapen "captions" har angetts, med oformaterad text och markerade versioner. Om ett svar inte kan fastställas utelämnas det från svaret. För korthet visar det här exemplet bara de tre svaren och de tre högsta bedömningsresultaten från frågan.

{
  "@odata.count": 29,
  "@search.answers": [
    {
      "key": "24",
      "text": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "highlights": "Chic hotel near the city. <strong>High-rise hotel in downtown, </strong>within<strong> walking distance to </strong>theaters, art<strong> galleries, restaurants and shops.</strong> Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "score": 0.9340000152587891
    },
    {
      "key": "40",
      "text": "Only 8 miles from Downtown. On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, All non-smoking hotel. Only 15 miles from airport.",
      "highlights": "Only 8 miles from Downtown. <strong>On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, </strong>All non-smoking<strong> hotel.</strong> Only 15 miles from airport.",
      "score": 0.9210000038146973
    },
    {
      "key": "38",
      "text": "Nature is Home on the beach. Explore the shore by day, and then come home to our shared living space to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "highlights": "Nature is Home on the beach. Explore the shore by day, and then come home to our<strong> shared living space </strong>to relax around a stone fireplace, sip something warm, and explore the library by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.",
      "score": 0.9200000166893005
    }
  ],
  "value": [
    {
      "@search.score": 3.2328331,
      "@search.rerankerScore": 2.575303316116333,
      "@search.captions": [
        {
          "text": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our penthouse suites offer views for miles and the rooftop plaza is open to all guests from sunset to 10 p.m. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.",
          "highlights": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our<strong> penthouse </strong>suites offer views for miles and the rooftop<strong> plaza </strong>is open to all guests from sunset to 10 p.m. Enjoy a<strong> complimentary continental breakfast in the lobby, </strong>and free Wi-Fi<strong> throughout </strong>the hotel."
        }
      ],
      "HotelId": "50",
      "HotelName": "Head Wind Resort",
      "Description": "The best of old town hospitality combined with views of the river and cool breezes off the prairie. Our penthouse suites offer views for miles and the rooftop plaza is open to all guests from sunset to 10 p.m. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.",
      "Category": "Suite"
    },
    {
      "@search.score": 0.632956,
      "@search.rerankerScore": 2.5425150394439697,
      "@search.captions": [
        {
          "text": "Every stay starts with a warm cookie. Amenities like the Counting Sheep sleep experience, our Wake-up glorious breakfast buffet and spacious workout facilities await.",
          "highlights": "Every stay starts with a warm cookie. Amenities like the<strong> Counting Sheep sleep experience, </strong>our<strong> Wake-up glorious breakfast buffet and spacious workout facilities </strong>await."
        }
      ],
      "HotelId": "34",
      "HotelName": "Lakefront Captain Inn",
      "Description": "Every stay starts with a warm cookie. Amenities like the Counting Sheep sleep experience, our Wake-up glorious breakfast buffet and spacious workout facilities await.",
      "Category": "Budget"
    },
    {
      "@search.score": 3.7076726,
      "@search.rerankerScore": 2.4554927349090576,
      "@search.captions": [
        {
          "text": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
          "highlights": "Chic hotel near the city. <strong>High-rise hotel in downtown, </strong>within<strong> walking distance to </strong>theaters, art<strong> galleries, restaurants and shops.</strong> Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance."
        }
      ],
      "HotelId": "24",
      "HotelName": "Uptown Chic Hotel",
      "Description": "Chic hotel near the city. High-rise hotel in downtown, within walking distance to theaters, art galleries, restaurants and shops. Visit Seattle Art Museum by day, and then head over to Benaroya Hall to catch the evening's concert performance.",
      "Category": "Suite"
    },
   . . .
  ]
}

Förväntade arbetsbelastningar

För semantisk rangordning bör du förvänta dig att en söktjänst stöder upp till 10 samtidiga frågor per replik.

Tjänsten begränsar semantiska rangordningsbegäranden om volymerna är för höga. Ett felmeddelande som innehåller dessa fraser anger att tjänsten har kapacitet för semantisk rangordning:

Error in search query: Operation returned an invalid status 'Partial Content'`
@search.semanticPartialResponseReason`
CapacityOverloaded

Om du förväntar dig konsekventa dataflödeskrav nära, på eller högre än den här nivån kan du skicka in ett supportärende så att vi kan etablera för din arbetsbelastning.

Nästa steg

Semantisk rangordning kan användas i hybridfrågor som kombinerar nyckelordssökning och vektorsökning i en enda begäran och ett enhetligt svar.

Hybridfråga med semantisk ranker