Szemantikai rangsorolás hozzáadása lekérdezésekhez az Azure AI Searchben

Ez a cikk bemutatja, hogyan hívhatja meg a szemantikai rangsorolót a lekérdezéseken. A szemantikai rangsorolást szöveges lekérdezésekre, hibrid lekérdezésekre és vektoros lekérdezésekre is alkalmazhatja, ha a keresési dokumentumok sztringmezőket tartalmaznak, és a vektoros lekérdezés szöveges ábrázolású.

A szemantikai rangsor egy kezdeti eredményhalmazon keresztül iterál, és egy L2 rangsorolási módszertant alkalmaz, amely a legszembetűnőbb eredményeket segíti elő a verem tetejére. Szemantikai feliratokat is kaphat, kiemelve a legrelevánsabb kifejezéseket és kifejezéseket, valamint szemantikai válaszokat.

Előfeltételek

• Egy alapszintű vagy magasabb szintű keresési szolgáltatás, amelyen engedélyezve van a szemantikai rangsorolás.

• Meglévő keresési index szemantikai konfigurációval és rich text tartalommal.

• Tekintse át a szemantikai rangsorolást , ha be kell ismerkednie a funkcióval.

Feljegyzés

A feliratok és válaszok szó szerint kinyerhetők a keresődokumentum szövegéből. A szemantikai alrendszer gépi olvasási megértéssel ismeri fel a felirat vagy válasz jellemzőivel rendelkező tartalmakat, de nem ír új mondatokat vagy kifejezéseket. Ezért a magyarázatokat vagy definíciókat tartalmazó tartalom a szemantikai rangsorolás szempontjából a legjobban működik. Ha csevegőstílusú interakciót szeretne a generált válaszokkal, olvassa el a Bővített generáció lekérése (RAG) című témakört.

Ügyfél kiválasztása

Az alábbi eszközök és SDK-k bármelyikével létrehozhat egy szemantikai rangsorolást használó lekérdezést:

• Az Azure Portalon az indextervezővel adhat hozzá szemantikai konfigurációt.
• Visual Studio Code REST-ügyféllel
• Azure SDK for .NET
• Pythonhoz készült Azure SDK
• Javához készült Azure SDK
• Azure SDK for JavaScript

Kerülje a relevanciapontozást megkerülő funkciókat

Néhány lekérdezési képesség megkerüli a relevanciapontozást, ami miatt nem kompatibilisek a szemantikai rangsorolással. Ha a lekérdezési logika a következő funkciókat tartalmazza, nem rangsorolhatja az eredményeket szemantikailag:

• Az üres keresési sztringet search=* tartalmazó vagy üres lekérdezések, például a csak szűrős lekérdezések nem működnek, mert nincs semmi a szemantikai relevancia mérésére, így a keresési pontszámok nullák. A lekérdezésnek olyan kifejezéseket vagy kifejezéseket kell megadnia, amelyek kiértékelhetők a feldolgozás során.

• Az adott mezők rendezése (orderBy záradékok) felülbírálják a keresési pontszámokat és a szemantikai pontszámokat. Tekintettel arra, hogy a szemantikai pontszámnak meg kell adnia a rangsort, az orderby záradék hozzáadása HTTP 400-es hibát eredményez, ha szemantikai rangsorolást alkalmaz a rendezett eredményekre.

A lekérdezés beállítása

Ebben a lépésben adjon hozzá paramétereket a lekérdezési kérelemhez. A sikeresség érdekében a lekérdezésnek teljes szöveges keresésnek kell lennie (a search paraméterrel sztringet kell megadnia), és az indexnek gazdag szemantikai tartalommal és szemantikai konfigurációval rendelkező szövegmezőket kell tartalmaznia.

Azure Portalra

A Keresőböngésző a szemantikai rangsorolási lehetőségeket tartalmazza.

1. Jelentkezzen be az Azure Portalra.

2. Nyisson meg egy keresési indexet, és válassza a Kereséskezelő lehetőséget.

3. Válassza a Lekérdezési beállítások lehetőséget. Ha már definiált szemantikai konfigurációt, az alapértelmezés szerint ki van választva. Ha nem rendelkezik ilyennel, hozzon létre egy szemantikai konfigurációt az indexhez.

   

4. Adjon meg egy lekérdezést, például "történelmi szálloda jó ételekkel", és válassza a Keresés lehetőséget.

5. Másik lehetőségként válassza a JSON-nézetet, és illessze be a definíciókat a lekérdezésszerkesztőbe:

   

   Íme néhány JSON-szöveg, amelyet beilleszthet a nézetbe:

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

A kérés megfogalmazásához használja a Keresési dokumentumok parancsot .

A válasz automatikusan tartalmazza @search.rerankerScore a választ. Ha feliratokat vagy válaszokat szeretne a válaszban, adjon hozzá feliratokat és válaszokat a kéréshez.

Az alábbi példa ebben a szakaszban a hotels-sample-index használatával mutatja be a szemantikai rangsorolást szemantikai válaszokkal és feliratokkal.

1. Illessze be a következő kérést egy webügyfélbe sablonként. Cserélje le a szolgáltatásnevet és az indexnevet érvényes értékekre.

   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. Állítsa a "queryType" értékét "szemantikai" értékre.

3. A "keresés" beállítása teljes szöveges keresési lekérdezésre. A keresési sztring támogatja az egyszerű vagy a teljes Lucene szintaxist. A szemantikus rangsorolás a teljes szöveges keresés kiterjesztése, így bár a "keresés" nem kötelező, nem fog várható eredményt kapni, ha üres keresésről van szó ("search": "*").

4. Állítsa a "szemanticConfiguration" beállítást egy előre definiált szemantikai konfigurációra , amely az indexbe van ágyazva.

5. A "válaszok" beállításával megadhatja, hogy a szemantikai válaszok szerepeljenek-e az eredményben. Jelenleg a paraméter egyetlen érvényes értéke az extractive. A válaszok legfeljebb 10-et adhatnak vissza. Az alapértelmezett érték az egyik. Ez a példa három válaszból áll: extractive|count-3.

   A válaszok nem minden kérés esetén garantáltak. A válaszhoz a lekérdezésnek kérdésként kell kinéznie, a tartalomnak pedig válasznak tűnő szöveget kell tartalmaznia.

6. A "feliratok" beállításával megadhatja, hogy a szemantikai feliratok szerepeljenek-e az eredményben. Jelenleg a paraméter egyetlen érvényes értéke az extractive. A feliratok úgy konfigurálhatók, hogy kiemelésekkel vagy anélkül is visszaadják az eredményeket. Az alapértelmezett érték a kiemelések visszaadása. Ez a példa a következő kiemelések nélküli feliratokat adja vissza: extractive|highlight-false.

   A feliratok és válaszok alapja a "szemanticConfiguration" mezőben hivatkozott mezők. Ezek a mezők 2000 token vagy körülbelül 20 000 karakter együttes korlátja alatt vannak. Ha a jogkivonatok száma meghaladja ezt a korlátot, fontolja meg az adatbeosztási lépést a Szöveg felosztása képesség használatával. Ez a megközelítés függőséget vezet be az AI-bővítési folyamattól és az indexelőkhöz.

7. Állítsa be a "highlightPreTag" és a "highlightPostTag" értéket, ha felül szeretné bírálni a feliratokra alkalmazott alapértelmezett kiemelési formázást.

   A feliratok a válasz összegzését tartalmazó dokumentum kulcsszakaszai fölé emelik a kiemelési formázást. Az alapértelmezett érték <em>. Ha meg szeretné adni a formázás típusát (például sárga háttér), beállíthatja a highlightPreTag és highlightPostTag értéket.

8. A "kiválasztás" beállításával adja meg, hogy mely mezők lesznek visszaadva a válaszban, a "darabszám" pedig az indexben lévő egyezések számát adja vissza. Ezek a paraméterek javítják a kérés minőségét és a válasz olvashatóságát.

9. Küldje el a kérést a lekérdezés végrehajtására és az eredmények visszaadására.

.NET SDK

A QueryType vagy a SzemanticQuery használatával meghívhatja a szemantikai rangsorolást egy szemantikai lekérdezésen. Az alábbi példa az Azure SDK csapatától származik.

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

A válasz kiértékelése

A kezdeti eredmények közül csak az első 50 találat lehet szemantikailag rangsorolva. Mint minden lekérdezés esetében, a válasz az összes beolvashatóként megjelölt mezőből, vagy csak a kiválasztási paraméterben felsorolt mezőkből áll. A válasz tartalmazza az eredeti relevanciapontot, és a kérés megfogalmazásától függően számmal vagy kötegelt eredményekkel is járhat.

A szemantikai rangsorban a válasz több elemből áll: egy új szemantikailag rangsorolt relevanciapont, egy választható felirat egyszerű szövegben és kiemelésekkel, valamint opcionális válasz. Ha az eredmények nem tartalmazzák ezeket a további elemeket, előfordulhat, hogy a lekérdezés helytelenül van konfigurálva. A probléma elhárításának első lépéseként ellenőrizze a szemantikai konfigurációt, hogy az az indexdefinícióban és a lekérdezésben is meg legyen adva.

Egy ügyfélalkalmazásban úgy strukturálhatja a keresési oldalt, hogy egy adott mező teljes tartalma helyett egy feliratot adjon meg az egyezés leírásaként. Ez a módszer akkor hasznos, ha az egyes mezők túl sűrűk a keresési eredmények oldalához.

A fenti példa lekérdezésre adott válasz a következő egyezést adja vissza a legjobb választásként. A feliratok azért jelennek meg, mert a "captions" tulajdonság be van állítva, egyszerű szöveggel és kiemelt verziókkal. A válaszok kimaradnak a példából, mert nem sikerült meghatározni az adott lekérdezést és korpuszt.

"@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"
    },
  ...
]

Várható számítási feladatok

A szemantikai rangsoroláshoz egy keresési szolgáltatásnak replikánként legfeljebb 10 egyidejű lekérdezést kell támogatnia.

A szolgáltatás szabályozza a szemantikai rangsorolási kérelmeket, ha a kötetek túl magasak. Az alábbi kifejezéseket tartalmazó hibaüzenet azt jelzi, hogy a szolgáltatás alkalmas a szemantikai rangsorolásra:

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

Ha konzisztens átviteli követelményeket vár ezen a szinten, vagy annál magasabb szinten, küldjön egy támogatási jegyet, hogy kiéphessük a számítási feladatát.

Következő lépések

A szemantikai rangsorolás olyan hibrid lekérdezésekben használható, amelyek a kulcsszókeresést és a vektorkeresést egyetlen kérelemben és egységes válaszban egyesítik.

Hibrid lekérdezés szemantikai rangsorolással