Szemantikai lekérdezés létrehozása az Azure AI Searchben

Ebben a cikkben megtudhatja, hogyan hívhat meg szemantikai rangsort egy eredményhalmazon, és hogyan népszerűsítheti a szemantikailag releváns eredményeket a verem tetejére. Szemantikai képaláírás is kaphat, kiemelve a legrelevánsabb kifejezéseket és kifejezéseket, valamint szemantikai válaszokat.

Előfeltételek

• Alapszintű vagy magasabb szintű keresési szolgáltatás szemantikai rangsorolással.

• 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 képaláírás 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

Válasszon egy keresési ügyfelet, amely támogatja a szemantikai rangsorolást. Íme néhány lehetőség:

• 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

Az Azure AI Search számos lekérdezési képessége megkerüli a relevanciapontozást, vagy más módon nem kompatibilis 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űrt lekérdezések nem működnek, mert nincs semmi, amellyel mérni lehet a szemantikai relevanciát. A lekérdezésnek olyan kifejezéseket vagy kifejezéseket kell megadnia, amelyek kiértékelhetők a feldolgozás során.

• A teljes Lucene-szintaxisban (queryType=full) álló lekérdezés nem kompatibilis a szemantikai rangsorolással (queryType=semantic). A szemantikai modell nem támogatja a teljes Lucene szintaxist.

• 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 képaláírás vagy választ szeretne a válaszban, adjon hozzá képaláírás é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 képaláírás.

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.

   Más lekérdezésekben a "queryType" a lekérdezéselemző megadására szolgál. A szemantikai rangsorban "szemantikai" értékre van állítva. A "keresés" mezőben megadhatja az egyszerű szintaxisnak megfelelő lekérdezéseket.

3. Állítsa be a "keresés" szót egy teljes szöveges keresési lekérdezésre az egyszerű szintaxis alapján. A szemantikai rangsorolás a teljes szöveges keresés kiterjesztése, így bár ez a paraméter nem szükséges, nem fog várható eredményt kapni, ha null értékű.

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 "képaláírás" beállításával megadhatja, hogy a szemantikai képaláírás szerepel-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 képaláírás ad vissza kiemelések nélkül: extractive|highlight-false.

   A képaláírás és a 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. Ha felül szeretné bírálni a képaláírás alapértelmezett kiemelési formázását, állítsa be a "highlightPreTag" és a "highlightPostTag" beállítá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ó képaláírás 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őlapot, hogy egy adott mező teljes tartalma helyett egy képaláírás szerepeljen 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 "képaláírás s" 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"
    },
  ...
]

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