Vytvoření sémantického dotazu ve službě Azure AI Search

V tomto článku se dozvíte, jak vyvolat sémantické hodnocení nad sadou výsledků a propagovat nejvíce sémanticky relevantních výsledků na začátek zásobníku. Můžete také získat sémantické popis, se zvýrazněnými výrazy a frázemi a sémantické odpovědi.

Požadavky

• Vyhledávací služba, úroveň Basic nebo vyšší sémantické řazení.

• Existující index vyhledávání s sémantickou konfigurací a obsahem ve formátu RTF.

• Pokud potřebujete úvod k této funkci, projděte si sémantické hodnocení .

Poznámka:

Titulky a odpovědi se extrahují doslovně z textu ve vyhledávacím dokumentu. Sémantický subsystém používá strojové čtení k rozpoznávání obsahu, který má vlastnosti popis nebo odpovědi, ale nevytváí nové věty nebo fráze. Z tohoto důvodu je nejvhodnější obsah, který obsahuje vysvětlení nebo definice pro sémantické řazení. Pokud chcete komunikovat ve stylu chatu s vygenerovanými odpověďmi, přečtěte si téma Načítání rozšířené generace (RAG).

Volba klienta

Zvolte klienta vyhledávání, který podporuje sémantické řazení. Zde je uvedeno několik možností:

• Azure Portal s použitím návrháře indexu přidejte sémantickou konfiguraci.
• Visual Studio Code s klientem REST
• Azure SDK pro .NET
• Azure SDK pro Python
• Azure SDK pro Javu
• Azure SDK pro JavaScript

Vyhněte se funkcím, které obcházejí vyhodnocování relevance

Několik možností dotazů ve službě Azure AI Search obchází vyhodnocování relevance nebo je jinak nekompatibilní s sémantickým řazením. Pokud logika dotazu obsahuje následující funkce, nemůžete výsledky seřadit sémanticky:

• Dotaz s hledaným řetězcem nebo prázdným vyhledávacím řetězcem search=* , jako je čistý dotaz jen pro filtr, nebude fungovat, protože neexistuje nic k měření sémantické relevance. Dotaz musí obsahovat termíny nebo fráze, které je možné vyhodnotit během zpracování.

• Dotaz složený z úplné syntaxe Lucene (queryType=full) není kompatibilní s sémantickým řazením (queryType=semantic). Sémantický model nepodporuje úplnou syntaxi Lucene.

• Řazení (klauzule orderBy) u konkrétních polí přepíše skóre hledání a sémantické skóre. Vzhledem k tomu, že sémantické skóre má poskytnout pořadí, přidání klauzule orderby má za následek chybu HTTP 400, pokud použijete sémantické řazení u seřazených výsledků.

Nastavení dotazu

V tomto kroku přidejte do požadavku dotazu parametry. Aby byl dotaz úspěšný, měl by být fulltextové vyhledávání (pomocí parametru search pro předání řetězce) a index by měl obsahovat textová pole s bohatým sémantickým obsahem a sémantickou konfigurací.

Azure Portal

Průzkumník služby Search obsahuje možnosti pro sémantické řazení.

1. Přihlaste se k portálu Azure.

2. Otevřete vyhledávací index a vyberte Průzkumníka služby Search.

3. Vyberte možnosti dotazu. Pokud jste už definovali sémantickou konfiguraci, je ve výchozím nastavení vybraná. Pokud ho nemáte, vytvořte pro svůj index sémantickou konfiguraci .

   

4. Zadejte dotaz, například "historický hotel s dobrým jídlem", a vyberte Hledat.

5. Alternativně vyberte zobrazení JSON a vložte definice do editoru dotazů:

   

   Tady je nějaký text JSON, který můžete vložit do zobrazení:

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

K formulaci požadavku použijte vyhledávací dokumenty .

Odpověď obsahuje @search.rerankerScore automaticky. Pokud chcete v odpovědi popis nebo odpovědi, přidejte do žádosti popis a odpovědi.

Následující příklad v této části používá index hotels-sample-index k předvedení sémantického řazení sémantických odpovědí a popis s.

1. Vložte následující požadavek do webového klienta jako šablonu. Nahraďte název služby a název indexu platnými hodnotami.

   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. Nastavte "queryType" na "sémantic".

   V jiných dotazech se "queryType" používá k určení analyzátoru dotazů. V sémantickém pořadí je nastavená na sémantickou. Pro pole "search" můžete zadat dotazy, které odpovídají jednoduché syntaxi.

3. Nastavte "search" na fulltextový vyhledávací dotaz na základě jednoduché syntaxe. Sémantické řazení je rozšíření fulltextového vyhledávání, takže i když tento parametr není povinný, nezískáte očekávaný výsledek, pokud má hodnotu null.

4. Nastavte sémanticConfiguration na předdefinovanou sémantickou konfiguraci , která je vložená do indexu.

5. Nastavte "odpovědi" a určete, jestli jsou do výsledku zahrnuty sémantické odpovědi . V současné době je jedinou platnou hodnotou tohoto parametru extractive. Odpovědi je možné nakonfigurovat tak, aby vracely maximálně 10. Výchozí hodnota je jedna. Tento příklad ukazuje počet tří odpovědí: extractive|count-3.

   U každého požadavku nejsou zaručeny odpovědi. Pokud chcete získat odpověď, musí dotaz vypadat jako otázka a obsah musí obsahovat text, který vypadá jako odpověď.

6. Nastavte "popis s" a určete, zda jsou do výsledku zahrnuté sémantické popis. V současné době je jedinou platnou hodnotou tohoto parametru extractive. Titulky je možné nakonfigurovat tak, aby vracely výsledky se zvýrazněnými nebo bez nich. Výchozí hodnota je pro vrácení zvýraznění. Tento příklad vrátí popis bez zvýraznění: extractive|highlight-false.

   Základem popis a odpovědí jsou pole odkazovaná v sémantické konfiguraci. Tato pole jsou pod kombinovaným limitem v rozsahu 2 000 tokenů nebo přibližně 20 000 znaků. Pokud předpokládáte, že počet tokenů překročí tento limit, zvažte krok dělení dat pomocí dovednosti Rozdělení textu. Tento přístup představuje závislost na kanálu rozšiřování AI a indexerech.

7. Pokud chcete přepsat výchozí formátování zvýraznění použité pro popis, nastavte "highlightPreTag" a "highlightPostTag".

   Titulky používají formátování zvýraznění u klíčových pasáží v dokumentu, které shrnují odpověď. Výchozí hodnota je <em>. Pokud chcete zadat typ formátování (například žluté pozadí), můžete nastavit zvýrazněníPreTag a zvýrazněníPostTag.

8. Nastavte "select" a určete, která pole se vrátí v odpovědi, a "count" pro vrácení počtu shod v indexu. Tyto parametry zlepšují kvalitu požadavku a čitelnosti odpovědi.

9. Odešlete žádost o provedení dotazu a vrátí výsledky.

.NET SDK

K vyvolání sémantického řazení v sémantickém dotazu použijte QueryType nebo SémanticQuery. Následující příklad je od týmu sady Azure SDK.

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

Vyhodnocení odpovědi

Pouze prvních 50 shod z počátečních výsledků může být sémanticky seřazeno. Stejně jako u všechdotazůch Odpověď zahrnuje původní skóre relevance a může také obsahovat počet nebo dávkové výsledky v závislosti na tom, jak jste žádost formulovali.

V sémantickém řazení má odpověď více prvků: nové sémanticky seřazené skóre relevance, volitelné popis v prostém textu a zvýraznění a volitelnou odpověď. Pokud vaše výsledky neobsahují tyto nadbytečné prvky, může být váš dotaz nesprávně nakonfigurovaný. Jako první krok k řešení potíží zkontrolujte sémantickou konfiguraci a ujistěte se, že je zadaná v definici indexu i dotazu.

V klientské aplikaci můžete vytvořit strukturu vyhledávací stránky tak, aby obsahovala popis jako popis shody, a ne celý obsah konkrétního pole. Tento přístup je užitečný, když jsou jednotlivá pole pro stránku výsledků hledání příliš hustá.

Odpověď pro výše uvedený příklad dotazu vrátí následující shodu jako horní výběr. Titulky jsou vráceny, protože vlastnost "popis s" je nastavena, s prostým textem a zvýrazněnými verzemi. Odpovědi jsou z příkladu vynechány, protože nebylo možné určit pro tento konkrétní dotaz a korpus.

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

Další kroky

Sémantické řazení lze použít v hybridních dotazech, které kombinují vyhledávání klíčových slov a vektorové vyhledávání do jednoho požadavku a jednotné odpovědi.

Hybridní dotaz s sémantickým řazením