検索結果の品質に問題がある場合、すなわちアルゴリズムが予想とは異なる結果を返す場合は、バックエンドに問題があります。
以下は、バックエンドの問題をデバッグするための推奨手順です。設定変更はただちに適用されるので、変更を保存する際には再度検索を実行し、問題が解決されているかを確認してください。問題が解決していれば、残りの手順をスキップしても構いません。これらの手順を完了しても問題が解決しない場合は、特定の問題のトラブルシューティングに関するヘルプ記事からさらに情報をお探しください。
バックエンドのデバッグに関する一般的なアプローチについては、Hitchhikersの「バックエンドのデバッグ」トレーニングをご覧ください。このページでは、このドキュメントで検討されている概念を使用します。
- 問題が発生しているクエリの検索ログを開きます。これを行う方法は2つあります。
- [検索ログ] の画面に直接移動する
- ナビゲーションバーの [検索] をクリックし、目的の検索エクスペリエンスをクリックします。
- [検索ログ] をクリックします。
- 目的の検索ログをクリックします。必要に応じて、検索バーも使用できます。
- テスト検索を実行し、そこから検索ログを開く
- ナビゲーションバーの [検索] をクリックし、目的の検索エクスペリエンスをクリックします。
- [テスト検索] をクリックして、全画面の [テスト検索] にアクセスするか、ナビゲーションバーの構成画面のいずれかをクリックして、サイドバーの [テスト検索] にアクセスします。
- テスト検索を実行します。
- Debug Queryをクリックしてください。
- [検索ログ] の画面に直接移動する
-
APIリクエストを確認する。ドロップダウンボタンをクリックし、ドロップダウンメニューで [コードを表示] をクリックします。
-
BACKEND_ERROR
が発生した場合は、根本的な問題があることを示しています。エンジニアリングチームによるレビューを受けられるよう、サポートチケットを送信してください。
-
-
設定のバージョンとラベルを確認する。これは検索ログの1番上にあるメタデータに表示されています。正しいバージョンとラベル(ステージングまたは本番環境)を使用していることを確認してください。しばしば、エクスペリエンスが古いバージョン設定を参照していることが原因で、予期しない結果が引き起こされます。
- 誤ったラベルを使用している場合は、正しいデプロイリンクで検索を再実行するか、テスト検索でラベルを修正します。
- これらのバージョンを更新する必要がある場合、または利用可能なバージョンを確認したい場合は、次の手順を実行します。
- ナビゲーションバーの [検索] をクリックし、目的の検索エクスペリエンスをクリックします。
- [リビジョン履歴(Revision History)]をクリックします。
- 関連するラベルのドロップダウンをクリックして、利用可能なバージョンを確認し、設定したいバージョンを選択します。
- ドロップダウン内の各バージョンには、保存された日付と時刻が表示されます。詳細情報を希望する場合は、[改訂履歴] の画面に移動して、誰がバージョンを更新したかを確認し、設定をダウンロードします。
-
ロケールを確認する。検索エクスペリエンスのロケールは、返そうとしているエンティティのロケールと一致しなければなりません。エンティティのプロフィールが「英語」(en)のロケールを使用している場合、リクエストするロケールは厳密に「en」としなくてはなりません。「en_GB」や「en_US」など類似するロケールをリクエストしても、その通りのロケールでプロフィールが返されます。
-
エンティティプロフィールのロケールを確認する。
- アカウントが1言語のみを使用している場合は、[アカウント設定]に移動し、[個人設定]をクリックします。アカウント主要言語に入力されている言語を確認します。
- アカウントで複数の言語を使用している場合は、各エンティティが異なるロケールを使用することがあります。個々のエンティティの言語を確認するか、エンティティをエクスポートして [プロフィール言語] フィールドを含めることが可能です。
- この言語とロケールのリファレンスドキュメントを使用して、言語とロケールを照合します。
- ナビゲーションバーの [検索] をクリックし、目的の検索エクスペリエンスをクリックします。
- JSONとして編集をクリックしてください。
-
supportedLocales
プロパティに、関連するロケールのカンマ区切りリストを入力します。必ず各ロケールが引用符に入れるようにします。次のような形式とします。"supportedLocales": ["de","es"],
-
エンティティプロフィールのロケールを確認する。
-
しばらくしてから再度確認する: これが新しいアカウントである場合、または最近、エンティティ(または多くのエンティティに影響を与える構成)に多数の更新を行った場合、変更が反映されるまでに数分かかることがあります。しばらくしてから検索を再実行して、結果が変わるかどうかを確認してください。
- Yext Trustサイトを確認して、遅延の原因となっている可能性のあるシステム全体のインシデントが発生していないかどうかを確認します。
-
検索が構成されているトークンを確認する。クエリのトークンは、検索対象、発動するクエリルール、および適用されるシノニムに影響を与えます。これは、検索ログの右側にある検索要素ボックスに表示されます。
- 検索クエリ内の単語がトークンとして識別されるが、不要な結果が表示される場合(例: あなたのブランド名)、それを追加のストップワードとして設定します。
- ナビゲーションバーの [検索] をクリックし、目的の検索エクスペリエンスをクリックします。
- 一般設定をクリックします。
- 追加のストップワードの下に、希望する単語を入力します。
- 検索クエリにトークンとして識別されない単語が含まれている場合、それらは組み込みのストップワード(例: 「または」、「の」、あるいは「で」)または追加のストップワードです。上記の手順に従って追加のストップワードプロパティを確認し、必要に応じてその単語を削除します。
- 検索クエリが複数の単語(例: 「検索レベルの検索要素」)で構成され、それぞれが別のトークン(「検索「検索レベル」、「検索」、「要素」など)として扱われているが、本来は1つのトークンであるべき場合、カスタムフレーズを設定します。
- ナビゲーションバーの [検索] をクリックし、目的の検索エクスペリエンスをクリックします。
- 一般設定をクリックします。
- カスタムフレーズの下に、希望するフレーズを入力します。
- 検索クエリ内の単語がトークンとして識別されるが、不要な結果が表示される場合(例: あなたのブランド名)、それを追加のストップワードとして設定します。
-
検索ログにある検索要素を確認して、適切な検索要素が適用されているかを確認します。適用されていない場合は、以下の特定のヘルプ記事に従い、問題をさらに詳しく調査してください。
- 同義語: 同義語が適用されているかどうかを確認します。
- クエリルール: 適用されたクエリルールによって結果が予想と異なるかどうかを確認します。
- バーティカルランキング: 各バーティカルのスコアを確認し、なぜこの順序でランク付けされたのかを判断します。
- 推論フィルター: 各バーティカルに推論フィルターが適用されているか確認します。
Searchバックエンドのトラブルシューティングに関するその他の記事
これらの手順を完了しても問題が解決しない場合は、特定の問題のトラブルシューティングに関するヘルプ記事からさらに情報をお探しください。別の担当者に確認してもらった後でも問題が解決しない場合は、チケットを送信して、Yext製品チームおよびエンジニアリングチームにお問い合わせください。
コメント
0件のコメント
記事コメントは受け付けていません。