この記事では、実際のエンティティの結果が期待どおりに表示されない場合のSearchバックエンドの問題をトラブルシューティングする方法を概説します。

まず、一般的なトラブルシューティング手順について、ヘルプ記事バックエンドでのSearchの問題のデバッグを開始する方法に従います。

 

一般的なトラブルシューティングの手順

トラブルシューティング中のクエリの検索ログを、設定で設定された検索可能なフィールドと比較する必要があります。まず、これらの両方を開きます。

1. バーティカル設定を確認します。
   1. Search > [[エクスペリエンス名]] > [バーティカル（Verticals）]に移動します。
   2. 関連するバーティカルを選択します。ここでは、検索可能なフィールドを持つバーティカルが表示されます。
2. 問題が発生しているクエリの検索ログを開きます。以下のいずれかを行います。
   1. Search > [[エクスペリエンス名]] > [テスト検索（Test Search）]または [設定（Configuration）]サブタブに移動します。テスト検索を実行し、ドロップダウンメニューから[クエリをデバッグ（Debug Query）]を選択します。
   2. ステージングまたは本番環境リンクですでに検索を実行している場合、Search > [[エクスペリエンス名]] > [検索ログ（Search Logs）] に移動し、該当する検索ログをクリックします。検索バーまたはフィルターを使用して正しい検索ログを見つけるか、検索を再度実行して一番上に表示させます。

 

このエンティティが結果にまったく表示されない

次の手順では、エンティティが結果に表示されない原因となる可能性のある要因について説明します。問題が何であるかを特定したら、次のことができます。

• この結果が想定通りであることを理解し、そのままにしておく
• 設定の検索可能フィールドまたはクエリルールを更新する
• エンティティの編集ページを開いて、そのエンティティのコンテンツを更新する

問題が解決したら、残りの手順をスキップしても構いません。

1. バーティカルの検索可能なフィールドを確認し、このエンティティが属するバーティカルで有効になっているものを確認します。
2. 推論フィルターを確認します：検索ログで関連するバーティカルを見つけ、バーティカルに推論フィルターが適用されているか確認します。その場合、エンティティは適用されたすべての推論フィルターを正確に満たす必要があります。
3. 意味的な類似性を確認します：セマンティック検索が有効な場合、エンティティの意味的な類似性を確認します（バーティカル検索でクエリを実行し、ユニバーサル検索に表示されない場合はその検索ログを開きます）。これがデフォルトの0.3未満の場合、エンティティは結果に表示されません。
4. クエリルールを確認します：このエンティティが返されないようにするアクティブなクエリルールが存在したかどうかを確認します。アクティブなクエリルールは、検索ログの右上にある検索要素ボックスに表示されます。
5. キーワード検索/ドキュメント検索/語句の一致を確認します：これらの検索可能なフィールドタイプが有効になっている場合、検索ログで検索トークンを確認し、関連するバーティカルの各エンティティの横で検索可能なフィールドの一致を確認して、アルゴリズムがクエリのどの部分と一致しているかを確認します。
   1. 問題のエンティティにこれらの一致があることを確認してください。
   2. それぞれ別のトークンとして扱われるものの、本来は1つのトークンであるべき複数の単語（例：「エンティティレベル」、「検索」、「要因」）で検索クエリが構成されている場合（例：「エンティティレベルの検索要因」）は、カスタムフレーズを設定します。
      1. Search > [[エクスペリエンス名]] > [一般設定（General Settings）]に移動します。
      2. カスタムフレーズの下に、希望のフレーズを入力してください。
6. 保存済みフィルターを確認してください: エンティティは、設定された保存済みフィルターに該当しない場合、表示されません。
   1. Search > [[エクスペリエンス名]] > [バーティカル（Verticals）]に移動します。
   2. 該当するバーティカルを選択し、「設定」タブをクリックして、「保存済みフィルター」プロパティを見つけてください。
   3. ここで保存済みフィルターが選択されているかどうかを確認し、必要に応じて更新します。
   4. 使用されているフィルターと、この保存されたフィルターに含まれるエンティティを確認するには、以下の手順に従います。
      1. [Knowledge Graph] > [エンティティ（Entities）]に移動します。
      2. 右上隅にあるファネルアイコンをクリックします。
      3. 目的のフィルター名をクリックして、そのフィルターを適用します。
      4. 適用されたフィルターは画面の上部に表示され、保存されたフィルターに含まれるエンティティは下にリストされます。

 

このエンティティは結果で想定よりも高い/低い位置に表示されている

1. 並べ替え順を確認します：検索ログで関連するバーティカルを探し、適用された並べ替え順があるかどうかを確認します。
   1. Search > [[エクスペリエンス名]] > [バーティカル（Verticals）]に移動し、[並べ替え（Sorting）]タブをクリックして、並べ替え設定を追加または編集します。次に、ルールを追加または編集します。
2. 意味的な類似性を確認します：関連するエンティティとその周辺のエンティティの意味的な類似性を確認します。
   1. セマンティック検索とキーワード検索の両方が有効になっている場合、意味的な類似性が0.65を超えると、アルゴリズムはトークンの一致に関係なくその結果を自動的に強調表示します。
3. クエリルールを確認します：このエンティティが返されないようにするアクティブなクエリルールが存在したかどうかを確認します。アクティブなクエリルールは、検索ログの右上にある検索要素ボックスに表示されます。
4. キーワード検索/ドキュメント検索/語句の一致を確認します：これらの検索可能なフィールドタイプが有効になっている場合、検索ログで検索トークンを確認し、関連するバーティカルの各エンティティの横で検索可能なフィールドの一致を確認して、アルゴリズムがクエリのどの部分と一致しているかを確認します。
   1. このエンティティのトークン一致数を他のエンティティと比較して確認します。一致数が多いほど、結果で上位にランクされます。
   2. 問題のエンティティにこれらの一致があることを確認してください。
   3. 異なるエンティティで同じ数のトークンが一致する場合、語句の一致はそのエンティティを検索結果で上位に表示するために強調表示を適用します。
   4. それぞれ別のトークンとして扱われるものの、本来は1つのトークンであるべき複数の単語（例：「エンティティレベル」、「検索」、「要因」）で検索クエリが構成されている場合（例：「エンティティレベルの検索要因」）は、カスタムフレーズを設定します。
      1. Search > [[エクスペリエンス名]] > [一般設定（General Settings）]に移動します。
      2. カスタムフレーズの下に、希望のフレーズを入力してください。

 

セマンティック検索でエンティティが表示されなくなった

1. 問題が発生しているクエリの検索ログを開きます。以下のいずれかを行います。
   
   1. Search > [[エクスペリエンス名]] > [テスト検索（Test Search）] または [設定（Configuration）]サブタブに移動します。テスト検索を実行し、ドロップダウンメニューから[クエリをデバッグ（Debug Query）]を選択します。
   2. ステージングまたは本番環境リンクですでに検索を実行している場合、Search > [[エクスペリエンス名]] > [検索ログ（Search Logs）] に移動し、該当する検索ログをクリックします。検索バーまたはフィルターを使用して正しい検索ログを見つけるか、検索を再度実行して一番上に表示させます。
2. また、関連するエンティティが結果に表示されていた以前の検索ログを開くこともできます。検索ログページの検索バーを使用して検索用語でフィルタリングし、エンティティが表示された検索結果を開きます。
3. エンティティのセマンティックスコアとセマンティックスコア間の違いを確認します。
4. セマンティック検索の背後にあるデータサイエンスモデルは常に改善されているため、以前はわずかに関連性があった結果でも関連性がまったくなくなることがあります。

 

セマンティックしきい値を下回るスコアを持つエンティティが表示される

1. バーティカルしきい値（vertical threshold）を確認します。
   1. Search > [[エクスペリエンス名]] > [バーティカル（Verticals）]に移動します。
   2. 該当するバーティカルのしきい値を見つけ、その値を記録してください。
2. 問題が発生しているクエリの検索ログを開きます。以下のいずれかを行います。
   1. Search > [[エクスペリエンス名]] > [テスト検索（Test Search）]または [設定（Configuration）]サブタブに移動します。テスト検索を実行し、ドロップダウンメニューから[クエリをデバッグ（Debug Query）]を選択します。
   2. ステージングまたは本番環境リンクですでに検索を実行している場合、Search > [[エクスペリエンス名]] > [検索ログ（Search Logs）] に移動し、該当する検索ログをクリックします。検索バーまたはフィルターを使用して正しい検索ログを見つけるか、検索を再度実行して一番上に表示させます。
3. そのバーティカル内の上位エンティティ結果のセマンティックスコアとバーティカルスコアを確認します。すでにお知らせのとおり、バーティカルしきい値は、バーティカル内のエンティティがどの程度関連性を持たなければならないかを制御し、バーティカルが表示されるかどうかを決定します。トップの結果がしきい値を超えている限り、製品は意図したとおりに動作しています。