Sdílet prostřednictvím

Konfigurace prostředí pro hostované uživatelské rozhraní

  • Článek

Upozornění

30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API Bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingu najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.

Vlastní vyhledávání Bingu poskytuje hostované uživatelské rozhraní, které můžete snadno integrovat do webových stránek a webových aplikací jako fragment kódu JavaScriptu. Pomocí portálu vlastního vyhledávání Bingu můžete nakonfigurovat rozložení, barvu a možnosti vyhledávání uživatelského rozhraní.

Konfigurace vlastního hostovaného uživatelského rozhraní

Chcete-li nakonfigurovat hostované uživatelské rozhraní pro webové aplikace, postupujte podle těchto kroků. Při provádění změn se v podokně na pravé straně zobrazí náhled uživatelského rozhraní. Zobrazené výsledky hledání nejsou skutečnými výsledky pro vaši instanci.

  1. Přihlaste se k portálu pro vlastní vyhledávání Bingu.

  2. Vyberte instanci vlastního vyhledávání Bingu.

  3. Klikněte na kartu Hostované uživatelské rozhraní.

  4. Vyberte rozložení.

    • Panel hledání a výsledky (výchozí): Zobrazí vyhledávací pole s výsledky hledání pod ním.
    • Pouze výsledky: Zobrazí jenom výsledky hledání bez vyhledávacího pole. Při použití tohoto rozložení musíte zadat vyhledávací dotaz (&q=<query string>). Do adresy URL požadavku ve fragmentu kódu JavaScriptu nebo odkazu na koncový bod HTML přidejte parametr dotazu.
    • Automaticky otevírané okno: Poskytuje vyhledávací pole a zobrazuje výsledky hledání v posuvné překryvné oblasti.

  5. Vyberte barevný motiv. Barvy můžete přizpůsobit tak, aby vyhovovaly vaší aplikaci, a to kliknutím na Přizpůsobit motiv. Pokud chcete změnit barvu, zadejte šestnáctkovou hodnotu RGB barvy (například #366eb8) nebo klikněte na náhled barvy.

    Náhled změn můžete zobrazit na pravé straně portálu. Kliknutím na Obnovit výchozí vrátíte změny na výchozí barvy vybraného motivu.

    Poznámka

    Při výběru barev zvažte přístupnost.

  6. V části Další konfigurace zadejte odpovídající hodnoty pro vaši aplikaci. Tato nastavení jsou volitelná. Pokud chcete vidět efekt jejich použití nebo odebrání, podívejte se na podokno náhledu na pravé straně. Dostupné možnosti konfigurace:

  7. Zadejte klíč předplatného pro vyhledávání nebo ho vyberte z rozevíracího seznamu. Rozevírací seznam se naplní klíči z předplatných vašeho účtu Azure. Viz Účet rozhraní API služeb Azure AI.

  8. Pokud jste povolili automatické návrhy, zadejte klíč předplatného pro automatické návrhy nebo ho vyberte z rozevíracího seznamu. Rozevírací seznam se naplní klíči z předplatných vašeho účtu Azure. Vlastní automatické návrhy vyžadují konkrétní úroveň předplatného, viz ceny.

Publikování nebo vrácení zpět

Změny, které provedete v instanci vlastního vyhledávání, se provedou na kartě Konfigurace , abyste je mohli ověřit. Až dokončíte změny a budete připraveni k publikování, klikněte na Publikovat. Změny se neprojeví v produkčních koncových bodech, dokud je nepublikujete.

Pokud se před publikováním rozhodnete, že provedené změny nechcete zachovat, klikněte na Vrátit. Při vrácení změn se konfigurace živého stavu nezmění a karta Konfigurace se vrátí tak, aby odpovídala živému stavu.

Využití vlastního uživatelského rozhraní

Pokud chcete využívat hostované uživatelské rozhraní, proveďte následující:

  • Zahrnutí skriptu do webové stránky

    <html>
    <body>
        <script type="text/javascript" 
            id="bcs_js_snippet"
            src="https://ui.customsearch.ai /api/ux/rendering-js?customConfig=<YOUR-CUSTOM-CONFIG-ID>&market=en-US&safeSearch=Moderate&version=latest&q=">
        </script>
    </body>    
</html>

  • Nebo použijte následující adresu URL ve webovém prohlížeči.

    https://ui.customsearch.ai/hosted?customConfig=YOUR-CUSTOM-CONFIG-ID

    Poznámka

    Podle potřeby přidejte do adresy URL následující parametry dotazu. Informace o těchto parametrech najdete v referenčních informacích k rozhraní API pro vlastní vyhledávání .

    • q
    • mkt
    • Safesearch
    • setlang

    Důležité

    Stránka nemůže zobrazit vaše prohlášení o zásadách ochrany osobních údajů ani jiná oznámení a podmínky. Vhodnost pro vaše použití se může lišit.

Další informace, včetně ID vlastní konfigurace, najdete v části Koncové body na kartě Produkce .

Možnosti konfigurace

Chování hostovaného uživatelského rozhraní můžete nakonfigurovat kliknutím na Další konfigurace a zadáním hodnot. Tato nastavení jsou volitelná. Pokud chcete vidět efekt jejich použití nebo odebrání, podívejte se na podokno náhledu na pravé straně.

Konfigurace vyhledávání na webu

  • Povolené webové výsledky: Určuje, jestli je povolené vyhledávání na webu (v horní části stránky se zobrazí karta Web).
  • Povolit automatické návrhy: Určuje, jestli jsou povolené vlastní automatické návrhy (další náklady najdete v cenách ).
  • Webové výsledky na stránku: Počet výsledků hledání na webu, které se mají zobrazit najednou (maximální počet je 50 výsledků na stránku).
  • Image popis: Určuje, jestli se obrázky zobrazují s výsledky hledání.

Pokud kliknete na Zobrazit pokročilé konfigurace, zobrazí se následující konfigurace:

  • Zvýraznění slov: Určuje, jestli se výsledky zobrazí tučným písmem s hledanými termíny.
  • Cíl odkazu: Určuje, jestli se webová stránka otevře na nové kartě prohlížeče (prázdné) nebo na stejné kartě prohlížeče (vlastní), když uživatel klikne na výsledek hledání.

Konfigurace vyhledávání obrázků

  • Povolené výsledky obrázků: Určuje, jestli je povolené vyhledávání obrázků (v horní části stránky se zobrazí karta Obrázky).
  • Výsledky obrázků na stránku: Počet výsledků hledání obrázků, které se mají zobrazit najednou (maximální počet je 150 výsledků na stránku).

Pokud kliknete na Zobrazit pokročilé konfigurace, zobrazí se následující konfigurace.

  • Povolit filtry: Přidá filtry, které může uživatel použít k filtrování obrázků vrácených Bingem. Uživatel může například filtrovat výsledky pouze pro animované gify.

Konfigurace vyhledávání videí

  • Povolené výsledky videa: Určuje, jestli je povolené vyhledávání videí (v horní části stránky se zobrazí karta Videa).
  • Výsledky videa na stránku: Počet výsledků hledání videí, které se mají zobrazit najednou (maximální počet je 150 výsledků na stránku).

Pokud kliknete na Zobrazit pokročilé konfigurace, zobrazí se následující konfigurace.

  • Povolit filtry: Přidá filtry, které uživatel může použít k filtrování videí, která Bing vrací. Uživatel může například filtrovat výsledky pro videa s konkrétním rozlišením nebo videa zjištěná za posledních 24 hodin.

Různé konfigurace

  • Název stránky: Text zobrazený v oblasti nadpisu stránky výsledků hledání (ne pro automaticky otevírané rozložení).
  • Motiv panelu nástrojů: Určuje barvu pozadí oblasti nadpisu stránky výsledků hledání.

Pokud kliknete na Zobrazit pokročilé konfigurace, zobrazí se následující konfigurace.

Sloupec1 Sloupec2
Zástupný symbol textu vyhledávacího pole Text zobrazený ve vyhledávacím poli před zadáním.
Adresa URL odkazu na název Cíl odkazu na nadpis.
Adresa URL loga Obrázek zobrazený vedle názvu.
Favicon Ikona zobrazená v záhlaví prohlížeče.

Následující konfigurace platí jenom v případě, že používáte hostované uživatelské rozhraní prostřednictvím koncového bodu HTML (neplatí pro použití fragmentu kódu JavaScriptu).

  • Nadpis stránky
  • Motiv panelu nástrojů
  • Adresa URL odkazu na nadpis
  • Adresa URL loga
  • Adresa URL faviiconu

Další kroky