カスタム autosuggest エクスペリエンスを構成する

[アーティクル]
02/12/2019

警告

2020 年 10 月 30 日、Bing Search API は Azure AI サービスから Bing Search Services に移行されました。このドキュメントは参考用に提供されています。更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace を使用して Bing Search リソースを作成するを参照してください。

Custom Autosuggest は、検索エクスペリエンスに関連する検索クエリ文字列の候補の一覧を返します。推奨されるクエリ文字列は、ユーザーが検索ボックスで提供する部分的なクエリ文字列に基づいています。リストには、最大 10 個の候補が含まれます。

カスタム候補のみを返すか、またはBing候補も含めるかを指定します。 Bing候補を含める場合は、Bing候補の前にカスタム候補が表示されます。関連性の高い提案を十分に提供した場合、返される提案の一覧にBing候補が含まれていない可能性があります。 Bing候補は、常に Custom Search インスタンスのコンテキストにあります。

インスタンスの検索クエリ候補を構成するには、「Autosuggest」タブをクリックしてください。

注

この機能を使用するには、適切なレベルで Custom Search をサブスクライブする必要があります (価格参照)。

提案がサービスエンドポイント (API またはホストされた UI) に反映されるまでに最大 24 時間かかる場合があります。

Bing候補を有効にする

Bing候補を有効にするには、自動Bing候補 スライダーをオンの位置に切り替えます。スライダーが青になります。

独自の提案を追加する

独自のクエリ文字列候補を追加するには、ユーザー定義候補一覧に追加します。リストに候補を追加した後、Enter キーを押すか、+ アイコンをクリックします。任意の言語で候補を指定できます。最大 5,000 個のクエリ文字列候補を追加できます。

提案をアップロードする

オプションとして、ファイルから候補の一覧をアップロードできます。ファイルには、1 行に 1 つの検索クエリ文字列が含まれている必要があります。ファイルをアップロードするには、アップロードアイコンをクリックし、アップロードするファイルを選択します。このサービスは、ファイルから候補を抽出し、一覧に追加します。

提案を削除する

クエリ文字列候補を削除するには、削除する候補の横にある削除アイコンをクリックします。

提案をブロックする

Bing の候補を含める場合は、Bing に返して欲しくない検索クエリ文字列の一覧を追加できます。ブロックされたクエリ文字列を追加するには、[ブロックされた候補の表示]をクリックします。クエリ文字列を一覧に追加し、Enter キーを押すか、+ アイコンをクリックします。最大 50 個のブロックされたクエリ文字列を追加できます。

発行または元に戻す

カスタム検索インスタンスに加えた変更は、[構成] タブで行われ、変更を検証できます。変更が完了し、発行する準備ができたら、[発行 ] をクリックします。発行するまで、運用環境のエンドポイントに対する変更は反映されません。

発行する前に、行った変更を保持しない場合は、[戻す] をクリックします。変更を元に戻すと、ライブ状態の構成は変更されず、の [構成] タブがライブ状態と一致するように戻されます。

注

カスタム Autosuggest 構成の変更が有効になるまで、最大で 24 時間かかる場合があります。

ホストされた UI で Autosuggest を有効にする

ホストされた UI のクエリ文字列候補を有効にするには、ホストされた UI をクリックします。 [追加の構成 ] セクション まで下にスクロールします。 [Web 検索] で、[オートサジェストを有効にする] のために [オン] を選択します。 Autosuggest を有効にするには、検索ボックスを含むレイアウトを選択する必要があります。

Autosuggest API の呼び出し

Bing Custom Search API を使用して推奨されるクエリ文字列を取得するには、次のエンドポイントに GET 要求を送信します。

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

応答には、提案されたクエリ文字列を含む SearchAction オブジェクトの一覧が含まれています。

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

各候補には、displayText フィールドと query フィールドが含まれています。 displayText フィールドには、検索ボックスのドロップダウンリストに入力するために使用するクエリ文字列が表示されます。

ユーザーがドロップダウンリストから推奨されるクエリ文字列を選択した場合は、Custom Search API Bingを呼び出すときに、query フィールドのクエリ文字列を使用します。

次のステップ

カスタム候補を取得する
カスタムインスタンスを検索する
カスタムでホストされる UI を構成して使用する

次の方法で共有