Azure モデル コンテキスト プロトコル (MCP) サーバーを使用すると、自然言語プロンプトを使用して、検索サービス、インデックス、ナレッジ ソース、ナレッジ ベースなどの Azure AI 検索 リソースを管理できます。
Azure AI 検索 (旧称 Azure Cognitive Search) は、取得拡張生成 (RAG) パターンに従うアプリケーションとエージェントを構築するための API とツールを提供するクラウド検索サービスです。 ベクトルとキーワードの取得、再ランク付け、エージェント検索をサポートしています。詳細については、 Azure AI 検索 のドキュメントを参照してください。
注
各 Azure AI 検索 ナレッジ ベースは、直接取得するためにネイティブ MCP エンドポイントを公開します。 詳細については、「 MCP エンドポイントの呼び出し」を参照してください。
注
ツール パラメーター: Azure MCP Server ツールは、タスクを完了するために必要なデータのパラメーターを定義します。 これらのパラメーターの一部は、各ツールに固有であり、ここに記載されています。 その他のパラメーターはグローバルであり、すべてのツールで共有されます。 詳細については、「 ツールパラメーター」を参照してください。
検索インデックスを取得する
このツールは、インデックス スキーマ、フィールド、アナライザー、スコアリング プロファイル、その他のインデックス プロパティなど、Azure AI 検索 インデックスに関する詳細情報を取得します。 インデックス名を指定すると、そのインデックスのプロパティが返されます。インデックス名を指定しない場合は、指定されたサービス内のすべてのインデックスが返されます。
プロンプトの例を次に示します。
- "Azure AI 検索 サービス 'my-search-service' のインデックス 'products-index' の詳細を表示します。"
- "Azure AI 検索 サービス 'enterprise-search' 内のすべてのインデックスを一覧表示します。"
- "サービス 'contoso-search' の 'users' インデックスに含まれるフィールドは何ですか?
| パラメーター | 必須または省略可能 | Description |
|---|---|---|
| サービス | 必須 | Azure AI 検索 サービスの名前 (たとえば、 my-search-service)。 |
| Index | オプション | Azure AI 検索 サービス内の検索インデックスの名前。 |
| 破壊的な | 冪等性 | オープン ワールド | [読み取り専用] | Secret | ローカル必須 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
クエリ検索インデックス
このツールは、Azure AI 検索 インデックスに対して検索クエリを実行し、一致するドキュメントと関連性メタデータを返します。 通常、結果には、ドキュメント フィールド、関連性スコア、クエリに一致するテキストの強調表示が含まれます。
プロンプトの例を次に示します。
- "'contoso-search' サービスの 'documents' インデックスで '機械学習' を検索します。"
- Azure AI 検索 サービス 'fabrikam-search' で、『ノイズキャンセリング ヘッドフォン』に対してインデックス 'products' にクエリを行います。
- "'my-search-service' で自分の 'content' インデックスを検索し、'気候変動' に言及するものを探します。
| パラメーター | 必須または省略可能 | Description |
|---|---|---|
| サービス | 必須 | Azure AI 検索 サービスの名前 (たとえば、 my-search-service)。 |
| Index | 必須 | Azure AI 検索 サービス内の検索インデックスの名前。 |
| クエリ | 必須 | Azure AI 検索 インデックスに対して実行する検索クエリ。 |
| 破壊的な | 冪等性 | オープン ワールド | [読み取り専用] | Secret | ローカル必須 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
ナレッジ ベースを取得する
このツールは、Azure AI 検索 ナレッジ ベースの詳細を取得します。 ナレッジ ベースは、1 つ以上のナレッジ ソースまたはインデックスに対する取得と推論の機能をカプセル化します。 ナレッジ ベース名を指定しない場合は、指定されたサービス内のすべてのナレッジ ベースの詳細が返されます。
プロンプトの例を次に示します。
- "Azure AI 検索 サービス 'my-search-service' 内のすべてのナレッジ ベースを一覧表示します。"
- "サービス 'contoso-search' のナレッジ ベースを表示してください。"
- "Azure AI 検索 サービス 'enterprise-search' のナレッジ ベース 'support-agent' の詳細を取得します。"
| パラメーター | 必須または省略可能 | Description |
|---|---|---|
| サービス | 必須 | Azure AI 検索 サービスの名前 (たとえば、 my-search-service)。 |
| 知識ベース | オプション | Azure AI 検索 サービス内のナレッジ ベースの名前。 |
| 破壊的な | 冪等性 | オープン ワールド | [読み取り専用] | Secret | ローカル必須 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
ナレッジ ベースから取得する
このツールは、Azure AI 検索 ナレッジ ベースに対して取得操作を実行して、データ ソースから関連情報を検索します。 取得用の単一ターン クエリまたは 1 つ以上の会話型メッセージを role:content 形式で指定します。 クエリとメッセージの両方を指定することはできません。
プロンプトの例を次に示します。
- "Azure AI 検索 サービス 'my-search-service' のナレッジ ベース 'support-agent' を使用して、クエリ 'パスワード リセット ステップ' の取得を実行します。"
- "検索サービス 'contoso-search' のナレッジ ベース 'product-docs' に 'API レート制限' に関する情報を取得するように依頼します。"
- "検索サービス 'hr-search' で '休暇積立方針' に関するナレッジベース 'hr-policies' にクエリを実行します。"
| パラメーター | 必須または省略可能 | Description |
|---|---|---|
| サービス | 必須 | Azure AI 検索 サービスの名前 (たとえば、 my-search-service)。 |
| 知識ベース | 必須 | Azure AI 検索 サービス内のナレッジ ベースの名前。 |
| クエリ | オプション | 会話メッセージ履歴が提供されていない場合に取得するための自然言語クエリ。 |
| メッセージ | オプション | ナレッジ ベースに渡された会話履歴メッセージ。 ロールがrole:contentまたはuser (たとえば、assistant) である、user:What policies apply to archived invoices?形式の各エントリ。 |
| 破壊的な | 冪等性 | オープン ワールド | [読み取り専用] | Secret | ローカル必須 |
|---|---|---|---|---|---|
| ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
ナレッジ ソースを取得する
このツールは、Azure AI 検索 のナレッジ ソースの詳細を取得します。 ナレッジ ソースは、既存の Azure AI 検索 インデックスをポイントしたり、Azure AI 検索 でインデックスが作成された外部データ (BLOB ストレージ コンテナーなど) を表すことができます。 ナレッジ ソースは、取得時にナレッジ ベースによって使用されます。 ナレッジ ソース名を指定しない場合は、指定されたサービス内のすべてのナレッジ ソースの詳細が返されます。
プロンプトの例を次に示します。
- "Azure AI 検索 サービス 'my-search-service' のすべてのナレッジ ソースを一覧表示します。"
- "Azure AI 検索 サービス 'contoso-search' のナレッジ ソースを表示します。"
- "検索サービス 'enterprise-search' でナレッジ ソース 'product-index' の詳細を取得します。"
| パラメーター | 必須または省略可能 | Description |
|---|---|---|
| サービス | 必須 | Azure AI 検索 サービスの名前 (たとえば、 my-search-service)。 |
| ナレッジ ソース | オプション | Azure AI 検索 サービス内のナレッジ ソースの名前。 |
| 破壊的な | 冪等性 | オープン ワールド | [読み取り専用] | Secret | ローカル必須 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
検索サービスを一覧表示する
このツールは、サブスクリプション内の Azure AI 検索 サービスを一覧表示し、名前、場所、SKU、プロビジョニング状態、エンドポイントなど、各サービスの詳細を返します。
プロンプトの例を次に示します。
- "サブスクリプション内の Azure AI 検索 サービスを一覧表示します。"
- "どのような AI Search サービスがありますか?
- "Azure AI 検索 リソースを表示してください"。
| 破壊的な | 冪等性 | オープン ワールド | [読み取り専用] | Secret | ローカル必須 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |