ブラックリストとホワイトリストを使用して、どの検索クエリを検索候補、トレンド、ヒントワードとして表示するかをコントロールします。不要なクエリをブラックリストに追加してブロックしたり、高品質なクエリをホワイトリストに追加して結果の上位に表示したりできます。
仕組み
ブロッキング:ブラックリストは包含マッチング (部分文字列マッチングに相当) を使用します。候補となる検索クエリ内の分割された term のいずれかがブラックリストに登録されたキーワードと一致した場合、そのクエリ全体がブロックされます。たとえば、「garbage」がブラックリストにある場合、「garbage」という term を含むクエリはすべて結果から除外されます。
優先表示:推奨条件を満たすホワイトリストのクエリは、候補となる検索クエリの結果で優先的に表示されます。
競合の解決:同じクエリがブラックリストとホワイトリストの両方に一致する場合、ブラックリストが優先されます。
正規表現のサポート:ブラックリストは正規表現をサポートしており、1 つのエントリで多くの類似パターンをカバーできます。これはエントリ数の上限内に収めるのに役立ちます。
即時反映:変更はすぐに反映されます。モデルの再トレーニングは不要です。
リストタイプ別の動作
| リストタイプ | アクティブな場合の動作 |
|---|---|
| 検索候補ブラックリスト | 一致するクエリは検索候補に表示されません |
| 検索候補ホワイトリスト | 一致するクエリは検索候補で優先的に表示されます |
| トップ検索ブラックリスト | 一致するクエリはトレンドから除外されます |
| トップ検索ホワイトリスト | クエリはトレンドの指定された位置に表示されます。ある位置にクエリが設定されていない場合、結果はトレンドモデルのランキングに従います |
| ヒントワードブラックリスト | 一致するクエリはヒントワードから除外されます |
| ヒントワードホワイトリスト | クエリはヒントワード内の推奨検索クエリとしてローテーション表示されます |
介入辞書の作成と適用
前提条件
開始する前に、以下を確認してください:
OpenSearch コンソールへのアクセス権
辞書をアタッチするための既存の検索候補モデル
ブラックリストまたはホワイトリストの作成
OpenSearch コンソールにログインします。左側のナビゲーションウィンドウで、[検索アルゴリズムセンター] > [検索案内] を選択します。
[ドロップダウン候補] ページで、左側のペインにある [ブラックリストとホワイトリスト] をクリックします。
[ブラックリストとホワイトリスト] ページで、[作成] をクリックします。

[ホワイトリストまたはブラックリストの作成] パネルで、以下を設定します:
名前:介入辞書の名前を入力します。
タイプ:リストタイプを選択します。クエリを優先表示するには [検索候補ホワイトリスト] を、ブロックするには [検索候補ブラックリスト] を選択します。
[保存] をクリックします。

[ブラックリストとホワイトリスト] ページで、作成した辞書を見つけ、[操作] 列の [エントリの管理] をクリックします。

介入エントリを辞書に追加します。

辞書をモデルにアタッチ
エントリを追加した後、介入辞書を検索候補モデルにアタッチして有効化します。
![]()
![]()
![]()
制限事項
| リストタイプ | 最大エントリ数 |
|---|---|
| 検索候補ブラックリスト | 500 |
| 検索候補ホワイトリスト | 500 |
| トップ検索ブラックリスト | 500 |
| トップ検索ホワイトリスト | 10 |
| ヒントワードブラックリスト | 500 |
| ヒントワードホワイトリスト | 3 |
注意:ブラックリストは正規表現をサポートしています。1 つの正規表現パターンを使用して複数の類似クエリをマッチングさせ、エントリ数の上限内に収めることができます。モデルから参照されているブラックリストとホワイトリストは削除できません。削除する前に、すべてのモデルから辞書をデタッチしてください。