Tvarování výsledků hledání nebo úprava složení výsledků hledání ve službě Azure AI Vyhledávač

Tento článek vysvětluje složení výsledků hledání a způsob tvarování fulltextových výsledků hledání tak, aby odpovídaly vašim scénářům. Výsledky hledání se vrátí v odpovědi dotazu. Tvar odpovědi je určen parametry v samotném dotazu. Mezi tyto parametry patří:

• Počet shod nalezených v indexu (count)
• Počet shod vrácených v odpovědi (ve výchozím nastavení 50, konfigurovatelný prostřednictvím top) nebo na stránku (skip a top)
• Skóre hledání pro každý výsledek, které se používá pro řazení (@search.score)
• Pole zahrnutá ve výsledcích hledání (select)
• Logika řazení (orderby)
• Zvýraznění termínů v rámci výsledku, které odpovídá celému nebo částečnému termínu v textu
• Volitelné prvky ze sémantického rankeru (answers v horní části, captions pro každé použití)

Výsledky hledání můžou obsahovat pole nejvyšší úrovně, ale většina odpovědí se skládá z odpovídajících dokumentů v poli.

Klienti a rozhraní API pro definování odpovědi dotazu

Ke konfiguraci odpovědi dotazu můžete použít následující klienty:

• Search Explorer v Azure portálu pomocí zobrazení JSON pro zadání jakéhokoliv podporovaného parametru
• Dokumenty – POST (REST API)
• Metoda SearchClient.Search (Azure SDK pro .NET)
• SearchClient.Search – metoda (Azure SDK pro Python)
• SearchClient.Search – funkce (Azure pro JavaScript)
• Metoda SearchClient.Search v Azure pro Javu

Složení výsledků

Výsledky jsou většinou tabulkové, složené z polí všech retrievable polí, nebo jsou omezeny pouze na tato pole zadaná v parametru select . Řádky jsou odpovídající dokumenty, obvykle seřazené v pořadí podle relevance, pokud logika dotazu nebrání řazení podle relevance.

Můžete zvolit, která pole budou ve výsledcích hledání. Zatímco vyhledávací dokument může mít velký počet polí, obvykle je jich potřeba jen několik k reprezentaci každého dokumentu ve výsledcích. V požadavku dotazu připojte select=<field list> , abyste určili, která retrievable pole se mají v odpovědi zobrazit.

Vyberte pole, která nabízejí kontrast a odlišení mezi dokumenty a poskytují dostatek informací, které podnítí uživatele k prokliknutí. Na webu elektronického obchodování může být název produktu, popis, značka, barva, velikost, cena a hodnocení. V případě indexu ukázek hotelů se může jednat o pole "select" v následujícím příkladu:

POST /indexes/hotels-sample/docs/search?api-version=2026-04-01 
    {  
      "search": "sandy beaches",
      "select": "HotelId, HotelName, Description, Rating, Address/City",
      "count": true
    }

Tipy pro neočekávané výsledky

Někdy výstup dotazu není to, co očekáváte. Můžete například zjistit, že některé výsledky vypadají jako duplicity, nebo výsledek, který by se měl zobrazit v horní části, je ve výsledcích umístěný níže. Pokud jsou výsledky dotazů neočekávané, můžete zkusit tyto úpravy dotazů a zjistit, jestli se výsledky zlepší:

• Změňte searchMode=any (výchozí) na searchMode=all, aby se vyžadovaly shody podle všech kritérií místo podle kteréhokoli kritéria. To platí zejména v případě, že jsou v dotazu zahrnuté logické operátory.

• Experimentujte s různými lexikálními analyzátory nebo vlastními analyzátory a zjistěte, jestli změní výsledek dotazu. Výchozí analyzátor rozdělí slova s pomlčkami a redukuje slova na jejich základní tvary, což obvykle zlepšuje robustnost odpovědi dotazu. Pokud ale potřebujete zachovat pomlčky nebo pokud řetězce obsahují speciální znaky, možná budete muset nakonfigurovat vlastní analyzátory, abyste zajistili, že index obsahuje tokeny ve správném formátu. Další informace najdete v tématu Částečné hledání termínů a vzorů se speciálními znaky (spojovníky, zástupné znaky, regulární výrazy, vzory).

Počítání shod

Parametr count vrátí počet dokumentů v indexu, které jsou považovány za shodu dotazu. Pokud chcete vrátit počet, přidejte count=true ho do požadavku dotazu. Vyhledávací služba nevynucuje žádnou maximální hodnotu. V závislosti na dotazu a obsahu dokumentů může být počet stejně vysoký jako každý dokument v indexu.

Počet je přesný, pokud je index stabilní. Pokud systém aktivně přidává, aktualizuje nebo odstraňuje dokumenty, je počet přibližný, s výjimkou všech dokumentů, které nejsou plně indexované.

Běžná údržba nebo jiné úlohy vyhledávací služby nemají vliv na počet. Pokud ale máte více oddílů a jednu repliku, můžete při restartování oddílů zaznamenat krátkodobé kolísání počtu dokumentů (několik minut).

Počet výsledků v odpovědi

Azure AI Vyhledávač používá stránkování na straně serveru, aby zabránilo dotazům v načítání příliš velkého počtu dokumentů najednou. Parametry dotazu, které určují počet výsledků v odpovědi, jsou top a skip. top odkazuje na počet výsledků hledání na stránce. skip je interval top a sděluje vyhledávači, kolik výsledků má přeskočit před získáním další sady.

Výchozí velikost stránky je 50, zatímco maximální velikost stránky je 1 000. Pokud zadáte hodnotu větší než 1 000 a v indexu se najde více než 1 000 výsledků, vrátí se pouze prvních 1 000 výsledků. Pokud počet shod překročí velikost stránky, odpověď obsahuje informace pro načtení další stránky výsledků. Příklad:

"@odata.nextLink": "https://contoso-search-eastus.search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-04-01"

Nejrelevantnější shody jsou určeny podle skóre vyhledávání, pokud je dotaz fulltextový nebo sémantický. V opačném případě jsou nejvyšší shody libovolným pořadím pro přesné shody dotazů (kde uniforma @search.score=1.0 označuje libovolné pořadí).

Nastavte top pro změnu výchozí hodnoty 50. Pokud používáte hybridní dotaz, můžete v novějších rozhraních API ve verzi Preview zadat maxTextRecallSize pro vrácení až 10 000 dokumentů.

Chcete-li řídit stránkování všech dokumentů vrácených v sadě výsledků, použijte top a skip společně. Tento dotaz vrátí první sadu 15 shodných dokumentů a celkový počet shod.

POST https://contoso-search-eastus.search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-04-01

{
    "search": "room with a view",
    "count": true,
    "top": 15,
    "skip": 0
}

Tento dotaz vrátí druhou sadu po přeskočení prvních 15 a získání dalších 15 (16 až 30):

POST https://contoso-search-eastus.search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-04-01

{
    "search": "room with a view",
    "count": true,
    "top": 15,
    "skip": 15
}

Výsledky stránkovaných dotazů nejsou zaručeny stabilní, pokud se podkladový index mění. Stránkování změní hodnotu skip pro každou stránku, ale každý dotaz je nezávislý a pracuje s aktuálním zobrazením dat, tak jak v době dotazu existují v indexu (jinými slovy, neexistuje žádné cacheování ani snímek výsledků, jako v běžné databázi).

Následuje příklad toho, jak můžete získat duplicitní záznamy. Předpokládejme index se čtyřmi dokumenty:

{ "id": "1", "rating": 5 }
{ "id": "2", "rating": 3 }
{ "id": "3", "rating": 2 }
{ "id": "4", "rating": 1 }

Teď předpokládejme, že chcete, aby se výsledky vrátily dva současně, seřazené podle hodnocení. Spuštěním tohoto dotazu získáte první stránku výsledků: $top=2&$skip=0&$orderby=rating desca vytvoří se následující výsledky:

{ "id": "1", "rating": 5 }
{ "id": "2", "rating": 3 }

Ve službě předpokládejme, že se do indexu přidá pátý dokument mezi voláními dotazu: { "id": "5", "rating": 4 }. Za chvíli spustíte dotaz, který načte druhou stránku: $top=2&$skip=2&$orderby=rating desca získá tyto výsledky:

{ "id": "2", "rating": 3 }
{ "id": "3", "rating": 2 }

Všimněte si, že dokument 2 se načte dvakrát. Je to proto, že nový dokument 5 má větší hodnotu pro hodnocení, takže se seřadí před dokumentem 2 a přejde na první stránku. I když toto chování může být neočekávané, je typické, jak se vyhledávací web chová.

Procházení stránkami velkého počtu výsledků

Alternativní technikou stránkování je použití řazení a rozsahového filtru jako dočasného řešení pro .

V tomto alternativním řešení se řazení a filtrování použije u pole ID dokumentu nebo jiného pole, které je jedinečné pro každý dokument. Jedinečné pole musí mít v indexu vyhledávání filterable a sortable atribuci.

1. Zadejte dotaz, který vrátí celou stránku seřazených výsledků.

   POST /indexes/good-books/docs/search?api-version=2026-04-01
       {  
         "search": "divine secrets",
         "top": 50,
         "orderby": "id asc"
       }
   

2. Zvolte poslední výsledek vrácený vyhledávacím dotazem. Příklad výsledku s hodnotou ID je tady ukázán.

   {
       "id": "50"
   }
   

3. Tuto hodnotu ID v dotazu rozsahu použijte k načtení další stránky výsledků. Toto pole ID by mělo mít jedinečné hodnoty, jinak stránkování může obsahovat duplicitní výsledky.

   POST /indexes/good-books/docs/search?api-version=2026-04-01
       {  
         "search": "divine secrets",
         "top": 50,
         "orderby": "id asc",
         "filter": "id gt 50"
       }
   

4. Stránkování skončí, když dotaz vrátí nulové výsledky.

Řazení výsledků

V fulltextovém vyhledávacím dotazu je možné výsledky seřadit podle:

• vyhledávací skóre
• Skóre sémantického rerankeru
• pořadí řazení v sortable poli

Přidáním profilu bodování můžete také zvýšit počet nalezených shod v konkrétních polích.

Pořadí podle skóre hledání

U fulltextových vyhledávacích dotazů se výsledky automaticky řadí podle skóre hledání pomocí algoritmu BM25, který k určení relevance bere v úvahu frekvenci termínů, délku dokumentu a průměrnou délku dokumentu.

Rozsah @search.score je buď nevázaný, nebo 0 až (ale neobsahuje) 1,00 ve starších službách.

U obou algoritmů @search.score označuje hodnota 1,00 neohodnocenou nebo nehodnocenou sadu výsledků, kde je skóre 1,0 jednotné pro všechny výsledky. Neoznačené výsledky se vyskytují, když je formulář dotazu hledání s neostrým řetězcem, zástupné znaky, dotazy regulárního výrazu nebo prázdné hledání (search=*). Pokud potřebujete zavést strukturu řazení nad nehodnocenými výsledky, zvažte orderby výraz ke splnění tohoto cíle.

Pořadí podle sémantického pořadí

Pokud používáte sémantický ranker, @search.rerankerScore určuje pořadí řazení výsledků.

Rozsah @search.rerankerScore je 1 až 4,00, kde vyšší skóre označuje silnější sémantickou shodu.

Uspořádání podle pořadí

Pokud je konzistentní řazení požadavkem aplikace, můžete definovat orderby výraz v poli. K seřazení výsledků lze použít pouze pole, která jsou indexována jako "seřazená".

Běžně používaná pole v orderby zahrnují hodnocení, datum a umístění. Filtrování podle umístění vyžaduje, aby kromě názvu pole výraz filtru volal funkci geo.distance().

Číselná pole (Edm.Double, Edm.Int32, Edm.Int64) jsou seřazená v číselném pořadí (například 1, 2, 10, 11, 20).

Pole řetězců (Edm.String, Edm.ComplexType podpole) jsou seřazena buď v pořadí ASCII, nebo v pořadí Unicode, v závislosti na jazyce.

• Číselný obsah v řetězcových polích je seřazen abecedně (1, 10, 11, 2, 20).

• Řetězce se velkými písmeny jsou seřazeny před těmi s malými písmeny (APPLE, Apple, BANANA, Banana, apple, banana). Před řazením můžete přiřadit normalizátor textu k předběžnému zpracování textu, aby se toto chování změnilo. Použití tokenizátoru malými písmeny u pole nemá žádný vliv na chování řazení, protože Azure AI Vyhledávač seřadí na neanalyzovanou kopii pole.

• Řetězce, které začínají diakritickými znaky, se zobrazují na konci (Äpfel, Öffnen, Üben)

Zvýšení relevance pomocí hodnoticího profilu

Dalším přístupem, který podporuje konzistenci pořadí, je použití vlastního bodovacího profilu. Profily bodování poskytují větší kontrolu nad pořadím položek ve výsledcích hledání a možností zvýšit počet nalezených shod nalezených v konkrétních polích. Logika dodatečného bodování může pomoci překonat mírné rozdíly mezi replikami, protože skóre hledání pro každý dokument jsou kvůli tomu více vzdálená od sebe. Pro tento přístup doporučujeme algoritmus řazení.

Zvýrazňování položek

Zvýraznění shod odkazuje na formátování textu (například tučné nebo žluté zvýraznění) použité u odpovídajících termínů ve výsledku, a usnadňuje tak jejich nalezení. Zvýraznění je užitečné pro delší obsahová pole, například popisové pole, kde shoda není okamžitě jasná.

Všimněte si, že zvýraznění se používá u jednotlivých termínů. Obsah celého pole neobsahuje žádné možnosti zvýraznění. Pokud chcete zvýraznit frázi, musíte v řetězci dotazu uzavřeném v uvozovkách zadat odpovídající termíny (nebo frázi). Tato technika je podrobněji popsána v této části.

Pokyny ke zvýraznění nalezených položek jsou k dispozici v dotazovacím požadavku. Dotazy, které aktivují rozšíření dotazů ve vyhledávači, jako je fuzzy vyhledávání a vyhledávání se zástupnými znaky, mají omezenou podporu zvýrazňování výsledků.

Požadavky na zvýraznění

• Pole musí být Edm.String nebo Collection(Edm.String)
• Pole musí být připsáno na searchable

Uveďte zvýraznění v požadavku

Pokud chcete vrátit zvýrazněné termíny, zahrňte do požadavku dotazu parametr zvýraznění. Parametr je nastavený na čárkami oddělený seznam polí.

Ve výchozím nastavení je formát značek <em>, ale tag můžete přepsat pomocí parametrů highlightPreTag a highlightPostTag. Váš klientský kód zpracovává odpověď (například použitím tučného písma nebo žlutého pozadí).

POST /indexes/good-books/docs/search?api-version=2026-04-01
    {  
      "search": "divine secrets",  
      "highlight": "title, original_title",
      "highlightPreTag": "<b>",
      "highlightPostTag": "</b>"
    }

Ve výchozím nastavení Azure AI Vyhledávač vrátí až pět zvýraznění na pole. Toto číslo můžete upravit připojením pomlčky následované celým číslem. Například "highlight": "description-10" vrátí až 10 zvýrazněných termínů odpovídajícího obsahu v poli popisu.

Zvýrazněné výsledky

Přidáním zvýrazňování k dotazu obsahuje odpověď @search.highlights pro každý výsledek, aby kód aplikace mohl zaměřit se na tuto strukturu. V odpovědi jsou zahrnuty pole specifikované pro zvýraznění.

Při hledání klíčových slov se každý termín prohledá nezávisle. Vyhledávací dotaz na "boží tajemství" vrátí shody v jakémkoli dokumentu obsahujícím některý z těchto termínů.

Zvýraznění klíčových slov ve vyhledávání

V rámci zvýrazněného pole se formátování použije na celé termíny. Například u shody s knihou "Božská tajemství Ya-Ya sestry", se formátování aplikuje na každý výraz zvlášť, i když následují po sobě.

"@odata.count": 39,
"value": [
    {
        "@search.score": 19.593246,
        "@search.highlights": {
            "original_title": [
                "<em>Divine</em> <em>Secrets</em> of the Ya-Ya Sisterhood"
            ],
            "title": [
                "<em>Divine</em> <em>Secrets</em> of the Ya-Ya Sisterhood"
            ]
        },
        "original_title": "Divine Secrets of the Ya-Ya Sisterhood",
        "title": "Divine Secrets of the Ya-Ya Sisterhood"
    },
    {
        "@search.score": 12.779835,
        "@search.highlights": {
            "original_title": [
                "<em>Divine</em> Madness"
            ],
            "title": [
                "<em>Divine</em> Madness (Cherub, #5)"
            ]
        },
        "original_title": "Divine Madness",
        "title": "Divine Madness (Cherub, #5)"
    },
    {
        "@search.score": 12.62534,
        "@search.highlights": {
            "original_title": [
                "Grave <em>Secrets</em>"
            ],
            "title": [
                "Grave <em>Secrets</em> (Temperance Brennan, #5)"
            ]
        },
        "original_title": "Grave Secrets",
        "title": "Grave Secrets (Temperance Brennan, #5)"
    }
]

Zvýraznění vyhledávání frází

Formátování celých termínů platí i pro hledání frází, kde je více termínů uzavřeno do uvozovek. Následující příklad je stejný dotaz, s výjimkou toho, že "boží tajemství" je odeslána jako fráze v uvozovkách (někteří klienti REST vyžadují, abyste unikli vnitřní uvozovky s použitím zpětného lomítka \"):

POST /indexes/good-books/docs/search?api-version=2026-04-01 
    {  
      "search": "\"divine secrets\"",
      "select": "title,original_title",
      "highlight": "title",
      "highlightPreTag": "<b>",
      "highlightPostTag": "</b>",
      "count": true
    }

Protože kritéria nyní obsahují oba termíny, je v indexu vyhledávání nalezena pouze jedna shoda. Odpověď na předchozí dotaz vypadá takto:

{
    "@odata.count": 1,
    "value": [
        {
            "@search.score": 19.593246,
            "@search.highlights": {
                "title": [
                    "<b>Divine</b> <b>Secrets</b> of the Ya-Ya Sisterhood"
                ]
            },
            "original_title": "Divine Secrets of the Ya-Ya Sisterhood",
            "title": "Divine Secrets of the Ya-Ya Sisterhood"
        }
    ]
}

Zvýraznění fráze ve starších službách

Vyhledávací služby, které byly vytvořeny před 15. červencem 2020, implementují pro dotazy typu fráze odlišný způsob zvýraznění.

V následujících příkladech předpokládejme dotazovací řetězec, který obsahuje frázi uzavřenou uvozovkami "super bowl". Před červencem 2020 se zvýrazní libovolný termín ve frázi:

"@search.highlights": {
    "sentence": [
        "The <em>super</em> <em>bowl</em> is <em>super</em> awesome with a <em>bowl</em> of chips"
   ]

Pro vyhledávací služby vytvořené po červenci 2020 jsou vráceny pouze ty fráze, které přesně odpovídají celému formulovanému dotazu v @search.highlights:

"@search.highlights": {
    "sentence": [
        "The <em>super</em> <em>bowl</em> is super awesome with a bowl of chips"
   ]

Další kroky

Pokud chcete rychle vygenerovat vyhledávací stránku pro klienta, zvažte tyto možnosti:

• Vytvoření ukázkové aplikace na webu Azure Portal vytvoří stránku HTML s panelem hledání, fasetovou navigaci a oblastí miniatur, pokud máte obrázky.

• Přidání vyhledávání do webových aplikací je kurz a ukázka kódu jazyka C#, která pro uživatelské prostředí používá knihovny React JavaScriptu. Aplikace se nasadí pomocí Azure Static Web Apps a implementuje stránkování.