Share via


Üzemeltetett felhasználói felület konfigurálása

Figyelmeztetés

2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search-szolgáltatásokba. Ez a dokumentáció csak referenciaként érhető el. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos utasításokért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.

A Bing Custom Search egy üzemeltetett felhasználói felületet biztosít, amely JavaScript-kódrészletként egyszerűen integrálható a weblapokba és webalkalmazásokba. A Bing Custom Search portál használatával konfigurálhatja a felhasználói felület elrendezését, színét és keresési beállításait.

Az egyéni üzemeltetett felhasználói felület konfigurálása

A webalkalmazások üzemeltetett felhasználói felületének konfigurálásához kövesse az alábbi lépéseket. A módosítások végrehajtásakor a jobb oldali panelen megjelenik a felhasználói felület előnézete. A megjelenített keresési eredmények nem a példány tényleges eredményei.

  1. Jelentkezzen be a Bing Custom Search portálra.

  2. Válassza ki a Bing Custom Search-példányt.

  3. Kattintson a Hosted UI (Üzemeltetett felhasználói felület) lapra.

  4. Válasszon ki egy elrendezést.

    • Keresősáv és találatok (alapértelmezett): Megjelenít egy keresőmezőt, alatta a találatokkal.
    • Csak találatok: Csak a keresési eredményeket jeleníti meg keresőmező nélkül. Ha ezt az elrendezést használja, meg kell adnia a keresési lekérdezést (&q=<query string>). Adja hozzá a lekérdezési paramétert a kérés URL-címéhez a JavaScript-kódrészletben vagy a HTML-végpont hivatkozásában.
    • Előugró ablak: Keresőmezőt biztosít, és csúszó átfedésben jeleníti meg a keresési eredményeket.
  5. Válasszon ki egy színtémát. A téma testreszabása gombra kattintva testreszabhatja az alkalmazáshoz illő színeket. Egy szín módosításához adja meg a szín RGB HEX értékét (például #366eb8), vagy kattintson a szín előnézetére.

    A módosítások előnézetét a portál jobb oldalán tekintheti meg. Az Alaphelyzetbe állítás alapértelmezettre gombra kattintva visszaállítja a módosításokat a kijelölt téma alapértelmezett színére.

    Megjegyzés

    A színek kiválasztásakor vegye figyelembe az akadálymentességet.

  6. A További konfigurációk területen adja meg az alkalmazásnak megfelelő értékeket. Ezek a beállítások nem kötelezőek. Az alkalmazásuk vagy eltávolításuk hatásának megtekintéséhez tekintse meg a jobb oldali előnézeti panelt. Az elérhető konfigurációs lehetőségek a következők:

  7. Adja meg a keresési előfizetés kulcsát, vagy válasszon egyet a legördülő listából. A legördülő lista az Azure-fiók előfizetéseiből származó kulcsokkal van feltöltve. Lásd: Azure AI-szolgáltatások API-fiókja.

  8. Ha engedélyezte az autosuggestet, adja meg az autosuggest előfizetési kulcsot, vagy válasszon egyet a legördülő listából. A legördülő lista az Azure-fiók előfizetéseiből származó kulcsokkal van feltöltve. Az egyéni autosuggesthez egy adott előfizetési szint szükséges. Lásd a díjszabást.

Közzététel vagy visszaállítás

Az Egyéni keresés példányon végzett módosítások a Konfiguráció lapon történnek, így ellenőrizheti a módosításokat. Ha végzett a módosításokkal, és készen áll a közzétételre, kattintson a Közzététel gombra. A módosítások csak a közzététel után jelennek meg az éles végpontokon.

Ha a közzététel előtt úgy dönt, hogy nem szeretné megtartani az elvégzett módosításokat, kattintson a Visszaállítás gombra. A módosítások visszaállításakor az élő állapotkonfiguráció változatlan marad, és a Konfiguráció lap visszaáll az élő állapotnak megfelelőre.

Egyéni felhasználói felület felhasználása

Az üzemeltetett felhasználói felület használatához a következők valamelyikét használhatja:

  • A szkript belefoglalása a weblapra

    <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>
    
  • Vagy használja a következő URL-címet egy webböngészőben.

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

    Megjegyzés

    Szükség szerint adja hozzá a következő lekérdezési paramétereket az URL-címhez. További információ ezekről a paraméterekről: Custom Search API-referencia .

    • q
    • mkt
    • Safesearch
    • setlang

    Fontos

    Az oldal nem tudja megjeleníteni az adatvédelmi nyilatkozatot, illetve az egyéb értesítéseket és feltételeket. A használatra való alkalmasság eltérő lehet.

További információkért, beleértve az egyéni konfigurációs azonosítót, lépjen a Végpontok lap Production (Éles környezet ) lapjára.

Beállítási lehetőségek

Az üzemeltetett felhasználói felület viselkedését úgy konfigurálhatja, hogy a További konfigurációk elemre kattint, és értékeket ad meg. Ezek a beállítások nem kötelezőek. Az alkalmazásuk vagy eltávolításuk hatásának megtekintéséhez tekintse meg a jobb oldali előnézeti panelt.

Webkeresési konfigurációk

  • Webes találatok engedélyezve: Meghatározza, hogy engedélyezve van-e a webes keresés (a lap tetején megjelenik egy Web lap)
  • Autosuggest engedélyezése: Meghatározza, hogy engedélyezve van-e az egyéni automatikus frissítés (további költségekért lásd a díjszabást ).
  • Weblaponkénti webes találatok: Az egyszerre megjelenítendő webes keresési eredmények száma (a maximális érték oldalanként 50 találat).
  • Kép képaláírás: Meghatározza, hogy a képek megjelennek-e keresési eredményekkel.

Ha a Speciális konfigurációk megjelenítése gombra kattint, a következő konfigurációk jelennek meg:

  • Szavak kiemelése: Meghatározza, hogy a találatok félkövér keresési kifejezésekkel jelenjenek-e meg.
  • Hivatkozás célja: Meghatározza, hogy a weblap megnyílik-e egy új böngészőlapon (üres) vagy ugyanazon böngészőlapon (önállóan), amikor a felhasználó egy keresési eredményre kattint.

Képkeresési konfigurációk

  • Engedélyezett képeredmények: Meghatározza, hogy engedélyezve van-e a képkeresés (a lap tetején megjelenik a Képek lap).
  • Képeredmények oldalanként: Az egyszerre megjelenítendő képkeresési találatok száma (a maximális érték oldalanként 150 találat).

Az alábbi konfiguráció jelenik meg, ha a Speciális konfigurációk megjelenítése elemre kattint.

  • Szűrők engedélyezése: Olyan szűrőket ad hozzá, amelyekkel a felhasználó szűrheti a Bing által visszaadott képeket. A felhasználó például csak animált GIF-ekre szűrheti az eredményeket.

Videokeresési konfigurációk

  • A videóeredmények engedélyezve: Meghatározza, hogy engedélyezve van-e a videókeresés (a lap tetején megjelenik a Videók lap).
  • Videóeredmények oldalanként: Egyszerre megjeleníthető videókeresési találatok száma (a maximális érték oldalanként 150 találat).

Az alábbi konfiguráció jelenik meg, ha a Speciális konfigurációk megjelenítése elemre kattint.

  • Szűrők engedélyezése: Olyan szűrőket ad hozzá, amelyekkel a felhasználó szűrheti a Bing által visszaadott videókat. A felhasználó például szűrheti az eredményeket egy adott felbontással rendelkező videókra, vagy az elmúlt 24 órában felfedezett videókra.

Egyéb konfigurációk

  • Lap címe: A keresési eredmények lapjának címterületén megjelenő szöveg (nem előugró elrendezés esetén).
  • Eszköztártéma: Meghatározza a keresési eredmények lap címterületének háttérszínét.

Az alábbi konfigurációk jelennek meg, ha a Speciális konfigurációk megjelenítése elemre kattint.

1\. oszlop 2\. oszlop
Keresőmező szövegének helyőrzője A bevitel előtt a keresőmezőben megjelenő szöveg.
Címhivatkozás URL-címe A címhivatkozás célja.
Embléma URL-címe A cím mellett megjelenő kép.
Favicon A böngésző címsorában megjelenő ikon.

A következő konfigurációk csak akkor érvényesek, ha az üzemeltetett felhasználói felületet a HTML-végponton keresztül használja (a JavaScript-kódrészlet használata esetén ezek nem érvényesek).

  • Oldalcím
  • Eszköztár téma
  • Címhivatkozás URL-címe
  • Embléma URL-címe
  • Faviicon URL-címe

Következő lépések