Konfigurieren der benutzerdefinierten Vorschlagssuche

  • Artikel

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Die benutzerdefinierte Vorschlagssuche gibt eine Liste der für Ihre Suche relevanten vorgeschlagenen Suchabfragezeichenfolgen zurück. Die vorgeschlagenen Abfragezeichenfolgen basieren auf einer partiellen Abfragezeichenfolge, die der Benutzer in das Suchfeld eingibt. Die Liste enthält maximal 10 Vorschläge.

Sie bestimmen, ob nur benutzerdefinierte Vorschläge zurückgegeben oder auch Bing-Vorschläge eingeschlossen werden. Wenn Sie Bing-Vorschläge einschließen, werden benutzerdefinierte Vorschläge vor den Bing-Vorschlägen angezeigt. Wenn Sie genügend relevante Vorschläge angeben, ist es möglich, dass die zurückgegebene Liste mit Vorschlägen keine Bing-Vorschläge enthält. Bing-Vorschläge beziehen sich immer auf den Kontext der benutzerdefinierten Suchinstanz.

Um die Vorschläge zu Suchabfragen für Ihre Instanz zu konfigurieren, klicken Sie auf die Registerkarte Vorschlagssuche.

Hinweis

Um dieses Feature verwenden zu können, müssen Sie die benutzerdefinierte Suche im entsprechenden Tarif abonnieren (siehe Preise).

Es kann bis zu 24 Stunden dauern, bis Vorschläge am aktiven Endpunkt (API oder gehostete Benutzeroberfläche) verfügbar werden.

Aktivieren der Bing-Vorschläge

Schalten Sie den Schieberegler für Automatische Bing-Vorschläge auf die Position EIN um, um Bing-Vorschläge zu aktivieren. Der Schieberegler wird Blau angezeigt.

Hinzufügen eigener Vorschläge

Ihre eigenen Vorschläge für Abfragezeichenfolgen fügen Sie der Liste mit benutzerdefinierten Vorschlägen hinzu. Nachdem Sie der Liste einen Vorschlag hinzugefügt haben, drücken Sie die EINGABETASTE, oder klicken Sie auf das Symbol + . Sie können die Vorschläge in einer beliebigen Sprache angeben. Sie können maximal 5.000 Vorschläge für Abfragezeichenfolgen hinzufügen.

Hochladen von Vorschlägen

Sie können optional auch eine Liste mit Vorschlägen aus einer Datei hochladen. Die Datei darf pro Zeile jeweils nur eine Zeichenfolge zur Suchabfrage enthalten. Um die Datei hochzuladen, klicken Sie auf das Symbol für den Upload und wählen die Datei aus. Der Dienst extrahiert die Vorschläge aus der Datei und fügt sie der Liste hinzu.

Entfernen von Vorschlägen

Wenn Sie einen Vorschlag für eine Abfragezeichenfolge entfernen möchten, klicken Sie neben diesem auf das Symbol zum Entfernen.

Blockieren von Vorschlägen

Wenn Sie Bing-Vorschläge einschließen, können Sie eine Liste von Abfragezeichenfolgen für die Suche hinzufügen, die Bing nicht zurückgeben soll. Wenn Sie blockierte Abfragezeichenfolgen hinzufügen möchten, klicken Sie auf Show blocked suggestions (Blockierte Vorschläge anzeigen). Fügen Sie die Abfragezeichenfolge der Liste hinzu, und drücken Sie die EINGABETASTE, oder klicken Sie auf das Symbol + . Sie können maximal 50 blockierte Abfragezeichenfolgen hinzufügen.

Veröffentlichen oder zurücksetzen

An einer benutzerdefinierten Suchinstanz vorgenommene Änderungen erfolgen auf der Registerkarte Konfiguration, damit Sie Ihre Änderungen überprüfen können. Wenn Sie alle gewünschten Änderungen vorgenommen haben und das Ergebnis veröffentlichen möchten, klicken Sie auf Veröffentlichen. Änderungen werden erst nach der Veröffentlichung für Ihre Produktionsendpunkte angezeigt.

Wenn Sie sich vor der Veröffentlichung gegen Ihre Änderungen entscheiden, klicken Sie auf Zurücksetzen. Wenn Sie Ihre Änderungen zurücksetzen, bleibt die aktive Konfiguration unverändert, und die Registerkarte Konfiguration wird gemäß dieses Zustands zurückgesetzt.

Hinweis

Es kann bis zu 24 Stunden dauern, bis Änderungen an der Konfiguration der benutzerdefinierten Vorschlagssuche wirksam werden.

Aktivieren der Vorschlagssuche auf gehosteter Benutzeroberfläche

Um Vorschläge für Abfragezeichenfolgen für Ihre gehostete Benutzeroberfläche zu aktivieren, klicken Sie auf Gehostete Benutzeroberfläche. Scrollen Sie nach unten zum Abschnitt Zusätzliche Konfiguration. Wählen Sie unter Websuche für Enable autosuggest (Vorschlagssuche aktivieren) die Option Ein aus. Um die Vorschlagssuche zu aktivieren, müssen Sie ein Layout auswählen, das ein Suchfeld enthält.

Aufrufen der Vorschlagssuche-API

Um mithilfe der API für die benutzerdefinierte Bing-Suche vorgeschlagene Abfragezeichenfolgen zu erhalten, senden Sie eine GET-Anforderung an den folgenden Endpunkt.

GET https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/Suggestions

Die Antwort enthält eine Liste mit SearchAction-Objekten, in denen die vorgeschlagenen Abfragezeichenfolgen enthalten sind.

        {  
            "displayText" : "sailing lessons seattle",  
            "query" : "sailing lessons seattle",  
            "searchKind" : "CustomSearch"  
        },

Jeder Vorschlag enthält die Felder displayText und query. Das Feld displayText enthält die vorgeschlagene Abfragezeichenfolge, die Sie zum Auffüllen der Dropdownliste des Suchfelds verwenden.

Wenn der Benutzer in der Dropdownliste eine vorgeschlagene Abfragezeichenfolge auswählt, können Sie die Abfragezeichenfolge im Feld query verwenden, wenn Sie die API für die benutzerdefinierte Bing-Suche aufrufen.

Nächste Schritte