OpenSearch:上位検索とヒント

上位検索とヒントは、完全な検索エンジンの必須機能です。多くの場合、検索ボックス内またはその近くの目立つ場所に表示され、不可欠なビジネス価値を提供します。

検索エンジンでは、検索プロセスの最初のステップで上位検索とヒントがユーザーに提供されます。優れた上位検索とヒントは、クエリ分析、ソート、運用介入などのステップの最適化における困難を軽減することにより、検索の最適化を促進します。さらに、上位検索とヒントは、ビジネス目標を達成するための運用戦略と共に使用できます。

ユーザーの観点からは、上位検索とヒントは次の要件を満たすことができます。

運用者の観点からは、上位検索とヒントは次のビジネス価値を提供できます。

コンソールのトップ検索リストとトップ検索推奨インターフェースには、次の違いがあります。

使用上の注意

上位検索モデルまたはヒントモデルを作成する

API または SDK を使用して上位検索モデルまたはヒントモデルを作成する

管理および制御 SDK の依存関係

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-opensearch</artifactId>
    <version>0.7.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.0</version>
</dependency>

Java 用 SDK のデモ

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.opensearch.model.v20171225.*;
import com.aliyuncs.profile.DefaultProfile;
public class CreateModel {
    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-beijing", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);
        CreateModelRequest request = new CreateModelRequest();
        request.setAppGroupIdentity("app_name");
 // type パラメーターはモデルタイプを指定します。値 hot は上位検索モデルを示します。値 hint はヒントモデルを示します。 modelName パラメーターはモデル名を指定します。数字、文字、およびアンダースコア（_）で構成されるカスタム名を入力できます。名前は数字のみを含めることはできず、最大 30 文字の長さにすることができます。
        String content = "{\"type\": \"hot\",\"name\": \"model_name\"}";
        request.setHttpContent(content.getBytes(), "UTF-8", FormatType.JSON);
        try {
            HttpResponse response = client.doAction(request);
            System.out.println(response.getHttpContentString());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

OpenSearch コンソールで上位検索モデルまたはヒントモデルを作成する

1. OpenSearch コンソールにログオンします。左側のナビゲーションウィンドウで、[検索アルゴリズムセンター] > [検索ガイダンス] を選択します。[検索ガイダンス] ページで、左側のウィンドウの [上位検索とヒント] をクリックします。[上位検索とヒント] ページで、作成 をクリックして上位検索モデルまたはヒントモデルを作成します。

2. [モデル名] パラメーターと [フィルター条件] パラメーターを構成し、[モデルタイプ] として [上位検索モデル] または [ヒントモデル] を選択します。 フィルター条件パラメーターはオプションです。

3. [上位検索とヒント] ページで、[トレーニング待機中] 状態の作成済みモデルを見つけ、[操作] 列の [トレーニング] をクリックします。4. トレーニングが完了したら、上位検索またはヒントの効果をプレビューします。

上位検索の効果をプレビューする

ヒントの効果をプレビューする

使用上の注意

[上位検索とヒント] ページの概要

上位検索モデルまたはヒントモデルのリスト

[上位検索とヒント] ページでは、モデルリストの各モデルに関する次の情報を表示できます。モデル名、モデルタイプ、作成時刻、モデルステータス、最後のトレーニングの開始時刻、最新バージョンのステータス。[操作] 列のモデルに対してさまざまな操作を実行できます。ビジネス要件に基づいて、モデルをデフォルトモデルとして指定できます。パラメーターでモデル名が指定されていない場合は、デフォルトモデルが使用されます。

上位検索モデルまたはヒントモデルの詳細ページ

[基本情報] セクションでは、作成時刻、モデルステータス、最後のトレーニングの開始時刻、最新バージョンのステータスなど、上位検索モデルまたはヒントモデルに関する基本情報を表示できます。[トレーニング履歴] セクションでは、各履歴トレーニングレコードに関する次の情報を表示できます。モデルバージョン、バージョンステータス、トレーニング開始時刻、トレーニング終了時刻。モデルトレーニングは成功または失敗する可能性があります。

失敗したトレーニングのトラブルシューティング

モデルの詳細ページで、ポインターを [例外レポート] に合わせて、トレーニングが失敗した原因を表示し、ポインターを [整合性レベルのアップグレードの条件を表示] に合わせて、整合性レベルのアップグレードの条件を表示します。

カスタム設定

ブラックリストとホワイトリストの構成：ビジネス要件に基づいて、モデルのブラックリストとホワイトリストを構成できます。ブラックリストとホワイトリストを構成するには、モデルの詳細ページの [構成情報] セクションで [構成] をクリックします。詳細については、「ブラックリストとホワイトリスト」をご参照ください。

API または SDK を使用して上位検索とヒントを取得する

上位検索とヒント機能がプロダクトに統合されると、API 操作を呼び出すか SDK を使用して、推奨される上位検索とヒントを取得できます。API 操作の詳細については、API ドキュメント をご参照ください。SDK の使用方法の詳細については、次の SDK デモコードをご参照ください。

デフォルトでは、10 件の上位検索と 3 件のヒントが返されます。ヒントは検索ボックスに順番に表示できます。

使用上の注意

トラフィック SDK の依存関係

<dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.5.0</version>
</dependency>

Java 用 SDK のデモ

import java.util.HashMap;
import java.util.Map;
import com.alibaba.fastjson.JSON;
import com.aliyun.opensearch.OpenSearchClient;
import com.aliyun.opensearch.sdk.generated.OpenSearch;
import com.aliyun.opensearch.sdk.generated.commons.OpenSearchClientException;
public class Hot {
    private static final String accesskey = "Your AccessKey ID"; // AccessKey ID を入力します
    private static final String secret = "Your AccessKey secret"; // AccessKey シークレットを入力します
    private static final String host = "The endpoint of the OpenSearch API, such as http://opensearch-cn-hangzhou.aliyuncs.com"; // OpenSearch API のエンドポイント。例： http://opensearch-cn-hangzhou.aliyuncs.com
    private static final String appName = "The name of your OpenSearch application"; // OpenSearch アプリケーションの名前
    private static final String HOT_API_PATH = "/apps/{app_name}/actions/hot";
    public static void main(String[] args) {
        OpenSearch openSearch = new OpenSearch(accesskey, secret, host);
        // OpenSearchClient を作成する
        OpenSearchClient client = new OpenSearchClient(openSearch);
        String requestPath = HOT_API_PATH.replaceAll(("\\{app_name\\}"), appName);
        Map<String, String> params = new HashMap<>();
        params.put("model_name", "your_model_name");// モデル名を指定します。
        params.put("hit", "20");// 取得する上位検索の数を指定します。
        try {
            String response = client.call(requestPath, params, OpenSearchClient.METHOD_GET);
            System.out.println(JSON.toJSONString(response));
        } catch (OpenSearchClientException e) {
            e.printStackTrace();
        }
    }
}

モデルの最適化

ユーザー行動データ

検索ログから収集された統計に基づいて生成される上位検索とヒントは、上位検索とヒント機能の初期使用時の要件を満たすことができます。機能が使用された後、ユーザー行動データを上位検索とヒントに関連付けることをお勧めします。システムは、from_request_id パラメーターと user_id パラメーターを含むユーザー行動データを収集します。ユーザー行動データを使用して、モデルをさらに最適化できます。ユーザー行動データには次の利点があります。

上位検索とヒントによってガイドされる検索トラフィック

API 操作を呼び出すか SDK を使用して上位検索またはヒントを取得すると、システムは ID を含む request_id パラメーターを返します。ID はリクエストを一意に識別します。ユーザーがプロダクトの上位検索またはヒントをクリックすると、システムは上位検索またはヒントに基づいて検索リクエストを開始します。システムが検索リクエストの from_request_id パラメーターを request_id パラメーターの値に設定することを許可できます。このようにして、ユーザーのクリック行動は上位検索とヒントに関連付けられます。システムが検索ログとユーザー行動データから統計を収集した後、ビジネス運用レポートで上位検索とヒントによってガイドされる検索トラフィックのメトリックを表示できます。 user_id パラメーターが検索リクエストで構成されている場合は、ビジネス運用レポートで上位検索とヒントによってガイドされる検索トラフィックの UV メトリックも表示できます。

使用上の注意

OpenSearch コンソールでビジネス運用レポートを表示する

上位検索のビジネス運用レポート

OpenSearch コンソールにログオンします。左側のナビゲーションウィンドウで、[レポート統計] > [上位検索レポート] を選択して、上位検索のビジネス運用レポートを表示します。

ヒントのビジネス運用レポート

OpenSearch コンソールにログオンします。左側のナビゲーションウィンドウで、[レポート統計] > [ヒントレポート] を選択して、ヒントのビジネス運用レポートを表示します。

使用上の注意