Konfigurace sémantického rankeru a vrácení titulků ve výsledcích hledání

Sémantické řazení iteruje nad počáteční sadou výsledků a používá metodologii řazení L2, která podporuje nejvíce sémanticky relevantních výsledků na začátek zásobníku. Můžete také získat sémantické titulky s nejdůležitějšími termíny a frázemi a sémantické odpovědi.

Tento článek vysvětluje, jak nakonfigurovat index vyhledávání pro sémantické reranking.

Poznámka:

Pokud máte existující kód, který volá verzi Preview nebo předchozí verze rozhraní API, nápovědu k úpravě kódu najdete v tématu Migrace sémantického kódu řazení.

Požadavky

• Vyhledávací služba na úrovni Basic nebo vyšší, v závislosti na dostupnosti oblastí.

• Sémantický ranker povolený ve vyhledávací službě.

• Existující index vyhledávání s obsahem rtf. Sémantické řazení se vztahuje na pole řetězců (nevector) a funguje nejlépe na obsahu, který je informativní nebo popisný.

Volba klienta

Sémantickou konfiguraci můžete zadat u nových nebo existujících indexů pomocí některého z následujících nástrojů a sad SDK pro přidání sémantické konfigurace:

• Azure Portal s použitím návrháře indexu přidejte sémantickou konfiguraci.
• Visual Studio Code s klientem REST a rozhraním REST API pro vytvoření nebo aktualizaci indexu (REST).
• Azure SDK pro .NET
• Azure SDK pro Python
• Azure SDK pro Javu
• Azure SDK pro JavaScript

Přidání sémantické konfigurace

Sémantická konfigurace je oddíl v indexu, který vytváří vstupy polí pro sémantické řazení. Sémantickou konfiguraci můžete kdykoli přidat nebo aktualizovat bez nutnosti opětovného sestavení. Pokud vytváříte více konfigurací, můžete zadat výchozí nastavení. V době dotazu zadejte pro požadavek dotazu sémantickou konfiguraci nebo ponechte prázdnou hodnotu, aby se použila výchozí hodnota.

Sémantická konfigurace má název a následující vlastnosti:

Vlastnost	Charakteristiky
Pole Název	Krátký řetězec, ideálně pod 25 slovy. Toto pole může být název dokumentu, název produktu nebo jedinečný identifikátor. Pokud nemáte vhodné pole, nechte ho prázdné.
Pole obsahu	Delší bloky textu ve formě přirozeného jazyka, které podléhají maximálním limitům zadávání tokenů v modelech strojového učení. Mezi běžné příklady patří text dokumentu, popis produktu nebo jiný volný text.
Pole klíčových slov	Seznam klíčových slov, jako jsou značky v dokumentu nebo popisný termín, například kategorie položky.

Můžete zadat pouze jedno pole názvu, ale můžete mít tolik polí obsahu a klíčových slov, kolik chcete. U polí obsahu a klíčových slov vypište pole v pořadí priority, protože pole s nižší prioritou se můžou zkrátit.

Ve všech sémantických vlastnostech konfigurace musí být pole, která přiřadíte, následující:

• Atribut as searchable a retrievable
• Řetězce typu Edm.String, Collection(Edm.String), podpole řetězců Edm.ComplexType

Azure Portal

1. Přihlaste se k webu Azure Portal a přejděte do vyhledávací služby, která má povolené sémantické řazení.

2. V části Indexy v levém navigačním podokně vyberte index.

3. Vyberte Sémantické konfigurace a pak vyberte Přidat sémantickou konfiguraci.

   

4. Na stránce Nová sémantická konfigurace zadejte sémantický název konfigurace a vyberte pole, která se mají použít v sémantické konfiguraci. Nárok mají pouze prohledávatelná a načístelná pole řetězců. Nezapomeňte vypsat pole obsahu a pole klíčových slov v pořadí priority.

   

5. Výběrem možnosti Uložit uložte nastavení konfigurace.

6. Opětovným výběrem možnosti Uložit na stránce indexu uložte sémantickou konfiguraci v indexu.

REST API

1. Formulujte žádost o vytvoření nebo aktualizaci indexu.

2. Přidejte do definice indexu sémantickou konfiguraci, třeba za scoringProfiles nebo suggesters. Zadání výchozí hodnoty je volitelné, ale užitečné, pokud máte více než jednu konfiguraci.

   "semantic": {
       "defaultConfiguration": "my-semantic-config-default",
       "configurations": [
           {
               "name": "my-semantic-config-default",
               "prioritizedFields": {
                   "titleField": {
                       "fieldName": "HotelName"
                   },
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ],
                   "prioritizedKeywordsFields": [
                       {
                           "fieldName": "Tags"
                       }
                   ]
               }
           },
                       {
               "name": "my-semantic-config-desc-only",
               "prioritizedFields": {
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ]
               }
           }
       ]
   }
   

.NET SDK

Použijte třídu SemanticConfiguration v sadě Azure SDK pro .NET.

Následující příklad pochází z sémantické ukázky řazení vytvořené týmem sady Azure SDK.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Další kroky

Otestujte sémantickou konfiguraci spuštěním sémantického dotazu.

Vytvoření sémantického dotazu