クイックスタート: Azure ポータルで検索エクスプローラーを使用してクエリを実行する

Note

Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。また、Foundry IQ は、エンタープライズコンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジベースに変換するマネージドナレッジレイヤーです。

このクイックスタートでは、Azure ポータルの組み込みクエリツールである Search explorer を使用して、Azure AI 検索インデックスに対してクエリを実行する方法について説明します。このツールを使用して、クエリまたはフィルター式をテストしたり、コンテンツがインデックスに存在するかどうかを確認したりできます。

このクイックスタートでは、既存のインデックスを使用して Search エクスプローラーのデモンストレーションを行います。

前提条件

アクティブなサブスクリプションを持つAzure アカウント。アカウントを無料で作成します。
Azure AI 検索サービス。サービスの作成または現在のサブスクリプションの既存のサービスを確認します。このクイックスタートでは、無料サービスを使用できます。
このクイックスタートでは、hotels-sample インデックスを使用します。このクイックスタートの手順に従ってインデックスを作成します。

検索エクスプローラーを起動する

Azure ポータルで検索サービスに移動します。
左側のウィンドウで、[ 概要] を選択します。
コマンドバーで、 検索エクスプローラーを選択します。

または、インデックスページの [検索エクスプローラー ] タブを選択します。

3 つの方法でクエリする

Search エクスプローラーでクエリを実行するには、次の 3 つの方法があります。

クエリビューには、既定の検索バーが用意されています。空のクエリや、 ocean view + parkingなどのブール値を含む自由形式のクエリを受け入れます。
画像ビューには、PNG、JPG、または JPEG ファイルを参照またはドラッグアンドドロップするためのウィンドウが用意されています。インデックスに画像ベクター化と同等のスキルがない限り、このビューは使用できません。
JSON ビューでは、パラメーター化されたクエリがサポートされます。フィルター、orderby、select、count、searchFields、およびその他すべてのパラメーターを JSON ビューで設定する必要があります。

例: イメージクエリ

検索エクスプローラーでは、 イメージビューを使用して画像をクエリ入力として受け入れます。そのためには、サポートされている vectorizer-skill ペアを使用する必要があります。詳細については、「検索インデックスでベクターライザーを構成する」を参照してください。

hotels-sample インデックスは、画像ベクター化用に構成されていません。イメージクエリを実行する場合は、「Quickstart: vector search in the Azure portal で説明されているようにインデックスを作成します。このクイックスタートではテキストベースのサンプルデータに依存しているため、画像を含むドキュメントを使用する必要があります。

イメージクエリを実行するには、画像を選択するか、検索領域にドラッグして、[ 検索] を選択します。検索エクスプローラーは、画像をベクター化し、クエリを実行するためにベクターを検索エンジンに送信します。検索エンジンは、指定した k 数の結果まで、入力イメージと十分に類似したドキュメントを返します。

例: JSON クエリ

検索エクスプローラーを使用して実行できる JSON クエリの例を次に示します。これらの例に従うために、 JSON ビューに切り替えます。各 JSON の例をテキスト領域に貼り付けることができます。

ヒント

JSON ビューでは、パラメーター名補完のインテリジェンスをサポートしています。 JSON ビュー内にカーソルを置き、スペース文字を入力して、すべてのクエリパラメーターの一覧を表示します。 sなどの文字を入力して、その文字で始まるクエリパラメーターのみを表示することもできます。

Intellisense では無効なパラメーターが除外されないため、最適な判断を使用してください。

指定されていないクエリを実行する

Search エクスプローラーでは、POST 要求は Documents - Search Post (REST API) を使用して内部的に作成され、応答は詳細な JSON ドキュメントとして返されます。

コンテンツを初めて見る場合は、[用語が指定されていない検索] を選択して空の検索を実行します。空の検索は、ドキュメントの構成を確認できるようにドキュメント全体を返すので、最初のクエリとして役立ちます。空の検索では、検索スコアはなく、ドキュメントは任意の順序 (すべてのドキュメントに対して"@search.score": 1 ) で返されます。既定では、検索要求ごとに 50 個のドキュメントが返されます。

インデックスで見つかった一致の数を取得する "count": true を追加します。空の検索では、カウントはインデックス内のドキュメントの合計数です。修飾検索では、クエリ入力と一致するドキュメントの数です。サービスは既定で上位 50 件の一致を返すので、結果で返される数よりも多くの一致がインデックスに含まれる可能性があることを思い出してください。

空の検索と同等の構文は、 * または "search": "*"です。

{
   "search": "*",
   "count": true
}

結果

フリーテキストクエリを実行する

演算子の有無にかかわらず、自由形式の検索は、カスタムアプリからAzure AI 検索に送信されるユーザー定義クエリをシミュレートするのに役立ちます。インデックス内で検索可能として属性付けされたフィールドのみが、一致をスキャンします。

自由テキストクエリの JSON ビューは必要ありませんが、この記事の他の例と一貫性を保つため、JSON で提供します。

クエリ用語や式などの検索条件を指定すると、検索ランクが適用されます。次の例は、フリーテキスト検索を示しています。 @search.scoreは、既定のスコアリングアルゴリズムを使用して一致に対して計算される関連性スコアです。

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

結果

Ctrl-F を使用して、特定の目的の用語を検索結果内で検索できます。

検索結果のフィールドを制限する

"select"を追加して、明示的に名前が付けられたフィールドに結果を制限し、検索エクスプローラーで読みやすい出力を得られます。インデックスで取得可能として属性付けされたフィールドのみが結果に表示されます。

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

結果

次の結果バッチを返す

Azure AI 検索は、検索ランクに基づいて上位 50 件の一致を返します。 hotels-sample インデックスには 50 件のホテルしかないため、ページングを示すために使用するホテルの数を少なくしています。一致するドキュメントの次のセットを取得するには、 "top": 20 を追加し、 "skip": 10 して結果セットを 20 個のドキュメントに増やします (既定値は 50、最大値は 1000)、最初の 10 個のドキュメントをスキップします。ドキュメントキー (HotelId) を確認して、ドキュメントを識別できます。

ランク付けされた結果を取得するには、クエリ用語や式などの検索条件を指定する必要があることを思い出してください。検索結果に深く進むほど、検索スコアが低下します。

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

結果

フィルター式 (より大きい、より小さい、等しい)

filter パラメーターを使用して、包含または除外の条件を指定します。フィールドは、インデックスでフィルター可能として属性付けする必要があります。次の例では、4 つを超える評価を検索します。

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

結果

結果の並べ替え

orderbyを追加して、検索スコア以外の別のフィールドで結果を並べ替えます。フィールドは、インデックス内で並べ替え可能として属性付けする必要があります。フィルター処理された値が同じ (同じ価格など) 場合、注文は任意ですが、より深い並べ替えの条件を追加できます。これをテストするために使用できる式の例を次に示します。

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

結果

重要なポイント

このクイックスタートでは、 検索エクスプローラー を使用して、REST API を使用してインデックスのクエリを実行しました。

結果は詳細な JSON ドキュメントとして返されるため、各ドキュメントの構造と内容全体を表示できます。クエリ式の select パラメーターは、返されるフィールドを制限します。
検索結果は、インデックスで取得可能として属性付けされたすべてのフィールドで構成されます。 [ フィールド ] タブを選択して属性を確認します。
キーワード検索は、商用 Web ブラウザーで入力する場合と同様に、エンドユーザーエクスペリエンスをテストするのに役立ちます。たとえば、hotels-sample インデックスを想定すると、 "activities 'outdoor pool' restaurant OR continental breakfast"を入力し、Ctrl-F を使用して検索結果内の用語を検索できます。
クエリ式とフィルター式は、Azure AI 検索によって実装される構文で明確に示されます。既定値は単純な構文ですが、必要に応じて完全な Lucene を使用して、より強力なクエリを実行できます。フィルター式は OData 構文で表現されます。

リソースのクリーンアップ

自分のサブスクリプションで作業する場合は、不要になったリソースを削除してプロジェクトを完了することをお勧めします。リソースが稼働し続けていると、コストが発生する可能性があります。

Azure ポータルで、左側のウィンドウから [すべてのリソース] または [リソースグループ を選択して、リソースを検索および管理します。リソースを個別に削除することも、リソースグループを削除してすべてのリソースを一度に削除することもできます。

無料の検索サービスを使用している場合は、3 つのインデックス、インデクサー、データソースに制限されていることを覚えておいてください。ポータルで個々のアイテムを削除して、制限を超えないようにすることができます。

次の手順

クエリの構造と構文の詳細については、REST クライアントを使用して、REST API のより多くの部分を使用するクエリ式を作成します。ドキュメント - Search Post (REST API) は、学習と探索に特に役立ちます。

クイックスタート: フルテキスト検索

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-05-12